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

查询指定API版本信息 - ShowApiVersion

功能介绍

查询指定API版本信息

接口约束

无

调用方法

请参见如何调用API。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /{api_version}

表1 路径参数

参数

是否必选

参数类型

描述

api_version

是

String

参数解释：

API版本号。用于指定请求的API版本。

约束限制：

不涉及。

取值范围：

v1、v2。

默认取值：

不涉及。

请求参数

表2 请求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

表3 响应Body参数

参数

参数类型

描述

version

Object

参数解释：

描述version相关对象的列表，VersionDetail对象。

取值范围：

不涉及。

请求示例

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版本信息

相关文档