Querying the Version List

Function

This API is used to query the API version list.

Calling Method

For details, see Calling APIs.

Authorization Information

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

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

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
kms::getVersions	Read	-	-	-	-

URI

GET /

Request Parameters

None

Response Parameters

Status code: 200

**Table 1** Response body parameters
Parameter	Type	Description
versions	Array of ApiVersionDetail objects	Related version object list. For details, see the data structure description of the versions field.

**Table 2** ApiVersionDetail
Parameter	Type	Description
id	String	Version number, for example, v1.0.
links	Array of ApiLink objects	JSON object. For details, see the data structure of the links field.
version	String	If the APIs of this version support microversions, the supported maximum microversion is returned. If microversions are not supported, an empty string is returned.
status	String	Version status. Possible values are as follows: CURRENT: The version is widely used. SUPPORTED: It is an earlier version which can still be used. DEPRECATED: The version is deprecated and may be deleted later.
updated	String	Version release time. The time must be in UTC format. For example, v1 is released on 2014-06-28T12:20:21Z.
min_version	String	If the APIs of this version support microversions, the supported minimum microversion is returned. If microversions are not supported, an empty string is returned.

**Table 3** ApiLink
Parameter	Type	Description
href	String	API URL.
rel	String	The default value is self.

Status code: 500

**Table 4** Response body parameters
Parameter	Type	Description
error	Object	Error message

**Table 5** ErrorDetail
Parameter	Type	Description
error_code	String	Error code returned by the error request
error_msg	String	Error information returned by the error request

Status code: 502

**Table 6** Response body parameters
Parameter	Type	Description
error	Object	Error message

**Table 7** ErrorDetail
Parameter	Type	Description
error_code	String	Error code returned by the error request
error_msg	String	Error information returned by the error request

Status code: 504

**Table 8** Response body parameters
Parameter	Type	Description
error	Object	Error message

**Table 9** ErrorDetail
Parameter	Type	Description
error_code	String	Error code returned by the error request
error_msg	String	Error information returned by the error request

Example Requests

None

Example Responses

Status code: 200

Request succeeded.

{
  "versions" : [ {
    "min_version" : "",
    "links" : [ {
      "rel" : "self",
      "href" : "https://kms.region_id.domain.com/v1.0/"
    } ],
    "id" : "v1.0",
    "version" : "",
    "updated" : "2016-10-29T02:00:00Z",
    "status" : "CURRENT"
  } ]
}

Status Codes

Status Code	Description
200	Request succeeded.
500	Internal service error.
502	Failed to complete the request. The server receives an invalid response from the upstream server.
504	Gateway timed out.