View a markdown version of this page

Appendice: oggetto OPTIONS - Amazon Simple Storage Service
DescriptionRichiesteRisposteEsempiRisorse correlate

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

Description

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 nella Amazon Simple Storage Service User Guide.

Richieste

Sintassi

OPTIONS /ObjectName HTTP/1.1
Host: BucketName.s3.amazonaws.com 
Origin: Origin
Access-Control-Request-Method: HTTPMethod
Access-Control-Request-Headers: RequestHeader

Parametri della richiesta

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

Intestazioni di richiesta

Nome Description Richiesto
Origin

Identifica l'origine della richiesta tra origini diverse ad Amazon S3. Ad esempio, http://www.example.com.

Tipo: stringa

Impostazione predefinita: nessuna

 Sì
Access-Control-Request-Method

Identifica il metodo HTTP che verrà utilizzato nella richiesta effettiva.

Tipo: stringa

Impostazione predefinita: nessuna

 Sì
Access-Control-Request-Headers

Un elenco delimitato da virgole di intestazioni HTTP che verranno inviate nella richiesta effettiva.

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

Tipo: stringa

Impostazione predefinita: nessuna

 No

Elementi della richiesta

Questa implementazione dell'operazione non utilizza elementi di richiesta.

Risposte

Intestazioni di risposta

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.

Tipo: stringa
Access-Control-Max-Age

Per quanto tempo, in secondi, i risultati della richiesta di preflight possono essere memorizzati nella cache.

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.

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

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.

Tipo: stringa

Elementi di risposta

Questa implementazione dell'operazione non restituisce elementi di risposta.

Esempi

Esempio: invia una richiesta OPTIONS di preflight a un bucket abilitato per cors

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

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

Risposta di esempio

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