Tous les produits
Search
Centre de documentation

:DetachNetworkInterface

Dernière mise à jour :Aug 18, 2026

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

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParameterTypeRequiredExampleDescription
ActionStringYesDetachNetworkInterface

Opération à effectuer. Définissez la valeur sur DetachNetworkInterface.

RegionIdStringYescn-hangzhou

ID de région de l'ENI. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.

NetworkInterfaceIdStringYeseni-bp67acfmxazb4p****

ID de l'ENI.

InstanceIdStringYesi-bp67acfmxazb4p****

ID de l'instance.

TrunkNetworkInstanceIdStringNoeni-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.