CreateNetworkInterface - - Centre de documentation Alibaba Cloud

Crée une interface réseau élastique (ENI).

Remarques sur l'utilisation

Prenez note des points suivants :

Cette opération est synchrone. Une fois créée, l'ENI passe immédiatement à l'état Available (Available) et peut être attachée à une instance Elastic Compute Service (ECS).
Si le paramètre NetworkInterfaceId est vide dans la réponse, aucune ENI n'a été créée. Appelez de nouveau l'opération pour créer une ENI.
Une ENI ne peut être attachée qu'à une seule instance résidant dans un Virtual Private Cloud (VPC).
Lorsqu'une ENI est détachée d'une instance puis rattachée à une autre, ses attributs restent inchangés et le trafic réseau est redirigé vers la nouvelle instance.
Lors de l'appel à cette opération pour créer une ENI, vous pouvez lui attribuer jusqu'à 49 adresses IP privées secondaires.
Pour attribuer des adresses IPv6 lors de la création d'une ENI, assurez-vous que le protocole IPv6 est activé sur le vSwitch auquel vous souhaitez associer l'ENI. Pour plus d'informations, consultez Qu'est-ce qu'une passerelle IPv6 ?
Un quota limite le nombre d'ENI pouvant être créées par région Alibaba Cloud et par compte. Vous pouvez consulter ce quota dans la console ECS. Pour plus d'informations, consultez Consulter et augmenter les quotas de ressources.

