更新时间:2025-04-28 GMT+08:00

获取API版本列表

功能介绍

获取服务支持的API版本列表。

URI

GET /

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

versions

Array of versions objects

版本定义

表3 versions

参数

参数类型

描述

id

String

版本号,如v1

links

Array of links objects

url地址

version

String

若该版本API支持微版本,则为支持的最大微版本号,如果不支持微版本,则为空

min_version

String

若该版本API支持微版本,则为支持的最小微版本号,如果不支持微版本,则为空

status

String

版本状态,支持CURRENT:推荐版本;SUPPORTED:老版本,仍支持使用;DEPRECATED:废弃版本,后续会删除

updated

String

版本发布UTC时间

请求示例

获取API版本列表

/

响应示例

状态码:200

查询成功

{
  "versions" : [ {
    "id" : "v1",
    "links" : [ {
      "href" : "https://eg.cn-north-4.myhuaweicloud.com/v1",
      "rel" : "self"
    } ],
    "version" : "",
    "min_version" : "",
    "status" : "CURRENT",
    "updated" : "2022-04-19T12:20:10Z"
  } ]
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码