Répertorier les parties (GET uploadID) - Amazon Glacier
DescriptionRequêtesRéponsesExemplesSections connexes

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.

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'acceptera plus de nouveaux clients à compter du 15 décembre 2025, sans aucune incidence sur les clients existants. 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, 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.

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.

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é).

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)). Vous pouvez éventuellement spécifier les paramètres marker et limit.

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
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 : String

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 : String

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

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "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 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, consultezRéponses d’erreur.

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

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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 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é.

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: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

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 limitest 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

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 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 Glacier renvoie une liste des pièces chargées associées à l'ID de téléchargement partitionné en cours spécifié.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}