更新时间:2022-01-10 GMT+08:00
分享

查询SMN API V2版本信息

功能介绍

查询SMN API V2版本信息。

调试

您可以在API Explorer中调试该接口。

URI

GET /{api_version}

表1 路径参数

参数

是否必选

参数类型

描述

api_version

String

待查询版本号。当前仅支持v2。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

version

Object

描述version相关对象的列表。

表4 VersionItem

参数

参数类型

描述

id

String

版本ID(版本号),如v2。

min_version

String

若该版本API支持微版本,则返回支持的最小微版本号;若不支持微版本,则返回空。

status

String

版本状态,为如下3种:

CURRENT:表示该版本为主推版本。

SUPPORTED:表示为老版本,但是现在还继续支持。

DEPRECATED:表示为废弃版本,存在后续删除的可能。

updated

String

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

version

String

若该版本API支持微版本,则返回支持的最大微版本号;若不支持微版本,则返回空。

links

Array of LinksItem objects

API的URL地址。

表5 LinksItem

参数

参数类型

描述

href

String

对应快捷链接。

rel

String

快捷链接标记名称。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码: 403

表7 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码: 404

表8 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码: 500

表9 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

请求示例

GET https://{SMN_Endpoint}/v2

null

响应示例

状态码: 200

OK

{
  "version" : {
    "id" : "v2",
    "links" : [ {
      "href" : "https://127.0.0.1/v2",
      "rel" : "self"
    } ],
    "min_version" : "",
    "status" : "CURRENT",
    "updated" : "2018-09-19T00:00:00Z",
    "version" : ""
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

403

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

分享:

    相关文档

    相关产品

close