Pour obtenir des exemples d'appels à cette opération, consultez Créer une ENI.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement le code d'exemple de l'opération pour différents SDKs.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Yes	CreateNetworkInterface	Opération à effectuer. Définissez la valeur à CreateNetworkInterface.
RegionId	String	Yes	cn-hangzhou	ID de la région où créer l'ENI. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste la plus récente des régions.
Tag.N.Key	String	No	TestKey	Clé du tag N à ajouter à l'ENI. Valeurs valides de N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. Elle peut contenir jusqu'à 128 caractères et ne doit pas inclure `http://` ni `https://`. La clé du tag ne peut pas commencer par acs: ou aliyun.
Tag.N.Value	String	No	TestValue	Valeur du tag N à ajouter à l'ENI. Valeurs valides de N : 1 à 20. La valeur du tag peut être une chaîne vide. Elle peut contenir jusqu'à 128 caractères et ne doit pas inclure `http://` ni `https://`. La valeur du tag ne peut pas commencer par acs:.
ResourceGroupId	String	No	rg-bp67acfmxazb4ph****	ID du groupe de ressources auquel affecter l'ENI. Vous pouvez appeler l'opération ListResourceGroups pour obtenir la liste la plus récente des groupes de ressources.
VSwitchId	String	Yes	vsw-bp1s5fnvk4gn2tws03****	ID du vSwitch dans le VPC spécifié. Les adresses IP privées sont attribuées à l'ENI à partir du bloc CIDR du vSwitch.
PrimaryIpAddress	String	No	172.17..	Adresse IP privée principale à attribuer à l'ENI. L'adresse IP spécifiée doit être une adresse IP inutilisée dans le bloc CIDR du vSwitch. Si ce paramètre n'est pas spécifié, une adresse IP inutilisée est attribuée aléatoirement depuis le bloc CIDR du vSwitch.
SecurityGroupId	String	No	sg-bp1fg655nh68xyz9i****	ID du groupe de sécurité. Le groupe de sécurité et l'ENI doivent appartenir au même VPC. Remarque Vous devez spécifier `SecurityGroupId` ou `SecurityGroupIds.N`, mais pas les deux.
NetworkInterfaceName	String	No	testNetworkInterfaceName	Nom de l'ENI. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Ce paramètre est vide par défaut.
Description	String	No	testDescription	Description de l'ENI. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`. Ce paramètre est vide par défaut.
Visible	Boolean	No	null	Remarque Ce paramètre n'est plus utilisé.
InstanceType	String	No	null	Remarque Ce paramètre n'est plus utilisé.
BusinessType	String	No	null	Remarque Ce paramètre n'est plus utilisé.
SecondaryPrivateIpAddressCount	Integer	No	1	Nombre d'adresses IP privées à créer automatiquement par ECS. Valeurs valides : 1 à 49.
QueueNumber	Integer	No	1	Nombre de files d'attente prises en charge par l'ENI. Valeurs valides : 1 à 2048. Lorsque vous attachez l'ENI à une instance, assurez-vous que la valeur de ce paramètre est inférieure au nombre maximal de files d'attente par ENI autorisé pour le type d'instance. Pour consulter le nombre maximal de files d'attente par ENI autorisé pour un type d'instance, appelez l'opération DescribeInstanceTypes et vérifiez la valeur de retour de `MaximumQueueNumberPerEni`. Ce paramètre est vide par défaut. Si vous ne le spécifiez pas, le nombre de files d'attente par ENI par défaut pour le type d'instance est utilisé lors de l'attachement de l'ENI à l'instance. Pour connaître le nombre de files d'attente par ENI par défaut pour un type d'instance, appelez l'opération DescribeInstanceTypes et vérifiez la valeur de retour de `SecondaryEniQueueNumber`.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.
NetworkInterfaceTrafficMode	String	No	Standard	Mode de communication de l'ENI. Valeurs valides : Standard : utilise le mode de communication TCP. HighPerformance : utilise le mode de communication RDMA (Remote Direct Memory Access) avec l'interface ERI (Elastic RDMA Interface) activée. Remarque La valeur HighPerformance prend uniquement en charge la famille d'instances optimisées pour RDMA c7re. Le nombre maximal d'ENI en mode RDMA pouvant être attachées à une instance c7re dépend du type d'instance. La famille d'instances c7re est disponible en avant-première sur invitation dans la zone K de Pékin. Pour plus d'informations, consultez Présentation des familles d'instances. Valeur par défaut : Standard.
QueuePairNumber	Integer	No	22	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.
SecurityGroupIds.N	String	No	sg-bp1fg655nh68xyz9i****	ID du groupe de sécurité N auquel affecter l'ENI. Le groupe de sécurité et l'ENI doivent appartenir au même VPC. Les valeurs valides de N dépendent du nombre maximal de groupes de sécurité auxquels une ENI peut être affectée. Pour plus d'informations, consultez Limites. Remarque Vous devez spécifier `SecurityGroupId` ou `SecurityGroupIds.N`, mais pas les deux.
PrivateIpAddress.N	String	No	172.17..	Adresse IP privée secondaire N à attribuer à l'ENI. Cette adresse IP doit être une adresse IP inutilisée dans le bloc CIDR du vSwitch auquel associer l'ENI. Valeurs valides de N : 0 à 10. Remarque Pour attribuer des adresses IP privées secondaires à l'ENI, vous devez spécifier les paramètres `PrivateIpAddress.N` ou `SecondaryPrivateIpAddressCount`, mais pas les deux.
Ipv6Address.N	String	No	2001:db8:1234:1a00::****	Adresse IPv6 N à attribuer à l'ENI. Valeurs valides de N : 1 à 10. Exemple : Ipv6Address.1=2001:db8:1234:1a00::** Remarque** Pour attribuer des adresses IPv6 à l'ENI, vous devez spécifier `Ipv6Addresses.N` ou `Ipv6AddressCount`, mais pas les deux.
Ipv6AddressCount	Integer	No	1	Nombre d'adresses IPv6 générées aléatoirement à attribuer à l'ENI. Valeurs valides : 1 à 10. Remarque Pour attribuer des adresses IPv6 à l'ENI, vous devez spécifier `Ipv6Addresses.N` ou `Ipv6AddressCount`, mais pas les deux.
Ipv4Prefix.N	String	No	192.168../28	Préfixe IPv4 N à attribuer à l'ENI. Valeurs valides de N : 1 à 10. Remarque Pour attribuer des préfixes IPv4 à l'ENI, vous devez spécifier Ipv4Prefix.N ou Ipv4PrefixCount, mais pas les deux.
Ipv4PrefixCount	Integer	No	1	Nombre de préfixes IPv4 à attribuer à l'ENI. Valeurs valides : 1 à 10. Remarque Pour attribuer des préfixes IPv4 à l'ENI, vous devez spécifier Ipv4Prefix.N ou Ipv4PrefixCount, mais pas les deux.
Ipv6Prefix.N	String	No	2001:db8:1234:1a00:****::/80	Préfixe IPv6 N à attribuer à l'ENI. Valeurs valides de N : 1 à 10. Remarque Pour attribuer des préfixes IPv6 à l'ENI, vous devez spécifier Ipv6Prefix.N ou Ipv6PrefixCount, mais pas les deux.
Ipv6PrefixCount	Integer	No	1	Nombre de préfixes IPv6 à attribuer à l'ENI. Valeurs valides : 1 à 10. Remarque Pour attribuer des préfixes IPv6 à l'ENI, vous devez spécifier Ipv6Prefix.N ou Ipv6PrefixCount, mais pas les deux.
DeleteOnRelease	Boolean	No	true	Indique si l'ENI doit être libérée lorsque l'instance associée est libérée. Valeurs valides : true false

