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

查询指定版本信息(OpenStack原生)

功能介绍

查询指定版本API的信息,包括该版本API的兼容性、域名信息等。

URI

GET /{api_version}

参数说明请参见表1

表1 参数说明

参数

是否必选

参数类型

描述

api_version

String

API版本号。例如:v2.0

请求消息

请求参数

请求示例

查询指定版本API的信息。

GET https://{Endpoint}/v2.0

响应消息

  • 响应参数

    参数

    参数类型

    描述

    versions

    Array of objects

    版本信息。

    详情请参见表2

    表2 versions字段说明

    参数

    参数类型

    描述

    status

    String

    接口状态。

    id

    String

    接口ID。

    links

    Array of objects

    自描述信息。

    详情请参见表3

    表3 versions.links字段说明

    参数

    参数类型

    描述

    href

    String

    域名。

    rel

    String

    域名描述。

  • 响应样例
    STATUS CODE 300
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    {
        "versions": [
            {
                "status": "SUPPORTED",
                "id": "v2.0",
                "links": [
                    {
                        "href": "https://image.az1.dc1.domainname.com/v2/",
                        "rel": "self"
                    }
                ]
            }
        ]
    }
    

返回值

  • 正常

    300

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。