Realización del bloqueo de almacenes (POST lockId) - Amazon S3 Glacier

Si aún no se ha familiarizado con el almacenamiento de archivos en Amazon Simple Storage Service (Amazon S3), se recomienda que comience por obtener más información sobre las clases de almacenamiento de S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información, consulte Clases de almacenamiento de S3 Glacier y Clases de almacenamiento para archivar objetos en la Guía del usuario de Amazon S3.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Realización del bloqueo de almacenes (POST lockId)

Descripción

Esta operación complete el proceso de bloqueo de almacenes mediante la transición del bloqueo del almacenamiento del estado InProgress al estado Locked, lo que provoca que la política de bloqueo de almacenes no se pueda cambiar. Un bloqueo de almacenes adopta el estado InProgress llamando a Inicio del bloqueo de almacenes (POST lock-policy). Puede obtener el estado del bloqueo de almacenes llamando a Obtención del bloqueo del almacén (GET política-bloqueo). Para obtener más información acerca del proceso de bloqueo de almacenes, consulte Bloqueo de almacenes de S3 Glacier.

Esta operación es idempotente. Esta solicitud siempre es correcta si el bloqueo de almacenes se encuentra en el estado Locked y el ID de bloqueo proporcionado coincide con el ID de bloqueo usado originalmente para bloquear el almacén.

Si se pasa un ID de bloqueo no válido en la solicitud cuando el bloqueo de almacenes se encuentra en el estado Locked, la operación devuelve un error AccessDeniedException. Si se pasa un ID de bloqueo no válido en la solicitud cuando el bloqueo de almacenes se encuentra en el estado InProgress, la operación genera un error InvalidParameter.

Solicitudes

Para completar el proceso de bloqueo de almacenes, envíe una solicitud HTTP POST al URI del subrecurso lock-policy del almacén con un ID de bloqueo válido.

Sintaxis

POST /AccountId/vaults/vaultName/lock-policy/lockId HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue Content-Length: Length x-amz-glacier-version: 2012-06-01
nota

El valor AccountId es el ID de Cuenta de AWS. Este valor debe coincidir con el ID de la Cuenta de AWS asociada con las credenciales que se utilizaron para firmar la solicitud. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si especifica su ID de cuenta, no incluya ningún guion (“-”) en él.

El valor lockId es el ID de bloqueo obtenido de una solicitud Inicio del bloqueo de almacenes (POST lock-policy).

Parámetros de solicitud

Encabezados de solicitud

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte Encabezados de solicitudes comunes.

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Si la solicitud de la operación se realiza correctamente, el servicio devuelve una respuesta HTTP 204 No Content.

Sintaxis

HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date

Encabezados de respuesta

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de respuesta

Esta operación no devuelve ningún cuerpo de respuesta.

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplos

Solicitud de ejemplo

El siguiente ejemplo envía una solicitud HTTP POST con el ID de bloqueo para completar el proceso de bloqueo de almacenes.

POST /-/vaults/examplevault/lock-policy/AE863rKkWZU53SLW5be4DUcW HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 Content-Length: length x-amz-glacier-version: 2012-06-01

Respuesta de ejemplo

Si la solicitud se realizó correctamente, Amazon S3 Glacier (S3 Glacier) devuelve una respuesta HTTP 204 No Content, tal y como se muestra en el ejemplo siguiente.

HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT

Véase también

Para obtener más información sobre el uso de esta API en uno de los SDK de Amazon específicos de idioma, consulte lo siguiente: