文档中心 > GetBucketCORS
GetBucketCORS

最近更新时间:2021-12-24

使用GetBucketCORS接口返回Bucket的cor配置信息。

该操作必须有权限执行s3:GetBucketCORS。Bucket所有者默认有此权限,并可以授予其他人权限。


请求

请求语法

GET /?cors HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: GMT date

Authorization: authorization string


响应

响应元素

参数

描述

CORSConfiguration

最多100个CORS规则元素容器。

CORSRule

起源和方法的集合(被许可的跨起源访问)。最多添加100个规则。

AllowedHeader

标记在Access-Control-Request-Headers中那个header被允许。被允许的header在规则中必须有一个相应的记录。只有被请求的headers被发送回来。此字段最多只能包含一个通配符。

AllowedMethod

标记规则中被允许执行的指定范围或起源的一个HTTP方法。每个cors规则必须包含至少一个AllowedMethod和AllowedOrigin。

AllowedOrigin

用户通过应用程序可以访问的一个或多个响应header。每个cor规则必须至少有一个AllowedOrigin, 字符串值可以包含最多一个通配符。

ExposeHeader

用户通过应用程序可以访问的一个或多个响应header。

ID

规则的唯一标识符。该值最多255个字符。

MaxAgeSeconds

浏览器缓存指定资源响应的时间。一个cors规则最多可以有一个MaxAgeSeconds。


示例

请求示例

GET /?cors HTTP/1.1

Host: test.oss-cn-north-1.unicloudsrv.com

Date: Tue, 13 Dec 2011 19:14:42 GMT

Authorization: authorization string

返回示例 

HTTP/1.1 200 OK

x-amz-id-2: 0FmFIWsh/PpBuzZ0JFRC55ZGVmQW4SHJ7xVDqKwhEdJmf3q63RtrvH8ZuxW1Bol5

x-amz-request-id: 0CF038E9BCF63097

Date: Tue, 13 Dec 2011 19:14:42 GMT

Server: los

Content-Length: 280

 

<CORSConfiguration>

     <CORSRule>

       <AllowedOrigin>http://www.unicloud.com</AllowedOrigin>

       <AllowedMethod>GET</AllowedMethod>

       <MaxAgeSeconds>3000</MaxAgeSec>

       <ExposeHeader>x-amz-server-side-encryption</ExposeHeader>

     </CORSRule>

</CORSConfiguration>