Tous les produits
Search

Ce produit

    Elastic Compute Service:CreateNetworkInterface

    Centre de documentation

    Elastic Compute Service:CreateNetworkInterface

    Dernière mise à jour :Aug 27, 2026

    Crée une interface réseau élastique (ENI) avec la possibilité de spécifier une adresse IP privée principale.

    Description de l'opération

    Prenez note des points suivants lors de l'appel de cette opération :

    • Il s'agit d'une opération synchrone. L'interface réseau élastique (ENI) nouvellement créée est dans l'état actif (Available) et peut être attachée immédiatement.

    • Si NetworkInterfaceId est vide dans la réponse, essayez de créer à nouveau l'ENI.

    • Une ENI ne peut être attachée qu'à une seule instance dans un cloud privé virtuel (VPC).

    • Lorsqu'une ENI est rattachée à une autre instance, ses propriétés restent inchangées et le trafic réseau est redirigé vers la nouvelle instance.

    • Lors de la création d'une ENI, vous pouvez allouer jusqu'à 49 adresses IP privées secondaires en appelant cette opération.

    • Lors de la création d'une ENI, si vous souhaitez configurer des adresses IPv6, assurez-vous qu'IPv6 est activé pour le vSwitch spécifié. Pour plus d'informations, consultez Qu'est-ce qu'IPv6 Gateway ?.

    • Le nombre d'ENI pouvant être créées par compte dans une région est limité. Vous pouvez consulter les quotas de ressources dans la console ECS. Pour plus d'informations, consultez Consulter et augmenter les quotas de ressources.

    Exemples de requête

    Créer une interface réseau élastique (ENI)

    RegionId:  cn-hangzhou,   //Définir la région de Chine (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Définir l'identifiant du groupe de sécurité.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //Définir l'identifiant du vSwitch.

    Créer une interface réseau élastique (ENI) et spécifier une adresse IP privée principale

    RegionId:  cn-hangzhou,   //Région de Chine (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Identifiant du groupe de sécurité.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //Identifiant du vSwitch.
