最近更新时间:2023-08-28 14:25:14
调用该接口可以为指定的Bucket设置跨域资源共享(CORS)规则。
ks3:PutBucketCORS
权限。Bucket的Owner默认具有所有权限,并且可以授予他人任意权限。http://www.example.com
以XMLHttpRequest的方式请求你在KS3的某个空间,可以通过此操作实现。以下关于存储桶的CORS配置包含两个规则:
https://www.example.com
源地址的跨域PUT、POST和DELETE请求。该规则还通过Access-Control-Request-Headers
标头允许预检OPTIONS请求中的所有标头。作为对任何预检OPTIONS请求的响应,KS3将返回请求的任意标头。<CORSConfiguration>
<CORSRule>
<AllowedOrigin>http://www.example.com</AllowedOrigin>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>DELETE</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
</CORSRule>
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
</CORSRule>
</CORSConfiguration>
用户可以通过其他可选参数来对某个空间进行CORS配置。例如,设置允许源地址http://www.example.com
使用PUT和POST发送跨域资源共享请求。
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>http://www.example.com</AllowedOrigin>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
<ExposeHeader>x-kss-server-side-encryption</ExposeHeader>
</CORSRule>
</CORSConfiguration>
以上配置中,CORSRule包含以下可选参数:
当KS3收到针对某一空间的跨域请求,它会根据设定的跨域资源共享规则来进行匹配,为了能够正常匹配,用户提交的规则配置必须满足以下条件。
PUT /?cors HTTP/1.1
Host: {BucketName}.{endpoint}
Content-Length: {length}
Date: {date}
Authorization: {SignatureValue}
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>
注意:
该接口不使用请求参数。
该接口仅使用常用请求头部。
名称 | 描述 | 是否必选 |
---|---|---|
CORSConfiguration | 包含CORSRules元素的容器,元素上限为100。 类型: Container 子节点: CORSRules 父节点: 无 |
是 |
CORSRule | 源与方法的集合,最多可以配置100条规则。 类型: Container 子节点: AllowedOrigin, AllowedMethod, MaxAgeSeconds, ExposeHeader, ID. 父节点: CORSConfiguration |
是 |
AllowedMethod | 用户允许源所能执行的HTTP方法,每一条CORSRule必须定义至少一个源地址和一种方法。 类型: Enum (GET, PUT, HEAD, POST, DELETE) 父节点: CORSRule |
是 |
AllowedOrigin | 用户允许跨域资源共享访问的源地址,其最多含有一个"*"通配符。每一条CORSRule必须定义至少一个源地址和一种方法。例如:http://*.example.com 。另外,你可以使用’*'来代表全部源。类型: String 父节点: CORSRule |
是 |
AllowedHeader | 指明在预检OPTION中通过 Access-Control-Request-Headers 哪些头部是可以使用的。每一个在 Access-Control-Request-Headers 中指定的头部必须要与发送到KS3请求的头部保持一致,最多使用一个’*’。类型: String 父节点: CORSRule |
是 |
MaxAgeSeconds | 指定在KS3针对特定资源的预检OPTIONS请求作出响应后,浏览器缓存该响应的时间。 类型: Integer (seconds) 父节点: CORSRule |
否 |
ExposeHeader | 识别可允许客户从应用程序(例如,从JavaScript XMLHttpRequest 数据元)进行访问的响应标头。类型: String 父节点: CORSRule |
否 |
该接口仅返回常用响应头部。
该接口不返回响应内容。
该接口不返回特殊错误。
PUT /?cors HTTP/1.1
Content-MD5: /QO8JEkpekFaAuWWEKS7Fg==
Date: Thu, 15 Jun 2017 02:32:02 GMT
Authorization: authorization string
Content-Length: 652
Host: ks3-example.ks3-cn-beijing.ksyun.com
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedMethod>GET</AllowedMethod>
<AllowedOrigin>http://baidu.com</AllowedOrigin>
<AllowedHeader>*</AllowedHeader>
</CORSRule>
<CORSRule>
<AllowedMethod>POST</AllowedMethod>
<AllowedOrigin>http://*ks3.ksyun.com</AllowedOrigin>
<AllowedOrigin>https://*ks3.console.ksyun.com</AllowedOrigin>
<AllowedOrigin>https://*ks3.ksyun.com</AllowedOrigin>
<AllowedOrigin>https://www.example.com</AllowedOrigin>
<AllowedOrigin>http://*ks3.console.ksyun.com</AllowedOrigin>
<AllowedHeader>*</AllowedHeader>
</CORSRule>
</CORSConfiguration>
HTTP/1.1 200 OK
Server: KS3
Date: Thu, 15 Jun 2017 02:32:56 GMT
Content-Length: 0
X-Application-Context: application
x-kss-request-id: 94def5b819f74135a1df54e6cf422f64
纯净模式