

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

# POST Object
<a name="RESTObjectPOST"></a>

## Description
<a name="RESTObjectPOST-description"></a>

L'`POST`operazione aggiunge un oggetto a un bucket specificato utilizzando moduli HTML. `POST`è una forma alternativa `PUT` che consente i caricamenti basati su browser per inserire oggetti nei bucket. I parametri passati `PUT` tramite intestazioni HTTP vengono invece passati come campi del modulo `POST` nel corpo del messaggio con codifica -data. multipart/form Per aggiungere un oggetto a un bucket, devi avere `WRITE` accesso al bucket. Amazon S3 non archivia mai oggetti parziali. Se ricevi una risposta positiva, puoi essere certo che l'intero oggetto è stato archiviato.

Amazon S3 è un sistema distribuito. A meno che tu non abbia abilitato il controllo delle versioni per un bucket, se Amazon S3 riceve più richieste di scrittura per lo stesso oggetto contemporaneamente, viene archiviata solo l'ultima versione dell'oggetto scritto.

Per assicurarti che i dati non vengano danneggiati durante l'attraversamento della rete, utilizza il campo del modulo. `Content-MD5` Quando utilizzi questo campo del modulo, Amazon S3 confronta l'oggetto con il valore MD5 fornito. Se non corrispondono, Amazon S3 restituisce un errore. Inoltre, puoi calcolare il valore MD5 mentre pubblichi un oggetto su Amazon S3 e confrontare il valore MD5 restituito `ETag` con il valore MD5 calcolato. L'ETag riflette solo le modifiche al contenuto di un oggetto, non i suoi metadati.

**Nota**  
Per configurare l'applicazione in modo che invii le intestazioni della richiesta prima di inviare il corpo della richiesta, utilizza il codice di stato HTTP 100 (Continua). Per quanto riguarda `POST` le operazioni, l'utilizzo di questo codice di stato consente di evitare l'invio del corpo del messaggio se il messaggio viene rifiutato in base alle intestazioni (ad esempio, a causa di un errore di autenticazione o di un reindirizzamento). Per ulteriori informazioni sul codice di stato HTTP 100 (Continua), vai alla Sezione 8.2.3 di. [ http://www.ietf.org/rfc/rfc2616.txt ](http://www.ietf.org/rfc/rfc2616.txt)

Amazon S3 esegue automaticamente la crittografa di tutti i nuovi oggetti caricati in un bucket S3. L'impostazione di crittografia di un oggetto caricato dipende dalla configurazione di crittografia predefinita del bucket di destinazione. Per impostazione predefinita, tutti i bucket hanno una configurazione di crittografia predefinita che utilizza la crittografia lato server con chiavi gestite da Amazon S3 (). SSE-S3 

Se il bucket di destinazione ha una configurazione di crittografia che utilizza la crittografia lato server con una AWS Key Management Service chiave (SSE-KMS), la crittografia lato server a doppio livello con una AWS KMS chiave (DSSE-KMS) o una chiave di crittografia fornita dal cliente (SSE-C), Amazon S3 utilizza la chiave KMS o la chiave fornita dal cliente corrispondente per crittografare l'oggetto caricato.AWS KMS Quando si carica un oggetto, se si desidera modificare l'impostazione di crittografia dell'oggetto caricato, è possibile specificare il tipo di crittografia lato server. È possibile configurare SSE-S3, SSE-KMS, DSSE-KMS o. SSE-C Per ulteriori informazioni, consulta [Protezione dei dati con la crittografia lato server](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) nella *Guida per l'utente di Amazon Simple Storage Service*.

**Importante**  
Quando crei la tua richiesta, assicurati che il `file` campo sia l'ultimo campo del modulo.

## Richieste
<a name="RESTObjectPOST-requests"></a>

### Sintassi
<a name="RESTObjectPOST-requests-syntax"></a>

