查询域名解析记录集列表 - ListRecordSets

功能介绍

查询域名解析记录集列表

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/traffic/recordsets

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
links	Links object	资源链接
recordsets	Array of RecordSet objects	记录信息，例如id,name,description等
metadata	Metadata object	资源元数据

表3 Links
参数	参数类型	描述
self	String	object信息
next	String	Next信息

表4 RecordSet
参数	参数类型	描述
id	String	记录集id
description	String	描述信息
zone_id	String	可用区id
zone_name	String	可用区名称
type	String	记录类型
project_id	String	项目id
name	String	记录集名称
ttl	Integer	生存时间
records	Array of strings	记录信息
weight	Integer	比例
line	String	解析线路ID
create_at	String	创建时间
update_at	String	更新时间
default	Boolean	是否为默认记录集合

表5 Metadata
参数	参数类型	描述
total_count	Integer	包含的记录集的个数

状态码：400

表6 响应Body参数
参数	参数类型	描述
-	String	-

状态码：403

表7 响应Body参数
参数	参数类型	描述
-	String	-

请求示例

无

响应示例

状态码：200

返回域名解析记录集列表

{
  "links" : {
    "self" : "https://dns.cn-north-5.myhuaweicloud.com/v2.1/recordsets",
    "next" : ""
  },
  "recordsets" : [ {
    "id" : "ff80808293ee8d6b01940ceb75492ddc",
    "name" : "wokao.abcdef.com.",
    "description" : "",
    "zone_id" : "ff8080828f71b6ee018f93f9dbb818cf",
    "zone_name" : "abcdef.com.",
    "type" : "A",
    "ttl" : 300,
    "records" : [ "100.85.216.156" ],
    "create_at" : "",
    "update_at" : "",
    "default" : false,
    "project_id" : "05495693df80d3c92fa1c01795c2be02",
    "weight" : 1
  }, {
    "id" : "8abf68938cd86d00018d1d2acb184c23",
    "name" : "gfsdf.xxx42352353442.xxx434234234.com.",
    "description" : "",
    "zone_id" : "8abf68938c33f127018c37c25cc71f08",
    "zone_name" : "xxx42352353442.xxx434234234.com.",
    "type" : "A",
    "ttl" : 300,
    "records" : [ "100.85.115.242" ],
    "create_at" : "",
    "update_at" : "",
    "default" : false,
    "project_id" : "05495693df80d3c92fa1c01795c2be02",
    "weight" : 1,
    "line" : "default_view"
  } ],
  "metadata" : {
    "total_count" : 5
  }
}