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/ Elastic Cloud Server/ Referencia de la API/ API de OpenStack Nova/ Gestión de variante/ Consulta de variantes de ECS

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

Ver PDF

Consulta de variantes de ECS

Función

Esta API se utiliza para consultar las variantes disponibles de ECS. Después de recibir la solicitud, Nova utiliza nova-api para ver las variantes de la base de datos.

URI

GET /v2.1/{project_id}/flavors?minDisk={minDisk}&minRam={minRam}&sort_key={sort_key}&sort_dir={sort_dir}

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

Se admite la consulta de paginación. Para más detalles, consulte Consulta de datos en páginas.

Los parámetros de la siguiente tabla se pueden utilizar como parámetros URI para filtrar los resultados de la consulta. Uso: /v2/{project_id}/flavors?minDisk={minDisk}&minRam={minRam}

Tabla 2 describe los parámetros de consulta.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Type	Descripción
minDisk	No	Integer	Especifica la especificación mínima del disco en la unidad de GB. Sólo se pueden consultar los ECS con la especificación de disco mayor o igual que la especificación mínima.
minRam	No	Integer	Especifica la RAM mínima en la unidad de MB. Solo se pueden consultar los ECS con la especificación RAM mayor o igual que la especificación mínima.
sort_key	No	String	Indica un campo de ordenación cuyo valor predeterminado es flavorid. El valor de este parámetro también puede ser name, memory_mb, vcpus, root_gb o flavorid.
sort_dir	No	String	Especifica la clasificación ascendente (asc) o descendente (desc). El valor predeterminado es asc.

Solicitud

No hay

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 3** Parámetros de respuesta
Parámetro	Tipo	Descripción
flavors	Array of objects	Especifica las variantes de ECS. Para más detalles, consulte Tabla 4.
flavors_links	Array of objects	Especifica los vínculos de datos para consultar las páginas siguientes en la consulta de paginación. Para más detalles, consulte Tabla 5.

**Tabla 4** Descripción del campo **flavors**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de variante.
links	Array of objects	Especifica el vínculo de acceso directo de la variante de ECS. Para más detalles, consulte Tabla 5.
name	String	Especifica el nombre de la variante.

**Tabla 5** Descripción del campo **links**
Parámetro	Tipo	Descripción
rel	String	Especifica el nombre del marcador de vínculo de acceso directo.
href	String	Especifica el vínculo de acceso directo.

Ejemplo de la solicitud

GET https://{endpoint}/v2.1/743b4c0428d94531b9f2add666642e6b/flavors

Ejemplo de la respuesta

{
    "flavors": [
        {
            "id": "c3.medium",
            "links": [
                {
                    "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.medium",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.medium",
                    "rel": "bookmark"
                }
            ],
            "name": "c3.medium"
        },
        {
            "id": "c3.xlarge",
            "links": [
                {
                    "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.xlarge",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.x.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.xlarge",
                    "rel": "bookmark"
                }
            ],
            "name": "c3.xlarge"
        }
    ]
}