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.
Achèvement du chargement partitionné (POST uploadID)
Description
Vous appelez cette opération de téléchargement en plusieurs parties pour informer Amazon Glacier (Amazon Glacier) que toutes les parties de l'archive ont été chargées et qu'Amazon Glacier peut désormais assembler l'archive à partir des parties chargées.
Pour plus d'informations sur le chargement partitionné, consultez Chargement d'archives volumineuses en plusieurs parties (chargement partitionné).
Après avoir assemblé et enregistré l'archive dans le coffre, Amazon Glacier renvoie l'ID d'archive de la ressource d'archive nouvellement créée. Une fois que vous avez chargé une archive, vous devez enregistrer l'ID de l'archive renvoyé pour extraire l'archive ultérieurement.
Dans la demande, vous devez inclure le hachage SHA256 arborescent calculé de l'ensemble de l'archive que vous avez chargée. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultezCalcul des totaux de contrôle. Côté serveur, Amazon Glacier construit également le hachage SHA256 arborescent de l'archive assemblée. Si les valeurs correspondent, Amazon Glacier enregistre l'archive dans le coffre ; dans le cas contraire, une erreur est renvoyée et l'opération échoue. L'opération Répertorier les parties (GET uploadID) renvoie la liste des parties chargées pour un chargement partitionné spécifique. Cette liste comporte les informations de total de contrôle pour chaque partie chargée, lesquelles peuvent être utilisées pour déboguer un problème de total de contrôle incorrect.
En outre, Amazon Glacier vérifie également la présence de plages de contenu manquantes. Lors du chargement des parties, vous spécifiez les valeurs de plage qui identifient l'emplacement auquel se trouve chaque partie dans l'assemblage final de l'archive. Lors de l'assemblage de l'archive finale, Amazon Glacier vérifie la présence de plages de contenu manquantes. Si des plages de contenu sont manquantes, Amazon Glacier renvoie un message d'erreur et l'opération de téléchargement partitionné complet échoue.
L'opération d'achèvement du chargement partitionné est idempotente. Une fois que vous avez effectué correctement le chargement partitionné, si vous appelez à nouveau l'opération dans un court délai, celle-ci aboutit et renvoie le même ID d'archive. Cela est très utile si vous rencontrez un problème réseau ou si vous recevez une erreur serveur 500, auquel cas vous pouvez répéter votre demande d'achèvement du chargement partitionné et obtenir le même ID d'archive sans créer d'archives en double. Notez toutefois qu'une fois le chargement partitionné terminé, vous ne pouvez pas appeler l'opération d'affichage de la liste des parties et que le chargement partitionné n'apparaîtra pas dans la réponse d'affichage de la liste des chargements partitionnés même si une opération idempotente est possible.
Requêtes
Pour terminer un téléchargement partitionné, vous envoyez une requête HTTP POST à l'URI de l'ID de téléchargement créé par Amazon Glacier en réponse à votre demande d'initiation de téléchargement partitionné. Il s'agit de l'URI que vous avez utilisé lors du chargement des parties. Outre les en-têtes obligatoires courants, vous devez inclure le résultat du hachage SHA256 arborescent de l'ensemble de l'archive et la taille totale de l'archive en octets.
Syntaxe
POST /AccountId/vaults/VaultName/multipart-uploads/uploadIDHost: glacier.Region.amazonaws.com Date:dateAuthorization:SignatureValuex-amz-sha256-tree-hash:SHA256 tree hash of the archivex-amz-archive-size:ArchiveSize in bytesx-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 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 |
|---|---|---|
x-amz-archive-size
|
Taille totale, en octets, de la totalité de l'archive. Cette valeur doit être la somme de toutes les tailles des différentes parties que vous avez chargées. Type : String Par défaut : aucun Contraintes: Aucune |
Oui |
x-amz-sha256-tree-hash
|
Le hachage SHA256 arborescent de l'ensemble de l'archive. Il s'agit du hachage SHA256 arborescent des différentes parties. Si la valeur que vous spécifiez dans la demande ne correspond pas au hachage SHA256 arborescent de l'archive assemblée finale tel que calculé par Amazon Glacier, Amazon Glacier renvoie une erreur et la demande échoue. Type : String Par défaut : aucun Contraintes: Aucune |
Oui |
Elements de la demande
Cette opération n'utilise pas les éléments de la demande.
Réponses
Amazon Glacier (Amazon Glacier) crée un hachage SHA256 arborescent de l'intégralité de l'archive. Si la valeur correspond au hachage SHA256 arborescent de l'intégralité de l'archive que vous avez spécifiée dans la demande, Amazon Glacier ajoute l'archive au coffre-fort. En réponse, il renvoie l'en-tête HTTP Location avec le chemin d'accès de l'URL de la ressource d'archivage nouvellement ajoutée. Si la taille de l'archive ou SHA256 celle que vous avez envoyée dans la demande ne correspond pas, Amazon Glacier renvoie un message d'erreur et le chargement reste incomplet. Il est possible de renouveler ultérieurement l'opération d'achèvement du chargement partitionné avec les valeurs correctes pour créer correctement une archive. Si un chargement en plusieurs parties n'aboutit pas, Amazon Glacier finira par récupérer l'ID de téléchargement.
Syntaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date 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 URI relatif de l'archive nouvellement créée. Cette URL inclut l'ID d'archive généré par Amazon Glacier. Type : String |
x-amz-archive-id
|
ID de l'archive. Cette valeur fait également partie de l'en-tête Type : String |
Champs de réponse
Cette opération ne renvoie pas de corps de réponse.
Exemple
Exemple de requête
Dans cet exemple, une demande HTTP POST est envoyée à l'URI qui a été renvoyé par une demande de lancement du chargement partitionné. La demande indique à la fois le hachage SHA256 arborescent de l'archive entière et la taille totale de l'archive.
POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 Host: glacier.us-west-2.amazonaws.com z-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0 x-amz-archive-size:8388608 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
L'exemple de réponse suivant montre qu'Amazon Glacier a créé avec succès une archive à partir des éléments que vous avez chargés. La réponse inclut l'ID de l'archive avec le chemin d'accès complet.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
Vous pouvez maintenant envoyer des demandes HTTP à l'URI de la ressource/archive nouvellement ajoutée. Par exemple, vous pouvez envoyer une demande GET pour extraire l'archive.
Sections connexes
