すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::ECS::AssignPrivateIpAddresses

最終更新日:Apr 10, 2025

ALIYUN::ECS::AssignPrivateIpAddresses は、Elastic Network Interface(ENI)にセカンダリ プライベート IP アドレスを割り当てるために使用します。ENI に関連付けられている vSwitch の CIDR ブロック内で使用可能なプライベート IP アドレスを指定できます。または、数値を指定して、指定した数のプライベート IP アドレスを ENI に自動的に割り当てることもできます。

構文

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

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

NetworkInterfaceId

String

はい

いいえ

ENI の ID。

なし。

SecondaryPrivateIpAddressCount

Integer

いいえ

いいえ

プライベート IP アドレスの数。

なし。

Ipv4Prefixes

List

いいえ

いいえ

ENI に割り当てる 1 つ以上の IPv4 プレフィックス。

例:

["192.168.**.**/28"]。最大 10 個の IPv4 プレフィックスを指定できます。

Ipv4PrefixCount

Integer

いいえ

いいえ

ENI 用にランダムに生成される IPv4 プレフィックスの数。

有効な値: 1 ~ 10。

PrivateIpAddresses

List

いいえ

いいえ

ENI に関連付けられている vSwitch の CIDR ブロック内の 1 つ以上のセカンダリ プライベート IP アドレス。

ENI が Available 状態の場合、最大 10 個の IP アドレスを指定できます。ENI が InUse 状態の場合、指定できる IP アドレスの数は、インスタンスタイプによって異なります。詳細については、「インスタンスファミリの概要」をご参照ください。セカンダリ プライベート IP アドレスを割り当てるときは、PrivateIpAddress と SecondaryPrivateIpAddressCount のいずれか 1 つのみを指定できます。

戻り値

Fn::GetAtt

  • NetworkInterfaceId: ENI の ID。

  • PrivateIpAddresses: セカンダリ プライベート IP アドレス。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  NetworkInterfaceId:
    Type: String
    Description: The ID of the ENI.  # ENI の ID
  SecondaryPrivateIpAddressCount:
    Type: Number
    Description: The specified number of private IP addresses to be assigned by the ECS instance. # ECS インスタンスによって割り当てられるプライベート IP アドレスの指定数
    MinValue: 0
Resources:
  AssignPrivateIpAddresses:
    Type: ALIYUN::ECS::AssignPrivateIpAddresses
    Properties:
      NetworkInterfaceId:
        Ref: NetworkInterfaceId
      SecondaryPrivateIpAddressCount: 0
Outputs:
  NetworkInterfaceId:
    Description: The ID of the ENI. # ENI の ID
    Value:
      Fn::GetAtt:
        - AssignPrivateIpAddresses
        - NetworkInterfaceId
  PrivateIpAddresses:
    Description: Assigned private ip addresses. # 割り当てられたプライベート IP アドレス
    Value:
      Fn::GetAtt:
        - AssignPrivateIpAddresses
        - PrivateIpAddresses
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "NetworkInterfaceId": {
      "Type": "String",
      "Description": "The ID of the ENI." // ENI の ID
    },
    "SecondaryPrivateIpAddressCount": {
      "Type": "Number",
      "Description": "The specified number of private IP addresses to be assigned by the ECS instance.", // ECS インスタンスによって割り当てられるプライベート IP アドレスの指定数
      "MinValue": 0
    }
  },
  "Resources": {
    "AssignPrivateIpAddresses": {
      "Type": "ALIYUN::ECS::AssignPrivateIpAddresses",
      "Properties": {
        "NetworkInterfaceId": {
          "Ref": "NetworkInterfaceId"
        },
        "SecondaryPrivateIpAddressCount": 0
      }
    }
  },
  "Outputs": {
    "NetworkInterfaceId": {
      "Description": "The ID of the ENI.", // ENI の ID
      "Value": {
        "Fn::GetAtt": [
          "AssignPrivateIpAddresses",
          "NetworkInterfaceId"
        ]
      }
    },
    "PrivateIpAddresses": {
      "Description": "Assigned private ip addresses.", // 割り当てられたプライベート IP アドレス
      "Value": {
        "Fn::GetAtt": [
          "AssignPrivateIpAddresses",
          "PrivateIpAddresses"
        ]
      }
    }
  }
}