GET Bucket CORS
更新時間 2024-09-20 18:12:44
最近更新時間: 2024-09-20 18:12:44
分享文章
本節主要介紹GET Bucket CORS。
返回Bucket的跨域配置信息。只有根用戶和擁有GET Bucket CORS權限的子用戶才能執行此操作，否則會返回403 AccessDenied錯誤。
請求語法
GET /?cors HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
請求參數
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| BucketName | 存儲桶名稱。 | 是 |
響應結果
| 名稱 | 描述 |
|---|---|
| CORSConfiguration | 最多包含100個CORSRules元素的容器。 類型：容器 |
| CORSRule | 用戶允許跨域的源和方法。 類型：容器。 子節點: AllowedOrigin、 AllowedMethod、MaxAgeSeconds、ExposeHeader、ID。 父節點: CORSConfiguration。 |
| ID | 規則的唯一標示。最長255個字符。 類型：字符串。 父節點: CORSRule。 |
| AllowedMethod | 用戶允許跨域的HTTP方法。每個CORSRule應至少包含一個源和一個方法。 類型: 枚舉。 取值：GET、PUT、HEAD、POST、DELETE。 父節點：CORSRule。 |
| AllowedOrigin | 用戶允許跨域的源。最多包含一個 * 通配符。比如：//*.daliqc.cn。 用戶也可以只指定 * 表示允許所有源跨域訪問。 類型：字符串。 父節點: CORSRule。 |
| AllowedHeader | 通過Access-Control-Request-Headers請求頭，指定預檢OPTIONS請求中允許的請求頭。Access-Control-Request-Headers中的每個請求頭名稱，必須在規則中有匹配的相應條目。OOS將僅發送允許的響應頭。規則中的每個 AllowedHeader 字符串可以最多包含一個 * 通配符字符。例如：x-amz-*。 類型：字符串。 父節點：CORSRule。 |
| MaxAgeSeconds | 指定瀏覽器為預檢請求緩存響應的時間 (以秒為單位)。 一個CORSRule最多包含一個MaxAgeSeconds元素。 類型：整型。 父節點：CORSRule。 |
| ExposeHeader | 指定客戶應用程序 (例如，JavaScript XMLHttpRequest文件) 能夠訪問的響應頭。 類型：字符串。 父節點: CORSRule。 |
請求示例
GET?/?cors?HTTP/1.1
Host:?example-bucket.oos-cn.ctyunapi.cn
Date:?Wed,?13?Dec?2017?19:14:42?GMT
Authorization: SignatureValue
響應示例
HTTP/1.1?200?OK
x-amz-request-id:?2c3ee2045e7f4839c03a3c33353bfafc04f0f2f4f6f8fafcfe
Date:?Wed,?13?Dec?2017?19:14:42?GMT
Server:?CTYUN
Content-Length:?288
?
<CORSConfiguration>
????<CORSRule>
????????<AllowedOrigin>//docs.oos-cn.ctyunapi.cn</AllowedOrigin>
????????<AllowedMethod>GET</AllowedMethod>
????????<MaxAgeSeconds>3000</MaxAgeSeconds>
????????<ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
????</CORSRule>
</CORSConfiguration>
