Anhang: OPTIONS-Objekt

Description

Ein Browser kann diese Preflight-Anfrage an Amazon S3 senden, um festzustellen, ob eine tatsächliche Anfrage mit dem spezifischen Ursprung, der HTTP-Methode und den Headern gesendet werden kann.

Amazon S3 unterstützt Cross-Origin Resource Sharing (CORS), indem es Ihnen ermöglicht, eine cors Unterressource zu einem Bucket hinzuzufügen. Wenn ein Browser diese Preflight-Anfrage sendet, reagiert Amazon S3, indem es die in der Konfiguration definierten Regeln auswertet. cors

Wenn im Bucket nicht aktiviert cors ist, gibt Amazon S3 eine 403 Forbidden Antwort zurück.

Weitere Informationen zu CORS finden Sie im Amazon Simple Storage Service-Benutzerhandbuch unter Enabling Cross-Origin Resource Sharing.

Anforderungen

Syntax

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

Anforderungsparameter

Bei diesem Vorgang werden keine spezifischen Anforderungsparameter eingeführt, er kann jedoch alle Anforderungsparameter enthalten, die für die eigentliche Anfrage erforderlich sind.

Anforderungsheader

Name	Description	Erforderlich
Origin	Identifiziert den Ursprung der ursprungsübergreifenden Anfrage an Amazon S3. Beispiel: http://www.example.com. Typ: Zeichenfolge Standard: keiner	Ja
Access-Control-Request-Method	Identifiziert, welche HTTP-Methode in der tatsächlichen Anfrage verwendet wird. Typ: Zeichenfolge Standard: keiner	Ja
Access-Control-Request-Headers	Eine kommagetrennte Liste von HTTP-Headern, die in der eigentlichen Anfrage gesendet werden. Um beispielsweise ein Objekt mit serverseitiger Verschlüsselung zu versehen, bestimmt diese Preflight-Anfrage, ob der Header in die Anfrage aufgenommen werden kann. x-amz-server-side-encryption Typ: Zeichenfolge Standard: keiner	Nein

Anfrage-Elemente

Diese Implementierung des Vorgangs verwendet keine Anforderungselemente.

Antworten

Antwort-Header

Header	Description
Access-Control-Allow-Origin	Der Ursprung, den Sie in Ihrer Anfrage gesendet haben. Wenn der Ursprung Ihrer Anfrage nicht zulässig ist, nimmt Amazon S3 diesen Header nicht in die Antwort auf. Typ: Zeichenfolge
Access-Control-Max-Age	Gibt an, wie lange (in Sekunden) die Ergebnisse der Preflight-Anfrage zwischengespeichert werden können. Typ: Zeichenfolge
Access-Control-Allow-Methods	Die HTTP-Methode, die in der ursprünglichen Anfrage gesendet wurde. Wenn die Methode in der Anfrage nicht zulässig ist, nimmt Amazon S3 diesen Header nicht in die Antwort auf. Typ: Zeichenfolge
Access-Control-Allow-Headers	Eine durch Kommas getrennte Liste von HTTP-Headern, die der Browser in der eigentlichen Anfrage senden kann. Wenn einer der angeforderten Header nicht zulässig ist, nimmt Amazon S3 diesen Header nicht in die Antwort auf, und die Antwort enthält auch keinen der Header mit dem Präfix. Access-Control Typ: Zeichenfolge
Access-Control-Expose-Headers	Eine durch Kommas getrennte Liste von HTTP-Headern. Dieser Header bietet dem JavaScript Client Zugriff auf diese Header in der Antwort auf die eigentliche Anfrage. Typ: Zeichenfolge

Antwortelemente

Diese Implementierung der Operation gibt keine Antwortelemente zurück.

Beispiele

Beispiel: Senden Sie eine Preflight-OPTIONS-Anfrage an einen Cors-fähigen Bucket

Ein Browser kann diese Preflight-Anfrage an Amazon S3 senden, um festzustellen, ob er die tatsächliche PUT-Anfrage vom http://www.example.com Ursprung an den angegebenen Amazon S3-Bucket senden kann. examplebucket

Beispielanforderung

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

Beispielantwort

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

Verwandte Ressourcen

• GetBucketCors

• DeleteBucketCors

• PutBucketCors