```
 1. POST / HTTP/1.1
 2. Host: {{destinationBucket}}.s3.amazonaws.com
 3. User-Agent: {{browser_data}}
 4. Accept: {{file_types}}
 5. Accept-Language: {{Regions}}
 6. Accept-Encoding: {{encoding}}
 7. Accept-Charset: {{character_set}}
 8. Keep-Alive: 300
 9. Connection: keep-alive
10. Content-Type: multipart/form-data; boundary=9431149156168
11. Content-Length: {{length}}
12. 
13. --9431149156168
14. Content-Disposition: form-data; name="key"
15. 
16. acl
17. --9431149156168
18. Content-Disposition: form-data; name="tagging"
19. 
20. <Tagging><TagSet><Tag><Key>{{Tag Name}}</Key><Value>{{Tag Value}}</Value></Tag></TagSet></Tagging>
21. --9431149156168
22. Content-Disposition: form-data; name="success_action_redirect"
23. 
24. success_redirect
25. --9431149156168
26. Content-Disposition: form-data; name="Content-Type"
27. 
28. content_type
29. --9431149156168
30. Content-Disposition: form-data; name="x-amz-meta-uuid"
31. 
32. uuid
33. --9431149156168
34. Content-Disposition: form-data; name="x-amz-meta-tag"
35. 
36. metadata
37. --9431149156168
38. Content-Disposition: form-data; name="AWSAccessKeyId"
39. 
40. access-key-id
41. --9431149156168
42. Content-Disposition: form-data; name="Policy"
43. 
44. encoded_policy
45. --9431149156168
46. Content-Disposition: form-data; name="Signature"
47. 
48. signature=
49. --9431149156168
50. Content-Disposition: form-data; name="file"; filename="{{MyFilename.jpg}}"
51. Content-Type: image/jpeg
52. 
53. file_content
54. --9431149156168
55. Content-Disposition: form-data; name="submit"
56. 
57. Upload to Amazon S3
58. --9431149156168--
```

### Parametri della richiesta
<a name="RESTObjectPOST-requests-request-parameters"></a>

Questa implementazione dell'operazione non utilizza parametri di richiesta.

### Campi del modulo
<a name="RESTObjectPOST-requests-form-fields"></a>

Questa operazione può utilizzare i seguenti campi del modulo.


