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.
Lancement de chargement partitionné (POST multipart-uploads)
Description
Cette opération lance un chargement partitionné (consultez Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)). Amazon Glacier (Amazon Glacier) crée une ressource de téléchargement en plusieurs parties et renvoie son identifiant dans la réponse. Vous utilisez cet ID de chargement dans les opérations de chargement partitionné suivantes.
Lorsque vous lancez un chargement partitionné, vous spécifiez la taille de la partie en indiquant le nombre d'octets correspondant. La taille de la partie doit être exprimée en mébioctet (Mio) (1 024 kibioctets [Kio]) multiplié par une puissance de 2 (par exemple, 1 048 576 (1 Mio), 2 097 152 (2 Mio), 4 194 304 (4 Mio), 8 388 608 (8 Mio), et ainsi de suite). La taille minimale autorisée pour les parties est de 1 Mio et la taille maximale est de 4 gibioctets (Gio).
Chacune des parties que vous chargez à l'aide de cet ID de chargement, à l'exception de la dernière, doit être de taille identique. La dernière partie peut être de taille identique ou plus petite. Par exemple, supposez que vous souhaitez charger un fichier de 16,2 Mio. Si vous lancez le chargement partitionné avec une taille de partie de 4 Mio, vous allez charger quatre parties de 4 Mio chacune et une partie de 0,2 Mio.
Note
Vous n'avez pas besoin de connaître la taille de l'archive lorsque vous lancez un téléchargement partitionné, car Amazon Glacier ne vous oblige pas à spécifier la taille globale de l'archive.
Une fois le téléchargement partitionné terminé, Amazon Glacier supprime la ressource de téléchargement partitionné référencée par l'ID. Amazon Glacier supprimera également la ressource de téléchargement partitionné si vous annulez le téléchargement partitionné ou elle peut être supprimée s'il n'y a aucune activité pendant une période de 24 heures. Il se peut que l'ID soit toujours disponible après 24 heures, mais ce n'est pas le comportement auquel les applications doivent s'attendre.
Requêtes
Pour lancer un chargement partitionné, vous envoyez une demande HTTP POST à l'URI de la sous-ressource multipart-uploads du coffre dans lequel vous souhaitez enregistrer l'archive. La demande doit inclure la taille de la partie et peut éventuellement comporter une description de l'archive.
Syntaxe
POST /AccountId/vaults/VaultName/multipart-uploads Host: glacier.us-west-2.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-amz-part-size:PartSize
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-part-size
|
Taille de chaque partie, à l'exception de la dernière, exprimée en octets. La taille de la dernière partie peut être inférieure à celle de cette partie. Type : String Par défaut : aucun Contraintes : la taille de la partie doit être exprimée en mébioctet (1 024 Kio) multiplié par une puissance de 2 (par exemple, 1 048 576 (1 Mio), 2 097 152 (2 Mio), 4 194 304 (4 Mio), 8 388 608 (8 Mio), et ainsi de suite). La taille minimale autorisée pour les parties est de 1 Mio et la taille maximale est de 4 Gio (4 096 Mio). |
Oui |
x-amz-archive-description
|
Description de l'archive que vous chargez en plusieurs parties. Il peut s'agir d'une description rédigée dans un style simple ou d'un identifiant unique que vous choisissez d'attribuer. 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. Les espaces de début présents dans les descriptions d'archive sont retirés. Type : String Par défaut : aucun Contraintes : la description doit être inférieure ou égale à 1 024 octets. Les caractères autorisés sont des caractères ASCII 7 bits sans code de contrôle, plus spécifiquement les valeurs ASCII décimales 32 à 126 ou hexadécimales 0x20 à 0x7E. |
Non |
Corps de la requête
Cette opération n'a pas de corps de demande.
Réponses
Dans la réponse, Amazon Glacier crée une ressource de téléchargement partitionné identifiée par un ID et renvoie le chemin URI relatif de l'ID de téléchargement partitionné.
Syntaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-multipart-upload-id: multiPartUploadId
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
|
Le chemin d'URI relatif de l'ID de téléchargement en plusieurs parties créé par Amazon Glacier. Vous utilisez ce chemin d'accès par URI pour définir la portée de vos demandes de chargement de parties et pour terminer le chargement partitionné. Type : String |
x-amz-multipart-upload-id
|
ID du chargement partitionné. Cette valeur fait également partie de l'en-tête 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.
Exemple
Exemple de requête
L'exemple suivant lance un chargement partitionné en envoyant une demande HTTP POST à l'URI de la sous-ressource multipart-uploads d'un coffre nommé examplevault. La demande comprend des en-têtes pour spécifier une taille de partie de 4 Mio (4 194 304 octets) une description facultative de l'archive.
POST /-/vaults/examplevault/multipart-uploads Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-archive-description: MyArchive-101 x-amz-part-size: 4194304 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
Amazon Glacier crée une ressource de téléchargement en plusieurs parties et l'ajoute à la multipart-uploads sous-ressource du coffre-fort. L'en-tête de réponse Location inclut le chemin d'accès par URI relatif à l'ID de chargement partitionné.
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/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
Pour plus d'informations sur le chargement de plusieurs parties, consultez la section Partie chargement (PUT uploadID).
Sections connexes
