Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API de REST original de 2012.
Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte las clases de almacenamiento de Amazon Glacier
Amazon Glacier (servicio original independiente basado en almacenes) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente con sus propias API que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier
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
InProgessoLocked. -
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). Para detener el proceso de bloqueo, llame a Anulación del bloqueo de almacenes (DELETE lock-policy). Para obtener más información acerca del proceso de bloqueo de almacenes, consulte Bloqueo del almacén de Amazon Glacier.
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 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:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01
nota
El valor AccountId es el ID de la Cuenta de AWS propietaria del almacén. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.
Parámetros de la 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
En respuesta, Amazon Glacier (Amazon 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.
- Política
-
Política de bloqueo de almacenes en forma de una cadena JSON, donde se utiliza" \" como carácter de escape.
Tipo: cadena
- Estado
-
Estado del bloqueo del almacén.
Tipo: cadena
InProgressValores válidos:|Locked - ExpirationDate
-
Fecha y hora en formato UTC en que vence el ID de bloqueo. Este valor puede ser
nullsi el bloque del almacén tiene el estadoLocked.Tipo: una representación de cadena con el formato de fecha ISO 8601; por ejemplo,
2013-03-20T17:03:43.221Z. - CreationDate
-
Fecha y hora en formato UTC en que el bloqueo de almacenes adoptó el estado
InProgress.Tipo: una representación de cadena con el formato de fecha ISO 8601; por ejemplo,
2013-03-20T17:03:43.221Z.
Errores
Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte Respuestas 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, Amazon 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" }
Secciones relacionadas
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: