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

Resource Orchestration Service:ALIYUN::ECS::InstanceGroupClone

最終更新日:Feb 27, 2026

ALIYUN::ECS::InstanceGroupClone を使用して、ECS インスタンスのグループをクローンします。

構文

 {
  "Type": "ALIYUN::ECS::InstanceGroupClone",
  "Properties": {
    "BackendServerWeight": Integer,
    "SystemDiskAutoSnapshotPolicyId": String,
    "DiskMappings": List,
    "Period": Number,
    "LaunchTemplateName": String,
    "RamRoleName": String,
    "ResourceGroupId": String,
    "KeyPairName": String,
    "SystemDiskDiskName": String,
    "PeriodUnit": String,
    "Description": String,
    "Tags": List,
    "AutoRenewPeriod": Number,
    "ImageId": String,
    "AutoRenew": String,
    "SpotStrategy": String,
    "SourceInstanceId": String,
    "EniMappings": List,
    "Password": String,
    "PasswordInherit": Boolean,
    "MaxAmount": Integer,
    "AutoReleaseTime": String,
    "SystemDiskCategory": String,
    "LoadBalancerIdToAttach": String,
    "LaunchTemplateId": String,
    "LaunchTemplateVersion": String,
    "ZoneId": String,
    "InternetMaxBandwidthOut": Integer,
    "InstanceName": String,
    "DeletionProtection": Boolean,
    "DeploymentSetId": String,
    "Ipv6AddressCount": Integer,
    "SecurityGroupId": String,
    "SecurityGroupIds": List,
    "SpotPriceLimit": String,
    "HpcClusterId": String,
    "SystemDiskDescription": String,
    "Ipv6Addresses": List,
    "SystemDiskProvisionedIops": Integer,
    "SystemDiskBurstingEnabled": Boolean,
    "SystemDiskKMSKeyId": String,
    "SystemDiskStorageClusterId": String,
    "InternetMaxBandwidthIn": Integer,
    "UpdatePolicy": String,
    "SystemDiskEncryptAlgorithm": String,
    "SystemDiskEncrypted": String,
    "SecurityOptions": Map,
    "ImageOptions": Map,
    "NetworkOptions": Map,
    "HostNames": List,
    "NetworkInterfaceQueueNumber": Integer,
    "UniqueSuffix": Boolean,
    "CpuOptions": Map
  }
}

プロパティ

プロパティ名

必須

更新可能

説明

制約

MaxAmount

Integer

はい

はい

一度に作成する ECS インスタンスの数です。

有効な値:1 ~ 100。

SourceInstanceId

String

はい

いいえ

クローン元の ECS インスタンスの ID です。

インスタントタイプ、イメージ、帯域幅課金方法、帯域幅制限、ネットワークタイプなどの設定がクローンされます。ソース ECS インスタンスが複数のセキュリティグループに追加されている場合、新規インスタンスはソースインスタンスの最初のセキュリティグループに追加されます。

AutoReleaseTime

String

いいえ

いいえ

新規 ECS インスタンスが自動的にリリースされる時刻です。

時刻は ISO 8601 形式で指定する必要があります(例: yyyy-MM-ddTHH:mm:ssZ)。リリース時刻は、現在時刻から最大 3 年先までとします。

AutoRenew

String

いいえ

はい

自動更新を有効にするかどうかを示します。

有効な値:

  • True:自動更新を有効にします。

  • False(デフォルト):自動更新を無効にします。

このパラメーターは、InstanceChargeType が PrePaid に設定されている場合に必須です。

AutoRenewPeriod

Number

いいえ

はい

自動更新期間です。

AutoRenew が true に設定されている場合に、このパラメーターは必須です。

有効な値:

  • 1(デフォルト)

  • 2

  • 3

  • 6

  • 12

BackendServerWeight

Integer

いいえ

いいえ

SLB インスタンスにおける新規 ECS インスタンスの重みです。

有効な値:0 ~ 100。

デフォルト値:100。

CpuOptions

Map

いいえ

いいえ

CPU のプロパティです。

詳細については、「CpuOptions プロパティ」をご参照ください。

DeletionProtection

Boolean

いいえ

いいえ

新規インスタンスのリリース保護属性です。コンソールまたは DeleteInstance API 操作を呼び出してインスタンスをリリースできるかどうかを指定します。

有効な値:

  • True:サポートされます。

  • false:サポートされません。

DeploymentSetId

String

いいえ

はい

デプロイメントセットの ID です。

なし

Description

String

いいえ

はい

説明です。

説明は最大 256 文字までです。

DiskMappings

List

いいえ

はい

アタッチするディスクです。

最大 16 個のディスクをサポートします。

詳細については、「DiskMappings プロパティ」をご参照ください。

EniMappings

List

いいえ

はい

インスタンスにアタッチする ENI です。

インスタンスには最大 1 個の ENI をアタッチできます。

詳細については、「EniMappings プロパティ」をご参照ください。

HostNames

List

いいえ

いいえ

複数のインスタンスを作成する場合、各インスタンスに異なるホスト名を指定します。

なし

HpcClusterId

String

いいえ

はい

新規インスタンスが属する E-HPC クラスターの ID です。

なし

ImageId

String

いいえ

はい

ECS インスタンスの起動に使用するイメージの ID です。パブリックイメージ、カスタムイメージ、Alibaba Cloud Marketplace のイメージのいずれかを指定できます。

あいまい一致を使用して、完全なパブリックイメージ ID を指定せずにパブリックイメージ ID を指定できます。たとえば、以下のように指定できます。

  • `ubuntu` を指定すると、`ubuntu16_0402_64_20G_alibase_20170818.vhd` が一致します。

  • `ubuntu_14` を指定すると、`ubuntu_14_0405_64_20G_alibase_20170824.vhd` が一致します。

  • `ubuntu*14*32` を指定すると、`ubuntu_14_0405_32_40G_alibase_20170711.vhd` が一致します。

  • `ubuntu_16_0402_32` を指定すると、`ubuntu_16_0402_32_40G_alibase_20170711.vhd` が一致します。

ImageOptions

Map

いいえ

いいえ

イメージのプロパティです。

詳細については、「ImageOptions プロパティ」をご参照ください。

InstanceName

String

いいえ

はい

新規インスタンスの名前です。

名前は最大 128 文字までです。英字、漢字、数字、アンダースコア (_ )、ピリオド (.)、ハイフン (-) を含めることができます。

InternetMaxBandwidthIn

Integer

いいえ

いいえ

インターネットアウトバウンド帯域幅の最大値です。

単位:Mbit/s。

有効な値:0 ~ 200。

デフォルト値:200。

InternetMaxBandwidthOut

Integer

いいえ

いいえ

パブリックアウトバウンドトラフィックの最大値です。

単位:Mbit/s。

有効な値:

  • 帯域幅課金の場合:0 ~ 200。

  • トラフィック課金の場合:1 ~ 200。

Ipv6AddressCount

Integer

いいえ

はい

ENI に割り当てるランダム生成 IPv6 アドレスの数です。

Ipv6Addresses と Ipv6AddressCount の両方を指定することはできません。

Ipv6Addresses

List

いいえ

はい

ENI に割り当てる 1 つ以上の IPv6 アドレスです。

リストには最大 1 個のアドレスを含めることができます。このプロパティの変更は既存のインスタンスには影響しません。Ipv6Addresses と Ipv6AddressCount の両方を指定することはできません。

KeyPairName

String

いいえ

はい

新規 ECS インスタンスにアタッチするキーペアの名前です。

このパラメーターは Windows ECS インスタンスでは無視されます。KeyPairName を指定した場合でも、インスタンスの Password 値は設定されますが、Linux システムではパスワードによるログインは無効になります。

LaunchTemplateId

String

いいえ

はい

起動テンプレートの ID です。

なし

LaunchTemplateName

String

いいえ

はい

起動テンプレートの名前です。

なし

LaunchTemplateVersion

String

いいえ

はい

起動テンプレートのバージョンです。

バージョンを指定しない場合、デフォルトバージョンが使用されます。

LoadBalancerIdToAttach

String

いいえ

いいえ

新規 ECS インスタンスを追加する SLB インスタンスの ID です。

なし

NetworkInterfaceQueueNumber

Integer

いいえ

いいえ

プライマリ NIC のキュー数です。

注意:

  • 値は、インスタンスタイプごとに許可される NIC あたりの最大キュー数を超えることはできません。

  • インスタンスのすべての NIC のキュー数の合計は、インスタンスタイプごとに許可される総キュークォータを超えることはできません。MaximumQueueNumberPerEni(NIC あたりの最大キュー数)および TotalEniQueueQuantity(総キュークォータ)は、DescribeInstanceTypes API 操作を呼び出すことで照会できます。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、NetworkInterfaceQueueNumber を設定することはできません。代わりに NetworkInterface.N.QueueNumber を設定してください。

NetworkOptions

Map

いいえ

いいえ

ネットワーク関連のプロパティおよびパラメーターです。

詳細については、「NetworkOptions プロパティ」をご参照ください。

Password

String

いいえ

はい

新規 ECS インスタンスのログインパスワードです。

パスワードは 8 ~ 30 文字の長さである必要があります。英字、数字、特殊文字を含める必要があります。サポートされる特殊文字: ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

