**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. # Description de coffre (GET vault) ## Description Cette opération renvoie des informations sur un coffre, y compris son Amazon Resource Name (ARN), sa date de création, le nombre d'archives qu'il contient et la taille totale de toutes ces archives. Le nombre d'archives et leur taille totale sont ceux du dernier inventaire de coffres-forts généré par Amazon Glacier (Amazon Glacier) (voir[Utilisation des coffres-forts dans Amazon Glacier](working-with-vaults.md)). Amazon Glacier génère des inventaires de coffres-forts environ tous les jours. Cela signifie que si vous ajoutez ou retirez une archive dans un coffre et que vous envoyez immédiatement une demande de description de coffre, la réponse peut ne pas refléter les modifications. ## Requêtes Pour obtenir des informations sur un coffre, envoyez une demande `GET` à l'URI de la ressource de coffre spécifique. ### Syntaxe ``` 1. GET /AccountId/vaults/VaultName 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 ### Syntaxe ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "CreationDate" : String, "LastInventoryDate" : String, "NumberOfArchives" : Number, "SizeInBytes" : Number, "VaultARN" : String, "VaultName" : 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. **CreationDate** Date UTC à laquelle le coffre a été créé. *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **LastInventoryDate** Date UTC à laquelle Amazon Glacier a terminé le dernier inventaire du coffre. Pour plus d'informations sur le lancement d'un inventaire pour un coffre, consultez la section [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md). *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **NumberOfArchives** Nombre d'archives présentes dans le coffre en fonction du dernier inventaire du coffre. Ce champ renvoie une valeur null si un inventaire n'a pas encore été exécuté sur le coffre, par exemple, si celui-ci vient d'être créé. *Type* : nombre **SizeInBytes** Taille totale, exprimée en octets, des archives présentes dans le coffre, y compris l'éventuelle surcharge de chaque archive, à la date du dernier inventaire. Ce champ renvoie une valeur `null` si un inventaire n'a pas encore été exécuté sur le coffre, par exemple, si celui-ci vient d'être créé. *Type* : nombre **VaultARN** Amazon Resource Name (ARN) du coffre. *Type* : chaîne **VaultName** Nom de coffre qui a été spécifié au moment de la création. Le nom de coffre est également inclus dans l'ARN du coffre. *Type* : chaîne ### 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 ### Exemple de requête L'exemple suivant montre comment obtenir des informations concernant le coffre nommé `examplevault`. ``` GET /-/vaults/examplevault HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 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 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 260 6. 7. { 8. "CreationDate" : "2012-02-20T17:01:45.198Z", 9. "LastInventoryDate" : "2012-03-20T17:03:43.221Z", 10. "NumberOfArchives" : 192, 11. "SizeInBytes" : 78088912, 12. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 13. "VaultName" : "examplevault" 14. } ``` ## Sections connexes + [Création de coffre (PUT vault)](api-vault-put.md) + [Affichage des coffres (GET vaults)](api-vaults-get.md) + [Suppression de coffre (DELETE vault)](api-vault-delete.md) + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management pour Amazon Glacier](security-iam.md) ## consultez 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/describe-vault.html)