PrimaryIpAddress:  192.168.0.*,   //Adresse IP privée principale.

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    ecs:CreateNetworkInterface

    create

    *NetworkInterface.

    acs:ecs:{#regionId}:{#accountId}:eni/*

    *SecurityGroup.

    acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

    *VSwitch.

    acs:vpc:{#regionId}:{#accountId}:vswitch/{#vswitchId}
    • vpc:IsDefaultVSwitch
    • vpc:IsDefaultVpc
    • vpc:VPC
    • vpc:tag
    • vpc:tag
    • vpc:tag
    		 Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RegionId

    string

    Oui

    L'identifiant de la région du contrôleur d'interface réseau (NIC) à créer. Vous pouvez appeler DescribeRegions pour obtenir la liste la plus récente des régions d'Alibaba Cloud.

    cn-hangzhou
    Tag

    array<object>

    Non

    Les balises du contrôleur d'interface réseau (NIC).

    object

    Non

    La balise du contrôleur d'interface réseau (NIC).

    Key

    string

    Non

    La clé de balise du contrôleur d'interface réseau (NIC). Valeurs valides de N : 1 à 20. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par aliyun ou acs:. Elle ne peut pas contenir http:// ou https://.

    TestKey
    Value

    string

    Non

    La valeur de balise du contrôleur d'interface réseau (NIC). Valeurs valides de N : 1 à 20. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas contenir http:// ou https://.

    TestValue
    ResourceGroupId

    string

    Non

    L'identifiant du groupe de ressources. Vous pouvez appeler ListResourceGroups pour obtenir des informations sur les groupes de ressources.

    rg-bp67acfmxazb4ph****
    VSwitchId

    string

    Oui

    L'identifiant du vSwitch du contrôleur d'interface réseau (NIC). L'adresse IP privée de l'ENI est allouée à partir des adresses inutilisées dans le bloc CIDR du vSwitch.

    Important Le contrôleur d'interface réseau (NIC) et l'instance à laquelle vous souhaitez attacher l'ENI doivent se trouver dans la même zone, mais peuvent appartenir à différents vSwitch.

    vsw-bp1s5fnvk4gn2tws03****
    PrimaryIpAddress

    string

    Non

    L'adresse IP privée principale du contrôleur d'interface réseau (NIC).

    L'adresse IP spécifiée doit être une adresse inutilisée dans le bloc CIDR du vSwitch. Si vous ne spécifiez pas ce paramètre, une adresse IP privée inutilisée dans le bloc CIDR du vSwitch est allouée aléatoirement par défaut.

    172.17.**.**
    SecurityGroupId

    string

    Non

    L'identifiant du groupe de sécurité auquel le contrôleur d'interface réseau (NIC) appartient. Le groupe de sécurité et l'ENI doivent se trouver dans le même VPC.

    Remarque

    Lorsque vous appelez cette opération, vous devez définir soit SecurityGroupId, soit SecurityGroupIds.N, mais pas les deux.

    sg-bp1fg655nh68xyz9i****
    NetworkInterfaceName

    string

    Non

    Le nom du contrôleur d'interface réseau (NIC). Le nom doit comporter de 2 à 128 caractères et peut contenir des caractères de la catégorisation des lettres Unicode (y compris les caractères anglais et chinois) et des chiffres ASCII (0-9). Le nom peut contenir des deux-points (:), des traits de soulignement (_), des points (.) ou des traits d'union (-).

    Valeur par défaut : vide.

    testNetworkInterfaceName
    Description

    string

    Non

    La description du contrôleur d'interface réseau (NIC). La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.

    Valeur par défaut : vide.

    testDescription
    Visible

    boolean

    Non

    Remarque

    Ce paramètre est obsolète.

    null
    InstanceType

    string

    Non

    Le type de l'interface réseau élastique (ENI). Valeurs valides :

    • Secondary : ENI secondaire.

    • Trunk : contrôleur d'interface réseau (NIC) principal (en aperçu sur invitation).

    Valeur par défaut : Secondary.

    Secondary
    BusinessType

    string

    Non

    Remarque

    Ce paramètre est obsolète.

    null
    SecondaryPrivateIpAddressCount

    integer

    Non

    Le nombre d'adresses IP privées à créer automatiquement par ECS. Valeurs valides : 1 à 49.

    1
    QueueNumber

    integer

    Non

    Le nombre de files d'attente pour le contrôleur d'interface réseau (NIC). Valeurs valides : 1 à 2048.

    Lorsque vous attachez l'ENI à une instance, la valeur doit être inférieure au nombre maximal de files d'attente par contrôleur d'interface réseau (NIC) pris en charge par le type d'instance. Vous pouvez appeler DescribeInstanceTypes pour obtenir le champ MaximumQueueNumberPerEni.

    Valeur par défaut : vide. Lorsque l'ENI est attachée, le nombre de files d'attente par défaut pour le type d'instance est utilisé. Vous pouvez appeler DescribeInstanceTypes pour obtenir le champ SecondaryEniQueueNumber.

    1
    ClientToken

    string

    Non

    Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais assurez-vous que le jeton est unique pour chaque requête. ClientToken ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

    123e4567-e89b-12d3-a456-426655440000
    NetworkInterfaceTrafficMode

    string

    Non

    Le mode de communication du contrôleur d'interface réseau (NIC). Valeurs valides :

    • Standard : utilise le mode de communication TCP.

    • HighPerformance : active l'interface RDMA élastique (ERI) et utilise le mode de communication RDMA.

    Remarque

    Un contrôleur d'interface réseau (NIC) en mode de communication RDMA ne peut être attaché qu'à une instance dont le type d'instance prend en charge ERI. Le nombre d'ENI en mode RDMA ne peut pas dépasser la limite de la famille d'instances. Pour plus d'informations, consultez Familles d'instances et Configurer eRDMA sur des instances de niveau entreprise.

    Valeur par défaut : Standard.

    Standard
    QueuePairNumber

    integer

    Non

    Le nombre de files d'attente pour l'ENI RDMA.

    Si vous souhaitez attacher plusieurs ENI RDMA à une instance, nous vous recommandons de spécifier manuellement QueuePairNumber pour chaque ENI en fonction de la limite supérieure de QueuePairNumber prise en charge par le type d'instance et du nombre d'ENI que vous prévoyez d'utiliser. Assurez-vous que le QueuePairNumber total de toutes les ENI ne dépasse pas la valeur maximale autorisée par le type d'instance. Appelez DescribeInstanceTypes pour obtenir la limite supérieure pour le type d'instance.

    Important Si QueuePairNumber n'est pas spécifié pour une ENI RDMA, la limite supérieure de QueuePairNumber pour toutes les ENI RDMA prises en charge par le type d'instance est utilisée par défaut. Par conséquent, après l'attachement d'une ENI RDMA sans QueuePairNumber spécifié, aucune autre ENI RDMA ne peut être ajoutée (les ENI classiques ne sont pas affectées par cette limite).

    22
    SecurityGroupIds

    array

    Non

    Les identifiants d'un ou plusieurs groupes de sécurité auxquels le contrôleur d'interface réseau (NIC) appartient. Les groupes de sécurité et l'ENI doivent se trouver dans le même VPC. Les valeurs valides de N dépendent du quota du nombre maximal de groupes de sécurité auxquels une ENI peut appartenir. Pour plus d'informations, consultez Limites.

    Remarque

    Lorsque vous appelez cette opération, vous devez définir soit SecurityGroupId, soit SecurityGroupIds.N, mais pas les deux.

    sg-bp1fg655nh68xyz9i****

    string

    Non

    Les identifiants d'un ou plusieurs groupes de sécurité auxquels le contrôleur d'interface réseau (NIC) appartient. Les groupes de sécurité et l'ENI doivent se trouver dans le même VPC. Les valeurs valides de N dépendent du quota du nombre maximal de groupes de sécurité auxquels une ENI peut appartenir. Pour plus d'informations, consultez Limites.

    Remarque

    Lorsque vous appelez cette opération, vous devez définir soit SecurityGroupId, soit SecurityGroupIds.N, mais pas les deux.

    sg-bp1fg655nh68xyz9i****
    PrivateIpAddress

    array

    Non

    Une ou plusieurs adresses IP privées secondaires sélectionnées parmi les adresses inutilisées dans le bloc CIDR du vSwitch auquel le contrôleur d'interface réseau (NIC) appartient. Valeurs valides de N : 0 à 10.

    Remarque

    Lorsque vous allouez des adresses IP privées secondaires, vous ne pouvez pas spécifier à la fois le paramètre PrivateIpAddress.N et le paramètre SecondaryPrivateIpAddressCount.

    172.17.**.**

    string

    Non

    Une ou plusieurs adresses IP privées secondaires sélectionnées parmi les adresses inutilisées dans le bloc CIDR du vSwitch auquel le contrôleur d'interface réseau (NIC) appartient. Valeurs valides de N : 0 à 10.

    Remarque

    Lorsque vous allouez des adresses IP privées secondaires, vous ne pouvez pas spécifier à la fois le paramètre PrivateIpAddress.N et le paramètre SecondaryPrivateIpAddressCount.

    172.17.**.**
    Ipv6Address

    array

    Non

    Une ou plusieurs adresses IPv6 à attribuer au contrôleur d'interface réseau (NIC). Vous pouvez spécifier jusqu'à 10 adresses IPv6. Valeurs valides de N : 1 à 10.

    Exemple : Ipv6Address.1=2001:db8:1234:1a00::****

    Remarque

    Si vous souhaitez définir des adresses IPv6 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv6Addresses.N, soit le paramètre Ipv6AddressCount, mais pas les deux.

    2001:db8:1234:1a00::****

    string

    Non

    Une ou plusieurs adresses IPv6 à attribuer au contrôleur d'interface réseau (NIC). Vous pouvez spécifier jusqu'à 10 adresses IPv6. Valeurs valides de N : 1 à 10.

    Exemple : Ipv6Address.1=2001:db8:1234:1a00::****

    Remarque

    Si vous souhaitez définir des adresses IPv6 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv6Addresses.N, soit le paramètre Ipv6AddressCount, mais pas les deux.

    2001:db8:1234:1a00::****
    Ipv6AddressCount

    integer

    Non

    Le nombre d'adresses IPv6 à générer aléatoirement pour le contrôleur d'interface réseau (NIC). Valeurs valides : 1 à 10.

    Remarque

    Si vous souhaitez définir des adresses IPv6 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv6Addresses.N, soit le paramètre Ipv6AddressCount, mais pas les deux.

    1
    Ipv4Prefix

    array

    Non

    Un ou plusieurs préfixes IPv4 à attribuer au contrôleur d'interface réseau (NIC). Valeurs valides de N : 1 à 10.

    Remarque

    Si vous souhaitez définir des préfixes IPv4 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv4Prefix.N, soit le paramètre Ipv4PrefixCount, mais pas les deux.

    string

    Non

    Un ou plusieurs préfixes IPv4 à attribuer au contrôleur d'interface réseau (NIC). Valeurs valides de N : 1 à 10.

    Remarque

    Si vous souhaitez définir des préfixes IPv4 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv4Prefix.N, soit le paramètre Ipv4PrefixCount, mais pas les deux.

    192.168.**.**/28
    Ipv4PrefixCount

    integer

    Non

    Le nombre de préfixes IPv4 à attribuer au contrôleur d'interface réseau (NIC). Valeurs valides : 1 à 10.

    Remarque

    Si vous souhaitez définir des préfixes IPv4 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv4Prefix.N, soit le paramètre Ipv4PrefixCount, mais pas les deux.

    1
    Ipv6Prefix

    array

    Non

    Un ou plusieurs préfixes IPv6 à attribuer au contrôleur d'interface réseau (NIC). Valeurs valides de N : 1 à 10.

    Remarque

    Si vous souhaitez définir des préfixes IPv6 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv6Prefix.N, soit le paramètre Ipv6PrefixCount, mais pas les deux.

    string

    Non

    Un ou plusieurs préfixes IPv6 à attribuer au contrôleur d'interface réseau (NIC). Valeurs valides de N : 1 à 10.

    Remarque

    Si vous souhaitez définir des préfixes IPv6 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv6Prefix.N, soit le paramètre Ipv6PrefixCount, mais pas les deux.

    2001:db8:1234:1a00:****::/80
    Ipv6PrefixCount

    integer

    Non

    Le nombre de préfixes IPv6 à attribuer au contrôleur d'interface réseau (NIC). Valeurs valides : 1 à 10.

    Remarque

    Si vous souhaitez définir des préfixes IPv6 pour le contrôleur d'interface réseau (NIC), vous devez définir soit le paramètre Ipv6Prefix.N, soit le paramètre Ipv6PrefixCount, mais pas les deux.

    1
    DeleteOnRelease

    boolean

    Non

    Indique si l'ENI doit être conservée lorsque l'instance associée est libérée. Valeurs valides :

    • true : ne conserve pas l'ENI.

    • false : conserve l'ENI.

    true
    TxQueueSize

    integer

    Non

    La profondeur de la file d'attente sortante du contrôleur d'interface réseau (NIC).

    Prenez note des points suivants :

    • La profondeur de la file d'attente sortante du contrôleur d'interface réseau (NIC) doit être égale à la profondeur de la file d'attente entrante. Valeurs valides : 8192 à 16384. La valeur doit être une puissance de 2.

    • Une profondeur de file d'attente sortante plus importante augmente le débit sortant, mais consomme plus de mémoire.

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    8192
    RxQueueSize

    integer

    Non

    La profondeur de la file d'attente entrante du contrôleur d'interface réseau (NIC).

    Prenez note des points suivants :

    • La profondeur de la file d'attente entrante du contrôleur d'interface réseau (NIC) doit être égale à la profondeur de la file d'attente sortante. Valeurs valides : 8192 à 16384. La valeur doit être une puissance de 2.

    • Une profondeur de file d'attente entrante plus importante augmente le débit entrant, mais consomme plus de mémoire.

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    8192
    NetworkInterfaceTrafficConfig

    object

    Non

    L'ensemble des paramètres de configuration du trafic du contrôleur d'interface réseau (NIC).

    QueueNumber

    integer

    Non

    Le nombre de files d'attente pour le contrôleur d'interface réseau (NIC).

    8
    NetworkInterfaceTrafficMode

    string

    Non

    Le mode de communication du contrôleur d'interface réseau (NIC).

    HighPerformance
    QueuePairNumber

    integer

    Non

    Le nombre de files d'attente pour l'ENI RDMA.

    8
    TxQueueSize

    integer

    Non

    La profondeur de la file d'attente sortante du contrôleur d'interface réseau (NIC).

    Remarque

    Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement. Si vous souhaitez utiliser ce paramètre, soumettez un ticket pour demander un accès.

    Prenez note des points suivants :

    • Ce paramètre s'applique uniquement aux types d'instances ECS de septième génération et ultérieures.

    • Ce paramètre s'applique actuellement uniquement aux images Linux.

    • Une profondeur de file d'attente sortante plus importante augmente le débit sortant et réduit la probabilité de perte de paquets, mais consomme plus de mémoire.

    8192
    RxQueueSize

    integer

    Non

    La profondeur de la file d'attente entrante du contrôleur d'interface réseau (NIC).

    Remarque

    Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement. Si vous souhaitez utiliser ce paramètre, soumettez un ticket pour demander un accès.

    Prenez note des points suivants :

    • Ce paramètre s'applique uniquement aux types d'instances ECS de septième génération et ultérieures.

    • Ce paramètre s'applique actuellement uniquement aux images Linux.

    • Une profondeur de file d'attente entrante plus importante augmente le débit entrant et réduit la probabilité de perte de paquets, mais consomme plus de mémoire.

    8192
    ConnectionTrackingConfiguration

    object

    Non

    La configuration du suivi de la connectivité réseau.

    Avant d'utiliser ce paramètre, lisez Gestion du délai d'expiration des connexions.

    TcpEstablishedTimeout

    integer

    Non

    Le délai d'expiration pour les connexions TCP établies. Unité : secondes. Valeurs valides : [30, 60, 80, 100, 200, 300, 500, 700, 910].

    Valeur par défaut : 910.

    910
    TcpClosedAndTimeWaitTimeout

    integer

    Non

    Le délai d'expiration pour les connexions TCP dans les états TIME_WAIT et CLOSED. Unité : secondes. Valeurs valides : entiers de 3 à 15.

    Valeur par défaut : 3.

    Remarque

    Si votre instance ECS est utilisée avec NLB/CLB, le délai d'expiration par défaut pour les connexions dans l'état TIME_WAIT est de 15 secondes.

    3
    UdpTimeout

    integer

    Non

    Le délai d'expiration pour les flux UDP. Unité : secondes. Valeurs valides : [10, 20, 30, 60, 80, 100].

    Valeur par défaut : 30.

    Remarque

    Si votre instance ECS est utilisée avec NLB/CLB, la valeur par défaut est de 100 secondes.

    30
    EnhancedNetwork

    object

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    EnableSriov

    boolean

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    true
    EnableRss

    boolean

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    true
    VirtualFunctionTotalQueueNumber

    integer

    Non

    VirtualFunctionQuantity

    integer

    Non

    EnableExpress

    boolean

    Non

    SourceDestCheck

    boolean

    Non

    Indique si la vérification source/destination doit être activée. Nous vous recommandons d'activer cette fonctionnalité pour améliorer la sécurité du réseau. Valeurs valides :

    • true : activée.

    • false : désactivée.

    Valeur par défaut : false.

    Remarque

    Cette fonctionnalité n'est prise en charge que dans des régions spécifiques. Avant d'utiliser cette fonctionnalité, lisez Vérification source/destination.

    false
    EnablePrimaryIPv6

    boolean

    Non

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Status

    string

    L'état de l'interface réseau.

    Available
    Type

    string

    Le type de l'interface réseau.

    Secondary
    VpcId

    string

    L'identifiant du VPC auquel l'ENI appartient.

    vpc-bp1j7w3gc1cexjqd****
    NetworkInterfaceName

    string

    Le nom de l'interface réseau.

    my-eni-name
    MacAddress

    string

    L'adresse MAC de l'interface réseau.

    00:16:3e:12:**:**
    NetworkInterfaceId

    string

    L'identifiant de l'interface réseau.

    eni-bp14v2sdd3v8htln****
    ServiceID

    integer

    L'identifiant de l'opérateur de réseau virtuel (VNO) auquel l'interface réseau correspond.

    12345678910
    OwnerId

    string

    L'identifiant du compte propriétaire de l'interface réseau.

    123456****
    ServiceManaged

    boolean

    Indique si l'utilisateur de l'interface réseau est un service Alibaba Cloud ou un VNO.

    true
    VSwitchId

    string

    L'identifiant du vSwitch dans le VPC.

    vsw-bp16usj2p27htro3****
    RequestId

    string

    L'identifiant de la requête.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    Description

    string

    La description de l'interface réseau.

    testDescription
    ResourceGroupId

    string

    L'identifiant du groupe de ressources.

    rg-2ze88m67qx5z****
    ZoneId

    string

    L'identifiant de la zone.

    cn-hangzhou-e
    PrivateIpAddress

    string

    L'adresse IP privée de l'interface réseau.

    172.17.**.**
    SecurityGroupIds

    object

    SecurityGroupId

    array

    Les groupes de sécurité auxquels l'ENI appartient.

    string

    L'identifiant du groupe de sécurité.

    sg-bp18kz60mefsicfg****
    PrivateIpSets

    object

    PrivateIpSet

    array<object>

    La collection d'objets PrivateIpSet.

    object

    PrivateIpAddress

    string

    L'adresse IP privée de l'instance.

    172.17.**.**
    Primary

    boolean

    Indique si l'adresse IP est l'adresse IP privée principale.

    true
    Tags

    object

    Tag

    array<object>

    Les balises.

    object

    TagValue

    string

    La valeur de la balise.

    TestValue
    TagKey

    string

    La clé de la balise.

    TestKey
    Ipv6Sets

    object

    Ipv6Set

    array<object>

    Les adresses IPv6 allouées à l'interface réseau.

    object
    Remarque

    Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.

    Ipv6Address

    string

    L'adresse IPv6.

    2001:db8:1234:1a00::****
    Primary

    boolean

    Ipv4PrefixSets

    object

    Ipv4PrefixSet

    array<object>

    Les préfixes IPv4 alloués à l'interface réseau.

    object

    Ipv4Prefix

    string

    Le préfixe IPv4.

    192.168.**.**/28
    Ipv6PrefixSets

    object

    Ipv6PrefixSet

    array<object>

    Les préfixes IPv6 alloués à l'interface réseau.

    object

    Ipv6Prefix

    string

    Le préfixe IPv6.

    2001:db8:1234:1a00:****::/80
    SourceDestCheck

    boolean
    Remarque

    Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.

    false

    Exemples

    JSON format

    {
  "Status": "Available",
  "Type": "Secondary",
  "VpcId": "vpc-bp1j7w3gc1cexjqd****",
  "NetworkInterfaceName": "my-eni-name",
  "MacAddress": "00:16:3e:12:**:**",
  "NetworkInterfaceId": "eni-bp14v2sdd3v8htln****",
  "ServiceID": 12345678910,
  "OwnerId": "123456****",
  "ServiceManaged": true,
  "VSwitchId": "vsw-bp16usj2p27htro3****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Description": "testDescription",
  "ResourceGroupId": "rg-2ze88m67qx5z****",
  "ZoneId": "cn-hangzhou-e",
  "PrivateIpAddress": "172.17.**.**",
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp18kz60mefsicfg****"
    ]
  },
  "PrivateIpSets": {
    "PrivateIpSet": [
      {
        "PrivateIpAddress": "172.17.**.**",
        "Primary": true
      }
    ]
  },
  "Tags": {
    "Tag": [
      {
        "TagValue": "TestValue",
        "TagKey": "TestKey"
      }
    ]
  },
  "Ipv6Sets": {
    "Ipv6Set": [
      {
        "Ipv6Address": "2001:db8:1234:1a00::****",
        "Primary": false
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.**/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "SourceDestCheck": false
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 MissingParameter %s
    400 UnsupportedParameter %s
    400 InvalidParameter %s
    400 InvalidInstanceID.Malformed %s
    400 InvalidOperation.InvalidEcsState %s
    400 InvalidOperation.InvalidEniState %s
    400 InvalidOperation.DetachPrimaryEniNotAllowed %s
    400 Forbidden.RegionId %s
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
    400 JoinedGroupLimitExceed %s
    400 InvalidParameter.SecurityGroupIdRepeated %s
    400 InvalidSecurityGroupId.SingleIdAndMultiIdConflict %s
    400 InvalidParameter.Conflict %s
    400 InvalidConnectionTrackingConfiguration.RegionOrUserNotSupported The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.
    400 InvalidOperation.EniCountExceeded %s.
    400 InvalidPrivateIpAddress.Duplicated The specified private IP address "%s" is duplicated.
    400 IncorrectVSwitchStatus The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".
    400 InvalidEniQueueSize.RegionOrUserNotSupported The specified parameter "RxQueueSize" or "TxQueueSize" is not supported in this region or this account is not allowed to use ENI QueueSize.
    400 InvalidParameter.EniQueueSize The specified parameter "TxQueueSize" and "RxQueueSize" are not equal or the value must be 8192 or 16384.
    400 InvalidParameter.EniConnectionTrackingConfiguration The specified ENI connection tracking configuration "%s" must be between %s and %s.
    400 QuotaExceeded.PrivateIpAddress There are not enough private IPs in the specified VSwitch.
    400 Throttling Request was denied due to request throttling.
    400 InvalidVSwitch.IllegalStatus The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".
    400 InvalidParameter.EniEnhancedNetwork The input parameter "EnhancedNetwork" is illegal, when EnableSriov is true, VirtualFunctionTotalQueueNumber must not be empty, and VirtualFunctionQuantity must be 1 to 256. When EnableSriov is empty or false, VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty.
    400 InvalidOperation.EnablePrimaryIPv6 The specified ENI can not enable primary IPv6 or already has primary IPv6.
    400 InvalidVSwitch.Ipv4NotEnabled The specify VSwitch of ECS does not support IPv4.
    401 InvalidOperation.SecurityGroupNotAuthorized The specified security group is not authorized to operate.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    500 InvalidOperation.RegionNotSupportIpPrefix The current region does not support IP prefix feature.
    500 ServiceUnavailable The request processing has failed due to some unknown error.
    403 InvalidUserType.NotSupported %s
    403 Abs.InvalidAccount.NotFound %s
    403 Forbidden.NotSupportRAM %s
    403 Forbidden.SubUser %s
    403 InValidParameter %s
    403 MaxEniCountExceeded %s
    403 EniPerInstanceLimitExceeded %s
    403 InvalidOperation.AvailabilityZoneMismatch %s
    403 InvalidOperation.VpcMismatch %s
    403 SecurityGroupInstanceLimitExceed %s
    403 InvalidSecurityGroupId.NotVpc %s
    403 InvalidOperation.InvalidEniType %s
    403 InvalidVSwitchId.IpNotEnough %s
    403 InvalidVSwitchId.IpInvalid %s
    403 QuotaExceed.Tags %s
    403 InvalidIp.Address %s
    403 InvalidIp.IpRepeated %s
    403 MaxEniPrivateIpsCountExceeded %s
    403 InvalidOperation.ResourceManagedByCloudProduct %s
    403 InvalidOperation.TrunkingIsNotAllowed %s
    403 InvalidParameter.InvalidEniQueueNumber %s
    403 InvalidOperation.MaxEniQueueNumberExceeded %s
    403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
    403 InvalidParameter.EniTrafficMode %s
    403 InvalidOperation.HighPerformanceTrafficModeIsNotAllowed %s
    403 InvalidParameter.QueuePairNumberMustEmpty %s
    403 InvalidParameter.InvalidQueuePairNumber %s
    403 InvalidParams.NetworkInterfaceName %s
    403 InvalidIp.IpPrefixIllegal The ip prefixes %s is/are illegal.
    403 InvalidIp.IpPrefixMustInReserveSegment The ip prefix must in vswitch reserve segment.
    403 InvalidOperation.Ipv4CountExceeded %s
    403 InvalidOperation.Ipv6CountExceeded %s
    403 InvalidOperation.HighPerformanceTrafficModeEniUnsupported High performance traffic mode does not support the current ENI type. Expected ENI type is "%s" but the current ENI type is "%s".
    403 AclLimitExceed %s
    403 InvalidIp.IpPrefixMaskInvalid The IP prefix mask %s is illegal which must be between %s and %s.
    403 InvalidVSwitchId.IpPrefixNotEnough The specified VSwitch does not have enough IP prefixes.
    403 InvalidIp.IpPrefixMaskNotSame The IP prefixes %s are illegal.The IP prefix mask must be the same.
    403 EnterpriseGroupLimited.MutliGroupType The specified instance can't associate security group of different types.
    403 InvalidOperation.BoundingEniSlaveQuotaExceed The number of Slave ENIs exceeds the limit of Bond ENI.
    403 InvalidIp.IpPrefixNotAvailable The IP prefix is not available.
    403 InvalidIp.IpPrefixMaskIllegal The current IP prefix mask is illegal.
    403 InvalidIp.IpPrefixNotStrict The IP prefix "%s" must be strict CIDR format.
    403 InvalidOperation.NotSupport The specified region does not support allocating IPv6 when creating ENI.
    404 InvalidEcsId.NotFound %s
    404 InvalidEniId.NotFound %s
    404 InvalidVSwitchId.NotFound %s
    404 InvalidSecurityGroupId.NotFound %s
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.
    404 InvalidOperation.MaxEniIpv6IpsCountExceeded The ipv6 address count exceed limitation.
    404 InvalidOperation.VSwitchIpv6Disabled The specified VSwitch does not support Ipv6 feature.
    404 InvalidOperation.EnableIpv6Failed The specified VSwitch does not support Ipv6 feature.
    404 InvalidOperation.AddressAlreadyAllocated The specified ipv6 has been already allocated.
    404 InvalidOperation.AddressNotInVSwitchCidr The specified ipv6 does not match VSwitch cidr scope.
    404 InvalidOperation.SlaveEniMustHaveBondingEni Ensure you create the corresponding Bond ENI before creating Slave ENI.
    404 InvalidOperation.EniTrafficModeNotSupportIpv6 The High Performance(RDMA) traffic mode does not support IPv6.
    404 InvalidOperation.VSwitchCidrReservationNotExist The specified VSwitch does not have CIDR reservation.

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.