AttachNetworkInterface - - Centro de documentación de Alibaba Cloud

Vincula una elastic network interface (ENI) a una instancia de Elastic Compute Service (ECS) que se encuentra en una virtual private cloud (VPC).

Descripción general

Cuando llame a esta operación, tenga en cuenta los siguientes elementos:

La ENI debe estar en el estado Available(Available). Cada ENI solo se puede vincular a una única instancia que resida en la misma zona y VPC que la ENI.
La instancia debe estar en el estado Running (Running) o Stopped (Stopped). Al vincular ENI a instancias de ciertos tipos, asegúrese de que las instancias estén en el estado Stopped (Stopped). Para obtener más información, consulte la sección "Instance types of the ECS instances that must be in the Stopped (Stopped) state" en

Bind an ENI

.

Nota
Si la última hora de inicio de la instancia (incluida la hora de inicio si es recién adquirida, la última hora de reinicio y la última hora de reactivación) es anterior al 1 de abril de 2018 y la instancia permanece en el estado Running, debe invocar la operación RebootInstance para reiniciarla. De lo contrario, no será posible vincular la ENI a la instancia.
Puede vincular varias ENI a una sola instancia. Para obtener más información, consulte ENI overview.
El vSwitch al que está conectada la ENI debe encontrarse en la misma zona y VPC que el vSwitch al que está conectada la instancia.
Esta operación es asíncrona. Después de invocarla para vincular una ENI, compruebe el estado o los eventos de la ENI para determinar si se vinculó correctamente. La siguiente figura muestra las transiciones entre los estados de la ENI.
- Si la ENI entra en el estado Attaching, la operación se invocó correctamente y la ENI se está vinculando a una instancia.
- Si la ENI entra en el estado InUse, significa que ya está vinculada a una instancia.
- Si la ENI entra en el estado Available, indica que no se pudo vincular a una instancia.

