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 (recomendado)/ Gestión de variante/ Consulta de detalles sobre las variantes y la información de variantes extendidas

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

Consulta de detalles sobre las variantes y la información de variantes extendidas

Función.

Esta API se utiliza para consultar detalles sobre variantes de ECS e información extendida sobre variantes.

URI

GET /v1/{project_id}/cloudservers/flavors?availability_zone={availability_zone}

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.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
availability_zone	No	String	Especifica una AZ. Si este parámetro no se deja en blanco, se devuelven las variantes en el estado normal, obt o promotion. Consulte Regiones y endpoint.

Solicitud

No hay

Respuesta

Tabla 3 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.

**Tabla 4** Descripción del campo **flavors**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de la variante de ECS.
name	String	Especifica el nombre de la variante de ECS.
vcpus	String	Especifica el número de vCPU en la variante de ECS.
ram	Integer	Especifica el tamaño de memoria (MB) en la variante de ECS.
disk	String	Especifica el tamaño del disco del sistema en la variante de ECS. Este parámetro no se ha utilizado. Su valor predeterminado es 0.
swap	String	Especifica el tamaño de partición de intercambio requerido por la variante de ECS. Este parámetro no se ha utilizado. Su valor predeterminado es "".
OS-FLV-EXT-DATA:ephemeral	Integer	Especifica el tamaño del disco temporal. Este es un atributo extendido. Este parámetro no se ha utilizado. Su valor predeterminado es 0.
OS-FLV-DISABLED:disabled	Boolean	Especifica si se ha deshabilitado la variante de ECS. Este es un atributo extendido. Este parámetro no se ha utilizado. Su valor predeterminado es false.
rxtx_factor	Float	Especifica la relación entre el ancho de banda de red disponible y el ancho de banda de hardware de red del ECS. Este parámetro no se ha utilizado. Su valor predeterminado es 1.0.
rxtx_quota	String	Especifica las restricciones de software del ancho de banda de red que puede utilizar el ECS. Este parámetro no se ha utilizado. Su valor predeterminado es null.
rxtx_cap	String	Especifica las restricciones de hardware del ancho de banda de red que puede utilizar el ECS. Este parámetro no se ha utilizado. Su valor predeterminado es null.
os-flavor-access:is_public	Boolean	Especifica si una variante está disponible para todos los tenant. Este es un atributo extendido. true: indica que una variante está disponible para todos los tenant. false: indica que un sabor solo está disponible para ciertos tenant. Valor predeterminado: true
links	Array of objects	Especifica los vínculos de acceso directo para las variantes de ECS. Para más detalles, consulte Tabla 5.
os_extra_specs	Object	Especifica las especificaciones ampliadas de ECS. Para más detalles, consulte Tabla 6.
attachableQuantity	Object	Especifica el número de NIC y discos que se pueden conectar a un ECS. Para más detalles, consulte Tabla 7.

**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	Proporciona el enlace de acceso directo correspondiente.
type	String	Especifica el tipo de enlace de acceso directo. Este parámetro no se ha utilizado. Su valor predeterminado es null.

