更新时间: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错误码

相关文档