Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant 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
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 S3 Glacier (S3 Glacier) renvoie l'ID d'archive dans l'en-tête x-amz-archive-id 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. S3 Glacier renvoie la description de l'archive lorsque vous extrayez l'archive ou obtenez l'inventaire du coffre. S3 Glacier n'interprète en aucune manière 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.
En dehors de la description facultative de l'archive, S3 Glacier ne prend pas en charge d'autres métadonnées 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 S3 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 S3 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.
| Name (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 S3 Glacier calcule un total de contrôle différent pour la charge utile, la demande est rejetée. 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, S3 Glacier stocke durablement l'archive et renvoie le chemin d'URI de l'ID d'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.
| Name (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 |
Total de contrôle de l'archive calculé par S3 Glacier. Type : String |
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 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 illustrée ci-dessous comporte un en-tête Location indiquant l'ID attribué à l'archive par S3 Glacier.
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
