List Multipart Uploads (GET multipart-uploads) - Amazon S3 Glacier
DescrizioneRichiesteRisposteEsempiSezioni correlate

Questa pagina è riservata ai clienti esistenti del servizio S3 Glacier che utilizzano Vaults e l'originale del 2012. REST API

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage S3 Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage S3 Glacier e lo storage dei dati a lungo termine con le classi di storage S3 Glacier nella Amazon S3 User Guide. Queste classi di storage utilizzano Amazon S3API, sono disponibili in tutte le regioni e possono essere gestite all'interno della console Amazon S3. Offrono funzionalità come Storage Cost Analysis, Storage Lens, funzionalità di crittografia opzionali avanzate e altro ancora.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

List Multipart Uploads (GET multipart-uploads)

Descrizione

Questa operazione di caricamento in più parti elenca i caricamenti di questo tipo in corso per il vault specificato. Un caricamento in più parti in corso è un caricamento che è stato avviato da una richiesta Initiate Multipart Upload (POST multipart-uploads), ma che non è ancora stato completato o arrestato. L'elenco restituito nella risposta List Multipart Uploads non è ordinato.

L'operazione List Multipart Uploads supporta la paginazione. Per impostazione predefinita, questa operazione restituisce fino a 50 caricamenti in più parti nella risposta. Devi sempre verificare se il campo marker nel corpo della risposta include un contrassegno che segnala il punto dal quale continuare l'elenco; se non vi sono altri elementi, il campo marker è null.

Se marker non è null, per recuperare il set di caricamenti in più parti successivo, invia un'altra richiesta List Multipart Uploads con il parametro di richiesta marker impostato sul valore del marker che Amazon S3 Glacier (S3 Glacier) ha restituito in risposta alla richiesta List Multipart Uploads precedente.

Nota la differenza tra questa operazione e l'operazione List Parts (GET uploadID). L'operazione List Multipart Uploads elenca tutti i caricamenti in più parti per un vault. L'operazione List Parts restituisce le parti di un determinato caricamento in più parti identificato da un ID di caricamento.

Per informazioni sul caricamento in più parti, consulta Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti).

Richieste

Sintassi

Per elencare i caricamenti in più parti, invia una richiesta GET all'URI della sottorisorsa multipart-uploads del vault. Puoi eventualmente specificare i parametri marker e 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

Nota

Il valore AccountId è l'ID dell'Account AWS dell'account proprietario del vault. Puoi specificare l'ID dell'Account AWS o eventualmente un "-" (trattino), nel qual caso Amazon S3 Glacier utilizza l'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. Se utilizzi un ID account, non includere alcun trattino ("-") nell'ID.

Parametri della richiesta

Nome Descrizione Obbligatorio
limit

Specifica Il numero massimo di caricamenti restituiti nel corpo della risposta. Se non è specificato, l'operazione List Uploads restituisce fino a 50 caricamenti.

Tipo: string

Vincoli: il valore intero minimo è 1. Il valore intero massimo è 50.

 No
marker

Una stringa opaca utilizzata per la paginazione. Il parametro marker specifica il caricamento da cui deve iniziare l'elenco di caricamenti. Ottieni il valore marker da una risposta List Uploads precedente. Devi includere marker solo se continui la paginazione dei risultati iniziata in una richiesta List Uploads precedente.

Tipo: string

Vincoli: nessuno

 No

Intestazioni di richiesta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Intestazioni di risposta comuni.

Corpo della richiesta

Questa operazione non ha un corpo della richiesta.

Risposte

Sintassi

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
    }, 
   ...
  ]
}

Intestazioni di risposta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Intestazioni di risposta comuni.

Corpo della risposta

Il corpo della risposta contiene i campi JSON descritti di seguito.

ArchiveDescription

La descrizione dell'archivio specificata nella richiesta Initiate Multipart Upload. Questo campo è null se la descrizione dell'archivio non è stata specificata nell'operazione Initiate Multipart Upload.

Tipo: stringa

CreationDate

La data e l'ora in formato UTC in cui il caricamento in più parti è stato avviato.

Tipo: stringa. Una rappresentazione di stringa nel formato di data ISO 8601, ad esempio 2013-03-20T17:03:43.221Z.

Marker

Una stringa opaca che rappresenta il punto da cui continuare la paginazione dei risultati. Utilizza l'elenco marker in una nuova richiesta List Multipart Uploads per ottenere ulteriori caricamenti nell'elenco. Se non vi sono altri caricamenti, questo valore è null.

Tipo: stringa

PartSizeInBytes

La dimensione di parte specificata nella richiesta Initiate Multipart Upload (POST multipart-uploads). Si tratta della dimensione di tutte le parti nel caricamento tranne l'ultima parte, che può essere più piccola di questa dimensione.

Tipo: numero

MultipartUploadId

L'ID del caricamento in più parti.

Tipo: stringa

UploadsList

Un elenco di metadati relativi agli oggetti del caricamento in più parti. Ogni elemento nell'elenco contiene un set di coppie nome-valore per il caricamento corrispondente, come ArchiveDescription, CreationDate, MultipartUploadId, PartSizeInBytes e VaultARN.

Tipo: matrice

VaultARN

L'ARN (Amazon Resource Name) del vault che contiene l'archivio.

Tipo: stringa

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.

Esempi

Esempio: elenco di tutti i caricamenti in più parti

L'esempio seguente elenca tutti i caricamenti in più parti in corso per il vault. L'esempio mostra una richiesta HTTP GET inviata all'URI della sottorisorsa multipart-uploads di un determinato vault. Poiché i parametri marker e limit non sono specificati nella richiesta, vengono restituiti fino a 1.000 caricamenti in più parti.

Richiesta di esempio

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

Risposta di esempio

Nella risposta S3 Glacier restituisce un elenco di tutti i caricamenti in più parti in corso per il vault specificato. Il campo marker è null, a indicare che non vi sono altri caricamenti da elencare. 

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

Esempio: elenco parziale dei caricamenti in più parti

L'esempio seguente mostra come utilizzare la paginazione per ottenere un numero limitato di risultati. L'esempio mostra una richiesta HTTP GET inviata all'URI della sottorisorsa multipart-uploads per un determinato vault. In questo esempio, il parametro limit è impostato su 1, il che significa che un solo caricamento viene restituito nell'elenco; il parametro marker indica l'ID di caricamento in più parti da cui inizia l'elenco restituito.

Richiesta di esempio

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

Risposta di esempio

Nella risposta, Amazon S3 Glacier (S3 Glacier) restituisce un elenco di non più di due caricamenti in più parti in corso per il vault specificato. Questo elenco inizia dal marker specificato e restituisce due risultati. 

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