Querying a Specific API Version

Function

This API is used to query a specific API version.

URI

GET /{version}

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
version	Yes	String	Indicates the version.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
version	Object	Indicates the information of the API version.

**Table 3** Version
Parameter	Type	Description
id	String	Identifies a version. An example version ID is v1.
links	Array of LinksBody objects	Indicates an API URL.
version	String	If microversions are supported, set this parameter to the maximum microversion supported. Otherwise, leave this parameter empty.
status	String	Indicates the version status. Possible values are CURRENT (widely used version), SUPPORTED (earlier version which is still supported), and DEPRECATED (deprecated version which may be deleted later). Enumeration values: CURRENT SUPPORTED DEPRECATED
updated	String	Indicates the Coordinated Universal time (UTC) time when the version was released. For example, the value is 2014-06-28T12:20:21Z for v1.
min_version	String	If microversions are supported, set this parameter to the minimum microversion supported. Otherwise, leave this parameter empty.

**Table 4** LinksBody
Parameter	Type	Description
href	String	Indicates an address referenced by the current API version.
rel	String	Indicates the relationship between the current API version and the referenced address.

Example Requests

None

Example Responses

Status code: 200

The request is successful.

{
  "version" : {
    "id" : "v1.0",
    "links" : {
      "href" : "https://x.x.x.x/v1.0/",
      "rel" : "self"
    },
    "min_version" : "",
    "status" : "CURRENT",
    "updated" : "2018-09-30T00:00:00Z",
    "version" : ""
  }
}

Status Codes

Status Code	Description
200	The request is successful.
404	The server failed to find the requested resource.
500	The server encountered an unexpected condition which prevented it from fulfilling the request.