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
<a name="RESTOPTIONSobject"></a>

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

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html) Enabling Cross-Origin Resource Sharing.

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

### Syntax
<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}}
```

### Anforderungsparameter
<a name="RESTOPTIONSobject-requests-request-parameters"></a>

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

### Anforderungsheader
<a name="RESTOPTIONSobject-requests-request-headers"></a>


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| Origin | Identifiziert den Ursprung der ursprungsübergreifenden Anfrage an Amazon S3. Beispiel: http://www.example.com.<br />Typ: Zeichenfolge <br />Standard: keiner |  Ja  | 
| Access-Control-Request-Method | Identifiziert, welche HTTP-Methode in der tatsächlichen Anfrage verwendet wird.<br />Typ: Zeichenfolge <br />Standard: keiner |  Ja  | 
| Access-Control-Request-Headers | Eine kommagetrennte Liste von HTTP-Headern, die in der eigentlichen Anfrage gesendet werden. <br />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`<br />Typ: Zeichenfolge <br />Standard: keiner |  Nein  | 

### Anfrage-Elemente
<a name="RESTOPTIONSobject-requests-request-elements"></a>

Diese Implementierung des Vorgangs verwendet keine Anforderungselemente.

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

### Antwort-Header
<a name="RESTOPTIONSobject-responses-response-headers"></a>


| 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.<br />Typ: Zeichenfolge | 
| Access-Control-Max-Age | Gibt an, wie lange (in Sekunden) die Ergebnisse der Preflight-Anfrage zwischengespeichert werden können.<br />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.<br />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`<br />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.<br />Typ: Zeichenfolge | 

### Antwortelemente
<a name="RESTOPTIONSobject-responses-response-elements"></a>

Diese Implementierung der Operation gibt keine Antwortelemente zurück.

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

### Beispiel: Senden Sie eine Preflight-OPTIONS-Anfrage an einen `Cors-fähigen Bucket`
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule"></a>

 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
<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
```

#### Beispielantwort
<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
```

## Verwandte Ressourcen
<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)