文档首页/ 容器镜像服务 SWR/ API参考（基础版）/ API/ API版本信息/ 查询指定API版本信息 - ShowApiVersion
更新时间：2025-10-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询指定API版本信息 - ShowApiVersion

功能介绍

查询指定API版本信息

接口约束

无

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

URI

GET /{api_version}

表1 路径参数

参数

是否必选

参数类型

描述

api_version

是

String

API版本号。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json

缺省值：application/json

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

version

VersionDetail object

描述version相关对象的列表
表4 VersionDetail

参数

参数类型

描述

id

String

版本ID（版本号)。

links

Link object

API的URL地址

version

String

若该版本API支持微版本，则填支持的最大微版本号，如果不支持微版本，则填空。

status

String

版本状态，为如下3种：

  • CURRENT：表示该版本为主推版本；
  • SUPPORTED：表示为老版本，但是现在还继续支持；
  • DEPRECATED：表示为废弃版本，存在后续删除的可能。

updated

String

版本发布时间，要求用UTC时间表示。如v1发布的时间2014-06-28T12:20:21Z。

min_version

String

若该版本API 支持微版本，则填支持的最小微版本号， 如果不支持微版本，则填空。
表5 Link

参数

参数类型

描述

href

String

链接

rel

String

描述

请求示例

GET https://{endpoint}/{api_version}

响应示例

状态码： 200

查询成功

{
  "version" : {
    "id" : "v2",
    "links" : {
      "href" : "https://swr-api.xxxx.myhuaweicloud.com/v2/",
      "rel" : "self"
    },
    "min_version" : "2.0",
    "status" : "CURRENT",
    "updated" : "2017-12-09T00:00:00Z",
    "version" : "2.26"
  }
}

状态码

状态码

描述

200

查询成功

500

内部错误

错误码

请参见错误码。

父主题： API版本信息