Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2023-03-02 GMT+08:00

Consulta de una versión de API

Función

Esta API se utiliza para consultar una versión de API especificada.

URI

GET /{api_version}

Tabla 1 describe los parámetros.

Tabla 1 Descripción de parámetros

Parámetro

Obligatorio

Descripción

api_version

Especifica la versión de la API, por ejemplo, v1.0.

Solicitud

  • Parámetros de solicitud

    Ninguno

  • Solicitud de ejemplo
    GET /v1.0

Respuesta

  • Parámetros de respuesta
    Tabla 2 Parámetros de respuesta

    Parámetro

    Tipo

    Descripción

    version

    Object

    Especifica información sobre una versión de API especificada.

    Tabla 3 Descripción del campo version

    Parámetro

    Tipo

    Descripción

    id

    String

    Especifica el ID de la versión de la API.

    links

    Array of objects

    Especifica la URL de la versión de la API.

    min_version

    String

    Especifica la microversión. Si las API de esta versión admiten microversiones, establezca este parámetro en la microversión mínima admitida. Si la microversión no es compatible, deje este parámetro en blanco.

    status

    String

    Especifica el estado de la versión de la API.

    • CURRENT indica una versión principal.
    • SUPPORTED: indica una versión anterior que todavía es compatible.
    • DEPRECATED indica una versión obsoleta que puede eliminarse más tarde.

    updated

    String

    Especifica el tiempo de actualización de la versión de la API.

    version

    String

    Si las API de esta versión admiten microversiones, establezca este parámetro en la microversión máxima admitida. Si no es así, deje este parámetro en blanco.

    Tabla 4 Descripción del campo links

    Parámetro

    Tipo

    Descripción

    href

    String

    Especifica la URL de la versión de la API.

    rel

    String

    Especifica la dependencia URL de la API.

  • Ejemplo de respuesta
    {
        "version": {
            "id": "v1.0",
            "links": [
                {
                    "href": "https//deh.xxx.com/v1.0/",
                    "rel": "self"
                }
            ],
            "min_version": "",
            "status": "SUPPORTED",
            "updated": "2016-12-01T11:33:21Z",
            "version": ""
        }
    }

Código de estado

Véase Códigos de estado.