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 las variantes destinas de ECS a las que se puede cambiar una variante

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

Consulta de las variantes destinas de ECS a las que se puede cambiar una variante

Función

Una variante de ECS no se puede cambiar a ciertas variantes. Esta API se utiliza para consultar las variantes de destino en las que se puede cambiar una variante de ECS especificada.

URI

GET /v1/{project_id}/cloudservers/resize_flavors?instance_uuid={instance_uuid}&source_flavor_id={source_flavor_id}&source_flavor_name={source_flavor_name}

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Descripción
project_id	Yes	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 debe configurar uno de los parámetros instance_uuid, source_flavor_id y source_flavor_name. Si se configuran varios parámetros, el sistema procesa los parámetros instance_uuid, source_flavor_id, y source_flavor_name en orden descendente de forma predeterminada.

Si se utiliza instance_uuid para consultar las variantes a las que se puede cambiar, solo se devuelven las variantes que admiten la imagen basada en la que se crea el ECS de destino. La razón es la siguiente: Las imágenes se basan en las variantes. Si se crea un ECS usando una imagen pública, la API filtra las variantes admitidas por la imagen.

Tabla 2 describe los parámetros de consulta.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
instance_uuid	No	String	Especifica el ID de ECS de destino en formato UUID.
source_flavor_id	No	String	Especifica el ID de variante de origen.
source_flavor_name	No	String	Especifica el nombre de la variante de origen.
sort_key	No	String	Indica el campo para ordenar. Opciones: flavorid: indica el ID dla variante. El valor predeterminado es flavorid. name: indica el nombre dla variante. memory_mb: indica el tamaño de la memoria. vcpus: indica el número de vCPUs. root_gb: indica el tamaño del disco del sistema.
sort_dir	No	String	Especifica la clasificación ascendente (asc) o descendente (desc). Opciones: asc: indica el orden ascendente. desc: indica el orden descendente.
limit	No	Integer	Especifica el número máximo de variantes que se pueden mostrar en una página. El valor predeterminado es 1000.
marker	No	String	Especifica el identificador de la última variante de una página como marcador de paginación.

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 identificador de variante de ECS.
name	String	Especifica el nombre de variante de ECS.
vcpus	String	Especifica el número de CPU virtuales 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.
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 el vínculo de acceso directo de la variante de ECS. Para más detalles, consulte Tabla 5.
extra_specs	Object	Especifica el campo extendido de las especificaciones de ECS. Para más detalles, consulte Tabla 6.
instance_quota	Object	Este es un parámetro reservado.

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

Ejemplo de la solicitud

GET https://{endpoint}/v1/{project_id}/cloudservers/resize_flavors?source_flavor_id=c3.xlarge.2

Ejemplo de la respuesta

{
    "flavors": [
        {
            "id": "c3.15xlarge.2",
            "name": "c3.15xlarge.2",
            "vcpus": "60",
            "ram": 131072,
            "disk": "0",
            "swap": "",
            "links": [
                {
                    "rel": "self",
                    "href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.2",
                    "type": null
                },
                {
                    "rel": "bookmark",
                    "href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.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,
            "extra_specs": {
                "ecs:virtualization_env_types": "CloudCompute",
                "ecs:generation": "c3",
                "ecs:performancetype": "computingv3",
                "resource_type": "IOoptimizedC3_2"
             }
        }
    ]
}