**Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.** Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon 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 [classes de stockage Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous [recommandons les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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. # Obtenir le verrouillage de coffre (GET lock-policy) ## Description Cette opération extrait les attributs suivants à partir de la sous-ressource `lock-policy` définie sur le coffre spécifié : + La stratégie de verrouillage de coffre définie sur le coffre. + L'état du verrouillage du coffre, qui est soit `InProgess` soit `Locked`. + Moment où l'ID de verrouillage arrive à expiration. L'ID de verrouillage est utilisé pour terminer le processus de verrouillage du coffre. + Le moment où le verrouillage du coffre a été lancé et s'est vu attribuer l'état `InProgress`. Le verrouillage du coffre est passé à l'état `InProgress` en appelant [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md). Le verrouillage du coffre est passé à l'état `Locked` en appelant [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md). Vous pouvez arrêter le processus de verrouillage de coffre en appelant [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md). Pour plus d'informations sur le processus de verrouillage de coffre, consultez la section [Verrou Amazon Glacier Vault](vault-lock.md). Si aucune stratégie de verrouillage de coffre n'est définie sur le coffre, l'opération renvoie une erreur `404 Not found`. Pour plus d'informations sur les stratégies de verrouillage de coffre, consultez la page [Stratégies de verrouillage de coffre](vault-lock-policy.md). ## Requêtes Pour renvoyer la stratégie de verrouillage de coffre actuelle et d'autres attributs, envoyez une demande `GET` HTTP à l'URI de la sous-ressource `lock-policy` du coffre, comme illustré dans l'exemple de syntaxe suivant. ### Syntaxe ``` 1. GET /AccountId/vaults/vaultName/lock-policy HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **Note** La `AccountId` valeur est l' Compte AWS ID du compte propriétaire du coffre-fort. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant associé aux informations d'identification utilisées pour signer la demande. Si vous utilisez un ID de compte, évitez d'y inclure des traits d'union (« - »). ### 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](api-common-request-headers.md). ### Corps de la requête Cette opération n'a pas de corps de demande. ## Réponses En réponse, Amazon Glacier (Amazon Glacier) renvoie la politique d'accès au coffre-fort au format JSON dans le corps de la réponse. ### Syntaxe ``` 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" } ``` ### 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](api-common-response-headers.md). ### Corps de la réponse Le corps de la réponse contient les champs JSON suivants. **Stratégie** Stratégie de verrouillage de coffre sous la forme une chaîne JSON, qui utilise « \$1 » comme caractère d'échappement. Type : Chaîne **État** État du verrouillage du coffre. Type : Chaîne Valeurs valides : `InProgress``|Locked` **ExpirationDate** Date et heure UTC auxquelles l'ID de verrouillage expire. Cette valeur peut être `null`si le verrouillage de coffre se trouve dans un état `Locked`. *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **CreationDate** Date et heure UTC auxquelles le verrouillage de coffre est passé à l'état `InProgress`t. *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. ### Erreurs Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md). ## Exemples L'exemple suivant montre comment obtenir une stratégie de verrouillage de coffre. ### Exemple de requête Dans cet exemple, une demande `GET` est envoyée à l'URI de la sous-ressource `lock-policy` d'un coffre. ``` 1. GET /-/vaults/examplevault/lock-policy HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` ### Exemple de réponse Si la demande aboutit, Amazon Glacier renvoie la politique d'accès au coffre-fort sous forme de chaîne JSON dans le corps de la réponse. La chaîne JSON renvoyée utilise « \$1 » comme caractère d'échappement, comme illustré dans l'exemple de demande [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md). Toutefois, l'exemple suivant montre la chaîne JSON retournée sans caractères d'échappement pour faciliter la lecture. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: length 6. 7. { 8. "Policy": " 9. { 10. "Version": "2012-10-17", 11. "Statement": [ 12. { 13. "Sid": "Define-vault-lock", 14. "Principal": { 15. "AWS": "arn:aws:iam::999999999999:root" 16. }, 17. "Effect": "Deny", 18. "Action": "glacier:DeleteArchive", 19. "Resource": [ 20. "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault" 21. ], 22. "Condition": { 23. "NumericLessThanEquals": { 24. "glacier:ArchiveAgeInDays": "365" 25. } 26. } 27. } 28. ] 29. } 30. ", 31. "State": "InProgress", 32. "ExpirationDate": "exampledate", 33. "CreationDate": "exampledate" 34. } ``` ## Sections connexes + [Interruption du verrouillage du coffre (DELETE lock-policy)](api-AbortVaultLock.md) + [Achèvement du verrouillage du coffre (POST lockId)](api-CompleteVaultLock.md) + [Lancement de verrouillage de coffre (POST lock-policy)](api-InitiateVaultLock.md) ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit : + [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-lock.html)