获取指定Bucket上设定一个跨域资源共享规则
更新时间：2021-12-29
接口说明
本接口用于获取指定的Bucket当前的CORS规则。
权限说明： 只有Bucket的所有者和被授予FULL_CONTROL权限的用户才能设置Bucket的CORS。没有权限时，返回403 Forbidden错误，错误码： AccessDenied。
请求URI
GET /v1/{bucketName}/?cors
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 | 参数位置 |
|---|---|---|---|---|---|
| bucketName | String | 是 | bucket的名称 | "bucketName_example" | Path |
请求体参数
请求体字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| corsConfiguration | List<CorsConfiguration> | 是 | Bucket的CORS规则容器。每个Bucket 最多允许有100条规则。 如果有多条配置，执行顺序为从上到下。 |
CorsConfiguration字段数据结构说明
| 参数名称 | 参数类型 | 是否必须 | 描述 | 示例值 |
|---|---|---|---|---|
| allowedOrigins | List<String> | 是 | 存储允许的跨域请求的来源的容器。 | |
| allowedMethods | List<String> | 是 | 存储允许的跨域请求方法的容器。 | |
| allowedHeaders | List<String> | 是 | 存储允许的allowedHeaders容器。控制 在OPTIONS预取指令中Access-Control- Request-Headers头中指定的header是 否允许。 | |
| allowedExposeHeaders | List<String> | 否 | 存储允许用户从应用程序中访问的响应头的容器。 | |
| maxAgeSeconds | Integer | 否 | 指定浏览器对特定资源的预取（OPTIONS）请求返 回结果的缓存时间，在缓存时间内请求方不必发送重 复的preflight 请求，单位为秒。 类型：Int64。 | 1800 |
响应体参数
响应体字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| corsConfiguration | List<CorsConfiguration> | Bucket的CORS规则容器。每个Bucket最多允许有100条规则。如果有多条配置，执行顺序为从上到下。 |
CorsConfiguration字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| allowedOrigins | List<String> | 存储允许的跨域请求的来源的容器。 | |
| allowedMethods | List<String> | 存储允许的跨域请求方法的容器。 | |
| allowedHeaders | List<String> | 存储允许的allowedHeaders容器。控制在OPTIONS预取指令中Access-Control-Request-Headers头中指定的header是否允许。 | |
| allowedExposeHeaders | List<String> | 存储允许用户从应用程序中访问的响应头的容器。 | |
| maxAgeSeconds | Long | 指定浏览器对特定资源的预取（OPTIONS）请求返回结果的缓存时间，在缓存时间内请求方不必发送重复的preflight请求，单位为秒。类型：Int64。 | 1800 |
请求示例
JSON
1GET /v1/bucketName_example/?cors
2<公共请求头>
3
4
5{
6 "corsConfiguration" : [ {
7 "allowedExposeHeaders" : [ "user-custom-expose-header" ],
8 "allowedOrigins" : [ "http://www.example.com" ],
9 "allowedHeaders" : [ "Authorization" ],
10 "allowedMethods" : [ "GET" ],
11 "maxAgeSeconds" : 1800
12 } ]
13}响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "corsConfiguration" : [ {
6 "allowedExposeHeaders" : [ "user-custom-expose-header", "user-custom-expose-header" ],
7 "allowedOrigins" : [ "http://www.example.com", "http://www.example.com" ],
8 "allowedHeaders" : [ "Authorization", "Authorization" ],
9 "allowedMethods" : [ "GET", "GET" ],
10 "maxAgeSeconds" : 1800
11 }, {
12 "allowedExposeHeaders" : [ "user-custom-expose-header", "user-custom-expose-header" ],
13 "allowedOrigins" : [ "http://www.example.com", "http://www.example.com" ],
14 "allowedHeaders" : [ "Authorization", "Authorization" ],
15 "allowedMethods" : [ "GET", "GET" ],
16 "maxAgeSeconds" : 1800
17 } ]
18}错误码
请参考通用错误码