DeleteVSwitch - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Invoca a operação DeleteVSwitch para excluir um vSwitch.

Descrição da operação

Antes de chamar esta operação para excluir um vSwitch, observe os seguintes itens:

Antes de excluir um vSwitch, libere ou mova todos os recursos na VPC, incluindo vSwitches, instâncias de serviços em nuvem, interfaces de roteador e HaVips.
Apenas vSwitches no estado Available podem ser excluídos.
Um vSwitch não pode ser excluído se a VPC à qual ele pertence estiver criando ou excluindo um vSwitch ou rota.
A operação DeleteVSwitch é assíncrona. Após enviar uma solicitação, o sistema retorna um ID de solicitação, mas o vSwitch ainda não foi excluído. A tarefa de exclusão continua sendo executada em segundo plano. Você pode chamar DescribeVSwitchAttributes para consultar o status de exclusão do vSwitch:
- Se o vSwitch estiver no estado Pending, o vSwitch está sendo excluído.
- Se o vSwitch especificado não for encontrado, o vSwitch foi excluído.
A operação DeleteVSwitch não suporta a exclusão simultânea do mesmo vSwitch.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:DeleteVSwitch

delete

*VSwitch.

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VSwitchId	string	Sim	O ID do vSwitch a ser excluído.	vsw-asdfjlna****
RegionId	string	Não	O ID da região do vSwitch a ser excluído. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: Realiza um dry run sem realmente excluir o vSwitch. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e as restrições de negócios. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro `DryRunOperation` será retornado. false (padrão): Envia uma solicitação normal. Após a verificação ser bem-sucedida, um código de status HTTP 2xx é retornado e a operação de exclusão do vSwitch é executada.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied.OtherSubnetProcessing	other subnet is processing.	O vSwitch não pode ser excluído porque outra sub-rede está sendo operada.
400	IncorrectVSwitchStatus	vpc subnet is in middle status.
400	DependencyViolation	Resources deployed in the vSwitch have not been deleted.	A operação não pode ser realizada porque as entradas de rota na tabela de rotas atual estão no estado pendente ou de modificação.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	DependencyViolation.HaVip	VSwitch cannot be deleted when there are some HaVip dependent with it.	Não é possível excluir um vSwitch porque ele possui endereços IP virtuais de alta disponibilidade (HaVips) associados.
400	DependencyViolation.RouteTable	VSwitch cannot be deleted when associated with route table
400	MissingParameter	Miss mandatory parameter.
400	TaskConflict	The operation is too frequent, TaskConflict.	A operação é muito frequente. Aguarde um momento e tente novamente.
400	DependencyViolation.SNAT	The vswitch cannot be deleted when used by snat.	O vSwitch não pode ser excluído porque está sendo usado por uma regra SNAT.
400	DeleteVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	O status atual do CEN não oferece suporte à operação de exclusão de um vSwitch.
400	AttrMismatching.NaclAndBindInstance	The network acl and resource not in same vpc.
400	InvalidResource.NotBinding	The resource has not been binded.
400	DependencyViolation.SnatEntry	VSwitch cannot be deleted when snat entry exist.
400	DependencyViolation.NetworkAcl	VSwitch cannot be deleted when network acl exist.	O vSwitch não pode ser excluído porque existe uma ACL de rede.
400	DependencyViolation.EnhancedNatgw	VSwitch cannot be deleted when natgw exist.	O vSwitch não pode ser excluído porque existe um gateway NAT.
400	DependencyViolation.ResourceShare	VSwitch cannot be deleted when resource share exist.
400	OperationFailed.SystemBusy	Operation failed because system is busy.	O sistema está ocupado. Tente novamente mais tarde.
400	DependencyViolation.MulticastDomain	VSwitch cannot be deleted when associated with multicast domain.	O vSwitch não pode ser excluído porque ingressou em um domínio multicast.
400	DependencyViolation.VSwitchCidrReservation	VSwitch cannot be deleted when vswitch cidr reservation exist.	O vSwitch não pode ser excluído porque possui um VSwitchCidrReservation em uso.
400	DependencyViolation.CloudService	VSwitch cannot be deleted when uesd by cloud service.	O vSwitch não pode ser excluído porque está sendo usado por um serviço em nuvem. Confirme os cenários do serviço em nuvem.
400	InvalidVSwitchId.NotFound	VSwitch not exist.
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.	Existem instâncias IPv6 no vSwitch.
400	DependencyViolation.Ipv6Address	The specified resource of %s depends on %s, so the operation cannot be completed.	O recurso especificado é dependência de outros recursos. A operação atual não é permitida.
400	DependencyViolation.%s	The specified resource of [%s] depends on [%s], so the operation cannot be completed.	O recurso [%s] sendo operado depende de [%s]. Exclua o recurso dependente antes de realizar esta operação.
400	Forbidden.RegionNotFound	Specified instance is not found during access authentication.	A região atual não é suportada.
400	IncorrectStatus	Vswtich status not stable.
400	DependencyViolation.RouterInterface	Specified object has dependent resources RouterInterface.
400	InvalidRegionId.NotFound	The specified region is not found.	O parâmetro é inválido.
400	DependencyViolation.NATGW	Nat gateway exists in the VSwitch, so the VSwitch cannot be deleted.	O vSwitch não pode ser excluído porque ainda contém gateways NAT que não foram excluídos. Exclua primeiro os gateways NAT associados ao vSwitch.
404	IncorrectVSwitchId	Specified vSwtich instance is not found during access authentication.	A instância de switch virtual (vSwitch) especificada não foi encontrada durante a verificação de permissões.
404	InvalidVSwitchId.NotFound	VSwitch not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.