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.

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 ce n'markerest 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)). 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

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

{
  "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.

Erreurs

Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultezRé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, 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.

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

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

Sections connexes