查询API版本信息

功能介绍

查询API指定版本信息。

• 调用接口前，您需要了解API 认证鉴权。

URI

• URI格式

  GET /rds/{version}

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  version	是	API版本号，区分大小写。 详情请参考查询API版本列表响应消息表2中的“id”。

请求消息

• 请求参数

  无。

• URI样例

  GET https://{endpoint}/rds/v1

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  versions	Object	API版本详细信息列表。 详情请参见表3。
  version	Object	API版本详细信息列表。 详情请参见表3。

  表3 versions字段数据结构说明

  名称	参数类型	说明
  id	String	API版本号。
  links	Array	对应该API版本的链接信息，该字段为空。 详情请参见表4。
  status	String	版本状态。
  updated	String	版本更新时间，格式为“yyyy-mm-dd Thh:mm:ssZ”。 其中，T指某个时间的开始；Z指UTC时间。

  表4 links字段数据结构说明

  名称	参数类型	说明
  href	String	对应该API的URL，该字段为""。
  rel	String	取值为“self”，表示href为本地链接。

• 正常响应样例

  {
    "version": {
      "id": "v1",
      "links": [],
      "status": "DEPRECATED",
      "updated": "2017-02-07T17:34:02Z"
    },
    "versions": {
      "id": "v1",
      "links": [],
      "status": "DEPRECATED",
      "updated": "2017-02-07T17:34:02Z"
    }
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。