OPTIONS Object
更新時間 2024-09-19 16:53:48
最近更新時間: 2024-09-19 16:53:48
分享文章
本節主要介紹OPTIONS Object。
瀏覽器可以向OOS發送預檢請求，來判斷其是否可以發送特定源、HTTP方法和頭的實際請求。當瀏覽器發送預檢請求時，OOS根據Bucket的跨域配置來返回響應信息。如果Bucket沒有配置跨域，那么OOS返回響應403 Forbidden。
請求語法
OPTIONS /ObjectName HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Origin: Origin
Access-Control-Request-Method: HTTPMethod
Access-Control-Request-Headers: RequestHeader
請求頭
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| Origin | 標示訪問OOS的跨域請求的源。 例如：//docs.oos-cn.daliqc.cn。 類型：字符串。 |
是 |
| Access-Control-Request-Method | 標示在實際請求中，將被用到的HTTP方法。 類型：字符串。 |
是 |
| Access-Control-Request-Headers | 在實際請求中將被發送的HTTP請求頭，用逗號分隔。 類型：字符串。 |
否 |
響應頭
| 響應頭 | 描述 |
|---|---|
| Access-Control-Allow-Origin | 用戶請求中發送的源。如果此源不被允許訪問，那么OOS 不會返回此響應頭。 類型：字符串。 |
| Access-Control-Max-Age | 預檢請求可以被緩存的時間，單位是秒。 類型：字符串。 |
| Access-Control-Allow-Methods | 用戶請求時，允許發送的HTTP方法列表。如果用戶請求的方法不被允許，那么OOS不會返回此響應頭。 類型：字符串。 |
| Access-Control-Allow-Headers | 在實際請求中，瀏覽器發送的HTTP請求頭列表，以逗號分隔。如果瀏覽器未發送此請求頭或者發送的此請求頭內容為空，OOS將不會返回此響應頭；如果沒有任何請求頭被允許，OOS將返回403狀態碼，也不會返回任何以Access-Control開頭的響應頭。 類型：字符串。 |
| Access-Control-Expose-Headers | 在實際響應中，JavaScript客戶端可以訪問的響應頭列表，以逗號分隔。 類型：字符串。 |
請求示例
瀏覽器可以向OOS發送預檢請求，來判斷其是否可以從源//docs.oos-cn.daliqc.cn向名為example-bucket的Bucket，發送PUT請求。
OPTIONS /exampleobject HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Origin: //docs.oos-cn.daliqc.cn
Access-Control-Request-Method: PUT
響應示例
HTTP/1.1 200 OK
x-amz-request-id: 0e66553608684ccf0b7e71807582848a494b543f4143454749
Date: Wed, 21 Aug 2012 23:09:55 GMT
Access-Control-Allow-Origin: //docs.oos-cn.daliqc.cn
Access-Control-Allow-Methods: PUT
Access-Control-Expose-Headers: x-amz-request-id
Server: CTYUN
