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.
Actualización más reciente 2022-11-08 GMT+08:00

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

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

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

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

Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

resize

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.

  • Si la comprobación falla, el sistema devuelve un error.
  • Si la comprobación tiene éxito, el sistema devuelve el código de estado 202.

false: La solicitud se envía y las especificaciones de ECS se modificarán si la comprobación se realiza correctamente.

Tabla 2 Descripción del campo resize

Parámetro

Obligatorio

Tipo

Descripción

flavorRef

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:
  • No se admiten modificaciones entre el mismo variante.

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.

Tabla 3 Descripción del campo extendparam

Parámetro

Obligatorio

Tipo

Descripción

isAutoPay

No

String

Especifica si el pedido se paga automáticamente o manualmente.

  • true: El pedido se pagará automáticamente.
  • false: El pedido debe ser pagado 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

Tabla 4 Descripción del parámetro

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"
    }
}

Códigos de error

Consulte Códigos de error