View a markdown version of this page

Anhang: OPTIONS-Objekt - Amazon Simple Storage Service
DescriptionAnforderungenAntwortenBeispieleVerwandte Ressourcen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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