View a markdown version of this page

附錄：OPONS 物件 - Amazon Simple Storage Service
說明要求回應範例相關資源

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

附錄：OPONS 物件

說明

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

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

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

如需 CORS 的詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》中的啟用跨來源資源共用。

要求

語法

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

請求參數

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

請求標頭

名稱 描述 必要
Origin

識別對 Amazon S3 的跨來源請求的來源。例如，https：//http://www.example.com。

類型：字串

預設：無

 是
Access-Control-Request-Method

識別要在實際請求中使用的 HTTP 方法。

類型：字串

預設：無

 是
Access-Control-Request-Headers

將在實際請求中傳送的以逗號分隔的 HTTP 標頭清單。

例如，若要放置具有伺服器端加密的物件，此預檢請求會判斷是否可以在請求中包含 x-amz-server-side-encryption標頭。

類型：字串

預設：無

 否

要求元素

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

回應

回應標頭

標頭 說明
Access-Control-Allow-Origin

您在請求中傳送的原始伺服器。如果不允許請求中的原始伺服器，Amazon S3 將不會在回應中包含此標頭。

類型：字串
Access-Control-Max-Age

預檢請求的結果可以快取多久，以秒為單位。

類型：字串
Access-Control-Allow-Methods

在原始請求中傳送的 HTTP 方法。如果不允許請求中的 方法，Amazon S3 將不會在回應中包含此標頭。

類型：字串
Access-Control-Allow-Headers

瀏覽器可在實際請求中傳送的以逗號分隔的 HTTP 標頭清單。如果不允許任何請求的標頭，Amazon S3 將不會在回應中包含該標頭，也不會包含任何具有 Access-Control字首的標頭。

類型：字串
Access-Control-Expose-Headers

HTTP 標頭的逗號分隔清單。此標頭可讓 JavaScript 用戶端在對實際請求的回應中存取這些標頭。

類型：字串

回應元素

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

範例

範例 ：將預檢 OPTIONS 請求傳送至cors已啟用的儲存貯體

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

請求範例

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

回應範例

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