文档首页/ 华为云UCS/ API参考/ API/ 流量管理/ 查询域名解析记录集列表 - ListRecordSets
更新时间：2025-11-17 GMT+08:00
查看PDF
分享

查询域名解析记录集列表 - 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
  }
}

状态码

状态码

描述

200

返回域名解析记录集列表

400

403

错误码

请参见错误码。

父主题： 流量管理

相关文档