获取服务API版本列表 - ListVersion

功能介绍

获取服务API版本列表，无需认证。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /

请求参数

无

响应参数

状态码：200

表1 响应Body参数
参数	参数类型	描述
versions	Array of Version objects	服务的API版本信息列表。
scene	String	场景信息。

表2 Version
参数	参数类型	描述
id	String	API版本ID，如v1。
version	String	API的最大微版本号，不支持固定填空。
min_version	String	API的最小微版本号，不支持固定填空。
status	String	API版本状态。取值： CURRENT：主推版本。 SUPPORTED：老版本，仍继续支持。 DEPRECATED：废弃版本，后续可能会删除。
updated	Number	API版本发布UTC时间。
links	links object	API版本URL地址。

表3 links
参数	参数类型	描述
rel	String	用途。
href	String	该用途的URL。

请求示例

无

响应示例

状态码：200

{
  "versions" : [ {
    "min_version" : "",
    "links" : {
      "rel" : "self",
      "href" : "https://roma.example.com/v1"
    },
    "id" : "v1",
    "updated" : "2018-06-28T12:20:21Z",
    "version" : "",
    "status" : "SUPPORTED"
  }, {
    "min_version" : "",
    "links" : {
      "rel" : "self",
      "href" : "https://roma.example.com/v2"
    },
    "id" : "v2",
    "updated" : "2020-06-28T12:20:21Z",
    "version" : "",
    "status" : "CURRENT"
  } ],
  "scene" : null
}