**Tabla 6** Descripción del campo **os_extra_specs** (solo se muestran los parámetros comunes)
Parámetro	Tipo	Descripción
ecs:performancetype	String	Especifica el tipo de variante de ECS: normal: cómputo general cpuv1: cómputo I cpuv2: cómputo II computingv3: Cómputo-plus highmem: memoria optimizada saphana: ECS HANA de gran memoria diskintensive: uso intensivo de disco
hw:numa_nodes	String	Especifica el número de CPU físicas del host. El variante de ECS determina si se debe devolver el valor del parámetro.
resource_type	String	Especifica el tipo de recurso. resource_type se utiliza para diferenciar entre los tipos de servidores físicos que alojan los ECS.
hpet_support	String	Especifica si se activa el reloj de alta precisión en el ECS. true indica habilitar la función, y false indica deshabilitar la función. Las especificaciones de ECS determinan si se devuelve el valor del parámetro.
instance_vnic:type	String	Especifica el tipo de NIC. El valor de este parámetro es consistentemente enhanced, lo que indica que se van a crear ECS de mejora de red.
instance_vnic:instance_bandwidth	String	Especifica el ancho de banda máximo en la unidad de Mbit/s. El valor máximo de este parámetro es 10000.
instance_vnic:max_count	String	Especifica el número máximo de NIC. El valor máximo de este parámetro es 4.
quota:local_disk	String	El valor de este parámetro tiene el formato "{type}:{count}:{size}:{safeFormat}", donde, type: indica el tipo de disco, que solo puede ser HDD. count: indica el número de discos locales. Para los ECS D1, el valor puede ser 3, 6, 12 o 24. Para ECS D2, el valor puede ser 2, 4, 8, 12, 16 o 24. Para ECS D3, el valor puede ser 2, 4, 8, 12, 16, 24 o 28. size: indica la capacidad de un solo disco, en GB. Actualmente, solo se admite 1675. El tamaño real del disco es 1800, y el tamaño disponible después de formatear es 1675. safeFormat: indica si los discos locales de ECS están formateados de forma segura. Para los ECS D1, el valor es FALSE. Para ECS D2 o D3, el valor es True. NOTA: Este campo está dedicado a ECS con uso intensivo de disco.
quota:nvme_ssd	String	El valor de este parámetro tiene el formato de {type}:{spec}:{num}:{size}:{safeFormat}:. type: indica la capacidad de un solo disco SSD NVME conectado al ECS, que solo puede ser de 1.6 TB o 3.2 TB. spec: indica la especificación del disco SSD NVME, que puede ser large o small. Si el valor es large, solo se admiten ECS I3. num: indica el número de particiones en el disco. size: indica la capacidad, en la unidad de GB, del disco utilizado por el usuario invitado.If the spec value is large, the value of this parameter is the size of a single disk attached to the ECS. Si el valor de spec es small, el valor de este parámetro es 1/4 o 1/2 de la especificación. safeFormat: indica si los discos locales del ECS están formateados de forma segura. Si el valor es True, sólo se admiten ECS I3. NOTA: Este campo está dedicado a ECS con capacidad ultraalta de E/S.
extra_spec:io:persistent_grant	String	Especifica si se admite la persistencia. El valor de este parámetro es true. Este parámetro indica que el ECS está autorizado persistentemente para acceder al almacenamiento. NOTA: Este campo está dedicado a ECS D1 con uso intensivo de disco.
ecs:generation	StECS	n tipo de ECS. Por ejemplo, 3 en s3 indica los ECS de tercera generación de propósito general. Para obtener más información acerca de las variantes y las generaciones, consulte Especificaciones de ECS en la Guía del usuario de Elastic Cloud Server.
ecs:virtualization_env_types	String	Especifica un tipo de virtualización. ECSusionCompute, el ECS utiliza la virtualización Xen. CloudCompute, el ECS utiliza la virtualización KVM. NOTA: Este campo es opcional.
cond:operation:status	String	Este parámetro tiene efecto en toda la región. Si no se configura un AZ en el parámetro cond:operation:az, el valor de este parámetro se utiliza por defecto. Si este parámetro no se establece o se utiliza, se aplica el significado normal. Opciones: normal: indica el uso comercial normal de la variante. abandon: indica que la variante ha sido cancelada (no mostrado). sellout: indica que la variante se ha agotado. obt: indica que la variante está bajo prueba beta abierta (OBT). obt_sellout: indica que los recursos OBT están agotados. promotion: indica la variante recomendado (uso comercial, que es similar al normal).
cond:operation:az	String	Este parámetro tiene efecto AZ-wide. Si no se configura un AZ en este parámetro, el valor del parámetro cond:operation:status se utiliza de forma predeterminada. Este parámetro tiene el formato de "az (xxx) ". El valor entre paréntesis es el estado de variante en una AZ. Si los paréntesis se dejan en blanco, la configuración no es válida. Las opciones cond:operation:az son las mismas que las opciones cond:operation:status. Por ejemplo, una variante es para el uso comercial en AZs 0 y 3, agotado en AZ 1, para OBT en AZ 2, y se cancela en otros AZs. A continuación, establezca los parámetros de la siguiente manera: cond:operation:status: abandon cond:operation:az: az0(normal), az1(sellout), az2(obt), az3(normal) NOTA: Configure este parámetro si el estado de variante en una AZ es diferente del valor cond:operation:status.
quota:max_rate	String	Especifica el ancho de banda máximo. Unidad: Mbit/s. Si un ancho de banda está en la unidad de Gbit/s, debe dividirse entre 1000.
quota:min_rate	String	Especificó el ancho de banda asegurado. Unidad: Mbit/s. Si un ancho de banda está en la unidad de Gbit/s, debe dividirse entre 1000.
quota:max_pps	String	Especifica el PPS máximo de intranet. Unidad: número. Si un valor está en la unidad de 10000, debe dividirse entre 10000.
cond:operation:charge:stop	String	Especifica si se facturan tarifas por un ECS detenido. Sin comisiones por defecto Cargar Gratis
cond:operation:charge	String	Especifica un tipo de facturación. Ambos tipos de facturación son compatibles si este parámetro no está definido. Anual/Mensual Pago por uso
cond:spot:operation:az	String	Especifica el AZ para las variantes en el modo de facturación de precios al contado.
cond:operation:roles	String	Especifica los roles permitidos. Etiqueta de usuario coincidente (roles op_gatexxx), que está disponible para todos los usuarios si este parámetro no está definido
cond:spot:operation:status	String	Especifica el estado de un tipo en el modo de facturación de precios al contado. Equivalente a abandon si este parámetro no está definido. normal: indica el uso comercial dla variante. abandon: indica que la variante se ha terminado. sellout: indica que la variante se ha agotado. obt: indica que la variante está en fase OBT (no soportado actualmente). private: indica que la variante es privada, que solo está disponible para usuarios especificados (no soportado actualmente). test: indica que la variante está en fase de prueba gratuita (no soportado actualmente). promotion: indica que se recomienda la variante.
cond:network	String	Especifica las restricciones de red. Las funciones de red son compatibles. Si este parámetro no está definido, se utiliza la configuración predeterminada en la consola.
cond:storage	String	Especifica las restricciones de almacenamiento. Se admiten las funciones de disco. Si este parámetro no está definido, se utiliza la configuración predeterminada en la consola. scsi: indica que se admite SCSI. localdisk: indica que se admiten discos locales. ib: indica que el IB es compatible.
cond:compute:live_resizable	String	Especifica las restricciones de cálculo. Si el valor de este parámetro es true, se admite la expansión de capacidad en línea. Si este parámetro no existe o su valor se establece en false, no se admite la expansión de capacidad en línea.
cond:compute	String	Especifica las restricciones de cálculo. autorecovery: indica que se admite la recuperación automática. Si este parámetro no existe, no se admite la recuperación automática.
ecs:instance_architecture	String	Especifica la arquitectura de CPU correspondiente a la variante. Este parámetro se devuelve solo para los ECS de Kunpeng. El valor arm64 indica que la arquitectura de CPU es Kunpeng.
info:gpu:name	String	Especifica el número y los nombres de las GPU.
info:cpu:name	String	Especifica el nombre de la CPU.
quota:gpu	String	Especifica el nombre de la GPU.

