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

Chama a operação AttachNetworkInterface para anexar uma Elastic Network Interface (ENI) a uma instância ECS conectada a uma VPC. Você pode especificar parâmetros como NetworkInterfaceId, InstanceId e NetworkCardIndex.

Descrição da operação

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

A Elastic Network Interface (ENI) deve estar no estado ativo (Available). Uma ENI pode ser anexada a apenas uma instância que reside na mesma zona e VPC que o controlador de interface de rede (NIC).
A instância ECS deve estar no estado Running ou Stopped. Alguns tipos de instância ECS exigem que a instância ECS esteja no estado Stopped ao anexar uma Elastic Network Interface (ENI). Para obter mais informações, consulte a seção sobre tipos de instância ECS que exigem que a instância ECS seja interrompida em Anexar uma ENI.

Nota
Se a instância foi iniciada pela última vez antes de 1º de abril de 2018 (incluindo, mas não se limitando a iniciar uma instância recém-adquirida, reiniciar ou ligar), você deve invocar RebootInstance para reiniciar a instância que está no estado Running. Caso contrário, o controlador de interface de rede (NIC) não poderá ser anexado.
Várias Elastic Network Interfaces (ENIs) podem ser anexadas a uma única instância ao mesmo tempo. Para obter mais informações, consulte Visão geral da ENI.
O vSwitch ao qual o controlador de interface de rede (NIC) pertence deve estar na mesma zona e VPC que a instância.
Esta é uma operação assíncrona. Após uma invocação bem-sucedida, você pode verificar o status da Elastic Network Interface (ENI) ou ouvir eventos de operação do controlador de interface de rede (NIC) para obter o resultado. A máquina de estados da ENI é mostrada na figura a seguir:
- Attaching indica que a solicitação para anexar a ENI foi enviada com sucesso e a ENI está sendo anexada à instância ECS.
- InUse indica que a ENI foi anexada à instância ECS.
- Available indica que houve falha ao anexar a ENI à instância ECS.

Para obter detalhes, consulte Anexar um controlador de interface de rede (NIC).

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:AttachNetworkInterface

update

*NetworkInterface

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

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NetworkInterfaceId	string	Sim	O ID do controlador de interface de rede (NIC).	eni-bp17pdijfczax1huji****
InstanceId	string	Sim	O ID da instância.	i-bp16qstyvxj9gpqw****
TrunkNetworkInstanceId	string	Não	O ID da ENI tronco. Nota Este parâmetro ainda não está disponível.	eni-f8zapqwj1v1j4ia3****
WaitForNetworkConfigurationReady	boolean	Não	Nota Este parâmetro foi descontinuado.	null
NetworkCardIndex	integer	Não	O índice da placa de rede especificada para a ENI. Nota Os valores válidos de NetworkCardIndex dependem da família da instância. Se o tipo de instância não suportar placas de rede, você não poderá especificar este parâmetro. Se o tipo de instância suportar placas de rede, consulte Famílias de instâncias para obter os valores válidos.	0

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	MissingParameter	%s
400	UnsupportedParameter	%s
400	InvalidParameter	%s
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidRegion	%s
400	InvalidOperation.InvalidEcsState	%s
400	InvalidOperation.InvalidEniState	%s
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s
400	Forbidden.RegionId	%s
400	InvalidOperation.InvalidGeneration	%s
400	InvalidParams.EniId	%s
400	InvalidOperation.UserNotSupportNetworkCard	User not support network card.
400	InvalidOperation.ConnectionTrackingConfigNotSupportMemberEni	Member eni not support ConnectionTrackingConfiguration.
400	InvalidParameter.NetworkCardIndexInvalid	The network card index is invalid or the current ECS/ENI type does not support the value.
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.
400	OperationDenied.NoEniStock	The requested resource of ENI is insufficient in the specified ECS, please retry or upgrade to enterprise-level computing instance types.
400	InvalidOperation.InstanceTypeNotSupportSriov	The specified instance type does not support ENI Sriov.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
500	InvalidSecurityGroupId.EniMustHaveSecurityGroup	The specified network card does not have an associated security group.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	Forbidden.NotSupportRAM	%s
403	Forbidden.SubUser	%s
403	MaxEniCountExceeded	%s
403	EniPerInstanceLimitExceeded	%s
403	InvalidOperation.AvailabilityZoneMismatch	%s
403	InvalidOperation.VpcMismatch	%s
403	SecurityGroupInstanceLimitExceed	%s
403	InvalidSecurityGroupId.NotVpc	%s
403	InvalidOperation.InvalidEniType	%s
403	InvalidInstanceId.NotFound	%s
403	InvalidEni.NotSameVpc	%s
403	InvalidOperation.Ipv4CountExceeded	%s
403	InvalidOperation.EniServiceManaged	%s
403	InvalidOperation.MultiGroupType	The specified instance can't join different types of security group.
403	InvalidOperation.NotSupportEnterpriseGroup	The specified instance type doesn't support enterprise level security group.
403	InvalidOperation.EniCountExceeded	The maximum number of eni in a enterprise level security group is exceeded.
403	InvalidOperation.EipBindModel	%s
403	InvalidOperation.Ipv6NotSupport	%s
403	InvalidOperation.HotPlugNotSupport	%s
403	InvalidInstance.NetworkType	%s
403	InvalidOperation.InvalidTrunkEniStatus	%s
403	InvalidOperation.TrunkingIsNotAllowed	%s
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s
403	InvalidOperation.EniTypeNotSupportTrunking	%s
403	InvalidOperation.EniTrunkDeviceFull	%s
403	InvalidParameter.EniNotBelongTrunk	%s
403	InvalidOperation.EniTypeNotSupportAttachToTrunk	%s
403	InvalidParameter.EniNotBelongEcs	%s
403	InvalidParameter.InvalidEniQueueNumber	%s
403	InvalidOperation.MaxEniQueueNumberExceeded	%s
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s
403	InvalidOperation.HighPerformanceTrafficModeNotSupportTrunkEni	%s
403	InvalidOperation.HighPerformanceTrafficModeNotSupportMemberEni	%s
403	InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode	%s
403	InvalidOperation.EniTrafficModeNotSupportIpv6	%s
403	InvalidOperation.MaxEniQueuePairNumberExceed	%s
403	InvalidParameter.InvalidQueuePairNumber	%s
403	InvalidOperation.EniQueuePairNumberOverflow	%s
403	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	%s
403	InvalidOperation.Ipv6CountExceeded	%s.
403	InvalidOperation.PrimaryEniNotExist	Primary Eni Not Exist.
404	InvalidEcsId.NotFound	%s
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s
404	InvalidSecurityGroupId.NotFound	%s

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.