文档中心 > PutBucketCORS
PutBucketCORS

最近更新时间:2021-12-24

使用PutBucketCORS接口设置Bucket的CORS配置。如果存在,就覆盖该配置。

这个配置设置的目的是为了服务跨源请求。


请求

请求语法

PUT /?cors HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Content-Length: length

Date: date

Authorization: authorization string

Content-MD5: MD5

 

<CORSConfiguration>

  <CORSRule>

    <AllowedOrigin>Origin you want to allow cross-domain requests from</AllowedOrigin>

    <AllowedOrigin>...</AllowedOrigin>

    ...

    <AllowedMethod>HTTP method</AllowedMethod>

    <AllowedMethod>...</AllowedMethod>

    ...

    <MaxAgeSeconds>Time in seconds your browser to cache the pre-flight OPTIONS response for a resource</MaxAgeSeconds>

    <AllowedHeader>Headers that you want the browser to be allowed to send</AllowedHeader>

    <AllowedHeader>...</AllowedHeader>

     ...

    <ExposeHeader>Headers in the response that you want accessible from client application</ExposeHeader>

    <ExposeHeader>...</ExposeHeader>

     ...

  </CORSRule>

  <CORSRule>

    ...

  </CORSRule>

    ...

</CORSConfiguration>

请求参数

参数

描述

Content-MD5

base64编码的128位MD5数据。

CORSConfiguration

包含最多100个CORSRules的容器。

CORSRule

一组源和方法。最多设置100个规则。

ID

规则标识符。

AllowedMethod

允许源执行的一个HTTP方法。

AllowedOrigin

一个允许跨源请求的源。

AllowedHeader

标识通过Access-Control-Request-Headers过来的OPTIONS请求中包含了哪些header。

MaxAgeSeconds

浏览器为指定请求缓存响应的时间,单位秒。

ExposeHeader

为了用户访问应用程序依赖更多的header。


示例

请求示例

PUT /?cors HTTP/1.1

Host: test.oss-cn-north-1.unicloudsrv.com

x-amz-date: Tue, 21 Aug 2012 17:54:50 GMT

Content-MD5: 8dYiLewFWZyGgV2Q5FNI4W==

Authorization: authorization string

Content-Length: 216

 

<CORSConfiguration>

 <CORSRule>

   <AllowedOrigin>http://www.example.com</AllowedOrigin>

   <AllowedMethod>PUT</AllowedMethod>

   <AllowedMethod>POST</AllowedMethod>

   <AllowedMethod>DELETE</AllowedMethod>

   <AllowedHeader>*</AllowedHeader>

   <MaxAgeSeconds>3000</MaxAgeSec>

   <ExposeHeader>x-amz-server-side-encryption</ExposeHeader>

 </CORSRule>

 <CORSRule>

   <AllowedOrigin>*</AllowedOrigin>

   <AllowedMethod>GET</AllowedMethod>

   <AllowedHeader>*</AllowedHeader>

   <MaxAgeSeconds>3000</MaxAgeSeconds>

 </CORSRule>

</CORSConfiguration>

返回示例

HTTP/1.1 200 OK

x-amz-id-2: CCshOvbOPfxzhwOADyC4qHj/Ck3F9Q0viXKw3rivZ+GcBoZSOOahvEJfPisZB7B

x-amz-request-id: BDC4B83DF5096BBE

Date: Tue, 21 Aug 2012 17:54:50 GMT

Server: nginx