文档首页/ 对象存储服务 OBS/ API参考（安卡拉区域）/ API/ 桶的高级配置/ 获取桶的自定义域名
更新时间：2024-04-15 GMT+08:00
查看PDF
分享

获取桶的自定义域名

功能介绍

OBS使用GET操作来获取桶的自定义域名。

请求消息样式

1
2
3
4
5
6
 
GET /?customdomain HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.example.com
Accept: */*
Date: date
Authorization: authorization string

请求参数

该请求消息中不使用请求消息参数。

请求消息头

该请求使用公共消息头，具体参见表3。

请求消息元素

此请求消息中不使用消息元素。

响应消息样式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: request id
x-obs-id-2: id
Content-Type: application/xml
Date: date
Content-Length: 272

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListBucketCustomDomainsResult xmlns="http://obs.example.com/doc/2015-06-30/">
  <Domains>
    <DomainName>domainname</DomainName>
    <CreateTime>createtime</CreateTime>
  </Domains>
</ListBucketCustomDomainsResult>

响应消息头

该请求的响应消息使用公共消息头，具体请参考表1。

响应消息元素

该响应以消息元素的形式返回桶的自定义域名，元素的具体意义如表1响应消息元素所示。

表1 响应消息元素

元素名称

描述

ListBucketCustomDomainsResult

自定义域名返回结果容器。

类型：Container

子节点：Domains

父节点：无

Domains

自定义域名元素。

类型：Container

子节点：DomainName、CreateTime

父节点：ListBucketCustomDomainsResult

DomainName

自定义域名。

类型：String

子节点：无

父节点:：Domains

CreateTime

自定义域名创建时间。

类型：String，UTC时间

子节点：无

父节点:：Domains

错误响应消息

无特殊错误，所有错误已经包含在表2中。

请求示例

1
2
3
4
5
6
 
GET /?customdomain HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.example.com
Accept: */*
Date: Mon, 14 Jan 2019 08:31:45 +0000
Authorization: OBS UDSIAMSTUBTEST000094:veTm8B18MPLFqNyGh2wmQqovZ2U=

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 000001697693130C80E9D2D29FA84FC2
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSM80AI9weqGUsIFJScVxSKlG4DmypX9
Content-Type: application/xml
Date: Wed, 13 Mar 2019 10:22:24 GMT
Content-Length: 272

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListBucketCustomDomainsResult xmlns="http://obs.example.com/doc/2015-06-30/">
  <Domains>
    <DomainName>obs.ccc.com</DomainName>
    <CreateTime>2019-03-13T10:22:05.912Z</CreateTime>
  </Domains>
</ListBucketCustomDomainsResult>
父主题： 桶的高级配置