• Direct Connect

dc
  1. Help Center
  2. Direct Connect
  3. API Reference
  4. API
  5. Obtaining the API Version Information
  6. Querying a Specified API Version

Querying a Specified API Version

Function

This API is used to query a specified API version supported by Direct Connect.

URI

GET /{api_version}

Request

None

Response

Table 1 lists the response parameters.

Table 1 Response parameters

Parameter

Type

Description

id

String

Indicates the version number, for example, v2.0

links

Array

Indicates the API URL.

href

String

Indicates the reference address of the current API version.

rel

String

Indicates the relationship between the current API version and the referenced address.

version

String

Indicates the version. If APIs of this version support minor versions, set this parameter to the supported maximum minor version. If the minor versions are not supported, leave this parameter blank.

status

String

Indicates the version status. Possible values are as follows:

  • CURRENT: indicates a primary version.
  • SUPPORTED: indicates an old version but is still supported.
  • DEPRECATED: indicates a deprecated version which may be deleted later.

updated

String

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

min_version

String

If this API version supports microversions, the minimum microversion number is returned. If microversions are not supported, no value is returned.

Examples

  • Example request
    GET /v2.0
  • Example response
    {
      "version": {
        "id": "v2.0",
        "links": [
          {
            "href": "https://dcaas.cn-north-1.myhwclouds.com/v2.0",
            "rel": "self"
          }
        ],
        "updated": "2017-11-30T00:00:00Z",
        "status": "CURRENT",
        "version": "",
        "min_version": ""
      }
    }