更新时间:2023-11-20 GMT+08:00

查询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"
      }
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码