Querying the Record Set List

Function

This API is used to query the record set list.

URI

GET /v1/traffic/recordsets

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	Identity authentication information. Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token.

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
links	Links object	Resource link
recordsets	Array of RecordSet objects	Record information such as the ID, name, and description
metadata	Metadata object	Resource metadata

**Table 3** Links
Parameter	Type	Description
self	String	Object information
next	String	Next information

**Table 4** RecordSet
Parameter	Type	Description
id	String	Record set ID
description	String	Description
zone_id	String	Zone ID
zone_name	String	Zone name
type	String	Record set type
project_id	String	Project ID
name	String	Record set name
ttl	Integer	Time to live (TTL)
records	Array of strings	Record information
weight	Integer	Weight
line	String	Resolution line ID
create_at	String	Creation time
update_at	String	Update time
default	Boolean	Whether the record set is default

**Table 5** Metadata
Parameter	Type	Description
total_count	Integer	The number of record sets

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
-	String	-

Status code: 403

**Table 7** Response body parameters
Parameter	Type	Description
-	String	-

Example Requests

None

Example Responses

Status code: 200

Record set list returned

{
  "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
  }
}