Paramètres de réponse

Paramètre

Type

Exemple

Description

Status

String

Available

État de l'ENI.

Type

String

Secondary

Type de l'ENI.

VpcId

String

vpc-bp1j7w3gc1cexjqd****

ID du VPC auquel appartient l'ENI.

NetworkInterfaceName

String

my-eni-name

Nom de l'ENI.

MacAddress

String

00:16:3e:12::

Adresse MAC (Media Access Control) de l'ENI.

NetworkInterfaceId

String

eni-bp14v2sdd3v8htln****

ID de l'ENI.

ServiceID

Long

12345678910

ID du distributeur auquel appartient l'ENI.

OwnerId

String

123456****

ID du compte auquel appartient l'ENI.

ServiceManaged

Boolean

true

Indique si l'utilisateur de l'ENI est un service Alibaba Cloud ou un distributeur.

VSwitchId

String

vsw-bp16usj2p27htro3****

ID du vSwitch.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Description

String

testDescription

Description de l'ENI.

ResourceGroupId

String

rg-2ze88m67qx5z****

ID du groupe de ressources auquel appartient l'ENI.

ZoneId

String

cn-hangzhou-e

ID de zone de l'ENI.

PrivateIpAddress

String

172,17..

Adresse IP privée de l'ENI.

SecurityGroupIds

Array of String

sg-bp18kz60mefsicfg****

ID des groupes de sécurité auxquels appartient l'ENI.

PrivateIpSets

Array of PrivateIpSet

Adresses IP privées de l'ENI.

PrivateIpSet

PrivateIpAddress

String

172,17..

Adresse IP privée de l'ENI.

Primary

Boolean

true

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

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
&RegionId=cn-hangzhou
&SecurityGroupIds.1=sg-bp18kz60mefsicfg****
&VSwitchId=vsw-bp1s5fnvk4gn2tws03****
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&ResourceGroupId=rg-bp67acfmxazb4ph****
&PrimaryIpAddress=172.17.**.**
&NetworkInterfaceName=testNetworkInterfaceName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6AddressCount=1
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<CreateNetworkInterfaceResponse>
    <Description>testDescription</Description>
    <Status>Available</Status>
    <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
    <ServiceManaged>false</ServiceManaged>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <ResourceGroupId>rg-2ze88m67qx5z****</ResourceGroupId>
    <ZoneId>cn-hangzhou-e</ZoneId>
    <VSwitchId>vsw-bp16usj2p27htro3****</VSwitchId>
    <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
    <MacAddress>00:16:3e:12:**:**</MacAddress>
    <NetworkInterfaceId>eni-bp14v2sdd3v8htln****</NetworkInterfaceId>
    <SecurityGroupIds>
        <SecurityGroupId>sg-bp18kz60mefsicfg****</SecurityGroupId>
    </SecurityGroupIds>
    <Type>Secondary</Type>
    <Ipv6Sets>
        <Ipv6Set>
            <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
        </Ipv6Set>
    </Ipv6Sets>
    <VpcId>vpc-bp1j7w3gc1cexjqd****</VpcId>
    <OwnerId>123456****</OwnerId>
    <Tags>
        <Tag>
            <TagKey>TestKey</TagKey>
            <TagValue>TestValue</TagValue>
        </Tag>
    </Tags>
    <PrivateIpSets>
        <PrivateIpSet>
            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
            <Primary>true</Primary>
        </PrivateIpSet>
    </PrivateIpSets>
