文档首页> > API参考> API说明> 获取接口版本号列表

获取接口版本号列表

分享
更新时间: 2019/07/08 00:32

功能介绍

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

URI

GET /

请求消息

  • 请求参数

  • 请求样例

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

    GET https://{endpoint}/

响应消息

响应参数

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

参数名称

类型

说明

versions

Array

描述version 相关对象的列表

id

String

版本ID(版本号),如v1

links

Dict

APIURL地址,详细信息请参考表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"
            }
        ]
    }

返回值

错误码

请参考错误码说明

如果您喜欢这篇文档,您还可以:

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区