更新时间:2026-07-13 GMT+08:00
设置桶的CORS配置
功能介绍
设置桶的CORS配置,以允许客户端浏览器进行跨域请求。
接口约束
- 您必须是桶拥有者或拥有设置桶的CORS配置的权限,才能设置桶的CORS规则。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketCORS权限,如果使用桶策略则需授予PutBucketCORS权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策略。
命令结构
- Windows操作系统
obsutil cors obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- macOS/Linux操作系统
./obsutil cors obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
运行示例
- 以Windows操作系统为例,运行obsutil cors obs://test-bucket -method=put -localfile=d:\temp\cors.xml,指定给桶test-bucket设置桶的CORS配置。
obsutil cors obs://test-bucket -method=put -localfile=d:\temp\cors.xml Start at 2024-09-30 07:59:28.8675681 +0000 UTC Put cors configuration succeed for bucket [test-bucket], requestId is [00000199765243C44018D688E9F5CFF5]
参数说明
| 参数 | 约束 | 描述 |
|---|---|---|
| bucket | 必选 | 桶名。 |
| method | 必选 | 指定方法,设置桶的CORS时该值为put。 |
| localfile | 必选 | 指定CORS配置文件。 |
| config | 附加参数,可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。 |
| e | 附加参数,可选 | 指定终端节点。 |
| i | 附加参数,可选 | 指定用户的AK。 |
| k | 附加参数,可选 | 指定用户的SK。 |
| t | 附加参数,可选 | 指定用户的securitytoken。 |
相关链接
- 关于设置桶的CORS配置的API说明,请参见设置桶的CORS配置。
- 设置桶的CORS配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。
父主题: 桶相关命令