Utilisation de ALIYUN::ECS::NetworkInterface pour créer une ENI - Resource Orchestration Service

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

Propriété	Type	Obligatoire	Modifiable	Description	Contrainte
ResourceGroupId	String	Non	Oui	ID du groupe de ressources.	Appelez l'opération ListResourceGroups pour récupérer l'ID du groupe de ressources.
SecurityGroupId	String	Non	Oui	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 SecurityGroupId et SecurityGroupIds.
VSwitchId	String	Oui	Non	ID du vSwitch.	Aucune.
Description	String	Non	Oui	Description de l'ENI.	La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
NetworkInterfaceName	String	Non	Oui	Nom de l'ENI.	Le nom doit comporter 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 tirets (-).
PrimaryIpAddress	String	Non	Non	Adresse IP privée principale de l'ENI.	L'adresse IP privée principale doit être une adresse IP libre dans le bloc CIDR du vSwitch auquel vous souhaitez associer l'ENI. Si vous laissez cette propriété vide, une adresse IP libre est attribuée aléatoirement à partir du bloc CIDR du vSwitch.
SecondaryPrivateIpAddressCount	Integer	Non	Non	Nombre d'adresses IP privées secondaires.	Aucune.
Tags	List	Non	Oui	Tags.	Vous pouvez ajouter jusqu'à 20 tags. Pour plus d'informations, consultez la section Propriétés des tags.
SecurityGroupIds	List	Non	Oui	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 SecurityGroupId et SecurityGroupIds.
PrivateIpAddresses	List	Non	Non	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 attribuables à 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 selon le type d'instance. Pour plus d'informations, consultez la page Présentation des familles d'instances.
Ipv6Addresses	List	Non	Non	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	Non	Non	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 interroger le nombre maximal de files d'attente par ENI pour le type d'instance, appelez l'opération DescribeInstanceTypes et vérifiez la valeur de retour de `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 interroger le nombre par défaut de files d'attente par ENI pour le type d'instance, appelez l'opération DescribeInstanceTypes et vérifiez la valeur de retour de `SecondaryEniQueueNumber`.
NetworkInterfaceTrafficMode	String	Non	Non	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é Elastic RDMA Interface (ERI) activée. Remarque La valeur HighPerformance prend uniquement en charge la famille d'instances c7re optimisée pour RDMA. 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 sur invitation dans la zone K de Pékin. Pour plus d'informations, consultez la page Présentation des familles d'instances.
Ipv6AddressCount	Integer	Non	Non	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	Non	Non	Préfixes IPv6.	Aucune.
Ipv4Prefixes	List	Non	Non	Préfixes IPv4.	Aucune.
Ipv4PrefixCount	Integer	Non	Non	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	Non	Oui	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 à la profondeur de la file d'attente de réception (Rx) de l'ENI. 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	Non	Oui	Indique si l'ENI doit être conservée lors de la libération de l'instance associée.	Valeurs valides : true false
Ipv6PrefixCount	Integer	Non	Non	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	Non	Oui	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 à la profondeur de la file d'attente de transmission (Tx) de l'ENI. 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

Propriété

Type

Obligatoire

Modifiable

Description

Contrainte

Key

String

Oui

Non

Clé du tag.

La clé du tag doit comporter 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

Non

Valeur du tag.

La valeur du tag peut comporter 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"
        ]
      }
    }
  }
}