获取桶的CORS配置
功能介绍
获取指定桶的CORS配置信息。
要正确执行此操作，需要确保执行者有GetBucketCORS权限。默认情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。
请求消息样式
1 2 3 4 |
GET /?cors HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization: authorization |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头，具体参见表3。
请求消息元素
该请求消息中不使用消息元素。
响应消息样式
1 2 3 4 5 6 7 8 9 10 11 |
HTTP/1.1 status_code Content-Type: application/xml Date: date Content-Length: length <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <CORSConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/"> <CORSRule> ... </CORSRule> </CORSConfiguration> |
响应消息头
该请求的响应消息使用公共消息头，具体请参考表1。
响应消息元素
在此请求返回的响应消息体中包含的配置元素如下表1描述。
|
名称 |
描述 |
|---|---|
|
CORSConfiguration |
CORSRules的根节点，最大不超过64 KB。 类型：Container 父节点：无。 |
|
CORSRule |
CORS规则，CORSConfiguration下可最多包含100个规则。 类型：Container 父节点：CORSConfiguration。 |
|
ID |
一条Rule的标识，由不超过255个字符的字符串组成。 类型：String 父节点：CORSRule。 |
|
AllowedMethod |
CORS规则允许的Method。 类型：String 有效值：GET、PUT、HEAD、POST 、DELETE 父节点：CORSRule。 |
|
AllowedOrigin |
CORS规则允许的Origin（表示域名的字符串），可以带一个匹配符”*”。每一个AllowedOrigin可以带最多一个“*”通配符。 类型：String 父节点：CORSRule。 |
|
AllowedHeader |
配置CORS请求中允许携带的“Access-Control-Request-Headers”头域。如果一个请求带了“Access-Control-Request-Headers”头域，则只有匹配上AllowedHeader中的配置才认为是一个合法的CORS请求。每一个AllowedHeader可以带最多一个“*”通配符，不可出现空格。 类型：String 父节点：CORSRule。 |
|
MaxAgeSeconds |
客户端可以缓存的CORS响应时间，以秒为单位。 每个CORSRule可以包含至多一个MaxAgeSeconds，可以设置为负值。 类型：Integer 父节点：CORSRule。 |
|
ExposeHeader |
CORS响应中带的附加头域，给客户端提供额外的信息，不可出现空格。 类型：String 父节点：CORSRule。 |
请求示例
1 2 3 4 5 6 |
GET /?cors HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 03:54:36 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:WJGghTrPQQXRuCx5go1fHyE+Wwg= |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF2600000164363593F10738B80CACBE x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSpngvwC5TskcLGh7Fz5KRmCFIayuY8p Content-Type: application/xml Date: WED, 01 Jul 2015 03:54:36 GMT Content-Length: 825 <?xml version="1.0" encoding="utf-8"?> <CORSConfiguration xmlns="http://obs.region.example.com/doc/2015-06-30/"> <CORSRule> <ID>783fc6652cf246c096ea836694f71855</ID> <AllowedMethod>POST</AllowedMethod> <AllowedMethod>GET</AllowedMethod> <AllowedMethod>HEAD</AllowedMethod> <AllowedMethod>PUT</AllowedMethod> <AllowedMethod>DELETE</AllowedMethod> <AllowedOrigin>obs.example.com</AllowedOrigin> <AllowedOrigin>www.example.com</AllowedOrigin> <AllowedHeader>AllowedHeader_1</AllowedHeader> <AllowedHeader>AllowedHeader_2</AllowedHeader> <MaxAgeSeconds>100</MaxAgeSeconds> <ExposeHeader>ExposeHeader_1</ExposeHeader> <ExposeHeader>ExposeHeader_2</ExposeHeader> </CORSRule> </CORSConfiguration> |
