解析记录相关接口

更新时间：2022-09-08

添加解析记录

描述

添加解析记录

请求结构

POST /v{version}/dns/zone/{zoneName}/record?clientToken={clientToken} HTTP/1.1
Host: dns.baidubce.com
Authorization: authorization string
 {
	"rr":rr,
	"type":type,
	"value":value,
	"ttl":ttl,
	"line":line,
	"description":description,
	"priority":priority
 }

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1。
zoneName	String	是	URL参数	域名名称。
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串。
rr	String	是	RequestBody参数	主机记录，例如“www”。记录值和zone的name长度加在一起不能超过255字符。
type	String	是	RequestBody参数	解析记录类型，包含：“A”, “CNAME”, “MX”, “TXT”, “NS”, “AAAA”, “SRV”。
value	String	是	RequestBody参数	记录值，例如 IP：“192.168.1.1”，CNAME：“cname.baidu.com”，MX：“mail.baidu.com”，SRV：优先级权重端口目标地址，每项中间需以空格分隔。例：“0 6 8080 vipserver.test.com”。
ttl	int	否	RequestBody参数	解析记录在本地DNS服务器的缓存时间（单位：秒），基础版默认300秒，普惠版默认120秒，企业版默认1秒。取值为正整数。
line	String	否	RequestBody参数	解析线路或线路组名称，默认为default，基础版和普惠版包含：默认(default)、电信(ct)、移动(cmnet)、联通(cnc)、教育网(edu)、搜索引擎(百度)(search)；企业版线路取值见LineName，企业版还可以传线路组名称。
description	String	否	RequestBody参数	描述，长度不超过255个字符。
priority	int	否	RequestBody参数	MX记录的优先级，取值范围：[0,50]。记录类型为MX记录时，此参数必选。

返回头域

除公共头域，无其它特殊头域。

返回参数

无返回参数。

请求示例

POST /v1/dns/zone/baidu.com/record?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
Host: dns.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2020-07-14T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
	"rr":"www",
	"type":"A",
	"value":"192.168.1.1",
	"ttl":300,
	"line":default,
	"description":"desc"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

查询解析记录列表

描述

查询解析记录列表

请求结构

GET /v{version}/dns/zone/{zoneName}/record?rr={rr}&id={id}&marker={marker}&maxKeys={maxKeys}   HTTP/1.1   
Host: dns.baidubce.com      
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1。
zoneName	String	是	URL参数	域名的名称。
rr	String	否	Query参数	主机记录，例如“www”。
id	String	否	Query参数	解析记录id。
marker	String	否	Query参数	批量获取列表的查询的起始位置，是一个由系统生成的字符串。
maxKeys	int	否	Query参数	每页包含的最大数量，最大数量通常不超过1000。缺省值为1000。

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
marker	String	标记查询的起始位置。
isTruncated	boolean	true表示后面还有数据，false表示已经是最后一页。
nextMarker	String	获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现。
maxKeys	int	每页包含的最大数量。
records	List<PublicRecord>	包含查询结果的解析记录列表。

请求示例

GET /v1/dns/zone/baidu.com/record?rr=www&marker=1234&maxKeys=1000 HTTP/1.1   
Host: dns.baidubce.com     
Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2017 03 11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

 HTTP/1.1 200 OK     
 x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
 Date: Thu, 16 Mar 2017 06:29:48 GMT    
 Content Type: application/json;charset=UTF 8     
 Server: BWS  
  
{
	"nextMarker": "5678",
    "marker": "1234",
    "maxKeys": 1000,
    "isTruncated": true,
    "records": [
		{
			"id":"1234",
			"rr":"www",
			"status":"running",
			"type":"A",
			"value":"192.168.1.1",
			"ttl":300,
			"line":default,
			"description":"desc"
		} 
    ]
}

修改解析记录

描述

修改解析记录

请求结构

PUT /v{version}/dns/zone/{zoneName}/record/{recordId}?clientToken={clientToken} HTTP/1.1
Host: dns.baidubce.com
Authorization: authorization string
{
	"rr":rr,
	"type":type,
	"value":value,
	"ttl":ttl,
	"description":description,
	"priority":priority
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1。
zoneName	String	是	URL参数	域名名称。
recordId	String	是	URL参数	解析记录id。
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串。
rr	String	是	RequestBody参数	主机记录，例如“www”，记录值和zone的name长度加在一起不能超过255字符。
type	String	是	RequestBody参数	解析记录类型，包含：“A”, “CNAME”, “MX”, “TXT”, “NS”, “AAAA”, “SRV”。
value	String	是	RequestBody参数	记录值，例如 IP：“192.168.1.1”，CNAME：“cname.baidu.com”，MX：“mail.baidu.com”。
ttl	int	否	RequestBody参数	解析记录在本地DNS服务器的缓存时间（单位：秒），基础版默认300秒，普惠版默认120秒，企业版默认1秒，取值为正整数。
description	String	否	RequestBody参数	描述，长度不超过255个字符。
priority	int	否	RequestBody参数	MX记录的优先级，取值范围：[0,50]。记录类型为MX记录时，此参数必选。

返回头域

除公共头域，无其它特殊头域。

返回参数

无返回参数。

请求示例

PUT /v1/dns/zone/baidu.com/record/1234?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849
Host: dns.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "rr":"www",
	"type":"A",
	"value":"192.168.1.1",
	"ttl": 120,                    
	"description": "desc"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Tus, 14 Jul 2020 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

修改解析记录状态

描述

修改解析记录状态

请求结构

PUT /v{version}/dns/zone/{zoneName}/record/{recordId}?{action}clientToken={clientToken} HTTP/1.1
Host: dns.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1。
zoneName	String	是	URL参数	域名名称。
recordId	String	是	URL参数	解析记录id。
action	String	是	Query参数	“enable”/“disable”分别代表启用/暂停该条解析记录。
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串。

返回头域

除公共头域，无其它特殊头域。

返回参数

无返回参数。

请求示例

PUT /v1/dns/zone/baidu.com/record/1234?enable&clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849
Host: dns.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

删除解析记录

描述

删除解析记录

请求结构

DELETE /v{version}/dns/zone/{zoneName}/record/{recordId}?clientToken={clientToken} HTTP/1.1
Host: dns.baidubce.com
Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号，当前取值1。
zoneName	String	是	URL参数	域名名称。
recordId	String	是	URL参数	解析记录id。
clientToken	String	否	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串。

返回头域

除公共头域，无其它特殊头域。

返回参数

无返回参数。

请求示例

DELETE /v1/dns/zone/baidu.com/record/1234?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
Host: dns.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

域名相关接口

线路组相关接口

百度智能云

智能云解析 DNS

智能云解析 DNS

解析记录相关接口

添加解析记录

查询解析记录列表

修改解析记录

修改解析记录状态

删除解析记录