**Tabla 7** Descripción del campo **attachableQuantity**
Parámetro	Tipo	Descripción
free_scsi	Integer	Especifica el número de discos SCSI que se pueden conectar.
free_blk	Integer	Especifica el número de discos VBD que se pueden conectar.
free_disk	Integer	Especifica el número de discos que se pueden adjuntar.
free_nic	Integer	Especifica el número de NIC que se pueden conectar.

Para obtener más información, consulte "Especificaciones y tipos de ECS" en Guía del usuario de Elastic Cloud Server.

Ejemplo de la solicitud

GET https://{endpoint}/v1/{project_id}/cloudservers/flavors?availability_zone=availability_value

Ejemplo de la respuesta

{
    "flavors": [
        {
            "attachableQuantity": {
                "free_scsi": 60,
                "free_blk": 24,
                "free_disk": 60,
                "free_nic": 12
            },
            "id": "c3.2xlarge.2",
            "name": "c3.2xlarge.2",
            "vcpus": "8",
            "ram": 16384,
            "disk": "0",
            "swap": "",
            "links": [
                {
                    "rel": "self",
                    "href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
                    "type": null
                },
                {
                    "rel": "bookmark",
                    "href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
                    "type": null
                }
            ],
            "OS-FLV-EXT-DATA:ephemeral": 0,
            "rxtx_factor": 1,
            "OS-FLV-DISABLED:disabled": false,
            "rxtx_quota": null,
            "rxtx_cap": null,
            "os-flavor-access:is_public": true,
            "os_extra_specs": {
                "ecs:virtualization_env_types": "CloudCompute",
                "ecs:generation": "c3",
                "ecs:instance_architecture":"arm64" ,
                "ecs:performancetype": "computingv3",
                "resource_type": "IOoptimizedC3_2"
            }
        }
    ]
}