</CreateNetworkInterfaceResponse>

JSON format

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

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

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

400

MissingParameter

Un paramètre obligatoire n'est pas spécifié.

400

UnsupportedParameter

Un paramètre spécifié n'est pas pris en charge.

400

InvalidParameter

Valeur de paramètre invalide.

400

InvalidInstanceID.Malformed

Format InstanceId invalide.

400

InvalidOperation.InvalidEcsState

Cette opération ne peut pas être effectuée sur l'instance dans son état actuel.

400

InvalidOperation.InvalidEniState

Cette opération ne peut pas être effectuée sur l'ENI dans son état actuel.

400

InvalidOperation.DetachPrimaryEniNotAllowed

L'ENI principale ne peut pas être détachée de l'instance.

400

Forbidden.RegionId

Le service n'est actuellement pas disponible dans cette région.

400

Duplicate.TagKey

The Tag.N.Key contain duplicate key.

La clé du tag existe déjà. Les clés de tag doivent être uniques.

400

InvalidTagKey.Malformed

The specified Tag.n.Key is not valid.

Valeur Tag.N.Key invalide.

400

InvalidTagValue.Malformed

The specified Tag.n.Value is not valid.

Valeur Tag.N.Value invalide.

400

InvalidOperation.EniCountExceeded

The maximum number of eni in a enterprise security group is exceeded.

Le nombre maximal d'ENI dans le groupe de sécurité avancé est dépassé.

400

IncorrectVSwitchStatus

The current status of vSwitch does not support this operation.

L'opération ne peut pas être effectuée sur le vSwitch dans son état actuel.

400

JoinedGroupLimitExceed

Le nombre maximal de groupes de sécurité auxquels la ressource spécifiée peut être affectée est dépassé. Pour plus d'informations, consultez la valeur de retour du placeholder %s dans le message d'erreur.

400

InvalidPrivateIpAddress.Duplicated

Specified private IP address is duplicated.

L'adresse IP privée spécifiée est déjà utilisée. Essayez une autre adresse IP.

400

InvalidParameter.Conflict

Valeur de paramètre invalide. Vérifiez s'il existe des conflits de paramètres. %s est une variable. Un message d'erreur est retourné dynamiquement en fonction des conditions d'appel.

400

IncorrectVSwitchStatus

The current status of virtual switch does not support this operation.

Le vSwitch spécifié est à l'état Pending et ne peut pas être supprimé.

403

InvalidUserType.NotSupported

Votre compte ne prend pas en charge cette opération.

403

Abs.InvalidAccount.NotFound

Votre compte Alibaba Cloud est introuvable ou votre paire d'AccessKey a expiré.

403

Forbidden.NotSupportRAM

Les utilisateurs Resource Access Management (RAM) n'ont pas les permissions nécessaires pour effectuer cette opération.

403

Forbidden.SubUser

Vous n'avez pas accès à la ressource. Contactez le propriétaire du compte Alibaba Cloud.

403

MaxEniCountExceeded

Le nombre maximal d'ENI pouvant être gérées est dépassé.

403

EniPerInstanceLimitExceeded

Le nombre maximal d'ENI pouvant être attachées à l'instance est dépassé.

403

InvalidOperation.AvailabilityZoneMismatch

L'opération est invalide.

403

InvalidOperation.VpcMismatch

L'opération est invalide. Vérifiez si le VPC de l'opération correspond aux autres paramètres.

403

SecurityGroupInstanceLimitExceed

Le nombre maximal d'instances dans le groupe de sécurité spécifié est dépassé.

403

InvalidSecurityGroupId.NotVpc

ID de groupe de sécurité invalide. Le type de réseau du groupe de sécurité spécifié n'est pas VPC.

403

InvalidOperation.InvalidEniType

Cette opération ne peut pas être effectuée sur ce type d'ENI.

403

InvalidVSwitchId.IpNotEnough

Le nombre d'adresses IP disponibles sur le vSwitch spécifié est insuffisant.

403

InvalidVSwitchId.IpInvalid

Adresse IP privée invalide.

403

