Querying API Versions (Native OpenStack API)

Function

This API is used to query API versions, such as version compatibility and domain name information of APIs.

URI

GET /

Request

• Request parameters

  None

• Example request

  GET https://{Endpoint}/
  

Response

• Response parameters

  Parameter	Type	Description
  versions	Array of objects	Specifies the versions. For details, see Table 1.

  Table 1 Data structure description of the versions field

  Parameter	Type	Description
  status	String	Specifies the API status.
  id	String	Specifies the API ID.
  links	Array of objects	Specifies the description. For details, see Table 2.

  Table 2 Data structure description of the versions.links field

  Parameter	Type	Description
  href	String	Specifies the domain name.
  rel	String	Specifies the domain name description.

• Example response

  STATUS CODE 300
  

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54

  { "versions": [ { "status": "CURRENT", "id": "v2.2", "links": [ { "href": "https://image.az1.dc1.domainname.com/v2/", "rel": "self" } ] }, { "status": "SUPPORTED", "id": "v2.1", "links": [ { "href": "https://image.az1.dc1.domainname.com/v2/", "rel": "self" } ] }, { "status": "SUPPORTED", "id": "v2.0", "links": [ { "href": "https://image.az1.dc1.domainname.com/v2/", "rel": "self" } ] }, { "status": "DEPRECATED", "id": "v1.1", "links": [ { "href": "https://image.az1.dc1.domainname.com/v1/", "rel": "self" } ] }, { "status": "DEPRECATED", "id": "v1.0", "links": [ { "href": "https://image.az1.dc1.domainname.com/v1/", "rel": "self" } ] } ] }

Returned Values

• Normal

  300

• Abnormal

  Returned Value	Description
  400 Bad Request	Request error.
  401 Unauthorized	Authentication failed.
  403 Forbidden	You do not have the rights to perform the operation.
  404 Not Found	The requested resource was not found.
  500 Internal Server Error	Internal service error.
  503 Service Unavailable	The service is unavailable.