Para obtener información sobre ejemplos de cómo llamar a esta operación, consulte Attach an ENI to an ECS instance.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos invocar esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	AttachNetworkInterface	La operación que desea ejecutar. Establezca el valor en AttachNetworkInterface.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede invocar la operación DescribeRegions para consultar la lista de regiones más reciente.
NetworkInterfaceId	String	Sí	eni-bp17pdijfczax1huji****	El ID de la ENI.
InstanceId	String	Sí	i-bp16qstyvxj9gpqw****	El ID de la instancia.
TrunkNetworkInstanceId	String	No	eni-f8zapqwj1v1j4ia3****	El ID de la ENI troncal. Nota Este parámetro no está disponible para su uso.
WaitForNetworkConfigurationReady	Boolean	No	null	Nota Este parámetro ya no se utiliza.
NetworkCardIndex	Integer	No	0	El índice del controlador de interfaz de red (NIC). Nota El valor de NetworkCardIndex varía según el tipo de instancia. Si el tipo de instancia no admite NIC, no puede especificar este parámetro. Si el tipo de instancia admite NIC, puede especificar este parámetro. Para obtener información sobre los valores de NetworkCardIndex, consulte Instance families.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	%s	El mensaje de error devuelto porque no se especificó un parámetro obligatorio.
400	UnsupportedParameter	%s	El mensaje de error devuelto porque un parámetro especificado no es compatible.
400	InvalidParameter	%s	El mensaje de error devuelto porque un parámetro especificado no es válido.
400	InvalidInstanceID.Malformed	%s	El mensaje de error devuelto porque el parámetro InstanceId especificado no es válido.
400	InvalidOperation.InvalidRegion	%s	El mensaje de error devuelto porque el parámetro RegionId especificado no es válido.
400	InvalidOperation.InvalidEcsState	%s	El mensaje de error devuelto porque la operación no es compatible mientras la instancia se encuentra en el estado actual.
400	InvalidOperation.InvalidEniState	%s	El mensaje de error devuelto porque la operación no es compatible mientras la ENI se encuentra en el estado actual.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	El mensaje de error devuelto porque la ENI principal no se puede desvincular de la instancia.
400	Forbidden.RegionId	%s	El mensaje de error devuelto porque el servicio no está disponible en la región actual por el momento.
400	InvalidOperation.InvalidGeneration	%s	El mensaje de error devuelto porque la operación no es válida.
400	InvalidParams.EniId	%s	El mensaje de error devuelto porque el parámetro NetworkInterfaceId especificado no es válido.
403	InvalidUserType.NotSupported	%s	El mensaje de error devuelto porque su cuenta no admite esta operación.
403	Abs.InvalidAccount.NotFound	%s	El mensaje de error devuelto porque su cuenta de Alibaba Cloud no existe o porque su par de AccessKey ha caducado.
403	Forbidden.NotSupportRAM	%s	El mensaje de error devuelto porque los usuarios de Resource Access Management (RAM) no tienen autorización para realizar esta operación.
403	Forbidden.SubUser	%s	El mensaje de error devuelto porque no tiene autorización para gestionar este recurso. Póngase en contacto con el propietario de la cuenta de Alibaba Cloud para obtener autorización.
403	MaxEniCountExceeded	%s	El mensaje de error devuelto porque se alcanzó el número máximo de ENI que se pueden gestionar.
403	EniPerInstanceLimitExceeded	%s	El mensaje de error devuelto porque se alcanzó el número máximo de ENI que se pueden vincular a la instancia especificada.
403	InvalidOperation.AvailabilityZoneMismatch	%s	El mensaje de error devuelto porque la operación no es válida.
403	InvalidOperation.VpcMismatch	%s	El mensaje de error devuelto porque la operación no es válida. Compruebe si la VPC de la operación corresponde a otros parámetros.
403	SecurityGroupInstanceLimitExceed	%s	El mensaje de error devuelto porque se alcanzó el número máximo de instancias en el security group.
403	InvalidSecurityGroupId.NotVpc	%s	El mensaje de error devuelto porque el ID de security group especificado no es válido y el tipo de red del security group no es VPC.
403	InvalidOperation.InvalidEniType	%s	El mensaje de error devuelto porque la operación no es compatible cuando la ENI es del tipo actual.
403	InvalidInstanceId.NotFound	%s	El mensaje de error devuelto porque el parámetro InstanceId especificado no existe.
403	InvalidEni.NotSameVpc	%s	El mensaje de error devuelto porque el recurso especificado y la ENI especificada no pertenecen a la misma VPC. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.Ipv4CountExceeded	%s	El mensaje de error devuelto porque se alcanzó el número máximo de direcciones IPv4.
403	InvalidOperation.EniServiceManaged	%s	El mensaje de error devuelto porque la operación no es válida.
403	InvalidOperation.Ipv6NotSupport	%s	El mensaje de error devuelto porque las direcciones IPv6 no admiten esta operación.
403	InvalidOperation.HotPlugNotSupport	%s	El mensaje de error devuelto porque la operación no es compatible mientras el recurso especificado se está ejecutando. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.InvalidTrunkEniStatus	%s	El mensaje de error devuelto porque la operación no es compatible mientras la ENI especificada en modo troncal se encuentra en el estado actual. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	El mensaje de error devuelto porque la operación no es compatible. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.EniTypeNotSupportTrunking	%s	El mensaje de error devuelto porque las operaciones relacionadas con el modo troncal no son compatibles cuando la ENI es del tipo actual. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidParameter.EniNotBelongTrunk	%s	El mensaje de error devuelto porque la ENI especificada no está en modo troncal. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidParameter.EniNotBelongEcs	%s	El mensaje de error devuelto porque la ENI especificada no está vinculada a la instancia de ECS especificada. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error. Puede invocar la operación DescribeInstances para consultar los ID de las ENI vinculadas a la instancia de ECS especificada.
403	InvalidParameter.InvalidEniQueueNumber	%s	El mensaje de error devuelto porque el número de colas por ENI especificado no es válido. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	El mensaje de error devuelto porque se alcanzó el número máximo de colas por ENI. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	El mensaje de error devuelto porque se alcanzó el número máximo de colas para todas las ENI en una instancia. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
404	InvalidEcsId.NotFound	%s	El mensaje de error devuelto porque el parámetro InstanceId especificado no existe.
404	InvalidEniId.NotFound	%s	El mensaje de error devuelto porque el parámetro NetworkInterfaceId especificado no existe.
404	InvalidVSwitchId.NotFound	%s	El mensaje de error devuelto porque el vSwitch especificado no existe.
404	InvalidSecurityGroupId.NotFound	%s	El mensaje de error devuelto porque el ID de security group especificado no existe.

Para obtener una lista de códigos de error, visite el Centro de errores de API.