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 del ciclo de vida/Supresión de ECS
Actualización más reciente 2025-08-25 GMT+08:00
Ver PDF
Compartir

Supresión de ECS

Función

Esta API se utiliza para eliminar ECS según una lista de ID especificada de ECS.

Puede eliminar un ECS o varios ECS por lotes. Se puede eliminar un máximo de 1000 ECS por lotes.

URI

POST /v1/{project_id}/cloudservers/delete

Tabla 1 describe los parámetros en el URI.
Tabla 1 Descripción del parámetro

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.

Solicitud

Tabla 2 describe los parámetros de solicitud.
Tabla 2 Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

servers

Sí

Array of objects

Especifica los ECS que se van a eliminar. Para más detalles, consulte Tabla 3.

delete_publicip

No

Boolean

Especifica si se debe suprimir el EIP enlazado al ECS cuando se elimina el ECS. Si no desea eliminar el EIP, el sistema solo desvincula el EIP del ECS y reserva la dirección IP.

El valor puede ser true o false.

  • true: Cuando se elimina un ECS, la EIP vinculada al ECS también se libera independientemente de si delete_on_termination de la EIP es true o false.
  • false: Cuando se elimina un ECS, el EIP solo es independiente del ECS y no se liberará independientemente de si delete_on_termination del EIP es true o false.
NOTA:

Si no se especifica delete_publicip, el valor delete_on_termination del EIP decide si el EIP se libera cuando se elimina el ECS.

  • Si delete_on_termination es true y delete_public es null, el EIP se libera cuando se elimina ECS.
  • Si delete_on_termination es false y delete_public es null, el EIP solo es independiente del ECS y no se liberará cuando se elimine el ECS.

delete_volume

No

Boolean

Especifica si se eliminarán los discos de datos adjuntos a un ECS al eliminar el ECS. Si establece el valor del parámetro en false, el sistema sólo desconecta los discos del ECS y reserva los discos. El valor predeterminado es false.

  • true: indica eliminar los discos de datos adjuntos al ECS cuando se elimina el ECS.
  • false: indica solo separar los discos de datos adjuntos al ECS cuando se elimina el ECS.
Tabla 3 Descripción del campo servers

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

Especifica el ID del ECS que se va a eliminar.

Respuesta

Consulte Respuestas (tarea)

Ejemplo de la solicitud

Ejemplo de la solicitud 
POST https://{endpoint}/v1/{project_id}/cloudservers/delete
{
    "servers": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
        }
    ], 
    "delete_publicip": false, 
    "delete_volume": false
   }

Ejemplo de la respuesta

{
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}

O

{
    "error": {
        "message": "request body is illegal.", 
        "code": "Ecs.0005"
    }
}

Valores devueltos

Consulte Valores devueltos para solicitudes generales

Códigos de error

Consulte Códigos de error