功能描述
GET Bucket domain 请求用于查询存储桶的自定义域名配置。
注意
请求
请求示例
GET /?domain HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: GMT DateAuthorization: Auth String
说明
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com,其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字,例如 examplebucket-1250000000,可参阅 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档;<Region> 为 COS 的可用地域,可参阅 地域和访问域名 文档。
Authorization: Auth String(详情请参见 请求签名 文档)。
请求参数
此接口无请求参数。
请求头
请求体
此接口无请求体。
响应
响应头
响应体
查询成功,返回 application/xml 数据,包含完整的存储桶自定义域名信息。
<DomainConfiguration><DomainRule><Status>Enum</Status><Name>string</Name><Type>Enum</Type></DomainRule><DomainRule><Status>Enum</Status><Name>string</Name><Type>Enum</Type></DomainRule></DomainConfiguration>
具体的节点描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
DomainConfiguration | 无 | 保存 GET Bucket domain 结果的所有信息 | Container |
Container 节点 DomainConfiguration 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
DomainRule | DomainConfiguration | 域名条目 | Container |
Container 节点 DomainRule 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Status | DomainConfiguration.DomainRule | 是否启用。枚举值: ENABLED:启用 DISABLED:禁用 | Enum |
Name | DomainConfiguration.DomainRule | 完整域名 | string |
Type | DomainConfiguration.DomainRule | 源站类型。枚举值: REST:默认源站 WEBSITE:静态源站 ACCELERATE:全球加速源站 | Enum |
错误码
实际案例
请求
GET /?domain HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Wed, 29 Apr 2020 09:16:26 GMTAuthorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1588151786;1588158986&q-key-time=1588151786;1588158986&q-header-list=date;host&q-url-param-list=domain&q-signature=b5f4a4b7bd7bca2ade21503b8f64d512ef69****Connection: close
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 277Connection: closeDate: Wed, 29 Apr 2020 09:16:26 GMTServer: tencent-cosx-cos-domain-txt-verification: tencent-cloud-cos-verification=673029e5ff8e4d2b5723d58f73aab232x-cos-request-id: NWVhOTQ1ZWFfN2ViMTJhMDlfMjU5Zl8xMzQ1****<DomainConfiguration><DomainRule><Status>ENABLED</Status><Name>cos.cloud.tencent.com</Name><Type>REST</Type></DomainRule><DomainRule><Status>ENABLED</Status><Name>www.cos.cloud.tencent.com</Name><Type>WEBSITE</Type></DomainRule></DomainConfiguration>