| Nome | Description | Richiesto | 
| --- | --- | --- | 
| AWSAccessKeyId | L'ID della chiave di AWS accesso del proprietario del bucket che concede a un utente anonimo l'accesso per una richiesta che soddisfa il set di vincoli della policy.<br />Tipo: stringa<br />Impostazione predefinita: nessuna<br />Vincoli: obbligatorio se nella richiesta è incluso un documento di policy.  | Condizionale | 
| acl | L'elenco di controllo degli accessi (ACL) di Amazon S3 specificato. Se l'ACL specificato non è valido, viene generato un errore. Per ulteriori informazioni sugli ACL, consulta la panoramica degli elenchi di controllo degli [ accessi (ACL) ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html) nella * Amazon Simple Storage Service User Guide. * <br />Tipo: stringa<br />Default: private<br /> Valori validi: `private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control `  | No | 
| Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires | Le REST-specific intestazioni. Per ulteriori informazioni, consulta [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).<br />Tipo: stringa<br />Impostazione predefinita: nessuna | No | 
| file | Il contenuto del file o del testo. <br />Il contenuto del file o del testo deve essere l'ultimo campo del modulo.<br />Non è possibile caricare più di un file alla volta.<br />Tipo: contenuto del file o del testo<br />Impostazione predefinita: nessuna | Sì | 
| key | Il nome della chiave caricata.<br />Per utilizzare il nome di file fornito dall'utente, utilizzare la `${filename}` variabile. Ad esempio, se un utente di nome Mary carica il file `example.jpg` e tu lo specifichi`/user/mary/${filename}`, il nome della chiave è`/user/mary/example.jpg`.<br />Per ulteriori informazioni, consulta la chiave [ dell'oggetto e i metadati ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) nella * Amazon Simple Storage Service User Guide. *<br />Tipo: stringa<br />Impostazione predefinita: nessuna | Sì | 
| policy | La politica di sicurezza che descrive cosa è consentito nella richiesta. Le richieste senza una politica di sicurezza sono considerate anonime e funzionano solo su bucket scrivibili pubblicamente. Per ulteriori informazioni, consulta i moduli [ HTML ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HTTPPOSTForms.html) e gli esempi di [ caricamento ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HTTPPOSTExamples.html) nella * Amazon Simple Storage Service User Guide. * <br />Tipo: stringa<br />Impostazione predefinita: nessuna<br />Vincoli: è necessaria una policy di sicurezza se il bucket non è scrivibile pubblicamente. | Condizionale | 
| success\_action\_redirect, redirect | L'URL a cui il client viene reindirizzato dopo un caricamento riuscito.<br />Se `success_action_redirect` non è specificato, Amazon S3 restituisce il tipo di documento vuoto specificato nel campo `success_action_status`.<br />Se Amazon S3 non è in grado di interpretare l'URL, si comporta come se il campo non fosse presente.<br />Se il caricamento non riesce, Amazon S3 visualizza un errore e non reindirizza l'utente a un URL.<br />Tipo: stringa<br />Impostazione predefinita: nessuna Il nome del `redirect` campo è obsoleto e il supporto per il nome del `redirect` campo verrà rimosso in futuro.   | No | 
| success\_action\_status | Se non lo specifichi`success_action_redirect`, il codice di stato viene restituito al client quando il caricamento ha esito positivo.<br />Questo campo accetta i valori `200``201`, o `204` (impostazione predefinita).<br />Se il valore è impostato su `200` o`204`, Amazon S3 restituisce un documento vuoto con un codice di stato 200 o 204.<br />Se il valore è impostato su`201`, Amazon S3 restituisce un documento XML con un codice di stato 201. <br />Se il valore non è impostato o se è impostato su un valore non valido, Amazon S3 restituisce un documento vuoto con un codice di stato 204. <br />Tipo: stringa<br />Impostazione predefinita: nessuna | No | 
| tagging | Il set di tag specificato da aggiungere all'oggetto. Per aggiungere tag, utilizzate il seguente schema di codifica.<br /> <pre><Tagging><br />  <TagSet><br />    <Tag><br />      <Key>{{TagName}}</Key><br />      <Value>{{TagValue}}</Value><br />    </Tag><br />    ...<br />  </TagSet><br /></Tagging></pre><br />Per ulteriori informazioni, consulta [ l'etichettatura degli oggetti ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) nella * Amazon Simple Storage Service User Guide. *<br />Tipo: stringa<br />Impostazione predefinita: nessuna | No | 
| x-amz-storage-class | La classe di storage da utilizzare per archiviare l'oggetto. Se non si specifica una classe, Amazon S3 utilizza la classe di storage predefinita,`STANDARD`. Amazon S3 supporta altre classi di storage. Per ulteriori informazioni, consulta la sezione [ Storage classes ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html) nella * Amazon Simple Storage Service User Guide*. <br />Tipo: stringa<br />Impostazione predefinita: `STANDARD`<br />Valori validi: `REDUCED_REDUNDANCY` \| `EXPRESS_ONEZONE` \| `DEEP_ARCHIVE` \| `GLACIER` \| `GLACIER_IR` \| `INTELLIGENT_TIERING` \| `ONEZONE_IA` \| `STANDARD` \| `STANDARD_IA`  | No | 
| x-amz-meta-\* | Le intestazioni che iniziano con questo prefisso sono metadati definiti dall'utente. Ognuna viene archiviata e restituita come set di coppie chiave-valore. Amazon S3 non convalida né interpreta i metadati definiti dall'utente. Per ulteriori informazioni, consulta [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).<br />Tipo: stringa<br />Impostazione predefinita: nessuna | No | 
| x-amz-security-token | Il token di sicurezza Amazon. DevPay <br />Ogni richiesta che utilizza Amazon DevPay richiede due campi del `x-amz-security-token` modulo: uno per il token del prodotto e uno per il token utente.<br />Tipo: stringa<br />Impostazione predefinita: nessuna | No | 
| x-amz-signature | (AWS Signature Version 4) L' HMAC-SHA256 hash della politica di sicurezza.<br />Tipo: stringa<br />Impostazione predefinita: nessuna | Condizionale | 
| x-amz-website-redirect-location  | Se il bucket è configurato come sito Web, questo campo reindirizza le richieste per questo oggetto a un altro oggetto nello stesso bucket o a un URL esterno. Amazon S3 memorizza il valore di questa intestazione nei metadati dell'oggetto. Per informazioni sui metadati degli oggetti, consulta la chiave e i metadati [ dell'oggetto ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) nella Amazon Simple Storage Service User Guide. * *<br />Nell'esempio seguente, l'intestazione della richiesta imposta il reindirizzamento a un object () `anotherPage.html` nello stesso bucket:<br />`x-amz-website-redirect-location: /anotherPage.html`<br />Nell'esempio seguente, l'intestazione della richiesta imposta il reindirizzamento dell'oggetto a un altro sito Web:<br />`x-amz-website-redirect-location: http://www.example.com/`<br />Per ulteriori informazioni sull'hosting di siti Web in Amazon S3, consulta [ Hosting websites on Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html) e [ Come configurare i reindirizzamenti delle pagine dei siti Web ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-page-redirect.html) nella * Amazon Simple Storage Service User Guide. *<br />Tipo: stringa<br />Impostazione predefinita: nessuna<br />Vincoli: il valore deve essere preceduto da,, o. `/` `http://` `https://` La lunghezza del valore è limitata a 2 KB. |  No  | 

