更新时间:2024-04-19 GMT+08:00

查询所有API版本信息

功能介绍

查询容器镜像服务所有可用的API版本信息列表。

URI

GET /

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json

缺省值:application/json

X-Auth-Token

String

用户Token。

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

响应消息

  • 响应参数
    状态码: 200
    表2 Response Body参数说明

    参数

    参数类型

    描述

    versions

    Array of objects

    描述version相关对象的列表

    表3 versions参数说明

    参数

    参数类型

    描述

    id

    String

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

    links

    Object

    API的URL地址

    version

    String

    若该版本API支持微版本,则为支持的最大微版本号;如果不支持微版本,则为空。

    status

    String

    版本状态,为如下3种:

    • CURRENT:表示该版本为主推版本。
    • SUPPORTED:表示为老版本,但是现在还继续支持。
    • DEPRECATED:表示为废弃版本,存在后续删除的可能。

    updated

    String

    版本发布时间,以UTC时间表示。如v2发布的时间2014-06-28T12:20:21Z。

    min_version

    String

    若该版本API支持微版本,则为支持的最小微版本号;如果不支持微版本,则为空。

    表4 links参数说明

    参数

    参数类型

    描述

    href

    String

    链接

    rel

    String

    描述

  • 响应样例
    { 
       "versions": [
            {
                "id": "v2",
                "links": 
                    {
                        "href": "https://xxx",
                        "rel": "self"
                    }
                "min_version": "2.0",
                "status": "CURRENT",
                "updated": "2020-07-09T00:00:00Z",
                "version": "2.26",
            }
        ]
    }

状态码

状态码

说明

200

请求成功

500

内部错误

错误码

请参见错误码