Querying All API Versions

Function

This API is used to query all API versions supported by Cloud Eye.

URI

GET /

Request

Example request

GET https://{Cloud Eye endpoint}/

Response

Response parameters

**Table 1** Response parameters
Parameter	Type	Description
versions	Array of objects	Specifies the list of all versions. Table 2 describes the parameters.

**Table 2** **versions** field data structure description
Parameter	Type	Description
id	String	Specifies the version ID, for example, v1.
links	Array of objects	Specifies the API URL. For details, see Table 3.
version	String	Specifies the API version. If the APIs of this version support microversions, set this parameter to the supported maximum microversion. If the microversion is not supported, leave this parameter blank.
status	String	Specifies the version status. Possible values are as follows: CURRENT: indicates a primary version. SUPPORTED: indicates an old version but is still supported. DEPRECATED: indicates a deprecated version which may be deleted later.
updated	String	Specifies the version release time, which must be the UTC time. For example, the release time of v1 is 2014-06-28T12:20:21Z.
min_version	String	If the APIs of this version support microversions, set this parameter to the supported minimum microversion. If not, leave this parameter blank.

**Table 3** **links** field data structure description
Parameter	Type	Description
href	String	Specifies the reference address of the current API version.
rel	String	Specifies the relationship between the current API version and the referenced address.

Example response

{
  "versions": [
    {
      "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": ""
    }
  ]
}

Returned Values

Normal
200

Abnormal

Returned Value	Description
400 Bad Request	Request error
401 Unauthorized	The authentication information is not provided or is incorrect.
403 Forbidden	You are forbidden to access the page requested.
408 Request Timeout	The request timed out.
429 Too Many Requests	Concurrent requests are excessive.
500 Internal Server Error	Failed to complete the request because of an internal service error.
503 Service Unavailable	The service is currently unavailable.