端点相关接口
更新时间：2025-08-21
查询域名的端点
描述
- 查询指定域名的端点信息
请求参数
| URI | GET /v1/endpoints |
| Query String | domain: 指定的域名 |
| Request Body | 无 |
示例：
Plain Text
1GET /v1/endpoints?domain=www.mydomain.com HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z返回数据
JSON
1[
2 {
3 "domain": "www.mydomain.com",
4 "endpoint": "1.1.1.1",
5 "type": "A", // 端点类型：A, CNAME
6 "area": "beijing.CN", // 端点所属地域，取值详见本文档的附录
7 "isp": "ct", // 端点所属运营商，取值详见本文档的附录
8 "tag": "", // 端点标签，可为空
9 "status": "ok" // 端点监控状态，ok: 健康；fail: 异常；unknown: 未知
10 }
11]添加域名的端点
描述
- 为指定域名添加端点
请求参数
| URI | POST /v1/endpoints |
| Query String | 无 |
| Request Body | 详见下述实例 |
示例：
Plain Text
1POST /v1/endpoints HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z
5
6[
7 {
8 "domain": "www.mydomain.com",
9 "endpoint": "1.1.1.1",
10 "type": "A", // 端点类型：A, CNAME
11 "area": "beijing.CN", // 端点所属地域，取值详见本文档的附录
12 "isp": "ct", // 端点所属运营商，取值详见本文档的附录
13 "tag": "" // 端点标签，可为空
14 }
15]返回数据
JSON
1null修改域名的端点
描述
- 修改指定域名的端点信息
请求参数
| URI | PUT /v1/endpoints |
| Query String | 无 |
| Request Body | 详见下述实例 |
示例：
Plain Text
1PUT /v1/endpoints 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 "endpoint": "1.1.1.1",
10 "area": "beijing.CN", // 端点所属地域，取值详见附录
11 "type": "A", // 端点类型：A, CNAME
12 "isp": "ct", // 端点所属运营商，ct: 电信；cu: 联通；cm: 移动；other: 其他运营商
13 "tag": "" // 端点标签，可为空
14 }
15]返回数据
JSON
1null删除域名的端点
描述
-
删除指定域名的端点
- 注：当端点在域名的调度策略中使用时，无法将其删除
请求参数
| URI | DELETE /v1/endpoints |
| Query String | 无 |
| Request Body | 详见下述实例 |
示例：
Plain Text
1DELETE /v1/endpoints HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z
5
6[
7 {
8 "domain": "www.mydomain.com",
9 "endpoint": "1.1.1.1"
10 }
11]返回数据
JSON
1null删除域名的端点，并重新生成默认调度策略
描述
-
删除指定域名的端点
-
注：
- 1.当端点在域名的调度策略中使用时，将其从策略中去除 & 重新生成策略，最后删除端点
- 2.可以删除多个端点，但要求待删除端点的域名相同
-
请求参数
| URI | DELETE /v1/endpoints/del-with-regen-strategy |
| Query String | 无 |
| Request Body | 详见下述实例 |
示例：
Plain Text
1DELETE /v1/endpoints/del-with-regen-strategy HTTP/1.1
2Host: itm.baidubce.com
3Authorization: authorization string
4x-bce-date: 2022-11-18T06:22:24Z
5
6[
7 {
8 "domain": "www.mydomain.com",
9 "endpoint": "1.1.1.1"
10 }
11]返回数据
JSON
1null附录
端点所属运营商、地域
运营商
| 名称 | 中文名称 |
|---|---|
| ct | 电信 |
| cu | 联通 |
| cm | 移动 |
| cernet | 教育网 |
| other | 其他 |
地域
| 名称 | 中文名称 |
|---|---|
| chongqing.CN | 重庆 |
| henan.CN | 河南 |
| hunan.CN | 湖南 |
| jilin.CN | 吉林 |
| ningxia.CN | 宁夏 |
| qinghai.CN | 青海 |
| shaanxi.CN | 陕西 |
| hubei.CN | 湖北 |
| xinjiang.CN | 新疆 |
| tianjin.CN | 天津 |
| shanxi.CN | 山西 |
| hebei.CN | 河北 |
| liaoning.CN | 辽宁 |
| shanghai.CN | 上海 |
| guangxi.CN | 广西 |
| jiangsu.CN | 江苏 |
| jiangxi.CN | 江西 |
| gansu.CN | 甘肃 |
| xizang.CN | 西藏 |
| yunnan.CN | 云南 |
| shandong.CN | 山东 |
| neimenggu.CN | 内蒙古 |
| anhui.CN | 安徽 |
| zhejiang.CN | 浙江 |
| hainan.CN | 海南 |
| heilongjiang.CN | 黑龙江 |
| guizhou.CN | 贵州 |
| guangdong.CN | 广东 |
| fujian.CN | 福建 |
| sichuan.CN | 四川 |
| beijing.CN | 北京 |
| none.abroad | 海外 |
| none.CN | 其他 |