GetBucketCORS--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

GetBucketCORS

最近更新时间：2024.08.01 20:30:29首次发布时间：2023.03.14 21:02:15

功能描述

此接口用于获取指定存储桶（Bucket）当前的跨域资源共享 CORS（Cross-Origin Resource Sharing）的配置规则。

注意

要获取桶的跨域资源共享规则，您的账号必须具备 tos:GetBucketCORS权限，具体操作请参见权限配置指南。

请求消息样式

GET /?cors HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
cors	Query	String	是	-	代表 GetBucketCORS 请求的特殊标识。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求返回当前存储空间（Bucket）配置的 CORS（Cross-Origin Resource Sharing）所有规则。

名称	参数类型	示例值	说明
CORSRules	Array	-	CORS 规则信息。
AllowedOrigins	Array	["*"]	允许跨域请求的来源。
AllowedMethods	Array	["PUT", "GET"]	允许的跨域请求方法。
AllowedHeaders	Array	["Authorization"]	允许的请求头。
ExposeHeaders	Array	["x-tos-test"]	允许的响应头。
MaxAgeSeconds	Integer	1024	最大的缓存时间。
ResponseVary	Bool	false	是否返回 `Vary: Origin` 头。

请求示例

GET /?cors HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 13:53:55 +0000
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2021 13:53:55 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0
Content-Length: 643

{
    "CORSRules":[
        {
            "AllowedOrigins":["http://www.example.com"],
            "AllowedMethods":["PUT", "GET"],
            "AllowedHeaders":["*"],
            "ExposeHeaders":["x-tos-test"],
            "MaxAgeSeconds":1024,
            "ResponseVary" : false
        }
    ]
}