#### Campi aggiuntivi del modulo di richiesta di checksum
<a name="post-object-additional-checksums"></a>

Quando carichi un oggetto, puoi specificare vari checksum da utilizzare per verificare l'integrità dei dati. Puoi specificare un algoritmo di checksum aggiuntivo da utilizzare per Amazon S3. Per ulteriori informazioni sui valori di checksum aggiuntivi, consulta [ Verifica dell'integrità degli oggetti ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) nella * Amazon Simple Storage Service User Guide. *


|  Nome  |  Description  |  Richiesto  | 
| --- | --- | --- | 
|  x-amz-checksum-algorithm  | Indica l'algoritmo utilizzato per creare il checksum per l'oggetto. Se viene specificato un valore, è necessario includere l'intestazione di checksum corrispondente. In caso contrario, la richiesta genererà un errore 400.<br />I valori possibili includono `CRC32`, `CRC32C`, `SHA1` e `SHA256`. | No | 
|  x-amz-checksum-crc32  | Specifica il checksum CRC32 a 32 bit codificato in base64 dell'oggetto.<br />Questo parametro è obbligatorio se il valore di è. `x-amz-checksum-algorithm` `CRC32` | Condizionale | 
|  x-amz-checksum-crc32c  | Specifica il checksum CRC32C a 32 bit con codifica base64 dell'oggetto.<br />Questo parametro è obbligatorio se il valore di è. `x-amz-checksum-algorithm` `CRC32C` | Condizionale | 
|  x-amz-checksum-sha1  | Specifica il digest a 160 SHA-1 bit con codifica base64 dell'oggetto.<br />Questo parametro è obbligatorio se il valore di è. `x-amz-checksum-algorithm` `SHA1` | Condizionale | 
|  x-amz-checksum-sha256  | Specifica il digest a 256 SHA-256 bit con codifica base64 dell'oggetto.<br />Questo parametro è obbligatorio se il valore di è. `x-amz-checksum-algorithm` `SHA256` | Condizionale | 