このパラメーターを指定する場合は、パスワードの漏洩を防ぐため、HTTPS プロトコルを使用して API 操作を呼び出してください。

PasswordInherit

Boolean

いいえ

いいえ

イメージの事前設定パスワードを使用するかどうかを示します。

有効な値:

  • true:事前設定パスワードを使用します。

  • false:事前設定パスワードを使用しません。

説明

このパラメーターを使用する場合、Password パラメーターは空である必要があり、イメージにパスワードが設定されていることを確認する必要があります。

Period

Number

いいえ

はい

課金サイクルです。

有効な値: 1 ~ 9、12、24、36、48、および 60。

単位:月。

このパラメーターは、InstanceChargeType が PrePaid に設定されている場合に必須です。InstanceChargeType が PostPaid に設定されている場合はオプションです。

PeriodUnit

String

いいえ

はい

リソース購入期間です。

有効な値:

  • Week(週)

    PeriodUnit が Week に設定されている場合、Period の有効な値は 1、2、3、4 であり、AutoRenewPeriod の有効な値は 1、2、3 です。

  • Month(月)(デフォルト)

    PeriodUnit が Month に設定されている場合、Period の有効な値は 1、2、3、4、5、6、7、8、9、12、24、36、48、60 であり、AutoRenewPeriod の有効な値は 1、2、3、6、12 です。

RamRoleName

String

いいえ

はい

新規インスタンスのインスタンス RAM ロールの名前です。

ListRoles を呼び出してインスタンス RAM ロール名を照会できます。詳細については、「ロールの作成」および「ロールの一覧の取得」をご参照ください。

ResourceGroupId

String

いいえ

いいえ

新規インスタンスが属するリソースグループの ID です。

なし

SecurityGroupId

String

いいえ

いいえ

新規インスタンスが属するセキュリティグループです。

SecurityGroupId と SecurityGroupIds の両方を指定することはできません。

SecurityGroupIds

List

いいえ

いいえ

新規インスタンスが属するセキュリティグループのリストです。

詳細については、「セキュリティグループ」をご参照ください。

SecurityGroupId と SecurityGroupIds の両方を指定することはできません。

SecurityOptions

Map

いいえ

いいえ

信頼されたシステムのプロパティです。

詳細については、「SecurityOptions プロパティ」をご参照ください。

SpotPriceLimit

String

いいえ

いいえ

新規インスタンスの時間あたりの最大価格です。

値は小数点以下 3 桁まで可能です。SpotPriceLimit は、SpotStrategy が SpotWithPriceLimit に設定されている場合に有効になります。

SpotStrategy

String

いいえ

はい

従量課金インスタンスの入札ポリシーです。

このパラメーターは、InstanceChargeType が PostPaid に設定されている場合に必須です。

有効な値:

  • NoSpot(デフォルト):通常の従量課金インスタンスです。

  • SpotWithPriceLimit:ユーザー定義の最大価格を持つスポットインスタンスです。

  • SpotAsPriceGo:システムが最適価格で自動的に入札し、従量課金価格を超えないようにします。

SystemDiskAutoSnapshotPolicyId

String

いいえ

はい

システムディスクの自動スナップショットポリシーの ID です。

なし

SystemDiskBurstingEnabled

Boolean

いいえ

はい

システムディスクのバースト機能を有効にするかどうかを示します。

有効な値:

  • true:有効。

  • false(デフォルト):無効。

SystemDiskCategory

String

いいえ

はい

システムディスクのタイプです。

有効な値:

  • cloud:基本ディスク。

  • cloud_efficiency(デフォルト):Ultra ディスク。

  • cloud_ssd:標準 SSD。

  • cloud_essd:ESSD(エンタープライズ SSD)。

SystemDiskDescription

String

いいえ

はい

システムディスクの説明です。

なし

SystemDiskDiskName

String

いいえ

はい

システムディスクの名前です。

名前は 2 ~ 128 文字の長さである必要があります。英字または漢字で始まる必要があります。また、http:// または https:// で始めてはいけません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

SystemDiskEncryptAlgorithm

String

いいえ

はい

システムディスクに使用する暗号化アルゴリズムです。

有効な値:

  • AES-256。

  • SM4-128。

SystemDiskEncrypted

String

いいえ

はい

システムディスクを暗号化するかどうかを示します。

有効な値:

  • true:ディスクを暗号化します。

  • false:暗号化を無効にします。

SystemDiskKMSKeyId

String

いいえ

はい

システムディスクに使用する KMS キーの ID です。

なし

SystemDiskProvisionedIops

Integer

いいえ

はい

システムディスクのプロビジョニング済み IOPS です。

なし

SystemDiskStorageClusterId

String

いいえ

はい

システムディスクの専用ブロックストレージクラスターの ID です。

