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.

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

Paramètres de demande

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.

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

Sections connexes