Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Lancement de verrouillage de coffre (POST lock-policy)

Description

Cette opération lance le processus de verrouillage de coffre en procédant comme suit :

Vous pouvez définir une stratégie de verrouillage de coffre pour chaque coffre et la taille de cette stratégie peut atteindre 20 Ko. Pour plus d'informations sur les stratégies de verrouillage de coffre, consultez la page Stratégies de verrouillage de coffre.

Vous devez terminer le processus de verrouillage de coffre dans un délai de 24 heures après le passage à l'état InProgress du verrouillage de coffre. Au terme de la fenêtre de 24 heures, l'ID de verrouillage expire, le coffre quitte automatiquement l'état InProgress et la stratégie de verrouillage de coffre est retirée du coffre. Vous appelez Achèvement du verrouillage du coffre (POST lockId) pour terminer le processus de verrouillage de coffre en affectant l'état Locked au verrouillage de coffre.

Vous pouvez arrêter le processus de verrouillage de coffre en appelant Interruption du verrouillage du coffre (DELETE lock-policy). Vous pouvez obtenir l'état du verrouillage de 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.

Si cette opération est appelée alors que le verrouillage de coffre est à l'état InProgress, l'opération renvoie une erreur AccessDeniedException. Lorsque le verrouillage de coffre est à l'état InProgress, vous devez appeler Interruption du verrouillage du coffre (DELETE lock-policy) avant de pouvoir lancer une nouvelle stratégie de verrouillage de coffre.

Requêtes

Pour lancer le processus de verrouillage de coffre, envoyez une demande HTTP POST à l'URI de la sous-ressource lock-policy du coffre, comme illustré dans l'exemple de syntaxe suivant.

Syntaxe

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"
}

Paramètres de demande

Cette opération n'utilise pas les 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

Le corps de la demande contient les champs JSON suivants.

Réponses

Amazon S3 Glacier (S3 Glacier) renvoie une réponse HTTP 201 Created si la politique est acceptée.

Syntaxe

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

En-têtes de réponse

Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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 PUT à l'URI de la sous-ressource lock-policy du coffre. La chaîne JSON Policy utilise « \ » comme caractère d'échappement.

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\"}}}]}"}

Exemple de réponse

Si la demande aboutit, S3 Glacier renvoie une réponse HTTP 201 Created, comme l'illustre l'exemple suivant.

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

Sections connexes

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 :