Use ALIYUN::ECS::NetworkInterface in a call to create an ENI - Resource Orchestration Service

Le type de ressource ALIYUN::ECS::NetworkInterface permet de créer une interface réseau élastique (ENI).

Syntaxe

{
  "Type": "ALIYUN::ECS::NetworkInterface",
  "Properties": {
    "Description": String,
    "SecurityGroupId": String,
    "PrimaryIpAddress": String,
    "ResourceGroupId": String,
    "VSwitchId": String,
    "NetworkInterfaceName": String,
    "Tags": List,
    "SecurityGroupIds": List,
    "PrivateIpAddresses": List,
    "SecondaryPrivateIpAddressCount": Integer,
    "Ipv6Addresses": List,
    "QueueNumber": Integer,
    "NetworkInterfaceTrafficMode": String,
    "Ipv6AddressCount": Integer,
    "Ipv6Prefixes": List,
    "Ipv4Prefixes": List,
    "Ipv4PrefixCount": Integer,
    "TxQueueSize": Integer,
    "DeleteOnRelease": Boolean,
    "Ipv6PrefixCount": Integer,
    "RxQueueSize": Integer
  }
}

Propriétés

Property	Type	Required	Editable	Description	Constraint
ResourceGroupId	String	No	Yes	ID du groupe de ressources.	Pour obtenir l'ID du groupe de ressources, appelez l'opération ListResourceGroups.
SecurityGroupId	String	No	Yes	ID du groupe de sécurité.	Le groupe de sécurité et l'ENI doivent appartenir au même VPC. Remarque Vous ne pouvez pas spécifier simultanément les propriétés SecurityGroupId et SecurityGroupIds.
VSwitchId	String	Yes	No	ID du vSwitch.	Aucune.
Description	String	No	Yes	Description de l'ENI.	La description doit contenir entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
NetworkInterfaceName	String	No	Yes	Nom de l'ENI.	Le nom doit contenir entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas débuter par `http://` ou `https://`. Il peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).
PrimaryIpAddress	String	No	No	Adresse IP privée principale de l'ENI.	L'adresse IP privée principale doit être une adresse IP disponible dans le bloc CIDR du vSwitch auquel vous souhaitez associer l'ENI. Si vous laissez cette propriété vide, une adresse IP disponible est attribuée aléatoirement depuis le bloc CIDR du vSwitch.
SecondaryPrivateIpAddressCount	Integer	No	No	Nombre d'adresses IP privées secondaires.	Aucune.
Tags	List	No	Yes	Tags.	Vous pouvez ajouter jusqu'à 20 tags. Pour plus d'informations, consultez la section Propriétés des tags.
SecurityGroupIds	List	No	Yes	ID d'un ou plusieurs groupes de sécurité.	Les groupes de sécurité et l'ENI doivent appartenir au même VPC. Remarque Vous ne pouvez pas spécifier simultanément les propriétés SecurityGroupId et SecurityGroupIds.
PrivateIpAddresses	List	No	No	Une ou plusieurs adresses IP privées secondaires à attribuer à l'ENI depuis le bloc CIDR du vSwitch auquel vous souhaitez associer l'ENI.	Plages de valeurs valides pour le nombre d'adresses IP privées secondaires pouvant être attribuées à l'ENI : Si l'ENI est à l'état Available, les valeurs valides vont de 1 à 10. Si l'ENI est à l'état InUse, les valeurs valides varient en fonction du type d'instance. Pour plus d'informations, consultez la page Présentation des familles d'instances.
Ipv6Addresses	List	No	No	Une ou plusieurs adresses IPv6 à attribuer à l'ENI.	Vous pouvez spécifier jusqu'à 10 adresses IPv6. Remarque Pour attribuer des adresses IPv6 à l'ENI, vous devez spécifier la propriété `Ipv6Addresses` ou `Ipv6AddressCount`, mais pas les deux simultanément.
QueueNumber	Integer	No	No	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 cette propriété est inférieure au nombre maximal de files d'attente par ENI autorisé pour le type d'instance. Pour connaître le nombre maximal de files d'attente par ENI pour un type d'instance donné, appelez l'opération DescribeInstanceTypes et vérifiez la valeur renvoyée pour `MaximumQueueNumberPerEni`. La propriété QueueNumber est vide par défaut. Si vous laissez cette propriété vide lors de l'attachement de l'ENI à une instance, le nombre par défaut de files d'attente par ENI autorisé pour le type d'instance est utilisé. Pour connaître le nombre par défaut de files d'attente par ENI pour un type d'instance donné, appelez l'opération DescribeInstanceTypes et vérifiez la valeur renvoyée pour `SecondaryEniQueueNumber`.
NetworkInterfaceTrafficMode	String	No	No	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 la fonctionnalité ERI (Elastic RDMA Interface) activée. Remarque La valeur HighPerformance n'est prise en charge que par la famille d'instances optimisées pour le 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 en aperçu invité dans la zone K de Pékin. Pour plus d'informations, consultez la page Présentation des familles d'instances.
Ipv6AddressCount	Integer	No	No	Nombre d'adresses IPv6 à générer aléatoirement pour l'ENI.	Valeurs valides : 1 à 10. Remarque Pour attribuer des adresses IPv6 à l'ENI, vous devez spécifier la propriété `Ipv6Addresses` ou `Ipv6AddressCount`, mais pas les deux simultanément.
Ipv6Prefixes	List	No	No	Préfixes IPv6.	Aucune.
Ipv4Prefixes	List	No	No	Préfixes IPv4.	Aucune.
Ipv4PrefixCount	Integer	No	No	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 la propriété Ipv4Prefixes ou Ipv4PrefixCount, mais pas les deux simultanément.
TxQueueSize	Integer	No	Yes	Profondeur de la file d'attente de transmission (Tx) de l'ENI.	Tenez compte des points suivants : La profondeur de la file d'attente Tx d'une ENI doit être identique à celle de la file d'attente de réception (Rx). Valeurs valides : puissances de 2 comprises entre 8192 et 16384. Une profondeur de file d'attente Tx plus élevée offre un débit sortant plus important, mais consomme davantage de mémoire.
DeleteOnRelease	Boolean	No	Yes	Indique s'il faut conserver l'ENI lors de la libération de l'instance associée.	Valeurs valides : true false
Ipv6PrefixCount	Integer	No	No	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 la propriété Ipv6Prefixes ou Ipv6PrefixCount, mais pas les deux simultanément.
RxQueueSize	Integer	No	Yes	Profondeur de la file d'attente de réception (Rx) de l'ENI.	Tenez compte des points suivants : La profondeur de la file d'attente Rx d'une ENI doit être identique à celle de la file d'attente de transmission (Tx). Valeurs valides : puissances de 2 comprises entre 8192 et 16384. Une profondeur de file d'attente Rx plus élevée offre un débit entrant plus important, mais consomme davantage de mémoire.

