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
Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'acceptera plus de nouveaux clients à compter du 15 décembre 2025, sans aucune incidence sur les clients existants. 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
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.
Chargement d'archive (POST archive)
Description
Cette opération ajoute une archive à un coffre. Pour qu'un chargement aboutisse, vos données sont conservées durablement. En réponse, Amazon Glacier (Amazon Glacier) renvoie l'ID d'archive dans l'x-amz-archive-iden-tête de la réponse. Vous devez enregistrer l'ID d'archive ainsi renvoyé afin de l'utiliser pour accéder ultérieurement à l'archive.
Vous devez fournir un hachage SHA256 arborescent des données que vous téléchargez. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultezCalcul des totaux de contrôle.
Note
Le hachage de l' SHA256 arbre n'est requis que pour l'action Upload Archive (archive POST) lors de l'utilisation de l'API. Cela n'est pas obligatoire lors de l'utilisation du AWS CLI.
Lorsque vous chargez une archive, vous avez la possibilité de décrire l'archive dans les limites de 1 024 caractères ASCII imprimables. Amazon Glacier renvoie la description de l'archive lorsque vous récupérez l'archive ou que vous obtenez l'inventaire du coffre-fort. Amazon Glacier n'interprète en aucune façon la description. Une description d'archive ne doit pas nécessairement être unique. Vous ne pouvez pas utiliser la description pour extraire ou trier la liste d'archives.
À l'exception de la description facultative de l'archive, Amazon Glacier ne prend en charge aucune métadonnée supplémentaire pour les archives. L'ID d'archive est une séquence de caractères opaque qui ne permet de déduire aucune information concernant l'archive. Par conséquent, vous pouvez conserver les métadonnées sur les archives côté client. Pour de plus amples informations, veuillez consulter Utilisation des archives dans Amazon Glacier.
Les archives sont immuables. Une fois que vous avez chargé une archive, vous ne pouvez pas modifier son contenu ni sa description.
Requêtes
Pour charger une archive, utilisez la méthode HTTP POST et limitez la portée de la demande à la sous-ressource archives du coffre dans lequel vous souhaitez enregistrer l'archive. La demande doit inclure la taille de la charge utile de l'archive, la somme de contrôle (hachage de l'SHA256 arbre) et peut éventuellement inclure une description de l'archive.
Syntaxe
POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
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 implémentation de l'opération n'utilise pas de paramètres de demande.
En-têtes de demande
Cette opération utilise les en-têtes de demande suivants, en plus de ceux communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez En-têtes de demande communs.
| Nom | Description | Obligatoire |
|---|---|---|
Content-Length
|
Taille de l'objet, exprimée en octets. Pour plus d'informations, rendez-vous sur http://www.w3. org/Protocols/rfc2616/rfc2616-sec14.html #sec14 .13. Type : nombre Par défaut : aucun Contraintes: Aucune |
Oui |
x-amz-archive-description
|
Description facultative de l'archive que vous chargez. Il peut s'agir d'une description rédigée dans un style simple ou d'un identifiant que vous choisissez d'attribuer. La description ne doit pas nécessairement être unique d'une archive à l'autre. Lorsque vous procédez à l'extraction d'un inventaire de coffre (consultez la section Lancement d'une tâche (POST jobs)), l'inventaire inclut cette description pour chacune des archives renvoyées dans la réponse. Type : String Par défaut : aucun Contraintes : la description doit être inférieure ou égale à 1 024 caractères. Les caractères autorisés sont les caractères ASCII 7 bits sans code de contrôle, plus précisément les valeurs ASCII décimales 32-126 ou hexadécimales 0x20-0x7E. |
Non |
x-amz-content-sha256
|
La SHA256 somme de contrôle (un hachage linéaire) de la charge utile. Il ne s'agit pas de la valeur que vous spécifiez dans l'en-tête Type : String Par défaut : aucun Contraintes: Aucune |
Oui |
x-amz-sha256-tree-hash
|
Somme de contrôle calculée par l'utilisateur, hachage de SHA256 l'arbre, de la charge utile. Pour plus d'informations sur le calcul du hachage de l' SHA256 arbre, consultezCalcul des totaux de contrôle. Si Amazon Glacier calcule une somme de contrôle différente de la charge utile, il rejettera la demande. Type : String Par défaut : aucun Contraintes: Aucune |
Oui |
Corps de la requête
Le corps de la demande contient les données à charger.
Réponses
En réponse, Amazon Glacier stocke l'archive de manière durable et renvoie un chemin URI vers l'ID de l'archive.
Syntaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId
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.
| Nom | Description |
|---|---|
Location
|
Chemin d'accès par URI relatif de la ressource d'archive nouvellement ajoutée. Type : String |
x-amz-archive-id
|
ID de l'archive. Cette valeur fait également partie de l'en-tête Type : String |
x-amz-sha256-tree-hash |
Somme de contrôle de l'archive calculée par Amazon Glacier. Type : String |
Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
Erreurs
Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultezRéponses d’erreur.
Exemples
Exemple de requête
L'exemple suivant illustre une demande de chargement d'une archive.
POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>
Exemple de réponse
La réponse positive ci-dessous comporte un Location en-tête dans lequel vous pouvez obtenir l'identifiant attribué par Amazon Glacier à l'archive.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
Sections connexes
