Description de coffre (GET vault) - Amazon S3 Glacier
DescriptionRequêtesRéponsesExemplesSections connexesVoir aussi

Si vous débutez dans le stockage d'archives dans Amazon Simple Storage Service (Amazon S3), nous vous recommandons dans un premier temps de vous familiariser avec les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour plus d'informations, consultez les sections Classes de stockage S3 Glacier et Classes de stockage pour l'archivage d'objets dans le guide de l'utilisateur 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 à la date du dernier inventaire de coffre généré par Amazon S3 Glacier (S3 Glacier) (consultez Utilisation des coffres dans Amazon S3 Glacier). S3 Glacier génère des inventaires de coffre pratiquement 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

GET /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

Note

La valeur de AccountId est l'ID de Compte AWS du compte propriétaire du coffre. 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 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.

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.

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 S3 Glacier a effectué 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).

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

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 260

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

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 :