List Parts (GET uploadID) - Amazon Glacier
DescrizioneRichiesteRisposteEsempiSezioni correlate

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

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage Amazon 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 di Amazon Glacier.

Amazon Glacier (servizio autonomo originale basato su vault) non accetterà più nuovi clienti a partire dal 15 dicembre 2025, senza alcun impatto sui clienti esistenti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage Amazon S3 Glacier, che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier.

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 Parts (GET uploadID)

Descrizione

Questa operazione di caricamento in più parti elenca le parti di un archivio che sono state caricate mediante 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).

Puoi effettuare questa richiesta in qualsiasi momento durante un caricamento in più parti prima che venga completato. Amazon Glacier restituisce l'elenco di parti ordinato per intervallo specificato in ogni caricamento di parte. Se invii una richiesta List Parts dopo aver completato il caricamento multiparte, Amazon Glacier (Amazon Glacier) restituisce un errore.

L'operazione List Parts supporta la paginazione. 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 non marker è nullo, per recuperare il prossimo set di parti hai inviato un'altra richiesta List Parts con il parametro marker request impostato sul valore marker restituito da Amazon Glacier in risposta alla tua precedente richiesta List Parts.

Puoi inoltre limitare il numero di parti restituite nella risposta specificando il parametro limit nella richiesta.

Richieste

Sintassi

Per elencare le parti di un caricamento in più parti in corso, devi inviare una richiesta GET all'URI della risorsa ID di caricamento in più parti. L'ID di caricamento in più parti viene restituito quando avvii un caricamento in più parti (Initiate Multipart Upload (POST multipart-uploads)). Puoi eventualmente specificare i parametri marker e 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

Nota

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

Parametri della richiesta

Nome Descrizione Richiesto
limit

Il numero massimo di parti da restituire. Il limite di default è 50. Il numero di parti restituite può essere inferiore al limite specificato, ma mai superiore.

▬Tipo: stringa

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

 No
marker

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

▬Tipo: stringa

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

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "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 Parts per ottenere ulteriori processi nell'elenco. Se non vi sono altre parti, questo valore è null.

▬Tipo: stringa

MultipartUploadId

L'ID del caricamento a cui sono associate le parti.

▬Tipo: stringa

PartSizeInBytes

La dimensione di parte in byte. Si tratta dello stesso valore specificato nella richiesta Initiate Multipart Upload.

Tipo: numero

Parti

Un elenco di dimensioni di parte del caricamento in più parti. Ogni oggetto nella matrice contiene una coppia nome/valore RangeBytes e sha256-tree-hash.

Tipo: matrice

RangeInBytes

L'intervallo di byte di una parte, compreso il valore superiore dell'intervallo.

▬Tipo: stringa

SHA256TreeHash

Il valore hash SHA256 dell'albero calcolato da Amazon Glacier per la parte. Questo campo non è mai null.

▬Tipo: stringa

VaultARN

L'ARN (Amazon Resource Name) del vault in cui è stato avviato il caricamento in più parti.

▬Tipo: stringa

Errori

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

Esempi

Esempio: elenco di parti di un caricamento in più parti

L'esempio seguente elenca tutte le parti di un caricamento. L'esempio invia una richiesta HTTP GET all'URI dell'ID di un caricamento in più parti in corso e restituisce fino a 1.000 parti.

Richiesta di esempio

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

Risposta di esempio

Nella risposta, Amazon Glacier restituisce un elenco di parti caricate associate all'ID di caricamento multiparte specificato. In questo esempio, ci sono solo due parti. Il campo Marker restituito è null a indicare che non ci sono ulteriori parti del caricamento in più parti.

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

Esempio: elenco di parti di un caricamento in più parti (specificare i parametri di richiesta di contrassegno e limite)

L'esempio seguente mostra come utilizzare la paginazione per ottenere un numero limitato di risultati. L'esempio invia una richiesta HTTP GET all'URI dell'ID di un caricamento in più parti in corso per restituire una parte. Un parametro marker iniziale specifica la parte da cui cominciare l'elenco. Puoi ottenere il valore marker da una risposta di una richiesta precedente per un elenco di parti. Inoltre, in questo esempio, il parametro limit è impostato su 1 e restituisce una parte. Nota che il campo Marker non è null, a indicare che è presente almeno un'altra parte da ottenere.

Richiesta di esempio

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

Risposta di esempio

Nella risposta, Amazon Glacier restituisce un elenco di parti caricate associate all'ID di caricamento multiparte in corso specificato.

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