Syntaxe des tags

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]

Propriétés des tags

Property	Type	Required	Editable	Description	Constraint
Key	String	Yes	No	Clé du tag.	La clé du tag doit contenir entre 1 et 128 caractères et ne peut pas contenir `http://` ni `https://`. Elle ne peut pas commencer par `aliyun` ni `acs:`.
Value	String	No	No	Valeur du tag.	La valeur du tag peut contenir jusqu'à 128 caractères et ne peut pas contenir `http://` ni `https://`. Elle ne peut pas commencer par `aliyun` ni `acs:`.

Valeurs de retour

Fn::GetAtt

NetworkInterfaceId : ID de l'ENI.
MacAddress : adresse MAC (Media Access Control) de l'ENI.
PrivateIpAddress : adresse IP privée de l'ENI.
SecondaryPrivateIpAddresses : adresses IP privées secondaires de l'ENI.
Arn : nom de ressource Alibaba Cloud (ARN).

Exemples

Format `YAML`

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  SecurityGroupId:
    Type: String
    AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
    Label:
       
      en: Security Group ID
  VSwitchId:
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    Type: String
    Label:
       
      en: VSwitch ID
Resources:
  EniInstance:
    Type: ALIYUN::ECS::NetworkInterface
    Properties:
      SecurityGroupId:
        Ref: SecurityGroupId
      VSwitchId:
        Ref: VSwitchId
      NetworkInterfaceName: TestNetworkInterface
Outputs:
  PrivateIpAddress:
    Description: The primary private ip address of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - PrivateIpAddress
  SecondaryPrivateIpAddresses:
    Description: The secondary private IP addresses of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - SecondaryPrivateIpAddresses
  MacAddress:
    Description: The MAC address of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - MacAddress
  NetworkInterfaceId:
    Description: ID of your Network Interface.
    Value:
      Fn::GetAtt:
        - EniInstance
        - NetworkInterfaceId

Format `JSON`

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "SecurityGroupId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
      "Label": {
         
        "en": "Security Group ID"
      }
    },
    "VSwitchId": {
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "Type": "String",
      "Label": {
         
        "en": "VSwitch ID"
      }
    }
  },
  "Resources": {
    "EniInstance": {
      "Type": "ALIYUN::ECS::NetworkInterface",
      "Properties": {
        "SecurityGroupId": {
          "Ref": "SecurityGroupId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "NetworkInterfaceName": "TestNetworkInterface"
      }
    }
  },
  "Outputs": {
    "PrivateIpAddress": {
      "Description": "The primary private ip address of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "PrivateIpAddress"
        ]
      }
    },
    "SecondaryPrivateIpAddresses": {
      "Description": "The secondary private IP addresses of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "SecondaryPrivateIpAddresses"
        ]
      }
    },
    "MacAddress": {
      "Description": "The MAC address of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "MacAddress"
        ]
      }
    },
    "NetworkInterfaceId": {
      "Description": "ID of your Network Interface.",
      "Value": {
        "Fn::GetAtt": [
          "EniInstance",
          "NetworkInterfaceId"
        ]
      }
    }
  }
}

Syntaxe

Propriétés

Syntaxe des tags

Propriétés des tags

Valeurs de retour

Exemples

Format YAML

Format JSON

Format `YAML`

Format `JSON`