更新时间:2023-12-15 GMT+08:00

查询指定API版本信息

功能介绍

查询指定API版本信息

接口约束

调用方法

请参见如何调用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 支持微版本,则填支持的最小微版本号, 如果不支持微版本,则填空。

请求示例

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

内部错误

错误码

请参见错误码