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 nativa de Nova V2.1 de OpenStack/ Consulta de la variante de BMS/ Consulta de variantes del BMS (API nativa de OpenStack)

Actualización más reciente 2023-03-20 GMT+08:00

Ver PDF

Consulta de variantes del BMS (API nativa de OpenStack)

Función

Esta API se utiliza para consultar las variantes del BMS.

Restricciones

Las variantes que obtuvo con esta API son todas las variantes en el sistema. Las variantes cuyos nombres comienzan con physical son las variantes del BMS y se pueden utilizar para crear los BMS.

URI

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

Tabla 1 enumera los parámetros.

**Tabla 1** Descripción del parámetro
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 del proyecto, consulte Obtención de un ID de proyecto.

Tabla 2 enumera los parámetros opcionales que se pueden usar para consultar las variantes del BMS.

**Tabla 2** Parámetros opcionales
Parámetro	Obligatorio	Tipo	Descripción
minDisk	No	String	Especifica el tamaño mínimo del disco en GB. Sólo se pueden consultar los BMS con un tamaño de disco mayor o igual que el tamaño mínimo.
minRam	No	String	Especifica el tamaño mínimo de memoria en MB. Solo se pueden consultar los BMS con un tamaño de memoria mayor o igual que el tamaño mínimo.
sort_key	No	String	Especifica el campo de la ordenación. El 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 de las variantes de BMS. El valor puede ser asc o desc y es asc de forma predeterminada.

Solicitud

Parámetros de solicitud
No hay

Ejemplo de la solicitud

Sin parámetro opcional

        
             GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail

Con un parámetro opcional

        
             GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725

Con múltiples parámetros opcionales

        
             GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725&is_public=true

Respuesta

Parámetros de respuesta

Parámetro	Tipo	Descripción
flavors	Array of objects	Especifica las variantes del BMS. Para obtener más información, véase Tabla 3.

**Tabla 3** Descripción de la estructura de datos de campo **flavors**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de la variante del BMS.
name	String	Especifica el nombre de la variante del BMS.
vcpus	Integer	Especifica el número de los núcleos de CPU de la variante del BMS.
ram	Integer	Especifica el tamaño de memoria (MB) en la variante del BMS.
disk	Integer	Especifica el tamaño de disco (GB) en la variante del BMS.
swap	String	Este es un atributo reservado.
OS-FLV-EXT-DATA:ephemeral	Integer	Este es un atributo reservado.
OS-FLV-DISABLED:disabled	Boolean	Este es un atributo reservado.
rxtx_factor	Float	Este es un atributo reservado.
os-flavor-access:is_public	Boolean	Este es un atributo reservado.
links	Array of objects	Especifica los enlaces de acceso directo de la variante del BMS. Para obtener más información, véase Tabla 4.

**Tabla 4** Descripción de la estructura de datos de campo **links**
Parámetro	Tipo	Descripción
rel	String	Especifica el nombre del marcador del enlace de acceso directo. 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.
href	String	Especifica el enlace de acceso directo correspondiente.

Ejemplo de la respuesta

{
    "flavors": [
        {
            "name": "physical.o2.medium",
            "links": [
                {
                    "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
                    "rel": "self"
                },
                {
                    "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
                    "rel": "bookmark"
                 }
            ],
            "ram": 321725,
            "OS-FLV-DISABLED:disabled": false,
            "vcpus": 56,
            "swap": "",
            "os-flavor-access:is_public": true,
            "rxtx_factor": 1,
            "OS-FLV-EXT-DATA:ephemeral": 0,
            "disk": 3725,
            "id": "physical.o2.medium"
        }
    ]
                }