Querying All Record Sets
Function
Query record sets in list.
URI
GET /v2/recordsets
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
zone_type |
No |
String |
Zone type of the record set to be queried, which can be public or private
A fuzzy search will be performed. The default value is public. To query private record sets, set this parameter to private. |
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. |
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. For details, see Adding Resource Tags. 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, AAAA, MX, CNAME, TXT, SRV, PTR, NS, or SOA. For details, see Record Set Type. Exact matching will work. The value is left blank by default. |
name |
No |
String |
Names of record sets to be queried A fuzzy search will be performed. The value is left blank by default. |
id |
No |
String |
IDs 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:
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:
The default value is left blank, indicating that the records are not sorted. |
Request
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
Total number of resources that meet the filter criteria. 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, SRV, PTR, NS, or SOA.
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.
Value range: 300–2147483647
The default value is 300.
records
Array of strings
Record set value
create_at
String
Time when the record set was created
The value format is yyyy-MM-dd'T'HH:mm:ss.SSS.
update_at
String
Time when the record set was updated
The value format is yyyy-MM-dd'T'HH:mm:ss.SSS.
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.
It is left blank by default.
- Example response
{ "links": { "self": "https://Endpoint/v2/recordsets", "next": "https://Endpoint/v2/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/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014a" }, "zone_id": "2c9eb155587194ec01587224c9f90149", "zone_name": "example.com.", "create_at": "2016-11-17T11:56:03.439", "update_at": "2016-11-17T11:56:03.827", "default": true, "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c" }, { "id": "2c9eb155587194ec01587224c9f9014c", "name": "example.com.", "type": "NS", "ttl": 172800, "records": [ "ns2.hotrot.de.", "ns1.hotrot.de." ], "status": "ACTIVE", "links": { "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014c" }, "zone_id": "2c9eb155587194ec01587224c9f90149", "zone_name": "example.com.", "create_at": "2016-11-17T11:56:03.439", "update_at": "2016-11-17T11:56:03.827", "default": true, "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c" }, { "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/zones/2c9eb155587228570158722996c50001/recordsets/2c9eb155587228570158722996ca0002" }, "zone_id": "2c9eb155587228570158722996c50001", "zone_name": "example.org.", "create_at": "2016-11-17T12:01:17.996", "update_at": "2016-11-17T12:56:03.827", "default": true, "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c" }, { "id": "2c9eb155587228570158722996ca0004", "name": "example.org.", "type": "NS", "ttl": 172800, "records": [ "ns2.hotrot.de.", "ns1.hotrot.de." ], "status": "ACTIVE", "links": { "self": "https://Endpoint/v2/zones/2c9eb155587228570158722996c50001/recordsets/2c9eb155587228570158722996ca0004" }, "zone_id": "2c9eb155587228570158722996c50001", "zone_name": "example.org.", "create_at": "2016-11-17T12:01:17.996", "update_at": "2016-11-17T12:56:03.827", "default": true, "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c" }, { "id": "2c9eb155587228570158722b6ac30007", "name": "www.example.com.", "description": "This is an example record set.", "type": "A", "ttl": 300, "records": [ "192.168.10.2", "192.168.10.1" ], "status": "ACTIVE", "links": { "self": "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007" }, "zone_id": "2c9eb155587194ec01587224c9f90149", "zone_name": "example.com.", "create_at": "2016-11-17T12:03:17.827", "update_at": "2016-11-17T12:56:03.827", "default": false, "project_id": "e55c6f3dc4e34c9f86353b664ae0e70c" } ], "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.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot