Updated on 2024-03-14 GMT+08:00

Querying All Record Sets

Function

Query record sets in list.

URI

GET /v2.1/recordsets

For details, see Table 1.
Table 1 Parameters in the URI

Parameter

Mandatory

Type

Description

zone_type

No

String

Zone type of the record set to be queried, which can only be public

A fuzzy search will be performed.

The default value is public.

marker

No

String

Start resource ID of pagination query

If the parameter is left blank, only resources on the first page are queried.

The value is left blank by default.

limit

No

Integer

Number of resources on each page

The value ranges from 0 to 500.

Commonly used values are 10, 20, and 50. The default value is 500.

offset

No

Integer

Start offset of pagination query. The query will start from the next resource of the offset value.

The value ranges from 0 to 2147483647.

The default value is 0.

If marker is not left blank, the query starts from the resource specified by marker.

line_id

No

String

Resolution line ID.

tags

No

String

Resource tag

The format is as follows: key1,value1|key2,value2.

Multiple tags are separated by vertical bar (|). The key and value of each tag are separated by comma (,).

The tags are in AND relationship.

Exact matching will work. If the value starts with an asterisk (*), fuzzy matching will work for the string following the asterisk.

The value is left blank by default.

status

No

String

Status of the record sets to be queried

The value can be ACTIVE, ERROR, DISABLE, FREEZE, PENDING_CREATE, PENDING_UPDATE, or PENDING_DELETE.

For details, see Resource Status.

A fuzzy search will be performed.

The value is left blank by default.

type

No

String

Type of the record sets to be queried

The value can be A, CNAME, MX, AAAA, TXT, SRV, NS, or CAA.

For details, see Record Set Type.

If this parameter is left blank, all types of record sets will be queried.

Exact matching will work.

name

No

String

Name of record sets to be queried

A fuzzy search will be performed.

The value is left blank by default.

id

No

String

ID of record sets to be queried

A fuzzy search will be performed.

The value is left blank by default.

records

No

String

Value included in the values of record sets to be queried

A fuzzy search will be performed.

The value is left blank by default.

sort_key

No

String

Sorting condition of the record set list

The value can be:

  • name: domain name
  • type: record set type

The default value is left blank, indicating that the records are not sorted.

sort_dir

No

String

Sorting order of the record set list

The value can be:

  • desc: descending order
  • asc: ascending order

The default value is left blank, indicating that the records are not sorted.

health_check_id

No

String

Health check ID

A fuzzy search will be performed.

The value is left blank by default.

Request

  • Request parameters

    None

  • Example request

    Query A record sets whose name contains www.example.com in public zones:

    GET https://{DNS_Endpoint}/v2.1/recordsets?zone_type=&type=A&name=www.example.com

