Help Center/ Identity and Access Management/ API Reference/ API/ Version Information Management/ Querying the Version Information of Keystone APIs
Updated on 2024-07-30 GMT+08:00

Querying the Version Information of Keystone APIs

Function

This API is used to query the version information of Keystone APIs.

The API can be called using both the global endpoint and region-specific endpoints. For IAM endpoints, see Regions and Endpoints.

Debugging

You can debug this API in API Explorer.

URI

GET /

Request Parameters

None

Response Parameters

Table 1 Parameters in the response body

Parameter

Type

Description

versions

Object

Keystone API version information.

Table 2 versions

Parameter

Type

Description

values

Array of objects

Keystone API version information.

Table 3 versions.values

Parameter

Type

Description

status

String

Version status.

updated

String

Time when the API was last updated.

links

Array of objects

Version resource link information.

id

String

Version number, for example, v3.6.

media-types

Array of objects

Supported message formats.

Table 4 versions.values.links

Parameter

Type

Description

rel

String

Link type.

  • self: Versioned link to a resource.
  • bookmark: Permanent link to a resource.
  • alternate: Alternate link to a resource.

href

String

Resource link

Table 5 versions.values.media-types

Parameter

Type

Description

type

String

Media type.

base

String

Basic data type.

Example Request

Request for querying the version information of Keystone APIs

GET https://iam.myhuaweicloud.com/

Example Response

Status code: 300

The request is successful. (Multiple choices)

{
    "versions": {
        "values": [
            {
                "media-types": [
                    {
                        "type": "application/vnd.openstack.identity-v3+json",
                        "base": "application/json"
                    }
                ],
                "links": [
                    {
                        "rel": "self",
                        "href": "https://iam.myhuaweicloud.com/v3/"
                    }
                ],
                "id": "v3.6",
                "updated": "2016-04-04T00:00:00Z",
                "status": "stable"
            }
        ]
    }
}

Status Codes

Status Code

Description

300

The request is successful. (Multiple choices)

400

Invalid parameters.

404

The requested resource cannot be found.

503

Service unavailable.

Error Codes

None