

 **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.

# Partie chargement (PUT uploadID)
<a name="api-upload-part"></a>

## Description
<a name="api-job-get-description"></a>

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
<a name="api-job-get-requests"></a>

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
<a name="api-job-get-requests-syntax"></a>

```
 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
<a name="api-upload-part-requests-parameters"></a>

Cette opération n'utilise pas les paramètres de demande.

### En-têtes de demande
<a name="api-upload-part-requests-headers"></a>

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
<a name="api-job-get-requests-elements"></a>

 Le corps de la demande contient les données à charger. 

## Réponses
<a name="api-job-get-responses"></a>

Une fois le chargement partiel réussi, Amazon Glacier renvoie une `204 No Content` réponse. 

### Syntaxe
<a name="api-job-get-response-syntax"></a>

```
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
<a name="api-job-get-responses-headers"></a>

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
<a name="api-job-get-responses-elements"></a>

Cette opération ne renvoie pas de corps de réponse.

## Exemple
<a name="api-job-get-examples"></a>

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
<a name="api-job-get-examples-sample-request"></a>

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
<a name="api-job-get-examples-sample-response"></a>

```
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
<a name="related-sections-upload-part"></a>

 
+ [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)