Todos os produtos
Search

Este produto

    :AttachNetworkInterface

    Central de documentação

    :AttachNetworkInterface

    Última atualização: Jul 03, 2026

    Anexa uma elastic network interface (ENI) a uma instância do Elastic Compute Service (ECS) em uma virtual private cloud (VPC).

    Descrição

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

    • A ENI deve estar no estado Available(Available). Cada ENI pode ser anexada a apenas uma instância na mesma zona e VPC da ENI.

    • A instância deve estar no estado Running (Running) ou Stopped (Stopped). Ao anexar ENIs a instâncias de determinados tipos, certifique-se de que estejam no estado Stopped (Stopped). Para mais informações, consulte a seção "Instance types of the ECS instances that must be in the Stopped (Stopped) state" em

      Bind an ENI

      .

      Nota

      Se a última hora de início da instância (incluindo a ativação inicial, caso seja recém-adquirida, a última reinicialização e a última reativação) for anterior a 1º de abril de 2018 e a instância permanecer no estado Running, chame a operação RebootInstance para reiniciá-la. Caso contrário, não será possível anexar a ENI à instância.

    • É possível anexar várias ENIs a uma única instância. Para mais detalhes, consulte ENI overview.

    • O vSwitch ao qual a ENI está conectada deve pertencer à mesma zona e VPC do vSwitch conectado à instância.

    • Esta é uma operação assíncrona. Após chamá-la para anexar uma ENI, verifique o status ou os eventos da ENI para confirmar se a anexação foi concluída. A figura a seguir ilustra as transições entre os estados da ENI.

      • Se a ENI entrar no estado Attaching, a operação foi chamada com sucesso e a anexação à instância está em andamento.

      • Quando a ENI atinge o estado InUse, ela foi anexada à instância.

      • Se a ENI retornar ao estado Available, a anexação à instância falhou.

    Para obter exemplos sobre como chamar esta operação, consulte Attach an ENI to an ECS instance.

    Depuração

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

    Parâmetros da solicitação

    ParameterTypeRequiredExampleDescription
    ActionStringYesAttachNetworkInterface

    A operação a ser executada. Defina o valor como AttachNetworkInterface.

    RegionIdStringYescn-hangzhou

    ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

    NetworkInterfaceIdStringYeseni-bp17pdijfczax1huji****

    ID da ENI.

    InstanceIdStringYesi-bp16qstyvxj9gpqw****

    ID da instância.

    TrunkNetworkInstanceIdStringNoeni-f8zapqwj1v1j4ia3****

    ID da ENI trunk.

    Nota Este parâmetro não está disponível para uso.
    WaitForNetworkConfigurationReadyBooleanNonull
    Nota Este parâmetro não é mais utilizado.
    NetworkCardIndexIntegerNo0

    Índice do controlador de interface de rede (NIC).

    Nota O valor de NetworkCardIndex varia conforme o tipo de instância. Se o tipo de instância não suportar NICs, não especifique este parâmetro. Caso suporte, você pode especificá-lo. Para informações sobre os valores de NetworkCardIndex, consulte Instance families.

    Parâmetros de resposta

    Parameter

    Type

    Example

    Description

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID da solicitação.

    Exemplos

    Exemplos de solicitações

    http(s)://ecs.aliyuncs.com/?Action=AttachNetworkInterface
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp17pdijfczax1huji****
&InstanceId=i-bp16qstyvxj9gpqw****
&WaitForNetworkConfigurationReady=false
&Common request parameters

    Exemplos de respostas de sucesso

    Formato XML

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

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

    Formato JSON

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

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

    Códigos de erro

    HTTP status code

    Error code

    Error message

    Description

    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 parâmetro InstanceId especificado é inválido.

    400

    InvalidOperation.InvalidRegion

    %s

    Mensagem de erro retornada porque o parâmetro RegionId 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 desvinculada da instância.

    400

    Forbidden.RegionId

    %s

    Mensagem de erro retornada porque o serviço está indisponível na região atual no momento.

    400

    InvalidOperation.InvalidGeneration

    %s

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

    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 anexadas à 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 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

    InvalidInstanceId.NotFound

    %s

    Mensagem de erro retornada porque o parâmetro InstanceId especificado não existe.

    403

    InvalidEni.NotSameVpc

    %s

    Mensagem de erro retornada porque o recurso especificado e a ENI especificada não pertencem à mesma VPC. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidOperation.Ipv4CountExceeded

    %s

    Mensagem de erro retornada porque o número máximo de endereços IPv4 foi atingido.

    403

    InvalidOperation.EniServiceManaged

    %s

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

    403

    InvalidOperation.Ipv6NotSupport

    %s

    Mensagem de erro retornada porque endereços IPv6 não suportam esta operação.

    403

    InvalidOperation.HotPlugNotSupport

    %s

    Mensagem de erro retornada porque a operação não é suportada enquanto o recurso especificado está em execução. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidOperation.InvalidTrunkEniStatus

    %s

    Mensagem de erro 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 de retorno do placeholder %s na mensagem de erro.

    403

    InvalidOperation.InstanceTypeNotSupportEniTrunking

    %s

    Mensagem de erro retornada porque a operação não é suportada. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidOperation.EniTypeNotSupportTrunking

    %s

    Mensagem de erro retornada porque operações relacionadas ao modo trunk não são suportadas para o tipo atual da ENI. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidParameter.EniNotBelongTrunk

    %s

    Mensagem de erro retornada porque a ENI especificada não está no modo trunk. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidParameter.EniNotBelongEcs

    %s

    Mensagem de erro retornada porque a ENI especificada não está anexada à instância ECS especificada. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro. Chame a operação DescribeInstances para consultar os IDs das ENIs anexadas à instância ECS especificada.

    403

    InvalidParameter.InvalidEniQueueNumber

    %s

    Mensagem de erro retornada porque o número de filas por ENI especificado é inválido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidOperation.MaxEniQueueNumberExceeded

    %s

    Mensagem de erro retornada porque o número máximo de filas por ENI foi atingido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    403

    InvalidOperation.ExceedInstanceTypeQueueNumber

    %s

    Mensagem de erro retornada porque o número máximo de filas para todas as ENIs em uma instância foi atingido. Para mais informações, consulte o valor de retorno do placeholder %s na mensagem de erro.

    404

    InvalidEcsId.NotFound

    %s

    Mensagem de erro retornada porque o parâmetro InstanceId especificado não existe.

    404

    InvalidEniId.NotFound

    %s

    Mensagem de erro retornada porque o parâmetro NetworkInterfaceId 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, visite o API Error Center.