查询所有API版本信息 - ListApiVersions
功能介绍
查询所有API版本信息
接口约束
无
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 参数解释： 消息体的类型（格式），用于指定请求体的MIME类型。 约束限制： 不涉及。 取值范围： 默认取值： 不涉及。 |
| X-Auth-Token | 是 | String | 参数解释： 用户Token。用于调用API时的鉴权。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| versions | Array of VersionDetail objects | 参数解释： 描述version相关对象的列表。 取值范围： 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释： 版本ID（版本号)。 取值范围： v2。 |
| links | Link object | 参数解释： API的URL地址。 取值范围： 参见Link定义。 |
| version | String | 参数解释： 若该版本API支持微版本，则填支持的最大微版本号，如果不支持微版本，则填空。 取值范围： 当前版本为空。 |
| status | String | 参数解释： 版本状态，为如下3种： CURRENT：表示该版本为主推版本； SUPPORTED：表示为老版本，但是现在还继续支持； DEPRECATED：表示为废弃版本，存在后续删除的可能。 取值范围： |
| updated | String | 参数解释： 版本发布时间，要求用UTC时间表示。如v1发布的时间2014-06-28T12:20:21Z。 取值范围： 不涉及。 |
| min_version | String | 参数解释： 若该版本API 支持微版本，则填支持的最小微版本号， 如果不支持微版本，则填空。 取值范围： 当前版本为空。 |
请求示例
GET https://{endpoint} 响应示例
状态码：200
{
"versions" : [ {
"id" : "v2",
"links" : {
"href" : "https://swr-api.xxxx.myhuaweicloud.com/v2/",
"rel" : "self"
},
"min_version" : "2.0",
"status" : "CURRENT",
"updated" : "2020-07-09T00:00:00Z",
"version" : "2.26"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
| 500 | 内部错误 |
错误码
请参见错误码。
