全部產品
Search
文件中心

Resource Orchestration Service:ALIYUN::ECS::AssignPrivateIpAddresses

更新時間:Mar 25, 2025

ALIYUN::ECS::AssignPrivateIpAddresses類型用於為一塊彈性網卡分配一個或多個輔助私人IP地址。您可以為網卡指定所屬交換器(vSwitch)的CIDR私人IP地址,也可以通過指定私人網路地址數量自動建立私人IP地址。

文法

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

屬性

屬性名稱

類型

必須

允許更新

描述

約束

NetworkInterfaceId

String

彈性網卡ID。

無。

SecondaryPrivateIpAddressCount

Integer

指定的私人IP地址數量。

無。

Ipv4Prefixes

List

為彈性網卡指定一個或多個 IPv4 首碼。

樣本:

["192.168.**.**/28"]。最多支援配置10個首碼。

Ipv4PrefixCount

Integer

為彈性網卡指定隨機產生的 IPv4 首碼數量。

取值範圍:1~10。

PrivateIpAddresses

List

彈性網卡所屬虛擬交換器的CIDR位址區段中的一個或多個輔助私人IP地址。

彈性網卡處於可用(Available)狀態時,可以設定的IP數量為:1~10個。彈性網卡處於已綁定(InUse)狀態時,可以設定的IP數量將受限於執行個體規格,詳情請參見執行個體規格類型系列。分配輔助私人IP地址時,不能同時指定參數PrivateIpAddress和參數SecondaryPrivateIpAddressCount。

傳回值

Fn::GetAtt

  • NetworkInterfaceId:彈性網卡ID。

  • PrivateIpAddresses:輔助私人IP地址。

樣本

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"
        ]
      }
    }
  }
}