更新时间:2025-08-22 GMT+08:00

获取桶的自定义域名

功能介绍

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

要使用该接口,使用者要求必须是桶的所有者,或者是桶所有者的子用户且具有获取自定义域名的权限。

请求消息样式

1
2
3
4
5
6
GET /?customdomain HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.myhuaweicloud.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.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Domains>
    <DomainName>domainname</DomainName>
    <CreateTime>createtime</CreateTime>
  </Domains>
</ListBucketCustomDomainsResult>

响应消息头

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

响应消息元素

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

表1 响应消息元素

参数

参数类型

描述

ListBucketCustomDomainsResult

Container

参数解释:

自定义域名返回结果容器。ListBucketCustomDomainsResult是Domains的父节点。

取值范围:

不涉及

Domains

Container

参数解释:

自定义域名元素。

取值范围:

请详见Domains参数说明

表2 Domains参数说明

参数

参数类型

描述

DomainName

String

参数解释:

自定义域名。

取值范围:

长度为0~256的字符串。

CreateTime

String

参数解释:

自定义域名的创建时间。

取值范围:

  • 格式要求为UTC时间,并符合ISO 8601标准。例如:2018-01-01T00:00:00.000Z,表示创建时间为2018-01-01T00:00:00.000Z。
  • 长度为24的字符串。

错误响应消息

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

请求示例

1
2
3
4
5
6
GET /?customdomain HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.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.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Domains>
    <DomainName>obs.ccc.com</DomainName>
    <CreateTime>2019-03-13T10:22:05.912Z</CreateTime>
  </Domains>
</ListBucketCustomDomainsResult>