文档首页/ 专属分布式存储服务 DSS/ API参考/ API说明/ 获取接口版本号列表
更新时间：2023-08-04 GMT+08:00
查看PDF
分享

获取接口版本号列表

功能介绍

查询本服务的接口版本号列表。

URI

GET /

请求消息

  • 请求参数

    无

  • 请求样例

    本示例展示了查询当前API所有版本信息。

    GET https://{endpoint}/

响应消息

响应参数

响应参数如表1所示。
表1 响应参数

参数名称

类型

说明

versions

Array

描述version 相关对象的列表。

id

String

版本ID（版本号），如v1。

links

Array of objects

API的URL地址，详细信息请参考表2。

version

String

该版本API支持的最大微版本。

status

String

版本状态，为如下3种：

CURRENT：表示该版本为当前推荐使用的版本。

SUPPORTED：表示为老版本，目前还在继续维护。

DEPRECATED：表示为废弃版本，已不再维护，存在后续删除的可能。

updated

String

版本发布时间。

时间格式：UTC YYYY-MM-DDTHH:MM:SS

min_version

String

该版本API 支持的最小微版本。

links参数信息

links参数信息说明如表2所示。
表2 参数说明

参数名

参数类型

说明

rel

String

链接的描述。

href

String

版本号查询链接。
  • 响应样例 
    {
    "versions": [
        {
            "min_version": "", 
             "links": [
                {
                    "rel": "self", 
                    "href": "https://dss.localdomain.com/v1"
                }
            ], 
            "id": "v1", 
            "updated": "2014-06-28T12:20:21Z", 
            "version": "", 
            "status": "SUPPORTED"
        }, 
        {
            "min_version": "", 
            "links": [
               {
                    "rel": "self", 
                    "href": "https://dss.localdomain.com/v2"
                }
            ], 
            "id": "v2", 
            "updated": "2014-06-28T12:20:21Z", 
            "version": "", 
            "status": "CURRENT"
        }
    ]
}

返回值

错误码

请参考错误码。

父主题： API说明