在指定Bucket上设定一个跨域资源共享规则
所有文档

          对象存储 BOS

          在指定Bucket上设定一个跨域资源共享规则

          接口说明

          本接口用来在指定的Bucket上设定一个跨域资源共享(CORS)的规则,如果原规则存在则覆盖原规则。

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

          注意事项

          • 通过此接口设置CORS规则之前,Bucket的CORS权限设置为不允许跨域。
          • 每个Bucket最多只允许有一个规则文件,因此新上传的规则文件会覆盖原有的。
          • CORS规则文件大小限制为20KB,因此请求时大于20KB会返回超出大小错误(400 Bad Request: EntityTooLarge)。

          请求URI

          PUT /v1/{bucketName}/?cors

          参数名称 参数类型 是否必须 描述 示例值 参数位置
          bucketName String bucket的名称 "bucketName_example" Path

          请求体参数

          请求体字段数据结构说明

          参数名称 参数类型 是否必须 描述 示例值
          corsConfiguration List<CorsConfiguration> Bucket的CORS规则容器。每个Bucket 最多允许有100条规则。 如果有多条配置,执行顺序为从上到下。

          CorsConfiguration字段数据结构说明

          参数名称 参数类型 是否必须 描述 示例值
          allowedOrigins List<String> 存储允许的跨域请求的来源的容器。
          allowedMethods List<String> 存储允许的跨域请求方法的容器。
          allowedHeaders List<String> 存储允许的allowedHeaders容器。控制 在OPTIONS预取指令中Access-Control- Request-Headers头中指定的header是 否允许。
          allowedExposeHeaders List<String> 存储允许用户从应用程序中访问的响应头的容器。
          maxAgeSeconds Integer 指定浏览器对特定资源的预取(OPTIONS)请求返 回结果的缓存时间,在缓存时间内请求方不必发送重 复的preflight 请求,单位为秒。 类型:Int64。 1800

          响应体参数

          响应体字段数据结构说明

          请求示例

          PUT /v1/bucketName_example/?cors
          <公共请求头>
          
          
          {
            "corsConfiguration" : [ {
              "allowedExposeHeaders" : [ "user-custom-expose-header" ],
              "allowedOrigins" : [ "http://www.example.com" ],
              "allowedHeaders" : [ "Authorization" ],
              "allowedMethods" : [ "GET" ],
              "maxAgeSeconds" : 1800
            } ]
          }

          响应示例

          HTTP/1.1 200 OK
          <公共响应头>
          
          { }

          错误码

          请参考通用错误码

          上一篇
          数据加密
          下一篇
          获取指定Bucket上设定一个跨域资源共享规则