PutBucketCORS
更新时间 2026-04-10 20:09:09
最近更新时间: 2026-04-10 20:09:09
功能说明
PutBucketCORS用来请求设置桶的跨域资源共享权限。
请求消息样式
PUT /{Bucket}?cors HTTP/1.1
Host: xxxx.zos.ctyun.cn
x-amz-date: Date
x-amz-content-sha256: Content-SHA256
Authorization: Auth String
Content-Length: ContentLength
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedHeader>string</AllowedHeader>
...
<AllowedMethod>string</AllowedMethod>
...
<AllowedOrigin>string</AllowedOrigin>
...
<ExposeHeader>string</ExposeHeader>
...
<ID>string</ID>
<MaxAgeSeconds>integer</MaxAgeSeconds>
</CORSRule>
...
</CORSConfiguration>请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| CORSConfiguration | 参数解释: 描述存储桶中对象的跨源访问配置。 | Container | 是 |
表CORSConfiguration
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| CORSRule | 参数解释: 为指定bucket配置的所有跨域规则的集合。 约束限制: 最多允许配置100条规则。 | Contanier | 是 |
表CORSRule
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| ID | 参数解释: 跨域规则的ID。 约束限制: 最长长度为255个字符。 | String | 否 |
| AllowedHeader | 参数解释: 允许浏览器发送CORS请求时携带的自定义HTTP请求头部。 约束限制: 不区分英文大小写,单条CORSRule可以配置多个AllowedHeader。 | String | 否 |
| AllowedMethod | 参数解释: 允许该源执行的HTTP方法列表。 约束限制: 只能填入GET、PUT、HEAD、POST和DELETE,单条规则可以配置多个方法。 | String | 是 |
| AllowedOrigin | 参数解释: 允许能够访问该bucket的一个或多个源,支持 * 通配符,表示所有域名都允许访问,不推荐。 约束限制: 一条CORSRule可以配置多个AllowedOrigin。 | String | 是 |
| ExposeHeader | 参数解释: 允许浏览器获取的CORS请求响应中的头部。 约束限制: 不区分英文大小写,单条CORSRule可以配置多个 ExposeHeader。 | String | 否 |
| MaxAgeSeconds | 参数解释: 跨域资源共享配置的有效时间,单位为秒,对应CORS请求响应中的Access-Control-Max-Age头部。 约束限制: 单条CORSRule只能配置一个MaxAgeSeconds。 | Integer | 否 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: Request Id
Content-Type: ContentType
Content-Length: ContentLength
Date: Date
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。