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.

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

{
    "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.

Querying API Versions (Native OpenStack API)

Function

URI

Request

Response

Returned Values