## **功能描述** 此接口用于获取指定存储桶（Bucket）当前的跨域资源共享 CORS（Cross\-Origin Resource Sharing）的配置规则。 :::warning * 您的账号必须具备 `tos:GetBucketCORS`权限，才能获取桶的跨域资源共享规则，具体操作请参见[权限配置指南](/docs/6349/102120)。 * [分层桶](/docs/6349/1282866)暂不支持 GetBucketCORS 接口。 ::: ## **请求消息样式** ```JSON GET /?cors HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 08:05:36 +0000 Authorization: authorization string ``` ## **请求参数和消息头** 该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |cors |Query |String |是 |\- |代表 GetBucketCORS 请求的特殊标识。 | ## **请求元素** 该请求不使用消息元素。 ## **响应消息头** 该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## **响应元素** 该请求返回当前存储空间（Bucket）配置的 CORS（Cross\-Origin Resource Sharing）所有规则。 |**名称** |**参数类型** |**示例值** |**说明** | |---|---|---|---| |CORSRules |Array |\- |CORS 规则信息。 | |AllowedOrigins |Array |["\*"] |允许跨域请求的来源。 | |AllowedMethods |Array |["PUT", "GET"] |允许的跨域请求方法。 | |AllowedHeaders |Array |["Authorization"] |允许的请求头。 | |ExposeHeaders |Array |["x\-tos\-test"] |允许的响应头。 | |MaxAgeSeconds |Integer |1024 |最大的缓存时间。 | |ResponseVary |Bool |false |是否返回 `Vary: Origin` 头。 | ## **请求示例** ```JSON GET /?cors HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 13:53:55 +0000 Authorization: authorization string ``` ## **响应示例** ```JSON HTTP/1.1 200 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 Content-Length: 643 { "CORSRules":[ { "AllowedOrigins":["http://www.example.com"], "AllowedMethods":["PUT", "GET"], "AllowedHeaders":["*"], "ExposeHeaders":["x-tos-test"], "MaxAgeSeconds":1024, "ResponseVary" : false } ] } ```

对象存储