Elastic Compute Service:AttachNetworkInterface

Description

When you call this operation, take note of the following items:

• The ENI must be in the Available (Available) state. Each ENI can be attached to only a single instance that resides in the same zone and VPC as the ENI.
• The instance must be in the Running (Running) or Stopped (Stopped) state. When you attach ENIs to instances of some instance types, make sure that the instances are in the Stopped (Stopped) state. For more information, see the "Instance types of the ECS instances that must be in the Stopped (Stopped) state" section in Bind an ENI.

  Note If the last start time of the instance (including the start time of the instance if it is newly purchased, the last restart time of the instance, and the last reactivation time of the instance) is before April 1, 2018 and the instance stays in the Running state, you must call the RebootInstance operation to restart the instance. Otherwise, the ENI cannot be attached to the instance.
• You can attach multiple ENIs to a single instance. For more information, see ENI overview.
• The vSwitch to which the ENI is connected must be in the same zone and VPC as the vSwitch to which the instance is connected.
• This operation is an asynchronous operation. After this operation is called to attach an ENI, you can check the status or events of the ENI to determine whether the ENI is attached. The following figure shows the transitions between the states of the ENI.
  • If the ENI enters the Attaching state, the operation is successfully called and the ENI is being attached to an instance.
  • If the ENI enters the InUse state, the ENI is attached to an instance.
  • If the ENI enters the Available state, the ENI failed to be attached to an instance.

For information about examples on how to call this operation, see Attach an ENI to an ECS instance.

Request parameters

Response parameters

Examples

Sample requests

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

Sample success responses

XML format

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

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

JSON format

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

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

Error codes

For a list of error codes, visit the API Error Center.