更新时间：2025-10-22 GMT+08:00
获取API版本列表 - ListApiVersions
功能介绍
获取服务支持的API版本列表。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
versions |
Array of versions objects |
版本定义 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
查询成功 |
错误码
请参见错误码。
父主题： API版本管理
