DeleteNetworkInterface - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Exclui de forma assíncrona uma Elastic Network Interface (ENI).

Descrição da operação

Ao chamar esta operação, observe os seguintes itens:

A ENI deve estar no estado Available.
Se a ENI estiver associada a uma instância ECS, você deve primeiro desassociá-la da instância (DetachNetworkInterface) antes de poder excluir a ENI.
Após a exclusão da ENI:
- Todos os endereços privados (incluindo o endereço IP privado primário e os endereços IP privados secundários) da ENI são liberados automaticamente.
- A ENI excluída é removida de todos os grupos de segurança associados.
Esta é uma operação assíncrona. Após chamar a operação com sucesso, você pode verificar o status da ENI ou ouvir eventos de operação do controlador de interface de rede (NIC) para determinar o resultado. A máquina de estados da ENI é mostrada na figura a seguir:
- O estado Deleting indica que a solicitação de exclusão foi enviada com sucesso e a ENI está sendo excluída.
- Se a ENI não puder ser encontrada, significa que ela foi excluída.
- Se a ENI permanecer no estado Deleting por um período prolongado, a exclusão falhou. Nesse caso, você pode enviar uma nova solicitação de exclusão para a ENI.

Para obter detalhes sobre o código de exemplo, consulte Excluir uma ENI.

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

ecs:DeleteNetworkInterface

delete

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NetworkInterfaceId	string	Sim	O ID da ENI.	eni-bp14v2sdd3v8htln****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	F3CD6886-D8D0-4FEE-B93E-1B73239673DE

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidOperation.HasSlaveEniBonded	%s	A interface de rede ainda possui interfaces de rede secundárias vinculadas a ela.
400	MissingParameter	%s	Pelo menos um dos parâmetros especificados deve ser fornecido. Eles não podem estar todos vazios.
400	UnsupportedParameter	%s	O parâmetro especificado não é suportado.
400	InvalidParameter	%s	A combinação de parâmetros especificada é inválida.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	O status atual da instância não suporta esta operação.
400	InvalidOperation.InvalidEniState	%s	O status atual da ENI não permite a modificação de atributos da ENI.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Não é permitido desanexar a ENI primária de uma instância.
400	Forbidden.RegionId	%s	Este serviço está temporariamente indisponível na região atual.
400	InvalidParams.EniId	%s	O parâmetro EniId especificado é inválido.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
500	InvalidSecurityGroupId.EniMustHaveSecurityGroup	The specified network card does not have an associated security group.	A ENI especificada não possui um grupo de segurança associado.
403	InvalidUserType.NotSupported	%s	O parâmetro de tipo de usuário é inválido.
403	Abs.InvalidAccount.NotFound	%s	Sua conta Alibaba Cloud não existe ou sua AccessKey expirou.
403	Forbidden.NotSupportRAM	%s	Usuários do Resource Access Management (RAM) não têm suporte para executar esta operação.
403	Forbidden.SubUser	%s	Sua conta não tem permissão para operar neste recurso. Solicite as permissões necessárias à conta Alibaba Cloud.
403	MaxEniCountExceeded	%s	O número de Elastic Network Interfaces (ENIs) que podem ser operadas excedeu o valor máximo permitido.
403	EniPerInstanceLimitExceeded	%s	O número de Elastic Network Interfaces (ENIs) anexadas à instância atingiu o limite máximo. Nenhuma outra Elastic Network Interface (ENI) pode ser anexada à instância.
403	InvalidOperation.AvailabilityZoneMismatch	%s	A Elastic Network Interface (ENI) e a instância ECS não estão na mesma zona com base em suas configurações de vSwitch.
403	InvalidOperation.VpcMismatch	%s	A VPC do controlador de interface de rede (NIC) não corresponde à VPC do grupo de segurança.
403	SecurityGroupInstanceLimitExceed	%s	O número de instâncias no grupo de segurança atingiu o limite máximo.
403	InvalidSecurityGroupId.NotVpc	%s	O parâmetro SecurityGroupId é inválido. O tipo de rede do grupo de segurança não é VPC.
403	InvalidOperation.InvalidEniType	%s	O tipo atual da Elastic Network Interface (ENI) não suporta esta operação.
403	InvalidEniId.NotFound	%s	O ID da Elastic Network Interface (ENI) especificado não existe. O controlador de interface de rede (NIC) não foi encontrado.
403	InvalidOperation.EniServiceManaged	%s	A operação é inválida.
403	InvalidOperation.TrunkingIsNotAllowed	The account is not authorized to use trunk ENI or perform trunking operation.	Operações em ENIs trunk não são permitidas. Certifique-se de que sua conta tenha permissão para operar em ENIs trunk. Se tiver dúvidas, envie um ticket.
404	InvalidEcsId.NotFound	%s	O ID da instância especificado não existe.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	O vSwitch especificado não existe.
404	InvalidSecurityGroupId.NotFound	%s	O grupo de segurança especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.