Modificación de las especificaciones de un ECS
Función
Esta API se utiliza para modificar las especificaciones de ECS.
La API V1.1 es compatible con todas las funciones (consulte Modificación de las especificaciones de un ECS (Pago por uso)) proporcionadas por la API V1. Además, la API V1.1 admite la modificación de ECS anuales/mensuales.
Restricciones
- Puede modificar las especificaciones de ECS sólo cuando se detenga el ECS.
- Los ECS de spot no admiten la modificación de especificaciones.
URI
POST /v1.1/{project_id}/cloudservers/{server_id}/resize
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. |
server_id |
Sí |
Especifica el ID del ECS. Puede obtener el ID de ECS desde la consola o siguiendo las instrucciones proporcionadas en "Consulta de detalles sobre un ECS". |
Solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
resize |
Sí |
Object |
Especifica la operación para modificar las especificaciones de ECS. Para más detalles, consulte Tabla 2. |
dry_run |
No |
Boolean |
Especifica si sólo se comprobará la solicitud y no se modificarán las especificaciones de ECS. true: La solicitud se envía y las especificaciones de ECS no se modificarán. Los elementos de verificación incluyen parámetros obligatorios y formato de solicitud.
false: La solicitud se envía y las especificaciones de ECS se modificarán si la comprobación se realiza correctamente. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
flavorRef |
Sí |
String |
Especifica el ID de variante del ECS después de la modificación. Puede ver el Consulta de las variantes destinas de ECS a las que se puede cambiar una variante para consultar las variantes de destino a las que se puede cambiar una variante de ECS especificado.
NOTA:
|
dedicated_host_id |
No |
String |
Especifica el nuevo ID de DeH, que sólo se aplica a los ECS de DeHs. |
extendparam |
No |
Object |
Modifique la información extendida sobre un ECS. Para más detalles, consulte Tabla 3. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
isAutoPay |
No |
String |
Especifica si el pedido se paga automáticamente o manualmente.
NOTA:
Este parámetro es válido solo para ECS anuales/mensuales. Cuando este parámetro se deja en blanco, el pedido debe pagarse manualmente por defecto. |
Respuesta
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
job_id |
No |
String |
Especifica el ID de la tarea. Este parámetro se devuelve cuando se modifican las especificaciones de un ECS de pago por uso. Para obtener más información sobre los estados de tareas, consulte Consulta de estado de ejecución de tareas. |
order_id |
No |
String |
Especifica el ID de pedido. Este parámetro se devuelve cuando se modifican las especificaciones de un ECS anual/mensual. |
Ejemplo de la solicitud
POST https://{endpoint}/v1.1/{project_id}/cloudservers/{server_id}/resize
{ "resize": { "flavorRef": "s3.large.2", "dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc", "extendparam":{ "isAutoPay": "true" }, } }
Ejemplo de la respuesta
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
O
{ "order_id": "CS1711152257C60TL", "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
O
{ "error": { "message": "XXXX", "code": "XXX" } }
Valores devueltos
Códigos de error
Consulte Códigos de error