Afficher la liste des chargements partitionnés (GET multipart-uploads) - Amazon S3 Glacier
DescriptionRequêtesRéponsesExemplesSections connexes

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 et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

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)

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), 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 le champ marker n'a pas la valeur null, pour récupérer le prochain ensemble de chargements partitionnés, envoyez une autre demande d'obtention de la liste des chargements partitionnés avec le paramètre de demande marker défini sur la valeur de marqueur qu'Amazon S3 Glacier (S3 Glacier) a renvoyée en réponse à votre demande précédente d'obtention de la liste des chargements partitionnés.

Notez la différence entre cette opération et l'opération Répertorier les parties (GET uploadID)). 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é).

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.

GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

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

Name (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.

Corps de la requête

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

Réponses

Syntaxe

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "Marker": String,
  "UploadsList" : [ 
    {
      "ArchiveDescription": String,
      "CreationDate": String,
      "MultipartUploadId": String,
      "PartSizeInBytes": Number,
      "VaultARN": String
    }, 
   ...
  ]
}

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.

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). 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 en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.

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

GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
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

Dans la réponse, S3 Glacier renvoie la liste de tous les 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. 

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 1054
      
{
  "Marker": null, 
  "UploadsList": [ 
    {
      "ArchiveDescription": "archive 1",
      "CreationDate": "2012-03-19T23:20:59.130Z",
      "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }, 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    },
    {
      "ArchiveDescription": "archive 3",
      "CreationDate": "2012-03-20T17:03:43.221Z",
      "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    } 
  ]
}

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

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
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

Dans la réponse, Amazon S3 Glacier (S3 Glacier) renvoie une liste limitée à deux chargements partitionnés en cours pour le coffre spécifié. Cette liste commence au marqueur spécifié et renvoie deux résultats. 

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 470

{
  "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
  "UploadsList" : [ 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }
  ]
}