なし

Tags

List

いいえ

はい

カスタムタグです。

最大 20 個のタグをサポートします。フォーマット: [{"Key": "tagKey", "Value": "tagValue"},{"Key": "tagKey2", "Value": "tagValue2"}]

詳細については、「Tags プロパティ」をご参照ください。

UniqueSuffix

Boolean

いいえ

いいえ

複数のインスタンスを作成する場合、HostName および InstanceName に順次増分のサフィックスを自動的に追加するかどうかを示します。

順次増分のサフィックスは 001 から開始し、増分されます。最大値は 999 を超えることはできません。有効な値:

  • true:サフィックスを追加します。

  • false(デフォルト値):項目を追加しません。

HostName または InstanceName が指定された順次形式で設定されており、name_suffix が設定されていない場合(つまり、命名形式が name_prefix[begin_number,bits] の場合)、UniqueSuffix は効果を発揮しません。名前は指定された順序でのみ並べ替えられます。

詳細については、「インスタンス名またはホスト名の順次設定」をご参照ください。

UpdatePolicy

String

いいえ

はい

更新ポリシーを指定します。

有効な値:

  • ForNewInstance(デフォルト):更新ポリシーは新規インスタンスに適用されます。

  • ForAllInstances:更新ポリシーはすべてのインスタンスに適用されます。

ZoneId

String

いいえ

いいえ

ゾーンの ID です。

なし

DiskMappings の構文

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "Encrypted": String,
    "KMSKeyId": String,
    "Device": String,
    "SnapshotId": String,
    "Size": String,
    "PerformanceLevel": String,
    "AutoSnapshotPolicyId": String,
    "ProvisionedIops": Integer,
    "BurstingEnabled": Boolean,
    "StorageClusterId": String
  }
]

DiskMappings のプロパティ

プロパティ名

必須

更新可能

説明

制約

Size

String

はい

いいえ

データディスクのサイズです。

単位:GB。

AutoSnapshotPolicyId

String

いいえ

いいえ

自動スナップショットポリシーの ID です。

なし

BurstingEnabled

Boolean

いいえ

いいえ

バースト機能を有効にするかどうかを示します。

有効な値:

  • true:このオプションを有効にします。

  • false(デフォルト):無効です。

Category

String

いいえ

いいえ

データディスクのタイプです。

有効な値:

  • cloud(デフォルト):基本ディスク。

  • cloud_ssd:標準 SSD。

  • cloud_essd:ESSD(エンタープライズ SSD)。

  • cloud_efficiency:Ultra ディスク。

Description

String

いいえ

いいえ

データディスクの説明です。

説明は 2 ~ 256 文字の長さである必要があります。また、http:// または https:// で始めてはいけません。

Device

String

いいえ

いいえ

ECS インスタンスにおけるデータディスクの名前です。

例:/dev/xvd[a-z]

DiskName

String

いいえ

いいえ

データディスクの名前です。

名前は最大 128 文字までです。英字、漢字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。

Encrypted

String

いいえ

いいえ

データディスクを暗号化するかどうかを示します。

有効な値:

  • true:データを暗号化します。

  • false(デフォルト):暗号化しません。

KMSKeyId

String

いいえ

いいえ

データディスクの KMS キーの ID です。

なし

PerformanceLevel

String

いいえ

いいえ

エンタープライズ SSD を使用してシステムディスクを作成する場合、そのパフォーマンスレベルを設定できます。

有効な値:

  • PL0:単一ディスクで最大 10,000 のランダム読み取り/書き込み IOPS を提供します。

  • PL1(デフォルト):単一ディスクで最大 50,000 のランダム読み取り/書き込み IOPS を提供します。

  • PL2:単一ディスクで最大 100,000 のランダム読み取り/書き込み IOPS を提供します。

  • PL3:単一ディスクで最大 1,000,000 のランダム読み取り/書き込み IOPS を提供します。

ESSD パフォーマンスレベルの選択方法については、「ESSD」をご参照ください。

ProvisionedIops

Integer

いいえ

いいえ

プロビジョニング済み IOPS です。

なし

SnapshotId

String

いいえ

いいえ

スナップショットの ID です。

なし

StorageClusterId

String

いいえ

いいえ

専用ブロックストレージクラスターの ID です。

なし

EniMappings の構文

"EniMappings": [
  {
    "SecurityGroupId": String,
    "VSwitchId": String,
    "Description": String,
    "NetworkInterfaceName": String,
    "PrimaryIpAddress": String,    
    "InstanceType": String,
    "Ipv6AddressCount": Integer,
    "NetworkInterfaceTrafficMode": String,
    "Ipv6Addresses": List,
    "QueueNumber": Integer,
    "SecurityGroupIds": List,
    "QueuePairNumber": Integer,
    "NetworkInterfaceId": String,
    "DeleteOnRelease": Boolean,
    "NetworkCardIndex": Integer
  }
]

