Updated on 2024-04-16 GMT+08:00

Querying the SMN API v2 Version

Function

This API is used to query the version of SMN API v2.

Calling Method

For details, see Calling APIs.

URI

GET /v2

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Specifies a user token.

It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

version

VersionItem object

Specifies the list of all v2 versions.

Table 3 VersionItem

Parameter

Type

Description

id

String

Specifies the version ID, for example, v2.

min_version

String

Specifies the microversion. If the API supports microversions, the system returns the supported minimum microversion. If no, the system returns an empty value.

status

String

Specifies the version status.

CURRENT: The version is the primary version.

SUPPORTED: The version is an earlier version, but it is still supported.

DEPRECATED: The version is a deprecated version, which may be deleted later.

updated

String

Specifies the version release time, which must be a UTC time. For example, the release time of v2 is 2014-06-28T12:20:21Z.

version

String

Specifies the microversion. If the API supports microversions, the system returns the supported minimum microversion. If no, the system returns an empty value.

links

Array of LinksItem objects

Specifies the API URL.

Table 4 LinksItem

Parameter

Type

Description

href

String

Specifies the corresponding shortcut link.

rel

String

Specifies the shortcut link marker name.

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

request_id

String

Specifies the request ID, which is unique.

code

String

Specifies the error code.

message

String

Describes the error message.

Status code: 403

Table 6 Response body parameters

Parameter

Type

Description

request_id

String

Specifies the request ID, which is unique.

code

String

Specifies the error code.

message

String

Describes the error message.

Status code: 404

Table 7 Response body parameters

Parameter

Type

Description

request_id

String

Specifies the request ID, which is unique.

code

String

Specifies the error code.

message

String

Describes the error message.

Status code: 500

Table 8 Response body parameters

Parameter

Type

Description

request_id

String

Specifies the request ID, which is unique.

code

String

Specifies the error code.

message

String

Describes the error message.

Example Requests

GET https://{SMN_Endpoint}/v2

null

Example Responses

Status code: 200

OK

{
  "version" : {
    "id" : "v2",
    "links" : [ {
      "href" : "https://127.0.0.1/v2",
      "rel" : "self"
    } ],
    "min_version" : "",
    "status" : "CURRENT",
    "updated" : "2018-09-19T00:00:00Z",
    "version" : ""
  }
}

Status Codes

Status Code

Description

200

OK

400

Bad Request

403

Unauthorized

404

Not Found

500

Internal Server Error

Error Codes

See Error Codes.