Todos os produtos
Search
Central de documentação

:DeleteVSwitch

Última atualização: Jul 03, 2026

Exclui um vSwitch.

Descrição

Ao chamar esta operação, observe as seguintes restrições:

  • Antes de excluir um vSwitch, libere ou remova todos os recursos da Virtual Private Cloud (VPC), incluindo vSwitches, instâncias, interfaces de roteador e endereços IP virtuais de alta disponibilidade (HAVIPs).

  • Somente é possível excluir vSwitches no estado Available.

  • Não é possível excluir um vSwitch de uma VPC enquanto outro vSwitch ou rota estiver sendo criado ou excluído.

  • A operação DeleteVSwitch é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Chame a operação DescribeVSwitchAttributes para consultar o status do vSwitch:

    • Se o vSwitch estiver no estado Pending, ele está sendo excluído.

    • Se a consulta não retornar o vSwitch, a exclusão foi concluída.

  • Não chame a operação DeleteVSwitch repetidamente para excluir o mesmo vSwitch dentro de um curto período.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DeleteVSwitch

A operação a ser executada. Defina o valor como DeleteVSwitch.

VSwitchId

String

Sim

vsw-asdfjlna****

O ID do vSwitch a ser excluído.

RegionId

String

Não

cn-hangzhou

O ID da região do vSwitch.

Chame a operação DescribeRegions para obter a lista mais recente de regiões.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DeleteVSwitch
&VSwitchId=vsw-asdfjlna****
&RegionId=cn-hangzhou
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteVSwitchResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteVSwitchResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

OperationDenied.OtherSubnetProcessing

other subnet is processing.

Erro retornado porque não é possível excluir o vSwitch enquanto outras sub-redes estão sendo gerenciadas.

400

IncorrectVSwitchStatus

The current virtual switch status does not support this operation.

Erro retornado porque o vSwitch está no estado Pending e não pode ser excluído.

400

DependencyViolation

Specified object has dependent resources.

Erro retornado porque existem recursos implantados no vSwitch que impedem sua exclusão. Exclua os recursos implantados na VPC antes de excluir a própria VPC.

400

DependencyViolation

Some route entry status blocked this operation.

Erro retornado porque uma ou mais entradas de rota na tabela de rotas atual estão no estado Pending ou Modifying.

400

IncorrectRouteEntryStatus

Some route entry status blocked this operation.

Erro retornado porque uma ou mais entradas de rota na tabela de rotas atual estão no estado Pending ou Modifying.

400

DependencyViolation.HaVip

VSwitch cannot be deleted when there are some HaVip dependent with it.

Erro retornado porque o vSwitch está associado a um HAVIP e não pode ser excluído.

400

MissingParameter

Miss mandatory parameter.

Erro retornado porque alguns parâmetros obrigatórios não foram definidos. Verifique se todos os parâmetros necessários foram configurados antes de chamar esta operação.

400

TaskConflict

The operation is too frequent, TaskConflict.

Erro retornado porque o sistema está ocupado. Tente novamente mais tarde.

400

DeleteVSwitch.IncorrectStatus.cbnStatus

Current CBN status does not support this operation.

Erro retornado porque não é possível excluir o vSwitch quando a instância CEN está no estado atual.

400

OperationFailed.SystemBusy

Operation failed because system is busy.

Erro retornado porque o sistema está ocupado. Tente novamente mais tarde.

400

DependencyViolation.MulticastDomain

VSwitch cannot be deleted when associated with multicast domain.

Erro retornado porque o vSwitch foi adicionado a um domínio multicast e não pode ser excluído.

400

DependencyViolation.VSwitchCidrReservation

VSwitch cannot be deleted when vswitch cidr reservation exist.

Erro retornado porque existe um bloco CIDR reservado para o vSwitch, impedindo sua exclusão.

404

Forbidden.RegionNotFound

Specified instance is not found during access authentication.

Erro retornado porque a região não é suportada.

404

IncorrectVSwitchId

Specified vSwtich instance is not found during access authentication.

Erro retornado porque o vSwitch não foi encontrado durante a verificação de permissões.

404

InvalidVSwitchId.NotFound

VSwitch not exist.

Erro retornado porque o vSwitch especificado não existe. Verifique se o ID do vSwitch informado é válido.

404

IncorrectStatus

Vswtich status not stable.

Erro retornado porque o vSwitch está no estado Pending ou Modifying. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.