域名相关接口
更新时间：2025-08-21
查询用户域名
描述
- 查询用户账户下的所有域名信息
请求参数
| URI | GET /v1/domains |
| Query String | 无 |
| Request Body | 无 |
示例：
Plain Text
1GET /v1/domains HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z返回数据
JSON
1[
2 {
3 "domain": "www.test.com.123",
4 "CNAME": "www.test.com.123.baidu-itm.com", // 非ITM域名：空字符串；ITM域名：格式为xxx.xxx.baidu-itm.com
5 "status": "start", // 域名调度状态， "": 未调度；"start"：调度中；"stop"：停止调度（域名无法正常解析）；"pause"：暂停调度（域名使用上一次解析结果）
6 "monitorStatus": "ok", // "ok": 健康；"fail": 存在异常端点; "": 未知
7 "resourceStatus": "STARTED", // 域名资源状态：STARTED/STOPPED/DELETED
8 "hasDistribution": true // true: 有调度结果；false：无调度结果
9 },
10 {
11 "domain": "www.mydomain.com",
12 "CNAME": "",
13 "status": "start",
14 "monitorStatus": "ok",
15 "resourceStatus": "STARTED",
16 "hasDistribution": true
17 }
18]创建域名
描述
- 创建域名，并返回创建后的域名数据
请求参数
| URI | POST /v1/domains |
| Query String | 无 |
| Request Body | 详见下述实例 |
示例：
Plain Text
1POST /v1/domains HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z
5
6[
7 {
8 "domain": "www.test.com",
9 "isItmDomain": true // true: ITM域名；false: 非ITM域名
10 },
11 {
12 "domain": "www.mydomain.com",
13 "isItmDomain": false
14 }
15]返回数据
JSON
1[
2 {
3 "domain": "www.test.com.133", // 注：133是用户的ITM域名ID，用于ITM域名资源隔离。不同用户有着不同的ID
4 "isItmDomain": true
5 },
6 {
7 "domain": "www.mydomain.com",
8 "isItmDomain": false
9 }
10]删除域名
描述
- 删除指定的域名
请求参数
| URI | DELETE /v1/domains |
| Query String | 无 |
| Request Body | 详见下述实例 |
示例：
Plain Text
1POST /v1/domains HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z
5
6["www.mydomain.com"]返回数据
JSON
1null