获取桶的跨域资源共享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规则。