Bucket跨域资源访问

更新时间：2026-09-23

应用场景

跨域资源共享（CORS）允许 Web 端的应用程序访问不属于本域的资源。BOS 提供接口方便开发者控制跨域访问的各种权限。

运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name（及其它占位符）替换为实际值。

设定 CORS 规则

如下代码设定了一个 CORS 规则：

                Python
                
            

                conf = {}
conf['allowedOrigins'] = ['http://www.boluor.com']
conf['allowedMethods'] = ['GET', 'HEAD', 'DELETE']
conf['allowedHeaders'] = ['Authorization', 'x-bce-test', 'x-bce-test2']
conf['allowedExposeHeaders'] = ['user-custom-expose-header']
conf['maxAgeSeconds'] = 3600

confs = []
# 每个 Bucket 最多允许有 100 条规则。
confs.append(conf)

response = bos_client.put_bucket_cors(bucket_name, confs)
print(response)
            

参数说明

参数	必填	说明
`bucket_name`	是	Bucket 名称。
`conf['allowedOrigins']`	是	允许跨域请求的来源域名列表，至少一个。每个条目最多包含一个通配符 `*`。
`conf['allowedMethods']`	是	允许的跨域请求方法列表，至少一个。取值只能为 `GET`、`PUT`、`HEAD`、`POST`、`DELETE`，其它值服务端返回 `InvalidArgument`。
`conf['allowedHeaders']`	否	允许浏览器在跨域请求中携带的请求头列表。每个条目最多包含一个通配符 `*`。
`conf['allowedExposeHeaders']`	否	允许浏览器从响应中读取的响应头列表。*不允许包含通配符 ``**。
`conf['maxAgeSeconds']`	否	浏览器缓存预检请求结果的时间，单位为秒，须为非负整数。
`confs`	是	CORS 规则列表，至少一条，每个 Bucket 最多 100 条规则。

调用成功后，BOS 对设置 CORS 规则的请求返回空响应体。可通过 get_bucket_cors 获取 Bucket 的 CORS 配置，确认规则是否已生效。

注意:

如果原规则存在则覆盖原规则。

只有 Bucket 的所有者和被授予 FULL_CONTROL 权限的用户才能设置 Bucket 的 CORS。没有权限时，返回 403 Forbidden 错误，错误码：AccessDenied。

CORS 规则相关参数的详细解释请参见 PutBucketCors 接口。

获取 Bucket 的 CORS 规则

如下代码可获取 Bucket 的 CORS 配置：

                Python
                
                response = bos_client.get_bucket_cors(bucket_name)
print(response.status_code)
print(response.cors_configuration)

参数说明

参数	必填	说明
`bucket_name`	是	Bucket 名称。

返回值说明：

返回值	说明
`response.status_code`	请求状态码。请求成功时通常为 `200`。
`response.cors_configuration`	Bucket 的 CORS 规则列表，包含 `allowedOrigins`、`allowedMethods`、`allowedHeaders`、`allowedExposeHeaders`、`maxAgeSeconds` 等配置项。

返回示例：

                JSON
                
            

                {
  "corsConfiguration": [
    {
      "allowedOrigins": [
        "http://www.boluor.com"
      ],
      "allowedMethods": [
        "GET",
        "HEAD",
        "DELETE"
      ],
      "allowedHeaders": [
        "Authorization",
        "x-bce-test",
        "x-bce-test2"
      ],
      "allowedExposeHeaders": [
        "user-custom-expose-header"
      ],
      "maxAgeSeconds": 3600
    }
  ]
}
            

关闭 Bucket 的 CORS 功能并清空所有规则

如下代码可以关闭 Bucket 的 CORS 功能并清空所有规则：

                Python
                
                response = bos_client.delete_bucket_cors(bucket_name)
print(response)

参数说明

参数	必填	说明
`bucket_name`	是	Bucket 名称。

调用成功后，Bucket 的 CORS 功能被关闭，已有 CORS 规则会被清空。删除后再次调用 get_bucket_cors 获取 CORS 配置时，如果服务端返回 NoSuchCORSConfiguration，表示当前 Bucket 不存在 CORS 配置。

评价此篇文章

有帮助没帮助

日志管理

数据同步

百度智能云

BOS 对象存储

BOS 对象存储

Bucket跨域资源访问

应用场景

设定 CORS 规则

获取 Bucket 的 CORS 规则

关闭 Bucket 的 CORS 功能并清空所有规则