Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API 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 d'arborescence SHA256 des données que vous chargez. Pour plus d'informations sur le calcul d'un hachage d'arborescence SHA256, consultez la section Calcul des totaux de contrôle.
Note
Le hachage d'arborescence SHA256 est nécessaire uniquement pour l'action de chargement d'archive (POST archive) lorsque l'API est utilisée. Il n'est pas nécessaire lorsque l'interface AWS CLI est utilisée.
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 valeur de total de contrôle (hachage d'arborescence SHA256) et éventuellement 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 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 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, consultez le document 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 Initier une tâche (POSToffres d'emploi)), l'inventaire inclut cette description pour chacune des archives renvoyées dans la réponse. Type : chaîne 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
|
Total de contrôle SHA256 (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 : chaîne Par défaut : aucun Contraintes: Aucune |
Oui |
x-amz-sha256-tree-hash
|
Total de contrôle calculé par l'utilisateur, hachage d'arborescence SHA256, de la charge utile. Pour plus d'informations sur le calcul du hachage d'arborescence SHA256, consultez la section Calcul 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 : chaîne 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 : chaîne |
x-amz-archive-id
|
ID de l'archive. Cette valeur fait également partie de l'en-tête Type : chaîne |
x-amz-sha256-tree-hash |
Total de contrôle de l'archive calculé par S3 Glacier. Type : chaîne |
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
