：DetachNetworkInterface

Description

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

• Primary ENIs cannot be detached from ECS instances.
• The ENI must be in the Detaching (Detaching) or InUse (InUse) state.
• The instance must be in the Running (Running) or Stopped (Stopped) state.
• This operation is an asynchronous operation. After this operation is called to detach an ENI, you can check the state or events of the ENI to determine whether the ENI is detached. The following figure shows the transitions between the states of the ENI.
  • If the ENI is in the Detaching state, the ENI detachment request is sent and the ENI is being detached from its associated instance.
  • If the ENI is in the Available state, the ENI is detached from its associated instance.
  • If the ENI is stuck in the Detaching state, the ENI may fail to be detached from the associated instance due to specific reasons. For example, the ENI may fail to be detached because the operating system did not respond to the ENI detachment request. If this occurs, you can re-initiate the request to detach the ENI. If the problem persists, restart the instance.

For information about examples on how to call this operation, see Detach an ENI.

Request parameters

Response parameters

Examples

Sample requests

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

Sample success response

XML format

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

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

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, see Service error codes.