EniMappings のプロパティ

プロパティ名

必須

更新可能

説明

制約

DeleteOnRelease

Boolean

いいえ

いいえ

インスタンスがリリースされたときに NIC を保持するかどうかを示します。

有効な値:

  • true:保持しません。

  • false:既存の設定を保持します。

Description

String

いいえ

はい

ENI の説明です。

説明は 2 ~ 256 文字の長さである必要があります。また、http:// または https:// で始めてはいけません。

InstanceType

String

いいえ

いいえ

ENI のタイプです。

最大 2 個の NIC を設定できます。1 個の ENI を設定する場合、プライマリ ENI またはセカンダリ ENI のいずれかとして設定できます。2 個の ENI を設定する場合、1 個をプライマリ ENI、もう 1 個をセカンダリ ENI として設定する必要があります。

有効な値:

  • Primary:プライマリ ENI。

  • Secondary(デフォルト):セカンダリ ENI。

Ipv6AddressCount

Integer

いいえ

いいえ

プライマリ NIC に割り当てるランダム生成 IPv6 アドレスの数です。

有効な値:1 ~ 10。

注意:

  • このパラメーターは、NetworkInterface.InstanceTypePrimary に設定されている場合にのみ有効です。NetworkInterface.InstanceTypeSecondary に設定されている場合、または空の場合、このパラメーターを設定することはできません。

  • このパラメーターを設定した後は、Ipv6AddressCountIpv6AddressNetworkInterface.Ipv6Address を設定することはできません。

Ipv6Addresses

List

いいえ

いいえ

プライマリ NIC に割り当てる 1 つ以上の IPv6 アドレスです。

最大 10 個の IPv6 アドレスを設定できます。

注意:

  • このパラメーターは、NetworkInterface.InstanceTypePrimary に設定されている場合にのみ有効です。NetworkInterface.InstanceTypeSecondary に設定されている場合、または空の場合、このパラメーターを設定することはできません。

  • このパラメーターを設定した後は、Amount の値は 1 のみとなり、Ipv6AddressCountIpv6Address.NNetworkInterface.N.Ipv6AddressCount を設定することはできません。

NetworkCardIndex

Integer

いいえ

いいえ

NIC によって指定される物理 NIC のインデックスです。

  • 特定のインスタンスタイプのみが物理 NIC インデックスの指定をサポートしています。

  • NetworkInterface.N.InstanceType が Primary に設定されている場合、サポート対象のインスタンスタイプでこのパラメーターを設定するときは、値は 0 のみとなります。

  • NetworkInterface.N.InstanceType が Secondary に設定されている場合、または空の場合、サポート対象のインスタンスタイプに対してインスタンスタイプに応じてこのパラメーターを設定できます。詳細については、「インスタンスファミリー」をご参照ください。

NetworkInterfaceId

String

いいえ

いいえ

インスタンスにアタッチする ENI の ID です。

このパラメーターはセカンダリ ENI のみに有効です。既存のセカンダリ ENI を指定した後は、他の NIC 作成パラメーターを設定できません。

NetworkInterfaceName

String

いいえ

はい

ENI の名前です。

名前は 2 ~ 128 文字の長さである必要があります。英字または漢字で始まる必要があります。また、http:// または https:// で始めてはいけません。英字、漢字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

NetworkInterfaceTrafficMode

String

いいえ

いいえ

NIC の通信モードです。

有効な値:

  • Standard(デフォルト):TCP 通信モードを使用します。

  • HighPerformance:Elastic RDMA Interface(ERI)を有効にし、RDMA 通信モードを使用します。

説明

RDMA モードの ENI の数は、インスタンスファミリーの制限を超えてはいけません。詳細については、「インスタンスファミリー」をご参照ください。

PrimaryIpAddress

String

いいえ

いいえ

ENI のプライベート IP アドレスです。

指定した IP アドレスは、vSwitch の CIDR ブロック内で利用可能なアドレスである必要があります。

IP アドレスを指定しない場合、vSwitch の CIDR ブロックから利用可能なアドレスがランダムに割り当てられます。

QueueNumber

Integer

いいえ

いいえ

ENI のキュー数です。

