对象存储
对象存储
对象存储
文档指南
请输入
产品动态
产品公告
产品计费
快速入门
用户指南
存储桶管理
基础设置
容错与容灾
ObjectSet
文件管理
监控与告警
权限配置
IAM 策略管理
典型配置场景
IAM 子用户授权
使用工具及 SDK 的授权说明
接入点
单区域接入点（SRAP）
内容感知与处理（SenseFlow）
TOS Agent
数据处理
分层命名空间（HNS）
TOS Vectors
API 参考
向量桶
SDK 参考
Python-Vectors
向量桶
向量索引
Java-Vectors
向量桶
向量索引
Node.js-Vectors
向量桶
向量索引
工具指南
tosutil
常用命令
辅助命令
TOS Browser
FSX
TOS PyTorch Connector
tosfsspec
API 参考
签名机制
存储桶
桶基础操作
自定义域名
数据处理
媒体处理
视频转码
音频转码
ObjectSet
生命周期
对象
基础操作
分片上传
SDK 参考
Java
存储桶接口
管理桶配置
ObjectSet
对象接口
下载对象
数据处理
视频处理
日志配置
分层命名空间
Python
数据处理
存储桶接口
对象接口
上传对象
C++
存储桶接口
对象接口
Go
对象接口
存储桶接口
管理桶配置
ObjectSet
数据处理
日志配置
Node.js
存储桶接口
对象接口
上传对象
数据处理
Browser.js
上传对象
.NET
对象接口
PHP
对象接口
异常处理
Android
对象接口
iOS
对象接口
Harmony
存储桶接口
对象接口
上传对象
Rust
存储桶接口
桶基础操作
桶清单
自定义域名
对象接口
基础操作
错误码
01-SERVICE_ERROR
02-AUTH
03-ACCESS_CONTROL
04-QOS
05-REQUEST
06-BUCKET
07-LIFECYCLE
08-ACL
09-CORS
10-POLICY
11-MIRROR
12-REPLICATION
13-WEBSITE
14-NOTIFICATION
15-ENCRYPT
16-CUSTOMDOMAIN
17-OBJECT
18-TAG
19-MULTIPART
20-STORAGE_CLASS
21-CALLBACK
22-DATA_PROCESS
23-BATCH
24-STORAGE_LENS
25-INVENTORY
26-DIRECTORY_BUCKET
32-WORM
常见问题
最佳实践
AIGC-豆包大模型最佳实践
校验数据一致性
- 文档首页
对象存储API 参考存储桶跨域资源共享PutBucketCORS
复制全文
下载 pdfPutBucketCORS
文档反馈
问问助手功能描述
此接口用于为存储桶（Bucket）设置跨域资源共享 CORS（Cross-Origin Resource Sharing）规则。您可以使用Content-MD5头带入期望的 MD5 值，与上传的对象的 MD5 值进行比较，如果不相等，则返回错误。
注意
- 如果您想要为桶设置跨域资源共享规则，您的账号必须具备 tos:PutBucketCORS 权限，具体操作请参见权限配置指南。
- TOS 支持设置多条 CORS 规则，但是所有规则大小总和不能超过 20KiB。
请求消息样式
PUT /?cors HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string
{
"CORSRules":[
{
"AllowedOrigins":["the origin you want allow CORS request from"],
"AllowedMethods":["HTTP method"],
"AllowedHeaders":["headers that allowed browser to send"],
"ExposeHeaders":["headers in response that can access from client app"],
"MaxAgeSeconds":1024,
"ResponseVary" : true
}
]
}
请求参数和消息头
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
cors | Query | String | 是 | - | 代表 PutBucketCORS 请求的特殊标识。 |
Content-MD5 | Header | String | 否 | XrY7u+Ae7tCTyyK7j1rNww== | 消息体的 Base64MD5 摘要。 |
请求元素
名称 | 参数类型 | 是否必选 | 示例值 | 说明 |
名称 | 参数类型 | 是否必选 | 示例值 | 说明 |
CORSRules | Array | 是 | - | CORS 规则信息。 |
AllowedOrigins | Array | 是 | ["*"] | 指定允许跨域请求的来源。约束如下：
|
AllowedMethods | Array | 是 | ["PUT", "GET"] | 指定允许的跨域请求方法，可指定一个或多个，包含 PUT、GET、POST、DELETE、HEAD。 |
AllowedHeaders | Array | 否 | ["Authorization"] | 指定允许跨域请求的响应头。约束如下：
|
ExposeHeaders | Array | 否 | ["x-tos-request-id"] | 指定 CORS 响应中携带的补充头域，以给客户端提供额外的信息。约束如下：
注意 通常建议添加 X-Tos-Request-Id 和 ETag 两个补充头域。 |
MaxAgeSeconds | Integer | 否 | 1024 | 指定客户端对 OPTIONS 请求返回结果的缓存时间，单位为秒，默认为 3600。 |
ResponseVary | Bool | 否 | false | 是否返回 Vary: Origin 头。
注意 启用返回Vary: Origin 后，可能会增加浏览次数或者 CDN 回源次数。 |
响应消息头
响应元素
该请求响应中无消息元素。
请求示例 1
为桶配置一个跨域访问 CORS 规则。
PUT /?cors HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string
{
"CORSRules":[
{
"AllowedOrigins":["*"],
"AllowedMethods":["PUT", "GET"],
"AllowedHeaders":["Authorization"],
"ExposeHeaders":["x-tos-request-id"],
"MaxAgeSeconds":1024
}
]
}
响应示例 1
HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444ed0
x-tos-request-id: f91b0c03a01300c1-a444ed0
Date: Fri, 30 Jul 2021 06:45:39 GMT
server: TosServer
Content-Length: 0
请求示例 2
为桶配置允许来自 http://www.example.com PUT 和 POST 请求跨域访问并启用返回Vary: Origin 头，其中 MaxAgeSeconds 允许避免浏览器为相同的请求发送 OPTION 请求。
PUT /?cors HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string
{
"CORSRules":[
{
"AllowedOrigins":["http://www.example.com"],
"AllowedMethods":["PUT", "GET"],
"AllowedHeaders":["*"],
"ExposeHeaders":["x-tos-request-id"],
"MaxAgeSeconds":1024,
"ResponseVary" : true
}
]
}
响应示例 2
HTTP/1.1 200 OK
x-tos-id-2: f91b0c03a01300c1-a444ed0
x-tos-request-id: f91b0c03a01300c1-a444ed0
Date: Fri, 30 Jul 2021 06:45:39 GMT
server: TosServer
Content-Length: 0
最近更新时间：2026.02.10 10:31:11
这个页面对您有帮助吗？
有用
有用
无用
无用