

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

# Upload Part (PUT uploadID)
<a name="api-upload-part"></a>

## Descrizione
<a name="api-job-get-description"></a>

Questa operazione di caricamento in più parti consente di caricare una parte di un archivio. Puoi caricare parti di un archivio in qualsiasi ordine in quanto nella richiesta Upload Part specifichi l'intervallo di byte dell'archivio assemblato che verrà caricato in questa parte. Puoi anche caricare le parti in parallelo. In un caricamento in più parti è consentito caricare fino a 10.000 parti.

Per informazioni sul caricamento in più parti, consulta [Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti)](uploading-archive-mpu.md).

 

Amazon Glacier (Amazon Glacier) rifiuta la richiesta di caricamento di una parte se si verifica una delle seguenti condizioni:

 
+ **SHA256 l'hash dell'albero non corrisponde:** per garantire che i dati della parte non vengano danneggiati durante la trasmissione, si calcola un hash ad SHA256 albero della parte e lo si include nella richiesta. Dopo aver ricevuto i dati del componente, Amazon Glacier calcola SHA256 anche un tree hash. Se i due valori hash non corrispondono, l'operazione non riesce. Per informazioni sul calcolo dell'hash di un SHA256 albero, consulta. [Calcolo di checksum](checksum-calculations.md)
+ SHA256 l'**hash lineare non corrisponde:** per l'autorizzazione è necessario calcolare un hash SHA256 lineare dell'intero payload caricato e includerlo nella richiesta. Per informazioni sul calcolo di un hash SHA256 lineare, vedere. [Calcolo di checksum](checksum-calculations.md)
+ **La dimensione di parte non corrisponde:** la dimensione di ogni parte eccetto l'ultima deve corrispondere alla dimensione specificata nella richiesta [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md) corrispondente. La dimensione dell'ultima parte deve essere uguale o inferiore alla dimensione specificata.
**Nota**  
Se carichi una parte la cui dimensione è inferiore alla dimensione specificata nella richiesta Initiate Multipart Upload e quella parte non è l'ultima parte, la richiesta Upload Part verrà eseguita senza problemi. Tuttavia, la richiesta Complete Multipart Upload successiva non riuscirà.
+ **L'intervallo non è allineato:** il valore dell'intervallo di byte nella richiesta non è allineato alla dimensione di parte specificata nella richiesta di avvio corrispondente. Ad esempio, se specifichi una dimensione di parte di 4194304 byte (4 MB), gli intervalli da 0 a 4194303 byte (4 MB – 1) e da 4194304 (4 MB) a 8388607 (8 MB – 1) sono intervalli di parte validi. Tuttavia, se imposti un valore di intervallo da 2 MB a 6 MB, l'intervallo non è allineato alla dimensione di parte e il caricamento non riuscirà.

Questa operazione è idempotente. Se carichi la stessa parte più volte, i dati inclusi nella richiesta più recente sovrascrivono i dati caricati precedentemente.

## Richieste
<a name="api-job-get-requests"></a>

Devi inviare questa richiesta `PUT` HTTP all'URI dell'ID di caricamento restituito dalla richiesta Initiate Multipart Upload. Amazon Glacier utilizza l'ID di caricamento per associare i caricamenti di parti a un caricamento multiparte specifico. La richiesta deve includere un hash ad SHA256 albero dei dati della parte (`x-amz-SHA256-tree-hash`intestazione), un hash SHA256 lineare dell'intero payload (`x-amz-content-sha256`header), l'intervallo di byte (header) e la lunghezza della parte in byte (`Content-Range`header). `Content-Length` 

### Sintassi
<a name="api-job-get-requests-syntax"></a>

```
 1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Range: ContentRange
 6. Content-Length: PayloadSize
 7. Content-Type: application/octet-stream
 8. x-amz-sha256-tree-hash: Checksum of the part
 9. x-amz-content-sha256: Checksum of the entire payload			
10. x-amz-glacier-version: 2012-06-01
```

 

