更新时间:2026-03-13 GMT+08:00
分享

obs_bucket_cors_conf

表1 obs_bucket_cors_conf

参数名称

参数类型

是否必选

描述

id

const char *

可选

参数解释:

一条CORS规则的标识。

约束限制:

取值范围:

1~255个字符的字符串组成。

默认取值:

allowed_method

const char **

必选

参数解释

指定允许的跨域请求HTTP方法,即桶和对象的几种操作类型。

约束限制:

取值范围:

支持以下HTTP方法:

  • GET
  • PUT
  • HEAD
  • POST
  • DELETE

默认取值:

allowed_method_number

unsigned int

可选

参数解释

allowed_method的元素数量。

约束限制:

取值范围:

默认取值:

allowed_origin

const char **

可选

参数解释:

指定允许的跨域请求的来源,即允许来自该域名下的请求访问该桶。

约束限制:

表示域名的字符串,仅支持英文域名。通过正则表达式进行匹配,每个匹配规则允许使用最多一个“*”通配符。例如:https://*.vbs.example.com。

取值范围:

符合CORS协议的取值范围,长度为[0-20480]个字符。

默认取值:

allowed_origin_number

unsigned int

可选

参数解释

allowed_origin的元素数量。

约束限制:

取值范围:

默认取值:

allowed_header

const char **

可选

参数解释:

指定允许的跨域请求的头域。配置CORS请求中允许携带的“Access-Control-Request-Headers”头域。如果一个请求带了“Access-Control-Request-Headers”头域,则只有匹配上AllowedHeader中的配置才认为是一个合法的CORS请求(通过正则表达式进行匹配)。

约束限制:

最多可填写一个“*”通配符,不支持&、:、<、空格以及中文字符。

取值范围:

符合CORS协议的取值范围,长度为[0-20480]个字符。

默认取值:

allowed_header_number

unsigned int

可选

参数解释

allowed_header的元素数量。

约束限制:

取值范围:

默认取值:

max_age_seconds

const char *

可选

参数解释:

请求来源的客户端可以对跨域请求返回结果的缓存时间。

约束限制:

每个CORSRule可以包含至多一个max_age_seconds。

取值范围:

大于等于0的整型数,单位:秒。

默认取值:

3000

expose_header

const char **

可选

参数解释:

CORS规则允许响应中可返回的附加头域,给客户端提供额外的信息。默认情况下浏览器只能访问以下头域:Content-Length、Content-Type,如果需要访问其他头域,需要在附加头域中配置。

约束限制:

不支持*、&、:、<、空格以及中文字符。

取值范围:

符合CORS协议的取值范围。

默认取值:

expose_header_number

unsigned int

可选

参数解释

expose_header的元素数量。

约束限制:

取值范围:

默认取值:

相关文档