注意事項

• 默認不開啟CORS

  Bucket默認不開啟CORS功能，所有跨域請求的Origin都不被允許。

• 覆蓋語義

  PutBucketCors為覆蓋語義，即新配置的CORS規則將覆蓋已有的CORS規則。

• 應用程序中使用CORS

  在應用程序中使用CORS功能時，需通過PutBucketCors接口手動上傳CORS規則來開啟CORS功能。

  例如從example.com通過瀏覽器的XMLHttpRequest功能來訪問OSS，需要通過本接口手動上傳CORS規則，且CORS規則需由XML文檔進行描述。

• CORS規則匹配

  當OSS收到一個跨域請求或OPTIONS請求，會先讀取Bucket對應的CORS規則，然后進行相應的權限檢查。OSS會依次檢查每一條規則，使用第一條匹配的規則來允許請求并返回對應的Header。如果所有規則都匹配失敗，則不附加任何CORS相關的Header。

  CORS規則匹配成功必須滿足以下三個條件：

  • 請求的Origin必須匹配一個AllowedOrigin項。

  • 請求的方法（例如GET、PUT等）或者OPTIONS請求的Access-Control-Request-Method頭對應的方法必須匹配一個AllowedMethod項。

  • OPTIONS請求的Access-Control-Request-Headers頭包含的每個header都必須匹配一個AllowedHeader項。

請求語法

PUT /?cors HTTP/1.1
Date: GMT Date
Content-Length：ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
    <CORSRule>
      <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 >

請求元素

此接口涉及的Host、Authorization等其他更多公共請求頭的更多信息，請參見公共請求頭（Common Request Headers）。

響應頭

此接口僅返回公共響應頭。更多信息，請參見公共響應頭（Common Response Headers）。

示例

• 請求示例

  PUT /?cors HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Content-Length: 186
  Date: Fri, 04 May 2012 03:21:12 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <?xml version="1.0" encoding="UTF-8"?>
  <CORSConfiguration>
      <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader>Authorization</AllowedHeader>
      </CORSRule>
      <CORSRule>
        <AllowedOrigin>http://example.com</AllowedOrigin>
        <AllowedOrigin>http://example.net</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader> Authorization</AllowedHeader>
        <ExposeHeader>x-oss-test</ExposeHeader>
        <ExposeHeader>x-oss-test1</ExposeHeader>
        <MaxAgeSeconds>100</MaxAgeSeconds>
      </CORSRule>
      <ResponseVary>false</ResponseVary>
  </CORSConfiguration >

• 返回示例

  HTTP/1.1 200 OK
  x-oss-request-id: 50519080C4689A033D0*****
  Date: Fri, 04 May 2012 03:21:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-server-time: 94

SDK

此接口所對應的各語言SDK如下：

• Java

• Python

• PHP

• Go

• C++

• C

• .NET

• Node.js

• Ruby

錯誤碼