注意:

  • 有効な値:1 ~ 2。1 個の ENI を設定する場合、プライマリ ENI またはセカンダリ ENI のいずれかとして設定できます。2 個の ENI を設定する場合、1 個をプライマリ ENI、もう 1 個をセカンダリ ENI として設定する必要があります。

  • 値は、インスタンスタイプごとに許可される NIC あたりの最大キュー数を超えることはできません。

  • インスタンスのすべての NIC のキュー数の合計は、インスタンスタイプごとに許可される総キュークォータを超えることはできません。MaximumQueueNumberPerEni(NIC あたりの最大キュー数)および TotalEniQueueQuantity(総キュークォータ)は、DescribeInstanceTypes API 操作を呼び出すことで照会できます。

  • NetworkInterface.InstanceTypePrimary に設定されており、このパラメーターを設定している場合、NetworkInterfaceQueueNumber パラメーターを設定することはできません。

QueuePairNumber

Integer

いいえ

いいえ

RDMA NIC のキュー数です。

このフィールドは Long 型です。シリアライズまたはデシリアライズ時に精度が失われる可能性があります。値が 9007199254740991 を超えないようにしてください。

SecurityGroupId

String

いいえ

はい

セキュリティグループの ID です。

セキュリティグループは同じ VPC 内にある必要があります。

SecurityGroupIds

List

いいえ

いいえ

ENI が属する 1 つ以上のセキュリティグループ ID です。

注意:

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、このパラメーターまたは NetworkInterface.SecurityGroupId のいずれかを設定する必要があります。この場合、このパラメーターは SecurityGroupIds と同じ効果を持ちますが、SecurityGroupIdSecurityGroupIdsNetworkInterface.SecurityGroupId を設定することはできません。

  • NetworkInterface.N.InstanceTypeSecondary に設定されている場合、または空の場合、このパラメーターはオプションです。デフォルト値は ECS インスタンスのセキュリティグループです。

VSwitchId

String

いいえ

いいえ

vSwitch の ID です。

なし

SecurityOptions の構文

"SecurityOptions": {
  "TrustedSystemMode": String
}

SecurityOptions のプロパティ

プロパティ名

必須

更新可能

説明

制約

TrustedSystemMode

String

いいえ

いいえ

信頼されたシステムモードです。

有効な値:vTPM。現在、信頼されたシステムモードは g7、c7、r7 インスタンスファミリーおよびセキュリティ強化型インスタンスファミリー(g7t、c7t、r7t)でサポートされています。これらのインスタンスファミリーの ECS インスタンスを作成する際には、このパラメーターを設定する必要があります。詳細は以下の通りです。

Alibaba Cloud 信頼されたシステムを使用する場合、このパラメーターを vTPM に設定します。これにより、インスタンスは起動時に Alibaba Cloud 信頼されたシステムを通じて信頼検証を完了できます。Alibaba Cloud 信頼されたシステムを使用しない場合、このパラメーターを空のままにできます。ただし、作成する ECS インスタンスが Enclave 機密コンピューティングモード(SecurityOptions.ConfidentialComputingMode=Enclave)を使用する場合、ECS インスタンスの信頼されたシステムも有効になります。OpenAPI を使用して信頼されたシステムを備えた ECS インスタンスを作成する場合、RunInstances のみを呼び出すことができます。CreateInstance では、現時点では SecurityOptions.TrustedSystemMode パラメーターの設定はサポートされていません。

説明

インスタンスを作成する際に信頼されたインスタンスとして指定した場合、システムディスクを交換する際に信頼されたシステムをサポートするイメージのみを使用できます。

ImageOptions の構文

"ImageOptions": {
  "LoginAsNonRoot": Boolean
}

ImageOptions のプロパティ

プロパティ名

必須

更新可能

説明

制約

LoginAsNonRoot

Boolean

いいえ

いいえ

このイメージを使用するインスタンスが ecs-user ユーザーとしてログインをサポートするかどうかを示します。

有効な値:

  • true:はい。

  • false:いいえ。

CpuOptions の構文

"CpuOptions": {
  "ThreadsPerCore": Integer,
  "Core": Integer
}

CpuOptions のプロパティ

プロパティ名

必須

更新可能

説明

制約

Core

Integer

いいえ

いいえ

CPU コア数です。

このパラメーターはカスタマイズできません。デフォルト値のみ使用できます。

デフォルト値:「CPU オプションの変更」をご参照ください。

ThreadsPerCore

Integer

いいえ

いいえ

CPU コアあたりのスレッド数です。

ECS インスタンスの vCPU 数 = CpuOptions.Core の値 × CpuOptions.ThreadsPerCore の値。

NetworkOptions の構文

"NetworkOptions": {
  "EnableJumboFrame": Boolean
}

NetworkOptions のプロパティ

プロパティ名

必須

更新可能

説明

制約

EnableJumboFrame

Boolean

いいえ

いいえ

インスタンスに対するジャンボフレーム機能の有効化を示します。

