

 **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](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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)
<a name="api-multipart-list-uploads"></a>

## Description
<a name="api-multipart-list-uploads-description"></a>

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)](api-multipart-initiate-upload.md), 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 non `marker` è nullo, per recuperare il set successivo di caricamenti multiparte hai inviato un'altra richiesta List Multipart Uploads con il parametro `marker` request impostato sul valore marker che Amazon Glacier (Amazon Glacier) aveva restituito in risposta alla precedente richiesta List Multipart Uploads.

Nota la differenza tra questa operazione e l'operazione [List Parts (GET uploadID)](api-multipart-list-parts.md). 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)](uploading-archive-mpu.md).

## Richieste
<a name="api-multipart-list-uploads-requests"></a>

### Sintassi
<a name="api-multipart-list-uploads-requests-syntax"></a>

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

```
1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**Nota**  
Il valore è l'ID dell'account proprietario del vault. `AccountId` Account AWS 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
<a name="api-multipart-list-uploads-requests-parameters"></a>


|  Nome  |  Description  |  Richiesto  | 
| --- | --- | --- | 
|  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
<a name="api-multipart-list-uploads-requests-headers"></a>

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](api-common-response-headers.md).

### Corpo della richiesta
<a name="api-multipart-list-uploads-requests-elements"></a>

Questa operazione non ha un corpo della richiesta.

## Risposte
<a name="api-multipart-list-uploads-responses"></a>

### Sintassi
<a name="api-multipart-list-uploads-responses-syntax"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: x-amzn-RequestId
 3. Date: Date
 4. Content-Type: application/json
 5. Content-Length: Length
 6. 
 7. {
 8.   "Marker": String,
 9.   "UploadsList" : [ 
10.     {
11.       "ArchiveDescription": String,
12.       "CreationDate": String,
13.       "MultipartUploadId": String,
14.       "PartSizeInBytes": Number,
15.       "VaultARN": String
16.     }, 
17.    ...
18.   ]
19. }
```

### Intestazioni di risposta
<a name="api-multipart-list-uploads-responses-headers"></a>

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](api-common-response-headers.md).

### Corpo della risposta
<a name="api-multipart-list-uploads-responses-elements"></a>

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)](api-multipart-initiate-upload.md). 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
<a name="api-multipart-list-uploads-responses-errors"></a>

Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md)

## Esempi
<a name="api-multipart-list-uploads-examples"></a>

### Esempio: elenco di tutti i caricamenti in più parti
<a name="api-multipart-list-uploads-examples-one"></a>

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
<a name="api-multipart-list-uploads-example-request"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
<a name="api-multipart-list-uploads-example-response"></a>

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

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 1054
 6.       
 7. {
 8.   "Marker": null, 
 9.   "UploadsList": [ 
10.     {
11.       "ArchiveDescription": "archive 1",
12.       "CreationDate": "2012-03-19T23:20:59.130Z",
13.       "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14.       "PartSizeInBytes": 4194304,
15.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16.     }, 
17.     {
18.       "ArchiveDescription": "archive 2",
19.       "CreationDate": "2012-04-01T15:00:00.000Z",
20.       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21.       "PartSizeInBytes": 4194304,
22.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23.     },
24.     {
25.       "ArchiveDescription": "archive 3",
26.       "CreationDate": "2012-03-20T17:03:43.221Z",
27.       "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28.       "PartSizeInBytes": 4194304,
29.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30.     } 
31.   ]
32. }
```

### Esempio: elenco parziale dei caricamenti in più parti
<a name="api-multipart-list-uploads-examples-two"></a>

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
<a name="api-multipart-list-uploads-example-request-two"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
<a name="api-multipart-list-uploads-example-response-two"></a>

Nella risposta, Amazon Glacier (Amazon Glacier) restituisce un elenco di non più di due caricamenti multiparte in corso per il vault specificato, a partire dal marker specificato e restituendo due risultati. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 470
 6. 
 7. {
 8.   "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
 9.   "UploadsList" : [ 
10.     {
11.       "ArchiveDescription": "archive 2",
12.       "CreationDate": "2012-04-01T15:00:00.000Z",
13.       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14.       "PartSizeInBytes": 4194304,
15.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16.     }
17.   ]
18. }
```

## Sezioni correlate
<a name="related-sections-multipart-list-uploads"></a>

 
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti)](uploading-archive-mpu.md)
+ [Identity and Access Management per Amazon Glacier](security-iam.md)