**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](https://aws.amazon.com/s3/storage-classes/glacier/).
Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. 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](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).
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.
# Opérations de chargement partitionné
Les opérations de téléchargement partitionné disponibles dans Amazon Glacier sont les suivantes.
**Topics**
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
# Annulation de chargement partitionné (DELETE uploadID)
## Description
Cette commande arrête le chargement partitionné identifié par l'ID de chargement.
Une fois que la demande d'annulation de chargement partitionné a abouti, vous ne pouvez pas utiliser l'ID de chargement pour charger d'autres parties ou effectuer d'autres opérations. L'arrêt d'un chargement partitionné terminé échoue. En revanche, l'arrêt d'un chargement qui a déjà été arrêté aboutit pour un temps limité.
Cette opération est idempotente.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
## Requêtes
Pour arrêter un chargement partitionné, envoyez une demande HTTP `DELETE` à l'URI de la sous-ressource `multipart-uploads` du coffre et identifiez l'ID de chargement partitionné spécifique dans l'URI.
### Syntaxe
```
1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-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 uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [En-têtes de demande communs](api-common-request-headers.md).
### Corps de la requête
Cette opération n'a pas de corps de demande.
## Réponses
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### En-têtes de réponse
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [En-têtes de réponse communs](api-common-response-headers.md).
### 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, consultez[Réponses d’erreur](api-error-responses.md).
## Exemple
### Exemple de requête
Dans l'exemple suivant, une demande `DELETE` est envoyée à l'URI d'une ressource d'ID de chargement partitionné.
```
1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# 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é)](uploading-archive-mpu.md).
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, consultez[Calcul des totaux de contrôle](checksum-calculations.md). 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)](api-multipart-list-parts.md) 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
```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. x-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](api-common-request-headers.md).
| 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](api-common-response-headers.md).
| 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 `Location`. 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.
```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
6. x-amz-glacier-version: 2012-06-01
7. 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.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. 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
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Suppression d'une archive (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# 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é)](uploading-archive-mpu.md)). 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
```
1. POST /AccountId/vaults/VaultName/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-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](api-common-request-headers.md).
| 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 [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)), 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, 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
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. 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](api-common-response-headers.md).
| 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 : Chaîne |
| x-amz-multipart-upload-id | ID du chargement partitionné. Cette valeur fait également partie de l'en-tête `Location`. Type : Chaîne |
### 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, consultez[Réponses d’erreur](api-error-responses.md).
## 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.
```
1. POST /-/vaults/examplevault/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. 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é.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. 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)](api-upload-part.md).
## Sections connexes
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Suppression d'une archive (DELETE archive)](api-archive-delete.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Répertorier les parties (GET uploadID)
## Description
Cette opération de chargement partitionné répertorie les parties d'une archive qui ont été chargées dans le cadre d'un chargement partitionné spécifique identifié par un ID de chargement. Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
Vous pouvez faire cette demande à tout moment au cours d'un chargement partitionné en cours avant d'avoir terminé le chargement partitionné. Amazon Glacier retourne la liste des parties triée en fonction de la plage que vous avez spécifiée dans chaque chargement de partie. Si vous envoyez une demande List Parts après avoir effectué le téléchargement en plusieurs parties, Amazon Glacier (Amazon Glacier) renvoie un message d'erreur.
L'opération de création d'une liste des parties prend en charge la pagination. Vous devez toujours vérifier le champ `Marker` dans le corps de la réponse pour repérer un marqueur à partir duquel poursuivre l'affichage de la liste. S'il n'y a aucun autre élément, le champ `marker` est `null`. Si `marker` ce n'est pas nul, pour récupérer le prochain ensemble de pièces, vous avez envoyé une autre demande List Parts avec le paramètre de `marker` demande défini sur la valeur de marqueur renvoyée par Amazon Glacier en réponse à votre précédente demande List Parts.
Vous pouvez également limiter le nombre de parties renvoyées dans la réponse en spécifiant le paramètre `limit` dans la demande.
## Requêtes
### Syntaxe
Pour afficher les parties d'un chargement partitionné en cours, vous envoyez une demande `GET` à l'URI de la ressource de l'ID de chargement partitionné. L'ID de chargement partitionné est retourné lorsque vous lancez un chargement partitionné ([Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)). Vous pouvez éventuellement spécifier les paramètres `marker` et `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-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
| Nom | Description | Obligatoire |
| --- | --- | --- |
| limit | Le nombre maximum de parties à renvoyer. La limite par défaut est de 50. Il peut arriver que le nombre de parties renvoyées soit inférieur à la limite spécifiée, mais il ne sera jamais supérieur à cette valeur. Type : Chaîne Contraintes : la valeur d'entier minimale est `1`. La valeur d'entier maximale est `50`. | Non |
| marker | Chaîne opaque utilisée pour la pagination. `marker` spécifie la partie à partir de laquelle la liste des parties doit commencer. Obtenez la valeur `marker` dans une réponse précédente concernant l'établissement d'une liste des parties. Vous devez simplement inclure la valeur du paramètre `marker` si vous poursuivez la pagination de résultats commencée dans une demande précédente d'affichage de la liste des parties. Type : Chaîne Contraintes: Aucune | Non |
### En-têtes de demande
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [En-têtes de réponse communs](api-common-response-headers.md).
### Corps de la requête
Cette opération n'a pas de corps de demande.
## Réponses
### Syntaxe
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "ArchiveDescription" : String,
9. "CreationDate" : String,
10. "Marker": String,
11. "MultipartUploadId" : String,
12. "PartSizeInBytes" : Number,
13. "Parts" :
14. [ {
15. "RangeInBytes" : String,
16. "SHA256TreeHash" : String
17. },
18. ...
19. ],
20. "VaultARN" : String
21. }
```
### En-têtes de réponse
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [En-têtes de réponse communs](api-common-response-headers.md).
### Corps de la réponse
Le corps de la réponse contient les champs JSON suivants.
**ArchiveDescription**
La description de l'archive qui a été spécifiée dans la demande de lancement des chargements partitionnés. Ce champ est `null` si aucune description d'archive n'a été spécifiée dans l'opération de lancement des chargements partitionnés.
*Type* : chaîne
**CreationDate**
L'heure UTC à laquelle le chargement partitionné a été lancé.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**Marker**
Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats. Vous utilisez le `marker` dans une nouvelle demande d'affichage des parties afin d'obtenir davantage de tâches dans la liste. S'il n'y a pas d'autres parties, cette valeur est `null`.
*Type* : chaîne
**MultipartUploadId**
L'ID du chargement auquel les parties sont associées.
*Type* : chaîne
**PartSizeInBytes**
La taille de la partie en octets. Il s'agit de la même valeur que celle qui a été spécifiée dans la demande de lancement d'une demande de chargement partitionné.
*Type* : nombre
**Parties**
Une liste des tailles des parties pour le chargement partitionné. Chaque objet du tableau contient une paire nom/valeur `RangeBytes` et `sha256-tree-hash`.
*Type* : tableau
**RangeInBytes**
La plage d'octets d'une partie, y compris la valeur supérieure de la plage.
*Type* : chaîne
**SHA256TreeHash**
Valeur de hachage de l' SHA256 arbre calculée par Amazon Glacier pour la pièce. Ce champ n'est jamais `null`.
*Type* : chaîne
**VaultARN**
L'Amazon Resource Name (ARN) du coffre pour lequel le chargement partitionné a été lancé.
*Type* : chaîne
### Erreurs
Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).
## Exemples
### Exemple : Liste différentes parties d'un chargement partitionné
L'exemple suivant répertorie toutes les parties d'un chargement. L'exemple envoie une demande `GET` HTTP à l'URI de l'ID de chargement partitionné d'un chargement partitionné en cours et retourne jusqu'à 1 000 parties.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
Dans la réponse, Amazon Glacier renvoie une liste des pièces téléchargées associées à l'ID de téléchargement en plusieurs parties spécifié. Cet exemple contient deux parties seulement. Le champ `Marker` retourné est `null`, ce qui indique qu'il n'y a plus aucune partie pour le chargement partitionné.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": null,
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "0-4194303",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. },
18. {
19. "RangeInBytes" : "4194304-8388607",
20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
21. }],
22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
23. }
```
### Exemple : Répertorier les parties d'un chargement partitionné (indiquer le marqueur et les paramètres de limite de la demande)
L'exemple suivant illustre l'utilisation de la pagination pour obtenir un nombre limité de résultats. L'exemple envoie une demande `GET` HTTP à l'URI de l'ID de chargement partitionné d'un chargement partitionné en cours pour retourner une partie. Un paramètres `marker` de départ spécifie à partir de quelle partie la liste doit commencer. Vous pouvez obtenir la valeur `marker` dans la réponse d'une demande précédente de liste de parties. En outre, dans cet exemple, le paramètre `limit`est défini sur 1 et retourne une partie. Notez que le champ `Marker` n'est pas `null`, ce qui indique qu'il reste encore au moins une partie à obtenir.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
Dans la réponse, Amazon Glacier renvoie une liste des pièces chargées associées à l'ID de téléchargement partitionné en cours spécifié.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: text/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description 1",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "4194304-8388607",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. }],
18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
19. }
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Afficher la liste des chargements partitionnés (GET multipart-uploads)
## Description
Cette opération de chargement partitionné affiche la liste des chargements partitionnés en cours pour le coffre spécifié. Un chargement partitionné en cours est un chargement partitionné qui a été lancé par une demande [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md), mais qui n'a pas encore été terminé ou arrêté. La liste renvoyée dans la réponse de chargement partitionné n'a aucun ordre garanti.
L'opération d'affichage de la liste des chargements partitionnés prend en charge la pagination. Par défaut, cette opération renvoie jusqu'à 50 chargements partitionnés dans la réponse. Vous devez toujours vérifier le champ `marker` dans le corps de la réponse pour repérer un marqueur à partir duquel poursuivre l'affichage de la liste. S'il n'y a aucun autre élément, le champ `marker` est `null`.
Si ce n'`marker`est pas nul, pour récupérer le prochain ensemble de téléchargements partitionnés, vous avez envoyé une autre demande List Multipart Uploads avec le paramètre de requête défini sur la valeur de marqueur qu'Amazon Glacier (Amazon Glacier) a renvoyée en réponse à votre précédente `marker` demande List Multipart Uploads.
Notez la différence entre cette opération et l'opération [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)). L'opération d'affichage des chargements partitionnés affiche la liste de tous les chargements partitionnés pour un coffre. L'opération d'affichage de la liste des parties renvoie les parties d'un chargement partitionné spécifique identifié par un ID de chargement.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
## Requêtes
### Syntaxe
Pour afficher la liste des chargements partitionnés, envoyez une demande `GET` à l'URI de la sous-ressource `multipart-uploads` du coffre. Vous pouvez éventuellement spécifier les paramètres `marker` et `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-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
| Nom | Description | Obligatoire |
| --- | --- | --- |
| limit | Spécifie le nombre maximal de chargements renvoyés dans le corps de la réponse. Si ce paramètre n'est pas spécifié, l'opération d'affichage de la liste des chargements renvoie jusqu'à 50 chargements. Type : Chaîne Contraintes : la valeur d'entier minimale est `1`. La valeur d'entier maximale est `50`. | Non |
| marker | Chaîne opaque utilisée pour la pagination. `marker` spécifie le chargement auquel doit commencer la liste des chargements. Obtenez la valeur du paramètre `marker` à partir d'une réponse précédente d'affichage de la liste des chargements. Il suffit d'inclure la valeur du paramètre `marker` si vous poursuivez la pagination de résultats commencée dans une demande précédente d'affichage de la liste des chargements. Type : Chaîne Contraintes: Aucune | Non |
### En-têtes de demande
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [En-têtes de réponse communs](api-common-response-headers.md).
### Corps de la requête
Cette opération n'a pas de corps de demande.
## Réponses
### Syntaxe
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Content-Type: application/json
5. Content-Length: Length
6.
7. {
8. "Marker": String,
9. "UploadsList" : [
10. {
11. "ArchiveDescription": String,
12. "CreationDate": String,
13. "MultipartUploadId": String,
14. "PartSizeInBytes": Number,
15. "VaultARN": String
16. },
17. ...
18. ]
19. }
```
### En-têtes de réponse
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [En-têtes de réponse communs](api-common-response-headers.md).
### Corps de la réponse
Le corps de la réponse contient les champs JSON suivants.
**ArchiveDescription**
La description de l'archive qui a été spécifiée dans la demande de lancement des chargements partitionnés. Ce champ est `null` si aucune description d'archive n'a été spécifiée dans l'opération de lancement des chargements partitionnés.
*Type* : chaîne
**CreationDate**
L'heure UTC à laquelle le chargement partitionné a été lancé.
*Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`.
**Marker**
Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats. Vous utilisez le paramètre `marker` dans une nouvelle demande d'affichage de la liste des chargements partitionnés en vue d'obtenir davantage de chargements dans la liste. S'il n'y a pas d'autres chargements, cette valeur est `null`.
*Type* : chaîne
**PartSizeInBytes**
Taille de la partie spécifiée dans la demande [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md). Il s'agit de la taille de toutes les parties comprises dans le téléchargement excepté la dernière partie, dont la taille peut être inférieure à cette taille.
*Type* : nombre
**MultipartUploadId**
ID du chargement partitionné.
*Type* : chaîne
**UploadsList**
Liste des métadonnées relatives aux objets des chargements partitionnés. Chaque élément de la liste contient un ensemble de paires nom-valeur pour le chargement correspondant, notamment `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes` et `VaultARN`.
*Type* : tableau
**VaultARN**
Amazon Resource Name (ARN) du coffre qui contient l'archive.
*Type* : chaîne
### Erreurs
Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).
## Exemples
### Exemple : Affichage de la liste de tous les chargements partitionnés
L'exemple suivant affiche la liste de tous les chargements partitionnés en cours pour le coffre. L'exemple illustre une demande HTTP `GET` envoyée à l'URI de la sous-ressource `multipart-uploads` d'un coffre spécifié. Etant donné que les paramètres `marker` et `limit` ne sont pas spécifiés dans la demande, jusqu'à 1 000 chargements partitionnés en cours sont renvoyés.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
Dans la réponse, Amazon Glacier renvoie une liste de tous les téléchargements partitionnés en cours pour le coffre spécifié. Le champ `marker` est `null`, ce qui indique qu'il n'y a pas plus de chargements à afficher dans la liste.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 1054
6.
7. {
8. "Marker": null,
9. "UploadsList": [
10. {
11. "ArchiveDescription": "archive 1",
12. "CreationDate": "2012-03-19T23:20:59.130Z",
13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. },
17. {
18. "ArchiveDescription": "archive 2",
19. "CreationDate": "2012-04-01T15:00:00.000Z",
20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21. "PartSizeInBytes": 4194304,
22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23. },
24. {
25. "ArchiveDescription": "archive 3",
26. "CreationDate": "2012-03-20T17:03:43.221Z",
27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28. "PartSizeInBytes": 4194304,
29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30. }
31. ]
32. }
```
### Exemple : Liste partielle des chargements partitionnés
L'exemple suivant illustre l'utilisation de la pagination pour obtenir un nombre limité de résultats. L'exemple illustre une demande HTTP `GET` envoyée à l'URI de la sous-ressource `multipart-uploads` pour un coffre spécifié. Dans cet exemple, le paramètre `limit` est défini sur 1, ce qui signifie qu'un seul chargement est renvoyé dans la liste, et le paramètre `marker` indique l'ID de chargement partitionné auquel commence la liste renvoyée.
#### Exemple de requête
```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
Dans la réponse, Amazon Glacier (Amazon Glacier) renvoie une liste ne contenant pas plus de deux téléchargements partitionnés en cours pour le coffre spécifié, en commençant par le marqueur spécifié et en renvoyant deux résultats.
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: 470
6.
7. {
8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
9. "UploadsList" : [
10. {
11. "ArchiveDescription": "archive 2",
12. "CreationDate": "2012-04-01T15:00:00.000Z",
13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. }
17. ]
18. }
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](api-upload-part.md)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
# Partie chargement (PUT uploadID)
## Description
Cette opération de chargement partitionné permet de charger une partie d'une archive. Vous pouvez charger des parties de l'archive dans n'importe quel ordre car vous spécifiez la plage d'octets de l'archive assemblée qui sera chargée dans cette partie dans votre demande de chargement partiel. Vous pouvez également charger ces différentes parties en parallèle. Vous pouvez charger jusqu'à 10 000 parties pour un chargement partitionné.
Pour plus d'informations sur le chargement partitionné, consultez [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md).
Amazon Glacier (Amazon Glacier) rejette votre demande de partie chargée si l'une des conditions suivantes est remplie :
+ **SHA256 le hachage de l'arbre ne correspond pas :** pour vous assurer que les données de la pièce ne sont pas corrompues lors de la transmission, vous calculez un hachage SHA256 arborescent de la pièce et vous l'incluez dans votre demande. Dès réception des données de pièce, Amazon Glacier calcule également un hachage SHA256 arborescent. Si les deux valeurs de hachage ne correspondent pas, l'opération échoue. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultez[Calcul des totaux de contrôle](checksum-calculations.md).
+ **SHA256 le hachage linéaire ne correspond pas :** pour obtenir l'autorisation, vous calculez un hachage SHA256 linéaire de l'ensemble de la charge utile téléchargée et vous l'incluez dans votre demande. Pour plus d'informations sur le calcul d'un hachage SHA256 linéaire, consultez[Calcul des totaux de contrôle](checksum-calculations.md).
+ **La taille de la partie ne correspond pas – **La taille de chaque partie, à l'exception de la dernière, doit correspondre à la taille spécifiée dans la demande [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md) correspondante. La taille de la dernière partie doit être identique, ou inférieure, à la taille spécifiée.
**Note**
Si vous chargez une partie dont la taille est inférieure à la taille de la partie spécifiée dans votre première demande de chargement partitionné et si cette partie n'est pas la dernière, la demande de chargement de la partie est réussie. Toutefois, la demande suivante de chargement partitionné complet échouera.
+ **La plage ne correspond pas – **La valeur de la plage d'octets de la demande ne correspond pas à la taille de la partie spécifiée dans la demande de lancement correspondante. Par exemple, si vous spécifiez une taille de partie de 4 194 304 octets (4 Mo), les plages de parties comprises entre 0 et 4 194 303 octets (4 Mo - 1) et entre 4 194 304 (4 Mo) et 8 388 607 (8 Mo - 1) sont valides. Toutefois, si vous définissez une valeur de plage de 2 Mo à 6 Mo, la plage ne correspond pas à la taille de la partie et le chargement échouera.
Cette opération est idempotente. Si vous téléchargez la même partie plusieurs fois, les données figurant dans la demande plus récente remplace les données chargées précédemment.
## Requêtes
Vous envoyez cette demande `PUT` HTTP à l'URI de l'ID de chargement qui a été renvoyé par votre demande de lancement de chargement partitionné. Amazon Glacier utilise l'ID de téléchargement pour associer les chargements partiels à un chargement partitionné spécifique. La demande doit inclure un hachage SHA256 arborescent des données de pièce (`x-amz-SHA256-tree-hash`en-tête), un hachage SHA256 linéaire de l'ensemble de la charge utile (`x-amz-content-sha256`en-tête), la plage d'octets (`Content-Range`en-tête) et la longueur de la partie en octets (`Content-Length`en-tête).
### Syntaxe
```
1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Range: ContentRange
6. Content-Length: PayloadSize
7. Content-Type: application/octet-stream
8. x-amz-sha256-tree-hash: Checksum of the part
9. x-amz-content-sha256: Checksum of the entire payload
10. x-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](api-common-request-headers.md).
| Nom | Description | Obligatoire |
| --- | --- | --- |
| Content-Length | Identifie la longueur de la partie en octets. Type : String Par défaut : aucun Contraintes: Aucune | Non |
| Content-Range | Identifie la plage d'octets de l'archive assemblée qui sera chargée dans cette partie. Amazon Glacier utilise ces informations pour assembler l'archive dans le bon ordre. Le format de cet en-tête suit [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Voici un exemple d'en-tête : `Content-Range:bytes 0-4194303/*`. Type : String Par défaut : aucun Contraintes : la plage ne peut pas être supérieure à la taille de la partie que vous avez spécifiée lorsque vous avez lancé le chargement partitionné. | Oui |
| x-amz-content-sha256 | La SHA256 somme de contrôle (un hachage linéaire) de la charge utile téléchargée. Il ne s'agit pas de la valeur que vous spécifiez dans l'en-tête `x-amz-sha256-tree-hash`. Type : String Par défaut : aucun Contraintes: Aucune | Oui |
| x-amz-sha256-tree-hash | Spécifie un hachage SHA256 arborescent des données en cours de téléchargement. Pour plus d'informations sur le calcul d'un hachage SHA256 arborescent, consultez[Calcul des totaux de contrôle](checksum-calculations.md). 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
Une fois le chargement partiel réussi, Amazon Glacier renvoie une `204 No Content` réponse.
### Syntaxe
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```
### 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](api-common-response-headers.md).
| Nom | Description |
| --- | --- |
| x-amz-sha256-tree-hash | Le hachage de l' SHA256 arbre calculé par Amazon Glacier pour la partie chargée. Type : String |
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
## Exemple
La demande suivante charge une partie de 4 Mo. La demande définit la plage d'octets afin que ce soit la première partie de l'archive.
### Exemple de requête
L'exemple envoie une demande `PUT` HTTP pour charger une partie de 4 Mo. La demande est envoyée à l'URI de l'ID de chargement qui a été retournée par la demande de lancement du chargement partitionné. L'en-tête `Content-Range` identifie la partie en tant que première partie de 4 Mo de l'archive.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. 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
```
Pour télécharger la pièce suivante, la procédure est la même ; toutefois, vous devez calculer un nouveau hachage SHA256 arborescent de la pièce que vous chargez et également spécifier une nouvelle plage d'octets pour indiquer où la pièce sera placée dans l'assemblage final. La demande suivante charge une autre partie en utilisant le même ID de chargement. La demande spécifie les 4 Mo suivants de l'archive après la demande précédente et une taille de partie de 4 Mo.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
Les pièces peuvent être chargées dans n'importe quelle commande ; Amazon Glacier utilise les spécifications de plage de chaque pièce pour déterminer l'ordre dans lequel les assembler.
### Exemple de réponse
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Lancement de chargement partitionné (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Partie chargement (PUT uploadID)](#api-upload-part)
+ [Achèvement du chargement partitionné (POST uploadID)](api-multipart-complete-upload.md)
+ [Annulation de chargement partitionné (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Afficher la liste des chargements partitionnés (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [Répertorier les parties (GET uploadID)](api-multipart-list-parts.md)
+ [Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)](uploading-archive-mpu.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)