Querying the Version of a Specified VPCEP API¶

Function¶

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

URI¶

GET /{version}

Request¶

Parameters

**Table 1** Request parameters¶
Parameter	Mandatory	Type	Description
version	No	String	Specifies the version to be queried. The value starts with v, for example, v1. If this parameter is left blank, versions of all APIs are queried.

Example request
GET https://{endpoint}/v1

Response¶

Parameters

**Table 2** Response parameters¶
Parameter	Type	Description
version	Object	Lists the versions of VPCEP APIs. For details, see Table 3.

**Table 3** **VersionModel** parameters¶
Parameter	Type	Description
status	String	Specifies the version status. CURRENT: indicates a major version. SUPPORT: indicates an earlier version which is still supported. DEPRECATED: indicates a deprecated version that may be deleted later.
id	String	Specifies the version ID.
updated	String	Specifies the time when the API version was released. The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.
version	String	Specifies the supported version.
min_version	String	Specifies the microversion number. If the APIs do not support microversions, the value is left blank.
links	Array of objects	Specifies the API URL. For details, see Table 4.

**Table 4** **VersionLink** parameters¶
Parameter	Type	Description
href	String	Specifies the reference address of the current API version.
type	String	Specifies the MIME type of the entity sending the request. The value is application/json.
rel	String	Specifies the relationship between the current API version and the referenced address.

Example response

{
  "version":{
    {
      "updated":"2018-09-30T00:00:00Z",
      "version":"1",
      "min_version":"",
      "status":"CURRENT",
      "id":"v1",
      "links":[
        {
          "href":"https://{vpcep_uri}/v1",
          "type":"application/json",
          "rel":"self"
        }
      ]
    }
  }
}

Status Code¶

For details about status codes, see Status Code.

last updated: 2024-11-08 14:12 UTC - commit: 584c68183f753c5a23d4736a733786722105da14