Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2022-11-08 GMT+08:00

Exclusão dos ECS

Função

Essa API é usada para excluir os ECS com base em uma lista de ID de ECS especificada.

Você pode excluir um ECS ou os vários ECS em um lote. Um máximo de os 1000 ECS pode ser excluído em um lote.

URI

POST /v1/{project_id}/cloudservers/delete

Tabela 1 descreve os parâmetros no URI.
Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Descrição

project_id

Sim

Especifica a ID do projeto.

Para obter detalhes sobre como obter o ID, consulte Obtenção de um ID de projeto.

Solicitação

Tabela 2 descreve os parâmetros de solicitação.
Tabela 2 Parâmetros de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

servers

Sim

Array of objects

Especifica os ECS a serem excluídos. Para mais detalhes, consulte Tabela 3.

delete_publicip

Não

Boolean

Especifica se o EIP vinculado ao ECS deve ser excluído ao excluir o ECS. Se você não quiser excluir o EIP, o sistema apenas desvinculará o EIP do ECS e reservará o endereço IP.

O valor pode ser true ou false.

  • true: Quando um ECS é excluído, o EIP vinculado ao ECS também é liberado, independentemente de delete_on_termination do EIP ser true ou false.
  • false: Quando um ECS é excluído, o EIP só está desacoplado do ECS e não será liberado, independentemente de delete_on_termination do EIP ser true ou false.
NOTA:

Se delete_publicip não for especificado, o valor delete_on_termination do EIP decidirá se o EIP será liberado quando o ECS for excluído.

  • Se delete_on_termination for true e delete_public for null, o EIP será liberado quando o ECS for excluído.
  • Se delete_on_termination for false e delete_public for null, o EIP só será desvinculado do ECS e não será liberado quando o ECS for excluído.

delete_volume

Não

Boolean

Especifica se devem ser excluídos os discos de dados anexados a um ECS ao excluir o ECS. Se você definir o valor do parâmetro como false, o sistema somente desanexa os discos do ECS e os reserva. O valor padrão é false.

  • true: indica para excluir os discos de dados anexados ao ECS ao excluir o ECS.
  • false: indica apenas para desanexar os discos de dados anexados ao ECS ao excluir o ECS.
Tabela 3 descrição do campo servers

Parâmetro

Obrigatório

Tipo

Descrição

id

Sim

String

Especifica a ID do ECS a ser excluído.

Resposta

Consulte Respostas (Tarefa).

Exemplo de solicitação

Exemplo de solicitação
POST https://{endpoint}/v1/{project_id}/cloudservers/delete
{
    "servers": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
        }
    ], 
    "delete_publicip": false, 
    "delete_volume": false
   }

Exemplo de resposta

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

Ou

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

Valores retornados

Consulte Valores retornados para solicitações gerais.

Códigos de erro

Consulte Códigos de erro.