Updated on 2023-02-13 GMT+08:00

Querying a Specified API Version

Function

This API is used to query a specified API version.

URI

GET /{api_version}

Table 1 Path parameters

Parameter

Mandatory

Type

Description

api_version

Yes

String

API version to be queried.

Value: v1

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token obtained from IAM.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

id

String

Version ID.

links

String

URL for displaying version information.

version

String

API microversion information.

status

String

Version status.

Default value: CURRENT

Value:

  • CURRENT
  • SUPPORTED
  • DEPRECATED

updated

String

Version update time.

Example Request

GET https://{endpoint}/{api_version}

Example Response

Status code: 200

Request succeeded.

{ 
  "id" : "v1", 
  "links" : "", 
  "version" : "", 
  "status" : "CURRENT", 
  "updated" : "2021-05-24T05:44:04Z" 
}

Status Codes

Status code

Description

200

Request succeeded.

Error Codes

For details, see Error Codes.