

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

# Afficher la liste des chargements partitionnés (GET multipart-uploads)
<a name="api-multipart-list-uploads"></a>

## Description
<a name="api-multipart-list-uploads-description"></a>

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
<a name="api-multipart-list-uploads-requests"></a>

### Syntaxe
<a name="api-multipart-list-uploads-requests-syntax"></a>

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
<a name="api-multipart-list-uploads-requests-parameters"></a>


|  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
<a name="api-multipart-list-uploads-requests-headers"></a>

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
<a name="api-multipart-list-uploads-requests-elements"></a>

Cette opération n'a pas de corps de demande.

## Réponses
<a name="api-multipart-list-uploads-responses"></a>

### Syntaxe
<a name="api-multipart-list-uploads-responses-syntax"></a>

```
 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
<a name="api-multipart-list-uploads-responses-headers"></a>

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
<a name="api-multipart-list-uploads-responses-elements"></a>

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
<a name="api-multipart-list-uploads-responses-errors"></a>

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
<a name="api-multipart-list-uploads-examples"></a>

### Exemple : Affichage de la liste de tous les chargements partitionnés
<a name="api-multipart-list-uploads-examples-one"></a>

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
<a name="api-multipart-list-uploads-example-request"></a>

```
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
<a name="api-multipart-list-uploads-example-response"></a>

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
<a name="api-multipart-list-uploads-examples-two"></a>

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
<a name="api-multipart-list-uploads-example-request-two"></a>

```
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
<a name="api-multipart-list-uploads-example-response-two"></a>

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
<a name="related-sections-multipart-list-uploads"></a>

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