Querying API Versions

Function

This API is used to query the supported API versions.

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 /

Request Parameters

None

Response Parameters

Status code: 200

**Table 1** Response body parameter
Parameter	Type	Description
versions	Array of ApiVersionResponse objects	API version information

**Table 2** 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 3** 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 Request

URI example

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

Example Response

Status code: 200

Successful request

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