端点相关接口
更新时间:2024-11-29
查询域名的端点
描述
- 查询指定域名的端点信息
请求参数
URI | GET /v1/endpoints |
Query String | domain: 指定的域名 |
Request Body | 无 |
示例:
GET /v1/endpoints?domain=www.mydomain.com HTTP/1.1
Host: itm.baidubce.com
Authorization: authorization string
x-bce-date: 2022-11-18T06:22:24Z
返回数据
[
{
"domain": "www.mydomain.com",
"endpoint": "1.1.1.1",
"type": "A", // 端点类型:A, CNAME
"area": "beijing.CN", // 端点所属地域,取值详见本文档的附录
"isp": "ct", // 端点所属运营商,取值详见本文档的附录
"tag": "", // 端点标签,可为空
"status": "ok" // 端点监控状态,ok: 健康;fail: 异常;unknown: 未知
}
]
添加域名的端点
描述
- 为指定域名添加端点
请求参数
URI | POST /v1/endpoints |
Query String | 无 |
Request Body | 详见下述实例 |
示例:
POST /v1/endpoints HTTP/1.1
Host: itm.baidubce.com
Authorization: authorization string
x-bce-date: 2022-11-18T06:22:24Z
[
{
"domain": "www.mydomain.com",
"endpoint": "1.1.1.1",
"type": "A", // 端点类型:A, CNAME
"area": "beijing.CN", // 端点所属地域,取值详见本文档的附录
"isp": "ct", // 端点所属运营商,取值详见本文档的附录
"tag": "" // 端点标签,可为空
}
]
返回数据
null
修改域名的端点
描述
- 修改指定域名的端点信息
请求参数
URI | PUT /v1/endpoints |
Query String | 无 |
Request Body | 详见下述实例 |
示例:
PUT /v1/endpoints HTTP/1.1
Host: itm.baidubce.com
Authorization: authorization string
x-bce-date: 2022-11-18T06:22:24Z
[
{
"domain": "www.test.com",
"endpoint": "1.1.1.1",
"area": "beijing.CN", // 端点所属地域,取值详见附录
"type": "A", // 端点类型:A, CNAME
"isp": "ct", // 端点所属运营商,ct: 电信;cu: 联通;cm: 移动;other: 其他运营商
"tag": "" // 端点标签,可为空
}
]
返回数据
null
删除域名的端点
描述
-
删除指定域名的端点
- 注:当端点在域名的调度策略中使用时,无法将其删除
请求参数
URI | DELETE /v1/endpoints |
Query String | 无 |
Request Body | 详见下述实例 |
示例:
DELETE /v1/endpoints HTTP/1.1
Host: itm.baidubce.com
Authorization: authorization string
x-bce-date: 2022-11-18T06:22:24Z
[
{
"domain": "www.mydomain.com",
"endpoint": "1.1.1.1"
}
]
返回数据
null
删除域名的端点,并重新生成默认调度策略
描述
-
删除指定域名的端点
-
注:
- 1.当端点在域名的调度策略中使用时,将其从策略中去除 & 重新生成策略,最后删除端点
- 2.可以删除多个端点,但要求待删除端点的域名相同
-
请求参数
URI | DELETE /v1/endpoints/del-with-regen-strategy |
Query String | 无 |
Request Body | 详见下述实例 |
示例:
DELETE /v1/endpoints/del-with-regen-strategy HTTP/1.1
Host: itm.baidubce.com
Authorization: authorization string
x-bce-date: 2022-11-18T06:22:24Z
[
{
"domain": "www.mydomain.com",
"endpoint": "1.1.1.1"
}
]
返回数据
null
附录
端点所属运营商、地域
运营商
名称 | 中文名称 |
---|---|
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 | 其他 |