Querying a Specified API Version

Function

This API is used to query the version of a specified API.

URI

GET /{api_version}

Table 1 describes the parameters.

Request Message

• Request parameter

  None

• Example request

  GET https://{Endpoint}/v2.0

Response Message

• Response parameter

  Table 2 Response parameter

  Parameter	Type	Description
  resources	Array of resource objects	Specifies the resource object list.

  Table 3 resource object

  Parameter	Type	Description
  name	String	Specifies the resource name.
  collection	String	Specifies the resource collection name.
  links	Array of link objects	Specifies the link list. For details, see Table 4.

  Table 4 link objects

  Parameter	Type	Description
  href	String	Specifies the API link.
  rel	String	Specifies the relationship between the API link and the API version.

• Example response

  {
      "resources": [
          {
              "links": [
                  {
                      "href": "https://vpc.systems.com/v2.0/subnets",
                      "rel": "self"
                  }
              ],
              "name": "subnet",
              "collection": "subnets"
          },
          {
              "links": [
                  {
                      "href": "https://vpc.systems.com/v2.0/networks",
                      "rel": "self"
                  }
              ],
              "name": "network",
              "collection": "networks"
          },
          {
              "links": [
                  {
                      "href": "https://vpc.systems.com/v2.0/ports",
                      "rel": "self"
                  }
              ],
              "name": "port",
              "collection": "ports"
          }
      ]
  }

Status Code

See Status Codes.

Error Code

See Error Codes.