QuotaExceed.Tags

Le nombre maximal de tags est dépassé. %s est une variable. Un message d'erreur est retourné dynamiquement en fonction des conditions d'appel.

403

InvalidIp.IpRepeated

L'adresse IP existe déjà.

403

MaxEniPrivateIpsCountExceeded

Le nombre maximal d'adresses IP privées secondaires pouvant être attribuées à l'ENI spécifiée est dépassé. Pour plus d'informations, consultez la valeur de retour du placeholder %s dans le message d'erreur.

403

InvalidOperation.ResourceManagedByCloudProduct

Vous ne pouvez pas modifier les groupes de sécurité gérés par les services cloud.

403

InvalidParameter.InvalidEniQueueNumber

Valeur QueueNumber invalide. Pour plus d'informations, consultez la valeur de retour du placeholder %s dans le message d'erreur.

403

InvalidOperation.MaxEniQueueNumberExceeded

Le nombre maximal de files d'attente par ENI est dépassé. Pour plus d'informations, consultez la valeur de retour du placeholder %s dans le message d'erreur.

403

InvalidOperation.ExceedInstanceTypeQueueNumber

Le nombre maximal de files d'attente pour toutes les ENI d'une instance est dépassé. Pour plus d'informations, consultez la valeur de retour du placeholder %s dans le message d'erreur.

403

InvalidIp.IpPrefixMaskNotSame

The ip prefixes %s are illegal which mask must be same.

Les masques de préfixe IP ne sont pas identiques.

403

InvalidIp.IpPrefixMaskInvalid

The ip prefixes mask %s is illegal which must be between %s and %s.

Le masque de préfixe IP est invalide et ne se situe pas dans la plage valide.

403

InvalidIp.IpPrefixMaskIllegal

The ip prefix mask is illegal.

Le masque de préfixe IP est invalide.

403

InvalidIp.IpPrefixIllegal

The ip prefixes %s is/are illegal.

Le préfixe IP est invalide et n'est pas au format CIDR.

403

InvalidIp.IpPrefixMustInReserveSegment

The ip prefix must in vswitch reserve segment.

Le préfixe IP est invalide et ne se trouve pas dans le bloc CIDR réservé du vSwitch.

403

InvalidIp.IpPrefixNotAvailable

The ip prefix is/are not available.

Le préfixe IP n'est pas disponible.

403

InvalidIp.IpPrefixNotStrict

The ip prefix must be strict cidr format.

Le préfixe IP est invalide et n'est pas au format CIDR.

403

InvalidVSwitchId.IpPrefixNotEnough

The specified vSwitch has not enough ip prefix.

Le nombre de préfixes IP dans le vSwitch spécifié est insuffisant.

404

InvalidEcsId.NotFound

L'ID d'instance est introuvable.

404

InvalidEniId.NotFound

L'ID d'ENI est introuvable.

404

InvalidVSwitchId.NotFound

L'ID de vSwitch est introuvable.

404

InvalidSecurityGroupId.NotFound

L'ID de groupe de sécurité spécifié n'existe pas.

404

InvalidResourceGroup.NotFound

The ResourceGroup provided does not exist in our records.

Le groupe de ressources n'existe pas.

404

InvalidOperation.VSwitchIpv6Disabled

The specified VSwitch does not support Ipv6 feature.

Le vSwitch spécifié ne prend pas en charge IPv6.

404

InvalidOperation.AddressAlreadyAllocated

The specified ip address has been already allocated.

L'adresse IP est déjà utilisée.

404

InvalidOperation.SlaveEniMustHaveBondingEni

Create slave eni must have bonding eni first.

Vous devez créer des ENI bond avant de pouvoir créer des ENI secondaires.

404

InvalidOperation.VSwitchCidrReservationNotExist

The specified vSwitch has no cidr reservation.

Aucun bloc CIDR réservé n'est disponible pour le vSwitch spécifié.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Une erreur interne s'est produite. Réessayez ultérieurement.

500

InvalidOperation.RegionNotSupportIpPrefix

The current region does not support ip prefix.

Les préfixes IP ne peuvent pas être attribués dans cette région.

Pour obtenir la liste des codes d'erreur, consultez Codes d'erreur du service.