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.

Puede detener el proceso de bloqueo llamando aAnulació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 SGlacier.

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

LaAccountIdValue esCuenta de AWSID. Este valor debe coincidir conCuenta de AWSId asociado con las credenciales que se utilizaron para firmar la solicitud. Puede especificarCuenta de AWSID u opcionalmente un solo '-'(guión), en cuyo caso Amazon S3 Glacier utiliza elCuenta de AWSId asociado con las credenciales que se utilizaron para firmar la solicitud. Si especificas tu 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

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

Obligatorio: Sí

Respuestas

Amazon S3 Glacier (S3 Glacier) devuelve unHTTP 201 Createdrespuesta, 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 que son comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuestas comunes, consulteEncabezados 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. Type: 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 en Amazon S3 Glacier, consulteRespuestas 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 unHTTP 201 Createdrespuesta, 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

Secciones relacionadas

• Anulación del bloqueo de almacenes (DELETE lock-policy)

• Realización del bloqueo de almacenes (POST lockId)

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

Véase también

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

• AWS Command Line Interface