Querying a Specified API Version

Function

This API is used to query a specific DNS API version.

Calling Method

For details, see Calling APIs.

URI

GET /{version}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
version	Yes	String	Definition Version to be queried Constraints N/A Range v2 Default Value N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
version	VersionItem object	Definition Version to be queried Range v2

**Table 3** VersionItem
Parameter	Type	Description
id	String	Definition Version Range v2
status	String	Definition Version status Range CURRENT: This version is a primary version. SUPPORTED: This version is an earlier version that is still supported. DEPRECATED: The version is a deprecated version, which may be deleted later.
links	Array of LinksItem objects	Definition API URL. Range N/A
updated	String	Definition Version release time Range N/A
version	String	Definition Maximum micro-version number Range If the APIs do not support micro-versions, you need to leave the parameter blank.
min_version	String	Definition Minimum micro-version number Range If the APIs do not support micro-versions, you need to leave the parameter blank.

**Table 4** LinksItem
Parameter	Type	Description
href	String	Definition Shortcut link Range N/A
rel	String	Definition Shortcut link marker name Range N/A

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
code	String	Definition Error code Range N/A
message	String	Definition Error description Range N/A

Status code: 404

**Table 6** Response body parameters
Parameter	Type	Description
code	String	Definition Error code Range N/A
message	String	Definition Error description Range N/A

Status code: 500

**Table 7** Response body parameters
Parameter	Type	Description
code	String	Definition Error code Range N/A
message	String	Definition Error description Range N/A

Example Requests

Querying a specific DNS API version.

GET https://{endpoint}/v2

Example Responses

Status code: 200

Querying a specified API version

{
  "version" : {
    "status" : "CURRENT",
    "id" : "v2",
    "links" : [ {
      "href" : "https://Endpoint/v2/",
      "rel" : "self"
    } ],
    "min_version" : "",
    "updated" : "2018-09-18T00:00:00Z",
    "version" : ""
  }
}