更新时间:2024-03-01 GMT+08:00

查询版本列表(OpenStack原生)

功能介绍

查询API的版本信息列表,包括API的版本兼容性、域名信息等。

URI

GET /

请求消息

  • 请求参数

请求示例

查询API的版本信息列表。

GET https://{Endpoint}/

响应消息

  • 响应参数

    参数

    参数类型

    描述

    versions

    Array of objects

    版本信息。

    详情请参见表1

    表1 versions字段说明

    参数

    参数类型

    描述

    status

    String

    接口状态。

    id

    String

    接口ID。

    links

    Array of objects

    自描述信息。

    详情请参见表2

    表2 versions.links字段说明

    参数

    参数类型

    描述

    href

    String

    域名。

    rel

    String

    域名描述。

  • 响应样例
    STATUS CODE 300
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    {
        "versions": [
            {
                "status": "CURRENT",
                "id": "v2.2",
                "links": [
                    {
                        "href": "https://image.az1.dc1.domainname.com/v2/",
                        "rel": "self"
                    }
                ]
            },
            {
                "status": "SUPPORTED",
                "id": "v2.1",
                "links": [
                    {
                        "href": "https://image.az1.dc1.domainname.com/v2/",
                        "rel": "self"
                    }
                ]
            },
            {
                "status": "SUPPORTED",
                "id": "v2.0",
                "links": [
                    {
                        "href": "https://image.az1.dc1.domainname.com/v2/",
                        "rel": "self"
                    }
                ]
            },
            {
                "status": "DEPRECATED",
                "id": "v1.1",
                "links": [
                    {
                        "href": "https://image.az1.dc1.domainname.com/v1/",
                        "rel": "self"
                    }
                ]
            },
            {
                "status": "DEPRECATED",
                "id": "v1.0",
                "links": [
                    {
                        "href": "https://image.az1.dc1.domainname.com/v1/",
                        "rel": "self"
                    }
                ]
            }
        ]
    }
    

返回值

  • 正常

    300

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。