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

查询指定API版本信息

功能介绍

查询容器镜像服务指定API版本信息列表。

URI

GET /{api_version}

参数说明请参见表1

表1 参数说明

参数

是否必选

参数类型

说明

api_version

String

API版本号

请求消息.

  • 请求参数
    表2 请求Header参数

    参数

    是否必选

    参数类型

    描述

    Content-Type

    String

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

    缺省值:application/json

    X-Auth-Token

    String

    用户Token。

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

  • 请求样例
    GET https://{Endpoint}/v2

响应消息

  • 响应参数
    表3 Response Body参数说明

    参数

    参数类型

    描述

    version

    Object

    描述version相关对象

    表4 version参数说明

    参数

    参数类型

    描述

    id

    String

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

    links

    Object

    API的URL地址

    version

    String

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

    status

    String

    版本状态,为如下3种:

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

    updated

    String

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

    min_version

    String

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

    表5 links参数说明

    参数

    参数类型

    描述

    href

    String

    链接

    rel

    String

    描述

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

状态码

状态码

说明

200

请求成功

500

内部错误

错误码

请参见错误码