Tous les produits
Search
Centre de documentation

Resource Orchestration Service:ALIYUN::ECS::AssignPrivateIpAddresses

Dernière mise à jour :Aug 10, 2026

La ressource ALIYUN::ECS::AssignPrivateIpAddresses permet d'attribuer des adresses IP privées secondaires à une interface réseau élastique (ENI). Spécifiez les adresses IP privées disponibles dans le bloc CIDR du vSwitch associé à l'ENI, ou indiquez un nombre pour que le système attribue automatiquement ce nombre d'adresses IP privées à l'ENI.

Syntaxe

{
  "Type": "ALIYUN::ECS::AssignPrivateIpAddresses",
  "Properties": {
    "NetworkInterfaceId": String,
    "SecondaryPrivateIpAddressCount": Integer,
    "Ipv4Prefixes": List,
    "Ipv4PrefixCount": Integer,
    "PrivateIpAddresses": List
  }
}

Propriétés

Propriété

Type

Obligatoire

Modifiable

Description

Contrainte

NetworkInterfaceId

String

Oui

Non

ID de l'ENI.

Aucune.

SecondaryPrivateIpAddressCount

Integer

Non

Non

Nombre d'adresses IP privées.

Aucune.

Ipv4Prefixes

List

Non

Non

Un ou plusieurs préfixes IPv4 à attribuer à l'ENI.

Exemple :

["192.168.**.**/28"]. Vous pouvez spécifier jusqu'à 10 préfixes IPv4.

Ipv4PrefixCount

Integer

Non

Non

Nombre de préfixes IPv4 à générer aléatoirement pour l'ENI.

Valeurs valides : 1 à 10.

PrivateIpAddresses

List

Non

Non

Une ou plusieurs adresses IP privées secondaires situées dans le bloc CIDR du vSwitch associé à l'ENI.

Si l'ENI est à l'état Available, vous pouvez spécifier au maximum 10 adresses IP. Si l'ENI est à l'état InUse, le nombre d'adresses IP spécifiées varie selon le type d'instance. Pour plus d'informations, consultez la rubrique Présentation des familles d'instances. Lors de l'attribution d'adresses IP privées secondaires, vous ne pouvez spécifier qu'un seul des paramètres suivants : PrivateIpAddresses ou SecondaryPrivateIpAddressCount.

Valeurs de retour

Fn::GetAtt

  • NetworkInterfaceId : ID de l'ENI.

  • PrivateIpAddresses : adresses IP privées secondaires.

Exemples

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  NetworkInterfaceId:
    Type: String
    Description: The ID of the ENI.
  SecondaryPrivateIpAddressCount:
    Type: Number
    Description: The specified number of private IP addresses to be assigned by the ECS instance.
    MinValue: 0
Resources:
  AssignPrivateIpAddresses:
    Type: ALIYUN::ECS::AssignPrivateIpAddresses
    Properties:
      NetworkInterfaceId:
        Ref: NetworkInterfaceId
      SecondaryPrivateIpAddressCount: 0
Outputs:
  NetworkInterfaceId:
    Description: The ID of the ENI.
    Value:
      Fn::GetAtt:
        - AssignPrivateIpAddresses
        - NetworkInterfaceId
  PrivateIpAddresses:
    Description: Assigned private ip addresses.
    Value:
      Fn::GetAtt:
        - AssignPrivateIpAddresses
        - PrivateIpAddresses
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "NetworkInterfaceId": {
      "Type": "String",
      "Description": "The ID of the ENI."
    },
    "SecondaryPrivateIpAddressCount": {
      "Type": "Number",
      "Description": "The specified number of private IP addresses to be assigned by the ECS instance.",
      "MinValue": 0
    }
  },
  "Resources": {
    "AssignPrivateIpAddresses": {
      "Type": "ALIYUN::ECS::AssignPrivateIpAddresses",
      "Properties": {
        "NetworkInterfaceId": {
          "Ref": "NetworkInterfaceId"
        },
        "SecondaryPrivateIpAddressCount": 0
      }
    }
  },
  "Outputs": {
    "NetworkInterfaceId": {
      "Description": "The ID of the ENI.",
      "Value": {
        "Fn::GetAtt": [
          "AssignPrivateIpAddresses",
          "NetworkInterfaceId"
        ]
      }
    },
    "PrivateIpAddresses": {
      "Description": "Assigned private ip addresses.",
      "Value": {
        "Fn::GetAtt": [
          "AssignPrivateIpAddresses",
          "PrivateIpAddresses"
        ]
      }
    }
  }
}