本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 附錄：OPONS 物件
<a name="RESTOPTIONSobject"></a>

## 說明
<a name="RESTOPTIONSobject-description"></a>

瀏覽器可以將此預檢請求傳送至 Amazon S3，以判斷是否可以傳送具有特定原始伺服器、HTTP 方法和標頭的實際請求。

Amazon S3 可讓您在儲存貯體上新增`cors`子資源，以支援跨來源資源共用 (CORS)。當瀏覽器傳送此預檢請求時，Amazon S3 會透過評估`cors`組態中定義的規則來回應 。

如果在儲存貯體上未啟用 `cors` ，則 Amazon S3 會傳回`403 Forbidden`回應。

 如需 CORS 的詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[啟用跨來源資源共用](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html)。

## 要求
<a name="RESTOPTIONSobject-requests"></a>

### 語法
<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}}
```

### 請求參數
<a name="RESTOPTIONSobject-requests-request-parameters"></a>

 此操作不會引入任何特定請求參數，但可能包含實際請求所需的任何請求參數。

### 請求標頭
<a name="RESTOPTIONSobject-requests-request-headers"></a>


|  名稱  |  描述  |  必要  | 
| --- | --- | --- | 
| Origin | 識別對 Amazon S3 的跨來源請求的來源。例如，https：//http://www.example.com。<br />類型：字串 <br />預設：無 |  是  | 
| Access-Control-Request-Method | 識別要在實際請求中使用的 HTTP 方法。<br />類型：字串 <br />預設：無 |  是  | 
| Access-Control-Request-Headers | 將在實際請求中傳送的以逗號分隔的 HTTP 標頭清單。<br />例如，若要放置具有伺服器端加密的物件，此預檢請求會判斷是否可以在請求中包含 `x-amz-server-side-encryption`標頭。<br />類型：字串 <br />預設：無 |  否  | 

### 要求元素
<a name="RESTOPTIONSobject-requests-request-elements"></a>

此 操作的實作不會使用請求元素。

## 回應
<a name="RESTOPTIONSobject-responses"></a>

### 回應標頭
<a name="RESTOPTIONSobject-responses-response-headers"></a>


| 標頭 | 說明 | 
| --- | --- | 
| Access-Control-Allow-Origin | 您在請求中傳送的原始伺服器。如果不允許請求中的原始伺服器，Amazon S3 將不會在回應中包含此標頭。<br />類型：字串 | 
| Access-Control-Max-Age | 預檢請求的結果可以快取多久，以秒為單位。<br />類型：字串 | 
| Access-Control-Allow-Methods  | 在原始請求中傳送的 HTTP 方法。如果不允許請求中的 方法，Amazon S3 將不會在回應中包含此標頭。<br />類型：字串 | 
| Access-Control-Allow-Headers  | 瀏覽器可在實際請求中傳送的以逗號分隔的 HTTP 標頭清單。如果不允許任何請求的標頭，Amazon S3 將不會在回應中包含該標頭，也不會包含任何具有 `Access-Control`字首的標頭。<br />類型：字串 | 
| Access-Control-Expose-Headers  | HTTP 標頭的逗號分隔清單。此標頭可讓 JavaScript 用戶端在對實際請求的回應中存取這些標頭。<br />類型：字串 | 

### 回應元素
<a name="RESTOPTIONSobject-responses-response-elements"></a>

此操作的實作不會傳回回應元素。

## 範例
<a name="RESTOPTIONSobject-examples"></a>

### 範例 ：將預檢 OPTIONS 請求傳送至`cors`已啟用的儲存貯體
<a name="RESTOPTIONSobject-examples-example-1-configure-cors---single-rule"></a>

 瀏覽器可以將此預檢請求傳送至 Amazon S3，以判斷是否可以將實際 PUT 請求從 http://www.example.com 原始伺服器傳送至名為 的 Amazon S3 儲存貯體`examplebucket`。

#### 請求範例
<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
```

#### 回應範例
<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
```

## 相關資源
<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)