Obtaining the API Version of a Given Version ID

Function

This API is used to obtain the API version of a given version ID.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

GET /{version}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
version	Yes	String	Version.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
id	String	API version ID, for example, v1.
version	String	Maximum microversion of the API. This parameter is left blank if the microversion is not supported.
min_version	String	Minimum microversion of the API. This parameter is left blank if the microversion is not supported.
status	String	API version status. The options are as follows: CURRENT: recommended version. SUPPORTED: an old version that is still supported. DEPRECATED: deprecated version, which may be deleted later.
updated	Number	UTC time when the API version was released.
links	links object	URL of the API version.

**Table 3** links
Parameter	Type	Description
rel	String	Usage.
href	String	URL for this usage.

Example Requests

None

Example Responses

Status code: 200

{
  "min_version" : "",
  "links" : {
    "rel" : "self",
    "href" : "https://roma.example.com/"
  },
  "id" : "v2",
  "updated" : "2020-06-28T12:20:21Z",
  "version" : "",
  "status" : "CURRENT"
}