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

Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant 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 l'API Amazon S3, 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 sécurité, notamment de multiples options de cryptage, 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.

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é. S3 Glacier renvoie la liste des parties triée en fonction de la plage que vous avez spécifiée dans chaque chargement partiel. Si vous envoyez une demande d'obtention de la liste des parties après avoir terminé le chargement partitionné, Amazon S3 Glacier (S3 Glacier) renvoie une 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 n'a pas la valeur null, pour récupérer le prochain ensemble de parties, envoyez une autre demande d'obtention de la liste des parties avec le paramètre de demande marker défini sur la valeur de marqueur renvoyée par S3 Glacier en réponse à votre précédente demande d'obtention de la liste des parties.

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

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.

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 d'arborescence SHA256 calculée par S3 Glacier pour la partie. 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 en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Ré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, S3 Glacier renvoie la liste des parties chargées associées à l'ID de chargement partitionné 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, S3 Glacier renvoie la liste des parties chargés associées à l'ID de 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"
}