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.

Centro de ayuda/ Bare Metal Server/ Referencia de la API/ API de BMS/ Consulta de la versión de API/ Consulta de una versión de API

Actualización más reciente 2025-02-18 GMT+08:00

Ver PDF

Consulta de una versión de API

Función

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

URI

GET /{api_version}

Tabla 1 enumera los parámetros.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
api_version	Sí	Especifica la versión de la API, por ejemplo, v1.

Parámetros de solicitud

No hay

Ejemplo de solicitud

Consultar la API V1

     
          GET https://{BMS Endpoint}/v1

Parámetros de respuesta

Parámetro	Tipo	Descripción
version	Object	Especifica una versión de API especificada del servicio de BMS. Para más detalles, consulte Tabla 2.

**Tabla 2** Descripción de la estructura de datos de campo **version**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de versión de la API.
links	Array of objects	Especifica la URL de la API. Para obtener más información, véase Tabla 3.
min_version	String	Especifica la versión más antigua de la micro API que se admite.
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. El formato de marca de tiempo es AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por ejemplo, 2018-09-30T00:00:00Z.
version	String	Especifica la versión más reciente de la micro API que se admite.

**Tabla 3** Descripción de la estructura de datos de campo **links**
Parámetro	Tipo	Descripción
href	String	Especifica el URL de la API.
rel	String	Especifica la dependencia URL de la API. El valor puede ser: self: el enlace de recurso que contiene el número de la versión. Se utiliza cuando se requiere un seguimiento inmediato. bookmark: el enlace de recurso que se puede almacenar durante mucho tiempo.

Ejemplo de respuesta

    
         {
    "version": {
        "id": "v1",
        "links": [
            {
                "href": "http://bms.xxx.com/v1/",
                "rel": "self"
            }
        ],
        "min_version": "",
        "status": "CURRENT",
        "updated": "2018-09-30T00:00:00Z",
        "version": ""
    }
}