有効な値:

  • false:ジャンボフレームを有効にしません。インスタンス上のすべての NIC(プライマリおよびセカンダリ NIC を含む)の MTU は 1500 です。

  • true(デフォルト):ジャンボフレームを有効にします。インスタンス上のすべての NIC(プライマリおよびセカンダリ NIC を含む)の MTU は 8500 です。

説明

ジャンボフレーム機能は、第 VIII 世代以降の一部のインスタンスタイプでのみサポートされています。詳細については、「ジャンボフレーム」をご参照ください。

Tags の構文

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

Tags のプロパティ

プロパティ名

必須

更新可能

説明

制約

Key

String

はい

いいえ

タグキーです。

キーは 1 ~ 128 文字の長さである必要があります。また、aliyun または acs: で始めてはいけません。また、http:// または https:// を含めてはいけません。

Value

String

いいえ

いいえ

タグ値です。

値は 0 ~ 128 文字の長さである必要があります。また、aliyun または acs: で始めてはいけません。また、http:// または https:// を含めてはいけません。

戻り値

Fn::GetAtt

  • InstanceIds:新規インスタンスの ID です。インスタンス ID は、システムがインスタンスに対して生成するグローバルに一意な識別子です。

  • PrivateIps:VPC 型インスタンスのプライベート IP アドレスのリストです。この属性は、NetworkType パラメーターが vpc に設定されている場合に返されます。例:["172.16.XX.XX", "172.16.XX.XX", ..., "172.16.XX.XX"]。リストには最大 100 個の IP アドレスを含めることができます。

  • InnerIps:クラシックネットワーク型インスタンスのプライベート IP アドレスのリストです。この属性は、NetworkType パラメーターが classic に設定されている場合に返されます。例:["10.1.XX.XX", "10.1.XX.XX", ..., "10.1.XX.XX"]。リストには最大 100 個の IP アドレスを含めることができます。

  • PublicIps:クラシックネットワーク型インスタンスのパブリック IP アドレスのリストです。この属性は、NetworkType パラメーターが classic に設定されている場合に返されます。例:["42.1.XX.XX", "42.1.XX.XX", ..., "42.1.XX.XX"]。リストには最大 100 個の IP アドレスを含めることができます。

  • HostNames:新規インスタンスのホスト名のリストです。

  • OrderId:新規インスタンスの注文 ID のリストです。

  • ZoneIds:ゾーン ID のリストです。

  • RelatedOrderIds:作成された ECS インスタンスの関連注文 ID のリストです。

  • Ipv6AddressIds:作成された ECS インスタンスの IPv6 アドレス ID のリストです。注:この属性は 2 次元リストを返します。インスタンスに IPv6 アドレスがない場合、リスト内の対応する要素は空のリストになります。すべてのインスタンスに IPv6 アドレスがない場合、null が返されます。

  • Ipv6Addresses:作成された ECS インスタンスの IPv6 アドレスのリストです。注:この属性は 2 次元リストを返します。インスタンスに IPv6 アドレスがない場合、リスト内の対応する要素は null になります。すべてのインスタンスに IPv6 アドレスがない場合、null が返されます。

使用例

ROSTemplateFormatVersion: '2015-09-01'
Description: 既存の ECS インスタンスに基づいて、同じ構成 (InstanceType、ImageId、InternetChargeType、InternetMaxBandwidthOut、システムディスク、データディスク構成、VPC プロパティ) を持つ ECS インスタンスのセットをクローンします。ユーザーは SourceInstanceId を指定するだけで済みます。
Parameters:
  SourceInstanceId:
    Type: String
    Description: クローンするソース ECS インスタンスの ID
    Label: ソースインスタンス ID
  InstanceName:
    Type: String
    Description: インスタンス名。名前は 2 ~ 128 文字の長さである必要があります。英字、漢字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。
    ConstraintDescription: '[2, 128] 文字、大文字、小文字、数字、または特殊文字で構成されます。'
    Label: インスタンス名
    Default: ClonedECS
    MaxLength: 128
    MinLength: 2
  MaxAmount:
    Type: Number
    Description: 一度に作成する ECS インスタンスの最大数。この値は、一度に作成する ECS インスタンスの最小数以上である必要があります。
    ConstraintDescription: [1, 100] 内の整数
    Label: ECS インスタンスの最大数
    MaxValue: 100
    MinValue: 1
    Default: 1
  Password:
    Type: String
    Description: 'パスワードは 8 ~ 30 文字の長さである必要があります。大文字、小文字、数字、特殊文字の 3 種類を含める必要があります。サポートされる特殊文字: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /.'
    ConstraintDescription: '長さ 8 ~ 30、大文字、小文字、数字、特殊文字の 3 種類を含める必要があります。サポートされる特殊文字: ()`~!@#$%^*_-+=|{}[]:;'',.?/'
    Label: ECS インスタンスのパスワード
    MaxLength: 30
    MinLength: 8
    AllowedPattern: '[a-zA-Z0-9-\(\)\`\~\!@\#\$%\^\*-+=\|\{\}\[\]\:\;\‘\,\.\?\/]*'
    NoEcho: true
