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/ Dedicated Distributed Storage Service/ Referencia de la API/ Descripción de la API/ Obtención de detalles de una versión de API

Actualización más reciente 2023-04-27 GMT+08:00

Ver PDF

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	Sí	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"
        }
}