Get Bucket Cors

Get Bucket Cors

获取指定桶的CORS配置信息。

请求语法

登录后复制GET /?cors HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

GET /?cors HTTP/1.1 Host: Bucket.s3-us-east-1.ossfiles.com

---

URI 请求参数

名称	描述	类型
Bucket	存储桶名称	字符串

---

请求消息头

该请求没有请求消息头。

---

请求正文

该请求没有请求正文。

---

请求元素

该请求没有请求元素。

---

响应语法

登录后复制HTTP/1.1 200

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
   <CORSRule>
      <AllowedHeader>string</AllowedHeader>
      <AllowedMethod>string</AllowedMethod>
      <AllowedOrigin>string</AllowedOrigin>
      <ExposeHeader>string</ExposeHeader>
      <MaxAgeSeconds>integer</MaxAgeSeconds>
   </CORSRule>
</CORSConfiguration>

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <CORSConfiguration> <CORSRule> <AllowedHeader>string</AllowedHeader> <AllowedMethod>string</AllowedMethod> <AllowedOrigin>string</AllowedOrigin> <ExposeHeader>string</ExposeHeader> <MaxAgeSeconds>integer</MaxAgeSeconds> </CORSRule> </CORSConfiguration>

---

响应元素

名称	描述	类型
CORSRule	CORS规则，CORSConfiguration 下可最多包含100个规则。	容器
CORSRule.AllowedHeader	一条Rule的标识，由不超过255个字符的字符串组成。	字符串
CORSRule.AllowedMethod	配置CORS请求中允许携带的“Access-Control-Request-Headers”头域。如果一个请求带了“Access-Control-Request-Headers”头域，则只有匹配上AllowedHeader中的配置才认为是一个合法的CORS请求。每一个AllowedHeader可以带最多一个“*”通配符，不可出现空格。	字符串
CORSRule.AllowedOrigin	CORS规则允许的Origin（表示域名的字符串），可以带一个匹配符””。每一个AllowedOrigin可以带最多一个“”通配符。	字符串
CORSRule.ExposeHeader	CORS响应中带的附加头域，给客户端提供额外的信息，不可出现空格。	字符串
CORSRule.MaxAgeSeconds	客户端可以缓存的CORS响应时间，以秒为单位。	整数

---

响应消息头

该请求没有响应消息头。

---

示例

请求示例

登录后复制GET /?cors HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=2adb6f2ae3a8ae7eb3c23099be6b9e2a939272cbb17add668b74b6e3618a4436
Content-length: 0
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230117T123902Z

GET /?cors HTTP/1.1 Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=2adb6f2ae3a8ae7eb3c23099be6b9e2a939272cbb17add668b74b6e3618a4436 Content-length: 0 Host: bucket.s3-us-east-1.ossfiles.com X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 X-amz-date: 20230117T123902Z

返回示例

登录后复制HTTP/1.1 200 OK
Content-length: 596
Content-type: application/xml
Date: Tue, 17 Jan 2023 12:39:03 GMT
x-amz-id-2: cbe62da76b7444cdb482b1b22b0a3845
x-amz-request-id: 0e6ba12d6a5f432ab2fe59a1fcb1bc3e

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
        <AllowedOrigin>http://www.example.com</AllowedOrigin>
        <AllowedHeader>*</AllowedHeader>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedMethod>POST</AllowedMethod>
        <AllowedMethod>DELETE</AllowedMethod>
        <ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
        <MaxAgeSeconds>3000</MaxAgeSeconds>
    </CORSRule>
    <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedHeader>Authorization</AllowedHeader>
        <AllowedMethod>GET</AllowedMethod>
        <MaxAgeSeconds>3000</MaxAgeSeconds>
    </CORSRule>
</CORSConfiguration>

HTTP/1.1 200 OK Content-length: 596 Content-type: application/xml Date: Tue, 17 Jan 2023 12:39:03 GMT x-amz-id-2: cbe62da76b7444cdb482b1b22b0a3845 x-amz-request-id: 0e6ba12d6a5f432ab2fe59a1fcb1bc3e <?xml version="1.0" encoding="UTF-8"?> <CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <CORSRule> <AllowedOrigin>http://www.example.com</AllowedOrigin> <AllowedHeader>*</AllowedHeader> <AllowedMethod>PUT</AllowedMethod> <AllowedMethod>POST</AllowedMethod> <AllowedMethod>DELETE</AllowedMethod> <ExposeHeader>x-amz-server-side-encryption</ExposeHeader> <MaxAgeSeconds>3000</MaxAgeSeconds> </CORSRule> <CORSRule> <AllowedOrigin>*</AllowedOrigin> <AllowedHeader>Authorization</AllowedHeader> <AllowedMethod>GET</AllowedMethod> <MaxAgeSeconds>3000</MaxAgeSeconds> </CORSRule> </CORSConfiguration>