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.
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 S3 Glacier (S3 Glacier) crée une ressource de chargement partitionné et renvoie son ID 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 chargement partitionné, car S3 Glacier ne vous demande pas de spécifier la taille globale de l'archive.
À l'issue du chargement partitionné, S3 Glacier supprime la ressource de chargement partitionné référencée par l'ID. S3 Glacier supprime également la ressource de chargement partitionné si vous annulez le chargement partitionné ; elle peut aussi être supprimée en l'absence d'activité sur 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 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 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.
| Name (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 : chaîne 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 Initier une tâche (POSToffres d'emploi)), 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 : chaîne 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, S3 Glacier crée une ressource de chargement partitionné identifiée par un ID et renvoie le chemin d'URI relatif de l'ID de 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.
| Name (Nom) | Description |
|---|---|
Location
|
Chemin d'URI relatif de l'ID de chargement partitionné créé par S3 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 : chaîne |
x-amz-multipart-upload-id
|
ID du chargement partitionné. Cette valeur fait également partie de l'en-tête 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.
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
S3 Glacier crée une ressource de chargement partitionné et l'ajoute à la sous-ressource multipart-uploads du coffre. 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
