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}
|
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.
|
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:
|
|
sort_dir |
No |
String |
Especifica la clasificación ascendente (asc) o descendente (desc). Opciones:
|
|
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.
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
flavors |
Array of objects |
Especifica las variantes de ECS. Para más detalles, consulte Tabla 4. |
|
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.
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. |
|
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"
}
}
]
}
Valores devueltos
Códigos de error
Consulte Códigos de error