获取桶的跨域资源共享CORS规则
此 GET 操作用于获取指定存储空间(Bucket)当前的跨域资源共享CORS(Cross-Origin Resource Sharing)规则。
请求
请求语法
内容
GET /?cors HTTP/1.1 Host: {BucketName}.{Endpoint} Content-Length: {length} Date: {date} Authorization: {SignatureValue}
描述
Endpoint:参考与region地域的关系 SignatureValue:参考签名算法
请求参数
无
非公共请求头
无
请求体
无
响应
非公共响应头
无
响应体
<?xml version="1.0" encoding="UTF-8"?>
<CORSRule> <ID>the CORS rule ID</ID> <AllowedOrigin>the origin you want allow CORS request from</AllowedOrigin> <AllowedOrigin>…</AllowedOrigin> <AllowedMethod>HTTP method</AllowedMethod> <AllowedMethod>…</AllowedMethod> <AllowedHeader> headers that allowed browser to send</AllowedHeader> <AllowedHeader>…</AllowedHeader> <ExposeHeader> headers in response that can access from client app</ExposeHeader> <ExposeHeader>…</ExposeHeader> <MaxAgeSeconds>time to cache pre-fight response</MaxAgeSeconds> </CORSRule> <CORSRule> … </CORSRule> …
</CORSConfiguration >
示例
请求
Get /?cors HTTP/1.1 Host: oss-example.oss-cn-beijing.inspurcloud.com Authorization: authorization string Content-Length: {length} Date: Wed, 29 Oct 2020 22:32:00 GMT
响应
HTTP/1.1 200 OK Date: Wed, 29 Oct 2020 22:32:00 GMT Content-Length: {length} Connection: keep-alive <?xml version="1.0" encoding="UTF-8"?> <CORSConfiguration> <CORSRule> <ID>123</ID> <AllowedOrigin>*</AllowedOrigin> <AllowedMethod>GET</AllowedMethod> <AllowedHeader>*</AllowedHeader> <ExposeHeader>x-oss-test</ExposeHeader> <MaxAgeSeconds>100</MaxAgeSeconds> </CORSRule> </CORSConfiguration>
错误码
错误码 | 状态码 | 描述 |
---|---|---|
NoSuchBucket | 404 | 目标Bucket不存在。 |
NoSuchCORSConfiguration | 404 | 目标CORS规则不存在。 |
AccessDenied | 403 | 只有Bucket的拥有者才能获取CORS规则。 |