# 查询所有API版本信息 - ListApiVersions #### 功能介绍 查询所有API版本信息 #### 接口约束 无 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-swr/swr_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-swr/swr_02_0131.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET / #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释**： 消息体的类型（格式），用于指定请求体的MIME类型。 **约束限制**： 不涉及。 **取值范围**： - application/json;charset=utf-8：使用UTF-8字符集的JSON格式 - application/json：标准JSON格式 **默认取值**： 不涉及。 | | X-Auth-Token | 是 | String | **参数解释**： 用户Token。用于调用API时的鉴权。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | versions | Array of [VersionDetail] objects | **参数解释**： 描述version相关对象的列表。 **取值范围**： 不涉及。 | 表3VersionDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 版本ID（版本号)。 **取值范围**： v2。 | | links | [Link] object | **参数解释**： API的URL地址。 **取值范围**： 参见Link定义。 | | version | String | **参数解释**： 若该版本API支持微版本，则填支持的最大微版本号，如果不支持微版本，则填空。 **取值范围**： 当前版本为空。 | | status | String | **参数解释**： 版本状态，为如下3种： CURRENT：表示该版本为主推版本； SUPPORTED：表示为老版本，但是现在还继续支持； DEPRECATED：表示为废弃版本，存在后续删除的可能。 **取值范围**： - CURRENT：表示该版本为主推版本 - SUPPORTED：表示为老版本，但是现在还继续支持 - DEPRECATED：表示为废弃版本，存在后续删除的可能 | | updated | String | **参数解释**： 版本发布时间，要求用UTC时间表示。如v1发布的时间2014-06-28T12:20:21Z。 **取值范围**： 不涉及。 | | min_version | String | **参数解释**： 若该版本API 支持微版本，则填支持的最小微版本号， 如果不支持微版本，则填空。 **取值范围**： 当前版本为空。 | 表4Link | 参数 | 参数类型 | 描述 | |:---|:---|:---| | href | String | **参数解释**： 链接。 **取值范围**： URL格式。 | | rel | String | **参数解释**： 描述。 **取值范围**： self。 | #### 请求示例 ``` 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 | 内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-swr/ErrorCode.html)。