金山云-文档中心-GET Bucket CORS

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Bucket相关

跨域资源共享（CORS）

GET Bucket CORS

最近更新时间：2026-06-29 16:30:18



描述

返回用户 Bucket (空间)的 CORS （跨域资源共享）信息。

使用此接口，您需要拥有执行ks3:GetBucketCORS操作的权限。空间拥有者默认具有此权限，并且可以授予他人相应权限。

请求

语法

GET /?cors HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

Endpoint与Region对应关系

SignatureValue签名算法

请求参数

该请求不使用请求参数。

请求头部

该接口仅使用常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口仅使用常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

名称	描述
CORSConfiguration	包含 `CORSRules` 元素的容器，元素上限为100。类型: Container 子节点: CORSRules 父节点: 无
CORSRule	源与方法的集合，最多可以配置100条规则。类型: Container 子节点: AllowedOrigin, AllowedMethod, MaxAgeSeconds, ExposeHeader, ID. 父节点: CORSConfiguration
AllowedMethod	用户允许源所能执行的 `HTTP` 方法，每一条 `CORSRule` 必须定义至少一个源地址和一种方法。类型: Enum (GET, PUT, HEAD, POST, DELETE) 父节点: CORSRule
AllowedOrigin	用户允许跨域资源共享访问的源地址，其最多含有一个"“通配符。每一条 `CORSRule` 必须定义至少一个源地址和一种方法。例如：`http://.example.com`。另外，你可以使用”*"来代表全部源。类型: String 父节点: CORSRule
AllowedHeader	指明在预检OPTION中通过 `Access-Control-Request-Headers` 哪些头部是可以使用的。每一个在 `Access-Control-Request-Headers` 中指定的头部必须要与发送到KS3请求的头部保持一致，最多使用一个"*" 类型: String 父节点: CORSRule
MaxAgeSeconds	指定在 KS3 针对特定资源的预检 OPTIONS 请求作出响应后，浏览器缓存该响应的时间。一个 `CORSRule` 最多有一个 `MaxAgeSeconds` 元素. 类型: Integer (seconds) 父节点: CORSRule
ExposeHeader	识别可允许客户从应用程序（例如，从 `JavaScript XMLHttpRequest` 数据元）进行访问的响应标头。类型: String 父节点: CORSRule
NonCrossOriginResponseVary	设置非跨域请求是否返回Vary: Origin头。父节点：CORSConfiguration 取值范围如下： true：无论跨域或非跨域请求，均会返回Vary: Origin头 false（默认）：仅跨域请求返回Vary: Origin头，非跨域请求不返回Vary: Origin头 1. 此字段不能单独配置，必须至少配置一项跨域规则才能生效。 2. 如果浏览器同时存在跨域和非跨域请求，建议启用该选项，否则可能会出现跨域问题。注意开启后可能会造成浏览器访问或CDN回源增加。

特殊错误

该接口不返回错误代码。

示例

请求示例

GET /?cors HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Wed, 24 Dec 2014 03:08:04 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Wed, 24 Dec 2014 03:08:04 GMT
Server: KS3
Content-Type: application/xml
x-kss-request-id: d72a2c2be3ec42aebf5b8c395b6cb8e7

<ns2:CORSConfiguration>
    <CORSRule>
        <AllowedOrigin>http://www.example.com</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <MaxAgeSeconds>3000</MaxAgeSeconds>
        <ExposeHeader>x-kss-server-side-encryption</ExposeHeader>
    </CORSRule>
    <NonCrossOriginResponseVary>false</NonCrossOriginResponseVary>
</ns2:CORSConfiguration>

文档导读

上一篇：PUT Bucket CORS

下一篇：OPTIONS Object

纯净模式常规模式

纯净模式

点击可全屏预览文档内容