:AttachNetworkInterface

Description

Lors de l'appel à cette opération, tenez compte des points suivants :

• L'ENI doit être à l'état Available (Available). Chaque ENI ne peut être attachée qu'à une seule instance située dans la même zone et le même VPC que l'ENI.

• L'instance doit être à l'état Running (Running) ou Stopped (Stopped). Pour certains types d'instance, assurez-vous que l'instance est à l'état Stopped (Stopped) avant d'y attacher des ENI. Pour plus d'informations, consultez la section « Types d'instance ECS devant être à l'état Stopped (Stopped) » dans la rubrique

  Bind an ENI

  .

  Remarque

  Si le dernier démarrage de l'instance (y compris le démarrage initial en cas d'achat récent, le dernier redémarrage ou la dernière réactivation) est antérieur au 1er avril 2018 et que l'instance reste à l'état Running, vous devez appeler l'opération RebootInstance pour la redémarrer. Sinon, l'attachement de l'ENI échouera.

• Vous pouvez attacher plusieurs ENI à une seule instance. Pour plus d'informations, consultez la page ENI overview.

• Le vSwitch auquel l'ENI est connectée doit se trouver dans la même zone et le même VPC que le vSwitch auquel l'instance est connectée.

• Cette opération est asynchrone. Après avoir appelé cette opération pour attacher une ENI, vérifiez l'état ou les événements de l'ENI pour confirmer son attachement. Le schéma suivant illustre les transitions entre les états de l'ENI.

  

  • Si l'ENI passe à l'état Attaching, l'appel a réussi et l'ENI est en cours d'attachement à une instance.

  • Si l'ENI passe à l'état InUse, elle est attachée à une instance.

  • Si l'ENI revient à l'état Available, l'attachement à l'instance a échoué.

Pour consulter des exemples d'appels de cette opération, voir la rubrique Attach an ENI to an ECS instance.

Request parameters

Response parameters

Examples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

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

Format JSON

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

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

Error codes

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.