Response

  • Parameter description
    Table 2 Parameters in the response

    Parameter

    Type

    Description

    links

    Object

    Link to the current resource or other related resources. When a response is broken into pages, a next link is provided to retrieve all results. For details, see Table 5.

    recordsets

    Array of object

    Record set list object

    For details, see Table 3.

    metadata

    Object

    Number of resources that meet the filter condition

    For details, see Table 4.

    Table 3 Description of the recordsets field

    Parameter

    Type

    Description

    id

    String

    Record set ID

    name

    String

    Record set name

    description

    String

    Record set description

    zone_id

    String

    Zone ID of the record set

    zone_name

    String

    Zone name of the record set

    type

    String

    Record set type

    The value can be A, AAAA, MX, CNAME, TXT, NS, SRV, or CAA.

    For details, see Record Set Type.

    ttl

    Integer

    Record set cache duration (in seconds) on a local DNS server. The longer the duration is, the slower the update takes effect.

    If your service address is frequently changed, set TTL to a smaller value.

    records

    Array of strings

    Record set value

    created_at

    String

    Time when the record set was created

    The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.

    updated_at

    String

    Time when the record set was updated

    The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.

    status

    String

    Resource status

    For details, see Resource Status.

    default

    Boolean

    Whether the record set is created by default

    A default record set cannot be deleted.

    project_id

    String

    Project ID of the record set

    links

    Object

    Link to the current resource or other related resources

    When a response is broken into pages, a next link is provided to retrieve all results. For details, see Table 5.

    tags

    Array of tag objects

    Resource tag.

    The format is as follows: key1,value1|key2,value2.

    Multiple tags are separated by vertical bar (|). The key and value of each tag are separated by comma (,).

    The tags are in AND relationship.

    For details, see Table 6.

    Exact matching will work. If the value starts with an asterisk (*), fuzzy matching will work for the string following the asterisk.

    The value is left blank by default.

    line

    String

    Resolution line ID

    weight

    Integer

    Weight of the record set

    health_check_id

    String

    Health check ID

    alias_target

    Object

    Domain name alias. For details, see Table 7.

    Table 4 Description of the metadata field

    Parameter

    Type

    Description

    total_count

    Integer

    Number of resources that meet the filter criteria. The number is irrelevant to limit or offset.

    Table 5 Parameters in the links field

    Parameter

    Type

    Description

    self

    String

    Link to the current resource

    next

    String

    Link to the next page

    Table 6 Description of the tag field

    Parameter

    Type

    Description

    key

    String

    Tag key

    A key can contain up to 36 Unicode characters. key must be specified. Equal signs (=), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), commas (,), vertical bars (|), and slashes (/) are not allowed. The first and last characters cannot be spaces.

    value

    String

    Tag value

    Each value can contain a maximum of 43 Unicode characters and can be an empty string. Equal signs (=), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), commas (,), vertical bars (|), and slashes (/) are not allowed. The first and last characters cannot be spaces.

    Table 7 Description of the alias_target field

    Parameter

    Type

    Description

    resource_type

    String

    Service that support domain name aliases

    The value can be cloudsite or waf (Web Application Firewall).

    resource_domain_name

    String

    Domain name of the target service

  • Example response
    {
        "links": {
            "self": "https://Endpoint/v2.1/recordsets",
            "next": "https://Endpoint/v2.1/recordsets?id=&limit=11&marker=2c9eb155587194ec01587224c9f9014a"
        },
        "recordsets": [
            {
                "id": "2c9eb155587194ec01587224c9f9014a",
                "name": "example.com.",
                "type": "SOA",
                "ttl": 300,
                "records": [
                    "ns1.hotrot.de. xx.example.com. (1 7200 900 1209600 300)"
                ],
                "status": "ACTIVE",
                "links": {
                    "self": "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014a"
                },
                "alias_target":null,
                "zone_id": "2c9eb155587194ec01587224c9f90149",
                "zone_name": "example.com.",
                "created_at": "2016-11-17T11:56:03.439",
                "updated_at": "2016-11-17T11:56:06.439",
                "default": true,
                "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
                "line": "default_view",
                "weight": 1,
                "health_check_id":null
            },
            {
                "id": "2c9eb155587194ec01587224c9f9014c",
                "name": "example.com.",
                "type": "NS",
                "ttl": 172800,
                "records": [
                    "ns2.hotrot.de.",
                    "ns1.hotrot.de."
                ],
                "status": "ACTIVE",
                "links": {
                    "self": "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014c"
                },
                "alias_target":null,
                "zone_id": "2c9eb155587194ec01587224c9f90149",
                "zone_name": "example.com.",
                "created_at": "2016-11-17T11:56:03.439",
                "updated_at": "2016-11-17T11:56:06.439",
                "default": true,
                "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
                "line": "default_view",
                "weight": 1,
                "health_check_id":null
            },
            {
                "id": "2c9eb155587228570158722996ca0002",
                "name": "example.org.",
                "type": "SOA",
                "ttl": 300,
                "records": [
                    "ns1.hotrot.de. xx.example.org. (1 7200 900 1209600 300)"
                ],
                "status": "ACTIVE",
                "links": {
                    "self": "https://Endpoint/v2.1/zones/2c9eb155587228570158722996c50001/recordsets/2c9eb155587228570158722996ca0002"
                },
                "alias_target":null,
                "zone_id": "2c9eb155587228570158722996c50001",
                "zone_name": "example.org.",
                "created_at": "2016-11-17T12:01:17.996",
                "updated_at": "2016-11-17T12:56:06.439",
                "default": true,
                "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
                "line": "xxx",
                "weight": 1,
                "health_check_id":null
            },
            {
                "id": "2c9eb155587228570158722996ca0004",
                "name": "example.org.",
                "type": "NS",
                "ttl": 172800,
                "records": [
                    "ns2.hotrot.de.",
                    "ns1.hotrot.de."
                ],
                "status": "ACTIVE",
                "links": {
                    "self": "https://Endpoint/v2.1/zones/2c9eb155587228570158722996c50001/recordsets/2c9eb155587228570158722996ca0004"
                },
                "alias_target":null,
                "zone_id": "2c9eb155587228570158722996c50001",
                "zone_name": "example.org.",
                "created_at": "2016-11-17T12:01:17.996",
                "updated_at": "2016-11-17T12:56:06.439",
                "default": false,
                "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
                "line": "xxx",
                "weight": 1,
                "health_check_id":null
            },
            {
                "id": "2c9eb155587228570158722b6ac30007",
                "name": "www.example.com.",
                "description": "This is an example record set.",
                "type": "A",
                "ttl": 300,
                "records": [
                    "abc.bcd.com."
                ],
                "status": "ACTIVE",
                "links": {
                    "self": "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
                },
                "alias_target":{
                      "resource_type": "cloudsite",
                     "resource_domain_name": "2018122216193840mjysxoqn.cname.ysjianzhan.cn."
                },
                "zone_id": "2c9eb155587194ec01587224c9f90149",
                "zone_name": "example.com.",
                "created_at": "2016-11-17T12:03:17.827",
                "updated_at": "2016-11-17T12:56:06.439",
                "default": false,
                "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c",
                "line": "default_view",
                "weight": 1,
                "health_check_id":null
            }
        ],
        "metadata": {
            "total_count": 5
        }
    }
    

Returned Value

If a 2xx status code is returned, for example, 200, 202, or 204, the request is successful.

For details, see Status Code.