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 2025-02-26 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 de ECS compatibles en la región actual.

Huawei Cloud dejó de proporcionar imágenes de Windows. Esta interfaz ya no se utilizará para consultar imágenes de Windows.

URI

GET /v1/cloudimages/os_version

**Tabla 1** Descripción de parámetros
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 de 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
Ninguna

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 obtener más información, véase 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. Consulte Tabla 3 para obtener más detalles.

**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 SO.

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

Valor devuelto	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.