#### Server-Side Campi specifici del modulo di richiesta di crittografia
<a name="post-object-sse-specific-request-headers"></a>

Server-side la crittografia è la crittografia dei dati inattivi. Amazon S3 crittografa i tuoi dati durante la scrittura su dischi nei data AWS center e li decrittografa quando accedi ad essi. Quando carichi un oggetto, puoi specificare il tipo di crittografia lato server che desideri che Amazon S3 utilizzi per crittografare l'oggetto. 

Esistono quattro tipi di crittografia lato server: 
+ **Server-side crittografia con chiavi gestite Amazon S3 (SSE-S3)**: a partire da maggio 2022, tutti i bucket Amazon S3 hanno la crittografia configurata per impostazione predefinita. L'opzione predefinita per la crittografia lato server è with. SSE-S3 Ogni oggetto è crittografato con una chiave univoca. Come protezione aggiuntiva, SSE-S3 crittografa la chiave stessa con una chiave radice che ruota regolarmente. SSE-S3 utilizza uno dei più potenti cifrari a blocchi disponibili, Advanced Encryption Standard () a 256 bit, per crittografare i dati. AES-256
+ **Server-side crittografia con AWS KMS chiavi (SSE-KMS) ** — SSE-KMS viene fornita tramite un'integrazione del AWS KMS servizio con Amazon S3. Con AWS KMS, hai un maggiore controllo sulle tue chiavi. Ad esempio, puoi visualizzare le chiavi separate, modificare le policy di controllo e seguire le chiavi in AWS CloudTrail. Inoltre, puoi creare e gestire chiavi gestite dal cliente oppure utilizzare chiavi Chiavi gestite da AWS create appositamente per te, il tuo servizio e la tua regione.
+ **Dual-layer crittografia lato server con AWS KMS chiavi (DSSE-KMS)**: la Dual-layer crittografia lato server con AWS KMS keys (DSSE-KMS) è simile a SSE-KMS, ma applica due singoli livelli di crittografia a livello di oggetto anziché un livello. 
+ **Server-side crittografia con chiavi fornite dal cliente (SSE-C)**: con SSE-C, gestisci le chiavi di crittografia e Amazon S3 gestisce la crittografia durante la scrittura sui dischi e la decrittografia quando accedi ai tuoi oggetti. 
**Nota**  
Se la crittografia lato server con le chiavi fornite dal cliente (SSE-C) è bloccata per il bucket generico, riceverai un errore HTTP 403 Access Denied quando specifichi le intestazioni della richiesta durante la scrittura di nuovi dati nel bucket. SSE-C Per ulteriori informazioni, consulta [ Bloccare o sbloccare un bucket per scopi generici. SSE-C ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html)

Per ulteriori informazioni, consulta [ Protecting data using server-side encryption ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) nella * Amazon Simple Storage Service User Guide. *

A seconda del tipo di crittografia lato server che desideri utilizzare, specifica i seguenti campi del modulo. 
+ **Usa SSE-S3 SSE-KMS, o DSSE-KMS**: se desideri utilizzare questi tipi di crittografia lato server, specifica i seguenti campi del modulo nella richiesta. 


<table>
<thead>
  <tr><th> Nome </th><th> Description </th><th> Richiesto </th></tr>
