

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

# Appendice: oggetto OPTIONS
<a name="RESTOPTIONSobject"></a>

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

Un browser può inviare questa richiesta di preflight ad Amazon S3 per determinare se può inviare una richiesta effettiva con l'origine, il metodo HTTP e le intestazioni specifici. 

Amazon S3 supporta la condivisione di risorse tra origini (CORS) consentendo di aggiungere una sottorisorsa su un bucket. `cors` Quando un browser invia questa richiesta di preflight, Amazon S3 risponde valutando le regole definite nella configurazione. `cors`

Se non `cors` è abilitato nel bucket, Amazon S3 restituisce una risposta. `403 Forbidden`

 Per ulteriori informazioni su CORS, consulta la sezione [ Enabling Cross-Origin Resource Sharing ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html) nella * Amazon Simple Storage Service User Guide. *

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

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

```
1. OPTIONS /{{ObjectName}} HTTP/1.1
2. Host: {{BucketName}}.s3.amazonaws.com 
3. Origin: {{Origin}}
4. Access-Control-Request-Method: {{HTTPMethod}}
5. Access-Control-Request-Headers: {{RequestHeader}}
```

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

 Questa operazione non introduce parametri di richiesta specifici, ma può contenere tutti i parametri di richiesta richiesti dalla richiesta effettiva. 

### Intestazioni di richiesta
<a name="RESTOPTIONSobject-requests-request-headers"></a>


|  Nome  |  Description  |  Richiesto  | 
| --- | --- | --- | 
| Origin | Identifica l'origine della richiesta tra origini diverse ad Amazon S3. Ad esempio, http://www.example.com.<br />Tipo: stringa <br />Impostazione predefinita: nessuna |  Sì  | 
| Access-Control-Request-Method | Identifica il metodo HTTP che verrà utilizzato nella richiesta effettiva.<br />Tipo: stringa <br />Impostazione predefinita: nessuna |  Sì  | 
| Access-Control-Request-Headers | Un elenco delimitato da virgole di intestazioni HTTP che verranno inviate nella richiesta effettiva. <br />Ad esempio, per inserire un oggetto con crittografia lato server, questa richiesta di preflight determinerà se può includere l'intestazione nella richiesta. `x-amz-server-side-encryption`<br />Tipo: stringa <br />Impostazione predefinita: nessuna |  No  | 

### Elementi della richiesta
<a name="RESTOPTIONSobject-requests-request-elements"></a>

Questa implementazione dell'operazione non utilizza elementi di richiesta.

## Risposte
<a name="RESTOPTIONSobject-responses"></a>

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


| Header | Description | 
| --- | --- | 
| Access-Control-Allow-Origin | L'origine che hai inviato nella tua richiesta. Se l'origine della tua richiesta non è consentita, Amazon S3 non includerà questa intestazione nella risposta.<br />Tipo: stringa | 
| Access-Control-Max-Age | Per quanto tempo, in secondi, i risultati della richiesta di preflight possono essere memorizzati nella cache.<br />Tipo: stringa | 
| Access-Control-Allow-Methods  | Il metodo HTTP inviato nella richiesta originale. Se il metodo nella richiesta non è consentito, Amazon S3 non includerà questa intestazione nella risposta.<br />Tipo: stringa | 
| Access-Control-Allow-Headers  | Un elenco delimitato da virgole di intestazioni HTTP che il browser può inviare nella richiesta effettiva. Se una delle intestazioni richieste non è consentita, Amazon S3 non includerà tale intestazione nella risposta, né la risposta conterrà nessuna delle intestazioni con il prefisso. `Access-Control`<br />Tipo: stringa | 
| Access-Control-Expose-Headers  | Un elenco di intestazioni HTTP delimitato da virgole. Questa intestazione fornisce al JavaScript client l'accesso a queste intestazioni nella risposta alla richiesta effettiva.<br />Tipo: stringa | 

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

Questa implementazione dell'operazione non restituisce elementi di risposta.

## Esempi
<a name="RESTOPTIONSobject-examples"></a>

### Esempio: invia una richiesta OPTIONS di preflight a un bucket abilitato per `cors`
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule"></a>

 Un browser può inviare questa richiesta di preflight ad Amazon S3 per determinare se può inviare la richiesta PUT effettiva dall'http://www.example.comorigine al bucket Amazon S3 denominato. `examplebucket` 

#### Richiesta di esempio
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule-sample-request"></a>

```
1. OPTIONS /exampleobject HTTP/1.1
2. Host: examplebucket.s3.amazonaws.com 
3. Origin: http://www.example.com
4. Access-Control-Request-Method: PUT
```

#### Risposta di esempio
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule-sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: 6SvaESv3VULYPLik5LLl7lSPPtSnBvDdGmnklX1HfUl7uS2m1DF6td6KWKNjYMXZ
 3. x-amz-request-id: BDC4B83DF5096BBE
 4. Date: Wed, 21 Aug 2012 23:09:55 GMT
 5. Etag: "1f1a1af1f1111111111111c11aed1da1"
 6. Access-Control-Allow-Origin: http://www.example.com
 7. Access-Control-Allow-Methods: PUT
 8. Access-Control-Expose-Headers: x-amz-request-id
 9. Content-Length: 0
10. Server: AmazonS3
```

## Risorse correlate
<a name="RESTOPTIONSobject-related-resources"></a>
+  [GetBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html) 
+  [DeleteBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html) 
+  [PutBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html) 