**Nota**  
Il `AccountId` valore è l'ID dell'account proprietario del vault. 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-upload-part-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

### Intestazioni di richiesta
<a name="api-upload-part-requests-headers"></a>

Questa operazione utilizza le seguenti intestazioni di richiesta, oltre alle intestazioni di richiesta comuni a tutte le operazioni. Per ulteriori informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).


|  Nome  |  Descrizione  |  Richiesto  | 
| --- | --- | --- | 
| Content-Length  |  Identifica la lunghezza della parte in byte.  ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: nessuno  |  No | 
| Content-Range  |  Identifica l'intervallo di byte nell'archivio assemblato che verrà caricato in questa parte. Amazon Glacier utilizza queste informazioni per assemblare l'archivio nella sequenza corretta. Il formato di questa intestazione segue la specifica [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Un esempio è `Content-Range:bytes 0-4194303/*`. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: l'intervallo non può essere maggiore della dimensione di parte specificata all'avvio del caricamento in più parti.   |  Sì | 
|  x-amz-content-sha256  |  Il SHA256 checksum (un hash lineare) del payload caricato. Non si tratta dello stesso valore che specifichi nell'intestazione `x-amz-sha256-tree-hash`. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: nessuno  |  Sì | 
|  x-amz-sha256-tree-hash​  |  Specifica un hash SHA256 ad albero dei dati da caricare. Per informazioni sul calcolo dell'hash di un SHA256 albero, vedere. [Calcolo di checksum](checksum-calculations.md) ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: nessuno  |  Sì | 

### Corpo della richiesta
<a name="api-job-get-requests-elements"></a>

 Il corpo della richiesta contiene i dati da caricare. 

## Risposte
<a name="api-job-get-responses"></a>

Una volta completato il caricamento di un componente, Amazon Glacier restituisce una risposta. `204 No Content` 

### Sintassi
<a name="api-job-get-response-syntax"></a>

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```

### Intestazioni di risposta
<a name="api-job-get-responses-headers"></a>

Una risposta corretta include le seguenti intestazioni di risposta, oltre alle intestazioni di risposta comuni a tutte le operazioni. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md).


|  Nome  |  Descrizione  | 
| --- | --- | 
|  x-amz-sha256-tree-hash​  |  L'hash SHA256 dell'albero calcolato da Amazon Glacier per la parte caricata. ▬Tipo: stringa  | 

### Corpo della risposta
<a name="api-job-get-responses-elements"></a>

Questa operazione non restituisce un corpo della risposta.

## Esempio
<a name="api-job-get-examples"></a>

La richiesta seguente carica una parte di 4 MB. La richiesta imposta l'intervallo di byte di modo che sia la prima parte nell'archivio. 

### Richiesta di esempio
<a name="api-job-get-examples-sample-request"></a>

L'esempio invia una richiesta HTTP `PUT` per caricare una parte di 4 MB. La richiesta è inviata all'URI dell'ID di caricamento restituito dalla richiesta Initiate Multipart Upload. L'intestazione `Content-Range` identifica la parte come la prima parte di dati di 4 MB dell'archivio.

```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```

Per caricare la parte successiva, la procedura è la stessa; tuttavia, è necessario calcolare un nuovo hash ad SHA256 albero della parte che si sta caricando e specificare anche un nuovo intervallo di byte per indicare dove andrà la parte nell'assemblaggio finale. La richiesta seguente carica un'altra parte utilizzando lo stesso ID di caricamento. La richiesta specifica i 4 MB successivi dell'archivio dopo la richiesta precedente e una dimensione di parte di 4 MB.

```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```

Le parti possono essere caricate in qualsiasi ordine; Amazon Glacier utilizza le specifiche dell'intervallo per ciascuna parte per determinare l'ordine in cui assemblarle.

### Risposta di esempio
<a name="api-job-get-examples-sample-response"></a>

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```

## Sezioni correlate
<a name="related-sections-upload-part"></a>

 
+ [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [Upload Part (PUT uploadID)](#api-upload-part)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.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)