Achèvement du verrouillage du coffre (POST lockId)

Description

Cette opération termine le processus de verrouillage du coffre en passant le verrouillage du coffre de l'état InProgress à l'état Locked, ce qui provoque l'immuabilité de la stratégie de verrouillage du coffre. Le verrouillage du coffre est passé à l'état InProgress en appelant Lancement de verrouillage de coffre (POST lock-policy). Vous pouvez obtenir l'état du verrouillage du coffre en appelant Obtenir le verrouillage de coffre (GET lock-policy). Pour plus d'informations sur le processus de verrouillage de coffre, consultez la section Verrouillage de coffre S3 Glacier.

Cette opération est idempotente. Cette demande aboutit toujours si l'état du verrouillage du coffre est Locked et que l'ID de verrouillage fourni correspond à l'ID de verrouillage utilisé initialement pour verrouiller le coffre.

Si un ID de verrouillage non valide est passé dans la demande lorsque le verrouillage du coffre a l'état Locked, l'opération renvoie une erreur AccessDeniedException. Si un ID de verrouillage non valide est passé dans la demande lorsque l'état du verrouillage du coffre est InProgress, l'opération génère une erreur InvalidParameter.

Requêtes

Pour terminer le processus de verrouillage du coffre, envoyez une demande HTTP POST à l'URI de la sous-ressource lock-policy du coffre avec un ID de verrouillage valide.

Syntaxe

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

Note

La valeur de AccountId est l'ID de Compte AWS. Cette valeur doit correspondre à l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « - » (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Si vous spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.

La valeur lockId est l'ID de verrouillage obtenu d'une demande Lancement de verrouillage de coffre (POST lock-policy).

Paramètres de demande

En-têtes de demande

Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez En-têtes de demande communs.

Corps de la requête

Cette opération n'a pas de corps de demande.

Réponses

Si la demande d'opération aboutit, le service renvoie une réponse HTTP 204 No Content.

Syntaxe

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

En-têtes de réponse

Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez En-têtes de réponse communs.

Corps de la réponse

Cette opération ne renvoie pas de corps de réponse.

Erreurs

Pour en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.

Exemples

Exemple de requête

L'exemple suivant envoie une demande HTTP POST avec l'ID de verrouillage pour terminer le processus de verrouillage du coffre.

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

Exemple de réponse

Si la demande aboutit, Amazon S3 Glacier (S3 Glacier) renvoie une réponse HTTP 204 No Content, comme dans l'exemple suivant.

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

Sections connexes

• Interruption du verrouillage du coffre (DELETE lock-policy)

• Obtenir le verrouillage de coffre (GET lock-policy)

• Lancement de verrouillage de coffre (POST lock-policy)

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK Amazon propres au langage, consultez la ressource suivante :

• AWS Command Line Interface