Todos os produtos
Search
Central de documentação

:DeleteNetworkInterface

Última atualização: Jul 03, 2026

Exclui uma elastic network interface (ENI).

Descrição

  • A ENI deve estar no estado Available.

  • Se a ENI estiver associada a uma instância do Elastic Compute Service (ECS), desassocie-a da instância (DetachNetworkInterface) antes de excluí-la.

  • Após a exclusão de uma ENI, ocorrem as seguintes situações:

    • Todos os endereços IP privados da ENI (incluindo endereços IP privados primários e secundários) são liberados automaticamente.

    • A ENI é removida automaticamente dos respectivos grupos de segurança.

  • Esta é uma operação assíncrona. Após chamar esta operação para excluir uma ENI, verifique o estado ou os eventos da ENI para confirmar se a exclusão foi concluída. A figura a seguir ilustra as transições entre os estados da ENI.

    • Se a ENI estiver no estado Deleting, a solicitação de exclusão foi enviada e a ENI está sendo excluída.

    • Caso a ENI não seja encontrada, ela já foi excluída.

    • Se a ENI permanecer no estado Deleting, a exclusão falhou. Reenvie a solicitação para excluí-la.

Para obter exemplos sobre como chamar esta operação, consulte Excluir uma ENI.

Depuração

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

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DeleteNetworkInterface

A operação que você deseja executar. Defina o valor como DeleteNetworkInterface.

RegionId

String

Sim

cn-hangzhou

O ID da região da ENI. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.

NetworkInterfaceId

String

Sim

eni-bp14v2sdd3v8htln****

O ID da ENI.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

F3CD6886-D8D0-4FEE-B93E-1B73239673DE

O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DeleteNetworkInterface
&NetworkInterfaceId=eni-bp14v2sdd3v8htln****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<DeleteNetworkInterfaceResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</DeleteNetworkInterfaceResponse>

Formato JSON

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

{
  "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

MissingParameter

%s

Mensagem de erro retornada porque um parâmetro obrigatório não foi especificado.

400

UnsupportedParameter

%s

Mensagem de erro retornada porque um parâmetro especificado não é suportado.

400

InvalidParameter

%s

Mensagem de erro retornada porque um parâmetro especificado é inválido.

400

InvalidInstanceID.Malformed

%s

Mensagem de erro retornada porque o ID da instância especificado é inválido.

400

InvalidOperation.InvalidEcsState

%s

Mensagem de erro retornada porque a operação não é suportada enquanto a instância está no estado atual.

400

InvalidOperation.InvalidEniState

%s

Mensagem de erro retornada porque a operação não é suportada enquanto a ENI está no estado atual.

400

InvalidOperation.DetachPrimaryEniNotAllowed

%s

Mensagem de erro retornada porque a ENI primária não pode ser desassociada da instância.

400

Forbidden.RegionId

%s

Mensagem de erro retornada porque o serviço não está disponível na região atual.

400

InvalidParams.EniId

%s

Mensagem de erro retornada porque o parâmetro NetworkInterfaceId especificado é inválido.

403

InvalidUserType.NotSupported

%s

Mensagem de erro retornada porque sua conta não suporta esta operação.

403

Abs.InvalidAccount.NotFound

%s

Mensagem de erro retornada porque sua conta Alibaba Cloud não existe ou porque seu par de AccessKey expirou.

403

Forbidden.NotSupportRAM

%s

Mensagem de erro retornada porque usuários do Resource Access Management (RAM) não têm autorização para executar esta operação.

403

Forbidden.SubUser

%s

Mensagem de erro retornada porque você não tem autorização para gerenciar este recurso. Entre em contato com o proprietário da conta Alibaba Cloud para obter autorização.

403

MaxEniCountExceeded

%s

Mensagem de erro retornada porque o número máximo de ENIs gerenciáveis foi atingido.

403

EniPerInstanceLimitExceeded

%s

Mensagem de erro retornada porque o número máximo de ENIs que podem ser associadas à instância especificada foi atingido.

403

InvalidOperation.AvailabilityZoneMismatch

%s

Mensagem de erro retornada porque a operação é inválida.

403

InvalidOperation.VpcMismatch

%s

Mensagem de erro retornada porque a operação é inválida. Verifique se a virtual private cloud (VPC) na operação corresponde aos outros parâmetros.

403

SecurityGroupInstanceLimitExceed

%s

Mensagem de erro retornada porque o número máximo de instâncias no grupo de segurança foi atingido.

403

InvalidSecurityGroupId.NotVpc

%s

Mensagem de erro retornada porque o ID do grupo de segurança especificado é inválido e o tipo de rede do grupo de segurança não é VPC.

403

InvalidOperation.InvalidEniType

%s

Mensagem de erro retornada porque a operação não é suportada para o tipo atual da ENI.

403

InvalidEniId.NotFound

%s

Mensagem de erro retornada porque o ID da ENI especificado não existe.

403

InvalidOperation.EniServiceManaged

%s

Mensagem de erro retornada porque a operação é inválida.

404

InvalidEcsId.NotFound

%s

Mensagem de erro retornada porque o ID da instância especificado não existe.

404

InvalidVSwitchId.NotFound

%s

Mensagem de erro retornada porque o vSwitch especificado não existe.

404

InvalidSecurityGroupId.NotFound

%s

Mensagem de erro retornada porque o ID do grupo de segurança especificado não existe.

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