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 2022-11-08 GMT+08:00

Consulta de una versión de API

Función

Esta interfaz se utiliza para consultar una versión de API especificada del servicio AS.

URI

GET /{api_version}

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

api_version

String

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

Mensaje de solicitud

  • Parámetros de solicitud

    No hay

  • Ejemplo de la solicitud

    Este ejemplo muestra cómo consultar la API V1 AS.

    GET https://{Endpoint}/v1

Mensaje de la respuesta

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

    Parámetro

    Tipo

    Descripción

    version

    version object

    Especifica una versión de API especificada.

    Tabla 3 Descripción del campo version

    Parámetro

    Tipo

    Descripción

    id

    String

    Especifica el ID de versión de la API.

    links

    Array of links objects

    Especifica la URL de la API. Para más detalles, consulte Tabla 4.

    min_version

    String

    Especifica el número de versión de la API admitida más antiguo.

    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 la fecha de lanzamiento de una versión de API.

    version

    String

    Especifica el número de versión de la API admitida más reciente.

    Tabla 4 Descripción del campo links

    Parámetro

    Tipo

    Descripción

    href

    String

    Especifica el localizador uniforme de recursos (URL) de la API.

    rel

    String

    Especifica la dependencia URL de la API.

  • Ejemplo de la respuesta
    {
      "version": {
        "id": "v1",
        "links": [
          {
            "href": "https://as.XXX.mycloud.com/autoscaling-api/v1/",
            "rel": "self"
          }
        ],
        "min_version": "",
        "status": "CURRENT",
        "updated": "2016-06-30T00:00:00Z",
        "version": ""
      }
    }

Valores devueltos

  • Normal

    200

  • Anormal

    Valor devuelto

    Descripción

    400 Bad Request

    Se produjo un error en el servidor al procesar la solicitud.

    401 Unauthorized

    Debe introducir el nombre de usuario y la contraseña para acceder a la página solicitada.

    403 Forbidden

    Está prohibido el acceso a la página solicitada.

    404 Not Found

    No se pudo encontrar la página solicitada.

    405 Method Not Allowed

    No se le permite utilizar el método especificado en la solicitud.

    406 Not Acceptable

    El cliente no pudo aceptar la respuesta generada por el servidor.

    407 Proxy Authentication Required

    Debe utilizar el servidor proxy para la autenticación para que la solicitud pueda procesarse.

    408 Request Timeout

    Se agotó el tiempo de espera de la solicitud.

    409 Conflict

    La solicitud no se pudo procesar debido a un conflicto.

    500 Internal Server Error

    Se produjo un error al completar la solicitud debido a un problema de servicio interno.

    501 Not Implemented

    Error al completar la solicitud porque el servidor no admite la función solicitada.

    502 Bad Gateway

    Error al completar la solicitud porque la solicitud no es válida.

    503 Service Unavailable

    Error al completar la solicitud porque el sistema no está disponible.

    504 Gateway Timeout

    Se ha producido un error de tiempo de espera de la puerta de enlace.

Códigos de error

Consulte Códigos de error