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-04-27 GMT+08:00

Obtención de detalles de una versión de API

Función

Esta API se utiliza para consultar los detalles de una versión de API de DSS.

URI

GET /{api_version}

Tabla 1 describe el parámetro.
Tabla 1 Descripción de parámetro

Parámetro

Obligatorio

Tipo

Descripción

api_version

String

Especifica el número de versión de destino.

Para obtener el número de versión, consulte Obtención de detalles de versiones de API.

Solicitud

  • Parámetros de solicitud

    Ninguna

  • Solicitud de ejemplo

    En el siguiente ejemplo se muestra cómo consultar información de versión de una v1 API.

    GET https://{endpoint}/v1

Respuesta

Parámetros de respuesta

Tabla 2 describe los parámetros de respuesta.
Tabla 2 Parámetros de respuesta

Parámetro

Tipo

Descripción

version

Object

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

id

String

Especifica el ID de versión, por ejemplo v1.

links

Array

Especifica la URL de la API. Para obtener más información, consulte Tabla 3.

version

String

Especifica la microversión máxima admitida por esta API.

status

String

Especifica el estado de la versión. El valor puede ser el siguiente:

CURRENT: indica que la versión está actualmente recomendada para su uso.

SUPPORTED: indica que la versión es una versión antigua, pero sigue siendo compatible.

DEPRECATED: indica una versión obsoleta que puede eliminarse más tarde.

updated

String

Especifica la hora en que se publicó la versión de la API.

Formato de hora: UTC AAAA-MM-DDTHH:MM:SS

min_version

String

Especifica la microversión mínima admitida por esta API.

Parámetros en el campo links

Tabla 3 describe los parámetros en el campo links.
Tabla 3 Descripción de parámetro

Parámetro

Tipo

Descripción

rel

String

Especifica la descripción del enlace.

href

String

Especifica el enlace de consulta de versión.

  • Ejemplo de respuesta
    {
        "version": {
                "min_version": "", 
                 "links": [
                    {
                        "rel": "self", 
                        "href": "https://dss.localdomain.com/v1"
                    }
                ], 
                "id": "v1", 
                "updated": "2014-06-28T12:20:21Z", 
                "version": "", 
                "status": "CURRENT"
            }
    }

Valor devuelto

Códigos de error

Consulte Códigos de error.