Listing All DNS API Versions¶

Function¶

List all DNS API versions.

To be interconnected with a third-party system, the current DNS version supports 1024- and 2048-bit DH key exchange algorithms, and the 2048-bit algorithm is recommended.

URI¶

GET /

Request¶

Request parameters
None
Example request
List all DNS API versions.
```
GET https://{DNS_Endpoint}/
```

Response¶

Parameter description

**Table 1** Parameter in the response¶
Parameter	Type	Description
versions	Object	Version object. For details, see Table 2.

**Table 2** Description of the **versions** field¶
Parameter	Type	Description
values	Array of object	Version list. For details, see Table 3.

**Table 3** Description of the **values** field¶
Parameter	Type	Description
status	String	Version status, which can be: CURRENT: widely used version SUPPORTED: earlier version which is still supported DEPRECATED: deprecated version which may be deleted later
id	String	Version number
links	Array of object	URL of the current version. For details, see Table 4.

**Table 4** Description of the **links** field¶
Parameter	Type	Description
href	String	Link address
rel	String	Link marker name

Example response

{
    "versions": {
        "values": [
            {
                "status": "CURRENT",
                "id": "v2",
                "links": [
                    {
                        "href": "https://Endpoint/v2",
                        "rel": "self"
                    }
                ]
            }
        ]
    }
}

Returned Value¶

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

For details, see Status Code.

last updated: 2024-11-08 14:03 UTC - commit: 19f51aa51ac7c1ca494dab59b144656ac281a68e