</thead>
<tbody>
  <tr><td> <code>x-amz-server-side-encryption</code> </td><td>Specifica l'algoritmo di crittografia lato server da utilizzare quando Amazon S3 crea un oggetto. Per utilizzarlo, specifica. SSE-S3 <code>AES256</code> Per usare SSE-KMS, specificare<code>aws:kms</code>. Per usare DSSE-KMS, specificare<code>aws:kms:dsse</code>.<br />Tipo: stringa<br />Valore valido:<code>aws:kms</code>,<code>AES256</code>, <code>aws:kms:dsse</code></td><td>Sì</td></tr>
  <tr><td> <code>x-amz-server-side-encryption-aws-kms-key-id</code> </td><td>Se l'<code>x-amz-server-side-encryption</code>intestazione ha un valore valido pari a <code>aws:kms</code> o<code>aws:kms:dsse</code>, questa intestazione specifica l'ID utilizzato per crittografare l' AWS KMS key oggetto.<br />Tipo: stringa</td><td>Sì, se il valore di è o <code>x-amz-server-side-encryption</code> <code>aws:kms</code> <code>aws:kms:dsse</code></td></tr>
  <tr><td> <code>x-amz-server-side-encryption-context</code> </td><td>Se <code>x-amz-server-side-encryption</code> il valore valido è <code>aws:kms</code> o<code>aws:kms:dsse</code>, questa intestazione specifica il contesto di crittografia per l'oggetto. Il valore di questa intestazione è una UTF-8 stringa con codifica Base64 che contiene JSON-formatted coppie chiave-valore per il contesto di crittografia.<br />Tipo: stringa</td><td>No</td></tr>
  <tr><td> <code>x-amz-server-side-encryption-bucket-key-enabled</code> </td><td>Se il valore valido <code>x-amz-server-side-encryption</code> è <code>aws:kms</code> or<code>aws:kms:dsse</code>, questa intestazione specifica se Amazon S3 deve utilizzare una chiave S3 Bucket con o. SSE-KMS DSSE-KMS Se si imposta questa intestazione su, Amazon S3 utilizza una chiave bucket S3 per la crittografia degli oggetti con o. <code>true</code> SSE-KMS DSSE-KMS<br />Tipo: Booleano</td><td>No</td></tr>
</tbody>
</table>

