更新时间:2025-09-23 GMT+08:00
分享

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

功能介绍

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

URI

GET /{version}

参数说明请参见表1

表1 参数说明

参数

是否必选

参数类型

描述

version

String

API版本号。例如:v2.0

请求消息

请求参数

请求示例

查询指定版本API的信息。

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

响应消息

  • 响应参数

    参数

    参数类型

    描述

    versions

    Array of objects

    版本信息。

    详情请参见表2

    表2 versions字段说明

    参数

    参数类型

    描述

    status

    String

    接口状态。

    取值范围:

    • CURRENT: 这是使用的API的首选版本。
    • SUPPORTED : 这是一个较老的,但仍然支持的API版本。
    • DEPRECATED: 一个被废弃的API版本,该版本将被删除。

    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

    服务不可用。

相关文档