DetachNetworkInterface - : Central de Documentação do Alibaba Cloud

Descrição

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

Não é possível desanexar ENIs primárias de instâncias ECS.
A ENI deve estar no estado Detaching (Detaching) ou InUse (InUse).
A instância deve estar no estado Running (Running) ou Stopped (Stopped).
Esta é uma operação assíncrona. Após chamar a operação para desanexar uma ENI, verifique o estado ou os eventos da ENI para confirmar se ela foi desanexada. A figura a seguir ilustra as transições entre os estados da ENI.
- Se a ENI estiver no estado Detaching, a solicitação de desanexação foi enviada e a ENI está sendo desanexada da instância associada.
- Se a ENI estiver no estado Available, ela foi desanexada da instância associada.
- Caso a ENI permaneça no estado Detaching, a desanexação pode ter falhado por motivos específicos. Por exemplo, o sistema operacional pode não ter respondido à solicitação de desanexação. Nessa situação, envie novamente a solicitação para desanexar a ENI. Se o problema persistir, reinicie a instância.

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

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 da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DetachNetworkInterface	A operação a ser executada. Defina o valor como DetachNetworkInterface.
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-bp67acfmxazb4p****	O ID da ENI.
InstanceId	String	Sim	i-bp67acfmxazb4p****	O ID da instância.
TrunkNetworkInstanceId	String	Não	eni-f8zapqwj1v1j4ia3****	O ID da ENI trunk. Nota Este parâmetro não está disponível para uso.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DetachNetworkInterface
&InstanceId=i-bp67acfmxazb4p****
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<DetachNetworkInterfaceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachNetworkInterfaceResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Mensagem retornada porque um parâmetro obrigatório não foi especificado.
400	UnsupportedParameter	%s	Mensagem retornada porque um parâmetro especificado não é suportado.
400	InvalidParameter	%s	Mensagem retornada porque um parâmetro especificado é inválido.
400	InvalidInstanceID.Malformed	%s	Mensagem retornada porque o parâmetro InstanceId especificado é inválido.
400	InvalidOperation.InvalidRegion	%s	Mensagem retornada porque o parâmetro RegionId especificado é inválido.
400	InvalidOperation.InvalidEcsState	%s	Mensagem retornada porque a operação não é suportada enquanto a instância está no estado atual.
400	InvalidOperation.InvalidEniState	%s	Mensagem retornada porque a operação não é suportada enquanto a ENI está no estado atual.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Mensagem retornada porque a ENI primária não pode ser desanexada da instância.
400	Forbidden.RegionId	%s	Mensagem retornada porque o serviço não está disponível na região atual.
400	InvalidParams.EniId	%s	Mensagem retornada porque o parâmetro NetworkInterfaceId especificado é inválido.
400	InvalidParameter.EniNotBelongEcs	%s	Mensagem retornada porque a ENI especificada não está anexada à instância ECS indicada. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro. Chame a operação DescribeInstances para consultar os IDs das ENIs anexadas à instância ECS especificada.
403	InvalidUserType.NotSupported	%s	Mensagem retornada porque sua conta não suporta esta operação.
403	Abs.InvalidAccount.NotFound	%s	Mensagem retornada porque sua conta Alibaba Cloud não existe ou porque seu par de AccessKey expirou.
403	Forbidden.NotSupportRAM	%s	Mensagem 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 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 retornada porque o número máximo de ENIs gerenciáveis foi atingido.
403	EniPerInstanceLimitExceeded	%s	Mensagem retornada porque o número máximo de ENIs anexáveis à instância especificada foi atingido.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Mensagem retornada porque a operação é inválida.
403	InvalidOperation.VpcMismatch	%s	Mensagem 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 retornada porque o número máximo de instâncias no grupo de segurança foi atingido.
403	InvalidSecurityGroupId.NotVpc	%s	Mensagem 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 retornada porque a operação não é suportada quando a ENI é do tipo atual.
403	InvalidOperation.EniServiceManaged	%s	Mensagem retornada porque a operação é inválida.
403	InvalidOperation.EniLinked	%s	Mensagem retornada porque a operação não é suportada enquanto a ENI da instância estiver associada a outras ENIs. Desassocie a ENI das outras ENIs antes de desanexá-la da instância.
403	InvalidInstanceId.NotFound	%s	Mensagem retornada porque o parâmetro InstanceId especificado não existe.
403	InvalidOperation.HotPlugNotSupport	%s	Mensagem retornada porque a operação não é suportada enquanto o recurso especificado está em execução. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
403	InvalidOperation.InvalidTrunkEniStatus	%s	Mensagem retornada porque a operação não é suportada enquanto a ENI especificada no modo trunk está no estado atual. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	Mensagem retornada porque a operação não é suportada. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
403	InvalidParameter.EniNotBelongTrunk	%s	Mensagem retornada porque a ENI especificada não está no modo trunk. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
403	InvalidOperation.EniTypeNotSupportTrunking	%s	Mensagem retornada porque operações relacionadas ao modo trunk não são suportadas quando a ENI é do tipo atual. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
403	InvalidOperation.HasMemberEniAttached	%s	Mensagem retornada porque outras ENIs estão anexadas à ENI que opera no modo trunk. Para mais informações, consulte o valor retornado pelo placeholder %s na mensagem de erro.
404	InvalidEcsId.NotFound	%s	Mensagem retornada porque o ID da instância especificado não existe.
404	InvalidEniId.NotFound	%s	Mensagem retornada porque o ID da ENI especificado não existe.
404	InvalidVSwitchId.NotFound	%s	Mensagem retornada porque o vSwitch especificado não existe.
404	InvalidSecurityGroupId.NotFound	%s	Mensagem 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.