**Nota**  
Se specifichi `x-amz-server-side-encryption:aws:kms` o`x-amz-server-side-encryption:aws:kms:dsse`, ma non lo fornisci`x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 utilizza Chiave gestita da AWS (`aws/S3`) per proteggere i dati.
+ **Uso SSE-C**: se desideri gestire le tue chiavi di crittografia, devi fornire tutti i seguenti campi del modulo nella richiesta. 
**Nota**  
Se lo usi SSE-C, il `ETag` valore che Amazon S3 restituisce nella risposta non è l'MD5 dell'oggetto.


<table>
<thead>
  <tr><th> Nome </th><th> Description </th><th> Richiesto </th></tr>
</thead>
<tbody>
  <tr><td><code>x-amz-server-side-encryption-customer-algorithm</code> </td><td>Specifica l'algoritmo da utilizzare per crittografare l'oggetto.<br />Tipo: stringa<br />Impostazione predefinita: nessuna<br />Valore valido: <code>AES256</code><br />Vincoli: deve essere accompagnato da <code>x-amz-server-side-encryption-customer-key-MD5</code> campi <code>x-amz-server-side-encryption-customer-key</code> e validi.</td><td> Sì </td></tr>
  <tr><td><code>x-amz-server-side-encryption-customer-key</code> </td><td>Specifica la chiave di crittografia con codifica Base64 fornita dal cliente per Amazon S3 da utilizzare nella crittografia dei dati. Questo valore viene utilizzato per memorizzare l'oggetto e quindi viene eliminato. Amazon non memorizza la chiave di crittografia. La chiave deve essere appropriata all'uso con l'algoritmo specificato nell'<code>x-amz-server-side-encryption-customer-algorithm</code>intestazione.<br />Tipo: stringa<br />Impostazione predefinita: nessuna<br />Vincoli: deve essere accompagnato da campi <code>x-amz-server-side-encryption-customer-algorithm</code> e <code>x-amz-server-side-encryption-customer-key-MD5</code> validi.</td><td>Sì</td></tr>
  <tr><td><code>x-amz-server-side-encryption-customer-key-MD5</code> </td><td>Specifica il digest MD5 a 128 bit con codifica base64 della chiave di crittografia secondo RFC 1321. <a href="http://tools.ietf.org/html/rfc1321">http://tools.ietf.org/html/rfc1321</a> Amazon S3 utilizza questa intestazione per un controllo dell'integrità dei messaggi per garantire che la chiave di crittografia sia stata trasmessa senza errori.<br />Tipo: stringa<br />Impostazione predefinita: nessuna<br />Vincoli: deve essere accompagnato da campi e validi. <code>x-amz-server-side-encryption-customer-algorithm</code> <code>x-amz-server-side-encryption-customer-key</code></td><td> Sì </td></tr>
</tbody>
</table>


### Risposte
<a name="RESTObjectPOST-requests-responses"></a>

#### Intestazioni di risposta
<a name="RESTObjectPOST-requests-responses-response-headers"></a>

Questa implementazione dell'operazione può includere le seguenti intestazioni di risposta oltre alle intestazioni di risposta comuni a tutte le risposte. Per ulteriori informazioni, vedere [ Common Response Headers. ](RESTCommonResponseHeaders.md)


|  Nome  |  Description  | 
| --- | --- | 
|  x-amz-checksum-crc32  | Il checksum CRC32 a 32 bit con codifica base64 dell'oggetto.<br />Tipo: stringa | 
|  x-amz-checksum-crc32c  | Il checksum CRC32C a 32 bit con codifica base64 dell'oggetto.<br />Tipo: stringa | 
|  x-amz-checksum-sha1  | Il digest a 160 bit dell'oggetto con codifica in base64. SHA-1 <br />Tipo: stringa | 
|  x-amz-checksum-sha256  | Digest a 256 bit dell'oggetto con codifica in base64. SHA-256 <br />Tipo: stringa | 
|  x-amz-expiration  | Se un'`Expiration`azione è configurata per l'oggetto come parte della configurazione del ciclo di vita del bucket, Amazon S3 restituisce questa intestazione.  Il valore dell'intestazione include un componente e un componente. `expiry-date` URL-encoded `rule-id`  Per i bucket abilitati alla versione, questa intestazione si applica solo alle versioni correnti. Amazon S3 non fornisce un'intestazione per indicare quando una versione non corrente è idonea per l'eliminazione permanente. Per ulteriori informazioni, consulta [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html).<br />Tipo: stringa | 
|  success\_action\_redirect, redirect  | L'URL a cui il client viene reindirizzato in caso di caricamento riuscito.<br />Tipo: stringa<br />Antenato: PostResponse | 
|  x-amz-server-side-encryption  | L'algoritmo di crittografia lato server utilizzato per archiviare questo oggetto in Amazon S3 (ad esempio,,`AES256`). `aws:kms` `aws:kms:dsse`<br />Tipo: stringa | 
|  x-amz-server-side-encryption-aws-kms-key-id  | Se l'`x-amz-server-side-encryption`intestazione ha un valore valido di`aws:kms`, questa intestazione specifica l'ID della chiave KMS utilizzata per crittografare l'oggetto.<br />Tipo: stringa | 
|  x-amz-server-side-encryption-bucket-key-enabled  | Se `x-amz-server-side-encryption` ha un valore valido di`aws:kms`, questa intestazione indica se l'oggetto è crittografato SSE-KMS utilizzando una chiave S3 Bucket. Se questa intestazione è impostata su`true`, l'oggetto utilizza una chiave S3 Bucket con. SSE-KMS<br />Tipo: Booleano | 
|  x-amz-server-side-encryption-customer-algorithm  | Se SSE-C richiesto, la risposta include questa intestazione, che conferma l'algoritmo di crittografia utilizzato.<br />Tipo: stringa<br />Valori validi: `AES256` | 
|  x-amz-server-side-encryption-customer-key-MD5  | Se SSE-C richiesto, la risposta include questa intestazione per verificare l'integrità del messaggio di andata e ritorno della chiave di crittografia fornita dal cliente.<br />Tipo: stringa | 
| x-amz-version-id | Versione dell'oggetto.<br />Tipo: stringa | 

#### Elementi di risposta
<a name="RESTObjectPOST-requests-responses-response-elements"></a>


|  Nome  |  Description  | 
| --- | --- | 
|  Bucket  | Il nome del bucket in cui è stato archiviato l'oggetto.<br />Tipo: stringa<br />Antenato: PostResponse | 
|  ETag  | L'entity tag (ETag) è un hash MD5 dell'oggetto che è possibile utilizzare per eseguire `GET` operazioni condizionali utilizzando il tag di richiesta con l'operazione di `If-Modified` richiesta. `GET` `ETag`riflette le modifiche solo al contenuto di un oggetto, non ai suoi metadati.<br />Tipo: stringa<br />Antenato: PostResponse | 
|  Key  | Il nome della chiave dell'oggetto.<br />Tipo: stringa<br />Antenato: PostResponse | 
|  Location  | L'URI dell'oggetto.<br />Tipo: stringa<br />Antenato: PostResponse | 

#### Errori speciali
<a name="RESTObjectPOST-requests-responses-special-errors"></a>

Questa implementazione dell'operazione non restituisce errori speciali. Per informazioni generali sugli errori di Amazon S3 e un elenco di codici di errore, consulta [ Error Responses](ErrorResponses.md).

## Esempi
<a name="RESTObjectPOST-requests-examples"></a>

### Richiesta di esempio
<a name="ExampleVersionObjectPost"></a>

```
1. POST /Neo HTTP/1.1
2. Content-Length: 4
3. Host: quotes.s3.amazonaws.com
4. Date: Wed, 01 Mar  2006 12:00:00 GMT
5. Authorization: {{authorization string}}
6. Content-Type: text/plain
7. Expect: the 100-continue HTTP status code
8. 
9. {{ObjectContent}}
```

### Esempio di risposta con controllo delle versioni sospeso
<a name="RESTObjectPOST-requests-examples-sample-response-with-versioning-suspended"></a>

Di seguito è riportato un esempio di risposta quando il controllo delle versioni del bucket è sospeso:

```
 1. HTTP/1.1 100 Continue
 2. HTTP/1.1 200 OK
 3. x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
 4. x-amz-request-id: 0A49CE4060975EAC
 5. x-amz-version-id: default
 6. Date: Wed, 12 Oct 2009 17:50:00 GMT
 7. ETag: "1b2cf535f27731c974343645a3985328"
 8. Content-Length: 0
 9. Connection: close
10. Server: AmazonS3
```

In questa risposta, l'ID della versione è. `null`

### Esempio di risposta con controllo delle versioni abilitato
<a name="RESTObjectPOST-requests-examples-sample-response-with-versioning-enabled"></a>

Di seguito è riportato un esempio di risposta quando il controllo delle versioni del bucket è abilitato.

```
 1. HTTP/1.1 100 Continue
 2. HTTP/1.1 200 OK
 3. x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
 4. x-amz-request-id: 0A49CE4060975EAC
 5. x-amz-version-id: 43jfkodU8493jnFJD9fjj3HHNVfdsQUIFDNsidf038jfdsjGFDSIRp
 6. Date: Wed, 01 Mar  2006 12:00:00 GMT
 7. ETag: "828ef3fdfa96f00ad9f27c383fc9ac7f"
 8. Content-Length: 0
 9. Connection: close
10. Server: AmazonS3
```

## Risorse correlate
<a name="RESTObjectPOST-requests-related-resources"></a>
+  [CopyObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) 
+  [POST Object](#RESTObjectPOST) 
+  [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) 