Metadata:
  ALIYUN::ROS::Interface:
    ParameterGroups:
      - Parameters:
          - InstanceName
          - SourceInstanceId
          - MaxAmount
          - Password
        Label:
          default: ECS
    TemplateTags:
      - acs:example:elastic-computing:SourceInstanceId を指定して、同じ構成の ECS インスタンスのグループをクローンします。
Resources:
  ECSInstanceGroup:
    Type: ALIYUN::ECS::InstanceGroupClone
    Properties:
      SourceInstanceId:
        Ref: SourceInstanceId
      MaxAmount:
        Ref: MaxAmount
      Password:
        Ref: Password
Outputs:
  InstanceIds:
    Description: 作成された ecs インスタンスのインスタンス ID リスト
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - InstanceIds
  PublicIps:
    Description: 作成された ecs インスタンスのパブリック IP アドレスリスト。
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - PublicIps
  ZoneIds:
    Description: 作成されたインスタンスのゾーン ID。
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - ZoneIds
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "既存の ECS インスタンスに基づいて、同じ構成 (InstanceType、ImageId、InternetChargeType、InternetMaxBandwidthOut、システムディスク、データディスク構成、VPC プロパティ) を持つ ECS インスタンスのセットをクローンします。ユーザーは SourceInstanceId を指定するだけで済みます。",
  "Parameters": {
    "SourceInstanceId": {
      "Type": "String",
      "Description": "クローンするソース ECS インスタンスの ID",
      "Label": "ソースインスタンス ID"
    },
    "InstanceName": {
      "Type": "String",
      "Description": "インスタンス名。名前は 2 ~ 128 文字の長さである必要があります。英字、漢字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。",
      "ConstraintDescription": "[2, 128] 文字、大文字、小文字、数字、または特殊文字で構成されます。",
      "Label": "インスタンス名",
      "Default": "ClonedECS",
      "MaxLength": 128,
      "MinLength": 2
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": "一度に作成する ECS インスタンスの最大数。この値は、一度に作成する ECS インスタンスの最小数以上である必要があります。",
      "ConstraintDescription": "[1, 100] 内の整数",
      "Label": "ECS インスタンスの最大数",
      "MaxValue": 100,
      "MinValue": 1,
      "Default": 1
    },
    "Password": {
      "Type": "String",
      "Description": "パスワードは 8 ~ 30 文字の長さである必要があります。大文字、小文字、数字、特殊文字の 3 種類を含める必要があります。サポートされる特殊文字: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /.",
      "ConstraintDescription": "長さ 8 ~ 30、大文字、小文字、数字、特殊文字の 3 種類を含める必要があります。サポートされる特殊文字: ()`~!@#$%^*_-+=|{}[]:;',.?/",
      "Label": "ECS インスタンスのパスワード",
      "MaxLength": 30,
      "MinLength": 8,
      "AllowedPattern": "[a-zA-Z0-9-\\(\\)\\`\\~\\!@\\#\\$%\\^\\*-+=\\|\\{\\}\\[\\]\\:\\;\\‘\\,\\.\\?\\/]*",
      "NoEcho": true
    }
  },
  "Metadata": {
    "ALIYUN::ROS::Interface": {
      "ParameterGroups": [
        {
          "Parameters": [
            "InstanceName",
            "SourceInstanceId",
            "MaxAmount",
            "Password"
          ],
          "Label": {
            "default": "ECS"
          }
        }
      ],
      "TemplateTags": [
        "acs:example:elastic-computing:SourceInstanceId を指定して、同じ構成の ECS インスタンスのグループをクローンします。"
      ]
    }
  },
  "Resources": {
    "ECSInstanceGroup": {
      "Type": "ALIYUN::ECS::InstanceGroupClone",
      "Properties": {
        "SourceInstanceId": {
          "Ref": "SourceInstanceId"
        },
        "MaxAmount": {
          "Ref": "MaxAmount"
        },
        "Password": {
          "Ref": "Password"
        }
      }
    }
  },
  "Outputs": {
    "InstanceIds": {
      "Description": "作成された ecs インスタンスのインスタンス ID リスト",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "InstanceIds"
        ]
      }
    },
    "PublicIps": {
      "Description": "作成された ecs インスタンスのパブリック IP アドレスリスト。",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "PublicIps"
        ]
      }
    },
    "ZoneIds": {
      "Description": "作成されたインスタンスのゾーン ID。",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "ZoneIds"
        ]
      }
    }
  }
}