Détachez une interface réseau élastique (ENI) d'une instance Elastic Compute Service (ECS).
Description
Lors de l'appel à cette opération, tenez compte des points suivants :
Les ENI principales ne peuvent pas être détachées des instances ECS.
L'ENI doit se trouver dans l'état Detaching (Detaching) ou InUse (InUse).
L'instance doit se trouver dans l'état Running (Running) ou Stopped (Stopped).
-
Cette opération est asynchrone. Une fois l'opération appelée pour détacher une ENI, vérifiez l'état ou les événements de l'ENI pour confirmer le détachement. La figure suivante illustre les transitions entre les états de l'ENI.

Si l'ENI est dans l'état Detaching, la demande de détachement a été envoyée et le détachement de l'ENI de l'instance associée est en cours.
Si l'ENI est dans l'état Available, l'ENI est détachée de l'instance associée.
Si l'ENI reste bloquée dans l'état Detaching, le détachement de l'instance associée peut échouer pour diverses raisons. Par exemple, le système d'exploitation peut ne pas répondre à la demande de détachement de l'ENI. Dans ce cas, renouvelez la demande de détachement. Si le problème persiste, redémarrez l'instance.
Pour des exemples d'appels à cette opération, consultez Détacher une ENI.
Débogage
Paramètres de requête
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DetachNetworkInterface | Opération à effectuer. Définissez la valeur sur DetachNetworkInterface. |
| RegionId | String | Yes | cn-hangzhou | ID de région de l'ENI. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes. |
| NetworkInterfaceId | String | Yes | eni-bp67acfmxazb4p**** | ID de l'ENI. |
| InstanceId | String | Yes | i-bp67acfmxazb4p**** | ID de l'instance. |
| TrunkNetworkInstanceId | String | No | eni-f8zapqwj1v1j4ia3**** | ID de l'ENI trunk. Remarque Ce paramètre n'est pas disponible. |
Paramètres de réponse
| Parameter | Type | Example | Description |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
ID de la requête. |
Exemples
Exemples de requêtes
https://ecs.aliyuncs.com/?Action=DetachNetworkInterface
&InstanceId=i-bp67acfmxazb4p****
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&<Common request parameters>
Exemple de réponse réussie
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"
}
Codes d'erreur
| HTTP status code | Error code | Error message | Description |
| 400 | MissingParameter | %s | Le message d'erreur indique qu'un paramètre requis n'est pas spécifié. |
| 400 | UnsupportedParameter | %s | Le message d'erreur indique qu'un paramètre spécifié n'est pas pris en charge. |
| 400 | InvalidParameter | %s | Le message d'erreur indique qu'un paramètre spécifié n'est pas valide. |
| 400 | InvalidInstanceID.Malformed | %s | Le message d'erreur indique que le paramètre InstanceId spécifié n'est pas valide. |
| 400 | InvalidOperation.InvalidRegion | %s | Le message d'erreur indique que le paramètre RegionId spécifié n'est pas valide. |
| 400 | InvalidOperation.InvalidEcsState | %s | Le message d'erreur indique que l'opération n'est pas prise en charge lorsque l'instance se trouve dans l'état actuel. |
| 400 | InvalidOperation.InvalidEniState | %s | Le message d'erreur indique que l'opération n'est pas prise en charge lorsque l'ENI se trouve dans l'état actuel. |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | Le message d'erreur indique que l'ENI principale ne peut pas être détachée de l'instance. |
| 400 | Forbidden.RegionId | %s | Le message d'erreur indique que le service n'est pas disponible dans la région actuelle. |
| 400 | InvalidParams.EniId | %s | Le message d'erreur indique que le paramètre NetworkInterfaceId spécifié n'est pas valide. |
| 400 | InvalidParameter.EniNotBelongEcs | %s | Le message d'erreur indique que l'ENI spécifiée n'est pas attachée à l'instance ECS spécifiée. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. Appelez l'opération DescribeInstances pour obtenir les ID des ENI attachées à l'instance ECS spécifiée. |
| 403 | InvalidUserType.NotSupported | %s | Le message d'erreur indique que votre compte ne prend pas en charge cette opération. |
| 403 | Abs.InvalidAccount.NotFound | %s | Le message d'erreur indique que votre compte Alibaba Cloud n'existe pas ou que votre paire de clés AccessKey a expiré. |
| 403 | Forbidden.NotSupportRAM | %s | Le message d'erreur indique que les utilisateurs Resource Access Management (RAM) ne sont pas autorisés à effectuer cette opération. |
| 403 | Forbidden.SubUser | %s | Le message d'erreur indique que vous n'êtes pas autorisé à gérer cette ressource. Contactez le propriétaire du compte Alibaba Cloud pour obtenir une autorisation. |
| 403 | MaxEniCountExceeded | %s | Le message d'erreur indique que le nombre maximal d'ENI gérables a été atteint. |
| 403 | EniPerInstanceLimitExceeded | %s | Le message d'erreur indique que le nombre maximal d'ENI attachables à l'instance spécifiée a été atteint. |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | Le message d'erreur indique que l'opération n'est pas valide. |
| 403 | InvalidOperation.VpcMismatch | %s | Le message d'erreur indique que l'opération n'est pas valide. Vérifiez si le cloud privé virtuel (VPC) de l'opération correspond aux autres paramètres. |
| 403 | SecurityGroupInstanceLimitExceed | %s | Le message d'erreur indique que le nombre maximal d'instances dans le groupe de sécurité a été atteint. |
| 403 | InvalidSecurityGroupId.NotVpc | %s | Le message d'erreur indique que l'ID de groupe de sécurité spécifié n'est pas valide et que le type de réseau du groupe de sécurité n'est pas VPC. |
| 403 | InvalidOperation.InvalidEniType | %s | Le message d'erreur indique que l'opération n'est pas prise en charge lorsque l'ENI est du type actuel. |
| 403 | InvalidOperation.EniServiceManaged | %s | Le message d'erreur indique que l'opération n'est pas valide. |
| 403 | InvalidOperation.EniLinked | %s | Le message d'erreur indique que l'opération n'est pas prise en charge lorsque l'ENI de l'instance est associée à d'autres ENI. Dissociez l'ENI des autres ENI avant de la détacher de l'instance. |
| 403 | InvalidInstanceId.NotFound | %s | Le message d'erreur indique que le paramètre InstanceId spécifié n'existe pas. |
| 403 | InvalidOperation.HotPlugNotSupport | %s | Le message d'erreur indique que l'opération n'est pas prise en charge lorsque la ressource spécifiée est en cours d'exécution. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.InvalidTrunkEniStatus | %s | Le message d'erreur indique que l'opération n'est pas prise en charge lorsque l'ENI spécifiée en mode trunk se trouve dans l'état actuel. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | Le message d'erreur indique que l'opération n'est pas prise en charge. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidParameter.EniNotBelongTrunk | %s | Le message d'erreur indique que l'ENI spécifiée n'est pas en mode trunk. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.EniTypeNotSupportTrunking | %s | Le message d'erreur indique que les opérations liées au mode trunk ne sont pas prises en charge lorsque l'ENI est du type actuel. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. |
| 403 | InvalidOperation.HasMemberEniAttached | %s | Le message d'erreur indique que d'autres ENI sont attachées à l'ENI qui fonctionne en mode trunk. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. |
| 404 | InvalidEcsId.NotFound | %s | Le message d'erreur indique que l'ID d'instance spécifié n'existe pas. |
| 404 | InvalidEniId.NotFound | %s | Le message d'erreur indique que l'ID d'ENI spécifié n'existe pas. |
| 404 | InvalidVSwitchId.NotFound | %s | Le message d'erreur indique que le vSwitch spécifié n'existe pas. |
| 404 | InvalidSecurityGroupId.NotFound | %s | Le message d'erreur indique que l'ID de groupe de sécurité spécifié n'existe pas. |
Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.