Obtención del bloqueo del almacén (GET política-bloqueo) - Amazon S3 Glacier

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.

Obtención del bloqueo del almacén (GET política-bloqueo)

Descripción

Esta operación recupera los siguientes atributos del subrecurso lock-policy establecido en el almacén especificado:

  • La política de bloqueo de almacenes definida en el almacén.

  • El estado del bloqueo de almacenes, que puede ser InProgess o Locked.

  • Fecha de vencimiento del ID del bloqueo. El ID del bloqueo se utiliza para completar el proceso de bloqueo del almacén.

  • Momento en que se inició el bloque de almacenes y adoptó el estado InProgress.

Un bloqueo de almacenes adopta el estado InProgress llamando a Inicio del bloqueo de almacenes (POST lock-policy). Un bloqueo de almacenes adopta el estado Locked llamando a Realización del bloqueo de almacenes (POST lockId). Puede detener el proceso de bloqueo llamando aAnulación del bloqueo de almacenes (DELETE lock-policy). Para obtener más información acerca del proceso de bloqueo de almacenes, consulte S3 Glacier almacén bloqueo.

Si no hay ninguna política de bloqueo de almacenes definida en el almacén, la operación devuelve un error 404 Not found. Para obtener más información sobre las políticas de bloqueo de almacenes, consulte Control del acceso de Amazon S3 Glacier mediante políticas de bloqueo de almacenes.

Solicitudes

Para devolver la política de bloqueo de almacenes actual y otros atributos, envíe una solicitud HTTP GET al URI del subrecurso lock-policy del almacén, tal y como se muestra en el siguiente ejemplo de sintaxis.

Sintaxis

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

nota

LaAccountIdValor es elCuenta de AWSACCOUNT ID de la cuenta propietaria del almacén. Puede especificar unCuenta de AWSID u opcionalmente un solo '-'(guión), en cuyo caso Amazon S3 Glacier utiliza elCuenta de AWSACCOUNT ID asociado con las credenciales que se utilizaron para firmar la solicitud. Si utilizas un ID de cuenta, no incluyas guiones ('-') en el ID.

Parámetros de solicitud

Esta operación no usa 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

Amazon S3 Glacier (S3 Glacier) devuelve la política de acceso a almacenes en formato JSON en el cuerpo de la respuesta.

Sintaxis

HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": "string", "State": "string", "ExpirationDate": "string", "CreationDate":"string" }

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

El cuerpo de la respuesta contiene los siguientes campos JSON.

Auto Scaling

Política de bloqueo de almacenes en forma de una cadena JSON, donde se utiliza" \" como carácter de escape.

Type: Cadena

Estado

Estado del bloqueo del almacén.

Type: Cadena

Valores válidos: InProgress|Locked

ExpirationDate

Fecha y hora en formato UTC en que vence el ID de bloqueo. Este valor puede ser null si el bloque del almacén tiene el estado Locked.

Type: Una representación de cadena en el formato de fecha ISO 8601, por ejemplo2013-03-20T17:03:43.221Z.

CreationDate

Fecha y hora en formato UTC en que el bloqueo de almacenes adoptó el estado InProgress.

Type: Una representación de cadena en el formato de fecha ISO 8601, por ejemplo2013-03-20T17:03:43.221Z.

Errores

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

Ejemplos

En el ejemplo siguiente, se muestra cómo obtener una política de bloqueo de almacenes.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud GET al URI del subrecurso lock-policy del almacén.

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

Respuesta de ejemplo

Si la solicitud se realizó correctamente, S3 Glacier devuelve la política de acceso a almacenes como una cadena JSON en el cuerpo de la respuesta. La cadena JSON devuelta utiliza "\" como carácter de escape, tal y como se muestra en la solicitud de ejemplo Inicio del bloqueo de almacenes (POST lock-policy). Sin embargo, en el ejemplo siguiente, la cadena JSON devuelta aparece sin caracteres de escape.

HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: length { "Policy": " { "Version": "2012-10-17", "Statement": [ { "Sid": "Define-vault-lock", "Principal": { "AWS": "arn:aws:iam::999999999999:root" }, "Effect": "Deny", "Action": "glacier:DeleteArchive", "Resource": [ "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault" ], "Condition": { "NumericLessThanEquals": { "glacier:ArchiveAgeInDays": "365" } } } ] } ", "State": "InProgress", "ExpirationDate": "exampledate", "CreationDate": "exampledate" }

Véase también

Para obtener más información sobre el uso de esta API en un SDK de Amazon específico, consulte: