Inicio del bloqueo de almacenes (POST lock-policy) - Amazon S3 Glacier
DescripciónSolicitudesRespuestasEjemplosSecciones relacionadasVéase también

Esta página es solo para los clientes actuales del servicio S3 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 S3 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 Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan la API de Amazon S3, están disponibles en todas las regiones y se pueden administrar en la consola de Amazon S3. Ofrecen funciones como el análisis de costes de almacenamiento, Lente de almacenamiento características avanzadas de cifrado opcionales y más.

Inicio del bloqueo de almacenes (POST lock-policy)

Descripción

Esta operación inicia el proceso de bloqueo de almacenes del modo siguiente:

  • Instalación de una política de bloqueo de almacenes en el almacén especificada.

  • Configuración del estado de bloqueo de almacenes en InProgress.

  • Devolución de un ID de bloqueo, que se utiliza para completar el proceso de bloqueo de almacenes.

Puede definir una política de bloqueo de almacenes para cada almacén y la política puede tener un tamaño de hasta 20 KB. Para obtener más información sobre las políticas de bloqueo de almacenes, consulte Políticas de bloqueo de almacenes.

Debe completar el proceso de bloqueo de almacenes en un plazo de 24 horas después de que el bloqueo de almacenes cambie al estado InProgress. Una vez que finalice el periodo de 24 horas, caduca el ID de bloqueo, el almacén sale automáticamente del estado InProgress y la política de bloqueo de almacenes se elimina del almacén. Llame a Realización del bloqueo de almacenes (POST lockId) para completar el proceso de bloqueo de almacenes mediante la configuración del estado del almacén de bloqueo en Locked.

nota

Después de que bloqueo de almacén cambie al estado Locked, no puede iniciar un nuevo bloqueo de almacenes para el almacén.

Para detener el proceso de bloqueo, llame a Anulación del bloqueo de almacenes (DELETE 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.

Si esta operación se llamada cuando el bloqueo de almacenes se encuentra en el estado InProgress, la operación devuelve un error AccessDeniedException. Cuando el bloqueo de almacenes se encuentra en el estado InProgress, debe llamar a Anulación del bloqueo de almacenes (DELETE lock-policy) para poder iniciar una nueva política de bloqueo de almacenes.

Solicitudes

Para iniciar el proceso de bloqueo de almacenes, envíe una solicitud HTTP POST al URI del subrecurso lock-policy del almacén, tal y como se muestra en el siguiente ejemplo de sintaxis.

Sintaxis

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

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.

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

El cuerpo de la solicitud 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

Obligatorio: sí

Respuestas

Amazon S3 Glacier (S3 Glacier) devuelve una respuesta HTTP 201 Created si se acepta la política.

Sintaxis

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-lock-id: lockId

Encabezados de respuesta

Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte Encabezados de respuesta comunes.

Nombre Descripción
x-amz-lock-id

El ID del bloqueo, que se utiliza para completar el proceso de bloqueo de almacenes.

Tipo: cadena

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 PUT dirigida al URI del subrecurso lock-policy del almacén. La cadena JSON Policy utiliza "\" como carácter de escape.

PUT /-/vaults/examplevault/lock-policy 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

{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}

Respuesta de ejemplo

Si la solicitud se realizó correctamente, S3 Glacier devuelve una respuesta HTTP 201 Created, tal y como se muestra en el ejemplo siguiente.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
x-amz-lock-id: AE863rKkWZU53SLW5be4DUcW

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: