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/ Image Management Service/ Referencia de la API/ Las API de IMS/ Imagen/ Consulta de sistemas operativos de imágenes compatibles

Actualización más reciente 2022-11-07 GMT+08:00

Ver PDF

Consulta de sistemas operativos de imágenes compatibles

Función

Esta interfaz se utiliza para consultar la lista de sistemas operativos ECS compatibles en la región actual.

URI

GET /v1/cloudimages/os_version

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
tag	No	String	Especifica la etiqueta del sistema operativo. Puede consultar sistemas operativos con características especificadas en función del valor de etiqueta. Los valores posibles son los siguientes: bms: indica las versiones del sistema operativo BMS compatibles con la imagen. uefi: indica las versiones del sistema operativo que admiten el modo de arranque UEFI. Si no se especifica este parámetro, se deben consultar todos los sistemas operativos admitidos en la región actual.

Solicitud

Parámetros de solicitud
Ninguno
Ejemplo de solicitud
- Consulta de sistemas operativos compatibles
```
GET https://{Endpoint}/v1/cloudimages/os_version
```
- Consulta de sistemas operativos compatibles por filtros
```
GET https://{Endpoint}/v1/cloudimages/os_version?tag=kvm&tag=uefi
```

Respuesta

Parámetros de respuesta

Parámetro	Tipo	Descripción
[Array]	Array of objects	Para más detalles, consulte Tabla 2.

**Tabla 2** Descripción de la estructura de datos del campo [Array]
Parámetro	Tipo	Descripción
platform	String	Especifica la plataforma del sistema operativo.
version_list	Array of objects	Especifica los detalles del sistema operativo devueltos. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción de la estructura de datos del campo [Array].version_list
Parámetro	Tipo	Descripción
platform	String	Especifica la plataforma del sistema operativo.
os_version_key	String	Especifica el valor de clave del sistema operativo. El valor de clave predeterminado es el valor de os_version.
os_version	String	Especifica la información completa del sistema operativo.
os_bit	Integer	Especifica el bit del sistema operativo.
os_type	String	Especifica el tipo de sistema operativo.

Ejemplo de respuesta

STATUS CODE 200

      
       
         
         
           [
    {
        "platform": "SUSE",
        "version_list": [
            {
                "platform": "SUSE",
                "os_version_key": "SUSE Linux Enterprise Server 15 64bit",
                "os_version": "SUSE Linux Enterprise Server 15 64bit",
                "os_bit": 64,
                "os_type": "Linux"
            },
            {
                "platform": "SUSE",
                "os_version_key": "SUSE Linux Enterprise Server 12 SP3 64bit",
                "os_version": "SUSE Linux Enterprise Server 12 SP3 64bit",
                "os_bit": 64,
                "os_type": "Linux"
            }
        ]
    },
    {
        "platform": "Other",
        "version_list": [
            {
                "platform": "Other",
                "os_version_key": "Other(32 bit)",
                "os_version": "Other(32 bit)",
                "os_bit": 32,
                "os_type": "Linux"
            }
        ]
    }
]

          

        

      
     

Valores devueltos

Normal
200

Anormal

Valores devueltos	Descripción
400 Bad Request	Error de solicitud. Para obtener más información sobre el código de error devuelto, consulte Códigos de error.
401 Unauthorized	Error de autenticación.
403 Forbidden	Usted no tiene los derechos para realizar la operación.
404 Not Found	No se encontró el recurso solicitado.
500 Internal Server Error	Error interno del servicio.
503 Service Unavailable	El servicio no está disponible.