Querying Version Information of an API

Function

This API is used to query version information of a specified API.

Authorization Information

Each account has permissions to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
-	-	-	-	-	-

URI

GET /{version}

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
version	Yes	String	API version

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
version	ApiVersionResponse object	API version information

**Table 3** ApiVersionResponse
Parameter	Type	Description
id	String	API version number
links	Array of Links objects	API link information NOTE: If the version is v3, the value is [].
status	String	Version status. CURRENT indicates the version is recommended.
version	String	Subversion information of the API version
min_version	String	Minimum API version number
updated	String	Version update time The format is yyyy-mm-dd Thh:mm:ssZ. T is the separator between the calendar and the hourly notation of time. Z indicates the UTC.

**Table 4** Links
Parameter	Type	Description
href	String	API URL. The value is "".
rel	String	The value is self, indicating that URL is a local link.

Example Requests

URI example

GET https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3

Example Responses

Status code: 200

Successful response

{
  "version" : {
    "id" : "v3",
    "links" : [ ],
    "status" : "CURRENT",
    "version" : "",
    "min_version" : "",
    "updated" : "2019-10-30T17:34:02Z"
  }
}