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

Resource Orchestration Service:ALIYUN::ECS::InstanceGroupClone

最終更新日:Nov 09, 2025

ALIYUN::ECS::InstanceGroupClone リソースタイプは、ECS インスタンスのグループをクローンするために使用されます。

構文

 {
  "Type": "ALIYUN::ECS::InstanceGroupClone",
  "Properties": {
    "BackendServerWeight": Integer, // バックエンドサーバーの重み
    "SystemDiskAutoSnapshotPolicyId": String, // システムディスクの自動スナップショットポリシーID
    "DiskMappings": List, // ディスクマッピング
    "Period": Number, // 期間
    "LaunchTemplateName": String, // 起動テンプレート名
    "RamRoleName": String, // RAMロール名
    "ResourceGroupId": String, // リソースグループID
    "KeyPairName": String, // キーペア名
    "SystemDiskDiskName": String, // システムディスク名
    "PeriodUnit": String, // 期間単位
    "Description": String, // 説明
    "Tags": List, // タグ
    "AutoRenewPeriod": Number, // 自動更新期間
    "ImageId": String, // イメージID
    "AutoRenew": String, // 自動更新
    "SpotStrategy": String, // スポット戦略
    "SourceInstanceId": String, // ソースインスタンスID
    "EniMappings": List, // ENIマッピング
    "Password": String, // パスワード
    "PasswordInherit": Boolean, // パスワード継承
    "MaxAmount": Integer, // 最大数
    "AutoReleaseTime": String, // 自動リリース時間
    "SystemDiskCategory": String, // システムディスクカテゴリ
    "LoadBalancerIdToAttach": String, // 接続するロードバランサーID
    "LaunchTemplateId": String, // 起動テンプレートID
    "LaunchTemplateVersion": String, // 起動テンプレートバージョン
    "ZoneId": String, // ゾーンID
    "InternetMaxBandwidthOut": Integer, // インターネット最大帯域幅(出力)
    "InstanceName": String, // インスタンス名
    "DeletionProtection": Boolean, // 削除保護
    "DeploymentSetId": String, // デプロイメントセットID
    "Ipv6AddressCount": Integer, // IPv6アドレス数
    "SecurityGroupId": String, // セキュリティグループID
    "SecurityGroupIds": List, // セキュリティグループIDリスト
    "SpotPriceLimit": String, // スポット価格制限
    "HpcClusterId": String, // HPCクラスタID
    "SystemDiskDescription": String, // システムディスクの説明
    "Ipv6Addresses": List, // IPv6アドレスリスト
    "SystemDiskProvisionedIops": Integer, // システムディスクのプロビジョンドIOPS
    "SystemDiskBurstingEnabled": Boolean, // システムディスクのバースト有効化
    "SystemDiskKMSKeyId": String, // システムディスクのKMSキーID
    "SystemDiskStorageClusterId": String, // システムディスクのストレージクラスタID
    "InternetMaxBandwidthIn": Integer, // インターネット最大帯域幅(入力)
    "UpdatePolicy": String, // 更新ポリシー
    "SystemDiskEncryptAlgorithm": String, // システムディスクの暗号化アルゴリズム
    "SystemDiskEncrypted": String, // システムディスクの暗号化
    "SecurityOptions": Map, // セキュリティオプション
    "ImageOptions": Map, // イメージオプション
    "NetworkOptions": Map, // ネットワークオプション
    "HostNames": List, // ホスト名リスト
    "NetworkInterfaceQueueNumber": Integer, // ネットワークインターフェースキュー番号
    "UniqueSuffix": Boolean, // ユニークサフィックス
    "CpuOptions": Map // CPUオプション
  }
}

プロパティ

プロパティ

タイプ

必須

更新の許可

説明

制約

SourceInstanceId

String

はい

いいえ

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

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

MaxAmount

Integer

はい

はい

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

有効値: 1 ~ 100。

ResourceGroupId

String

いいえ

いいえ

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

なし

HpcClusterId

String

いいえ

はい

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

なし

BackendServerWeight

Integer

いいえ

いいえ

Server Load Balancer (SLB) インスタンスにおける新しい ECS インスタンスの重み。

有効値: 0 ~ 100。

デフォルト値: 100。

LoadBalancerIdToAttach

String

いいえ

いいえ

新しい ECS インスタンスが追加される SLB インスタンスの ID。

なし

Description

String

いいえ

はい

インスタンスの説明。

説明は 256 文字以内でなければなりません。

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 と一致させます。

InternetMaxBandwidthOut

Integer

いいえ

いいえ

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

単位: Mbit/s。

有効値:

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

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

SecurityGroupId

String

いいえ

いいえ

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

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

SecurityGroupIds

List

いいえ

いいえ

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

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

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

InstanceName

String

いいえ

いいえ

新しいインスタンスの名前。

名前は 128 文字以内でなければなりません。文字、漢字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。

Password

String

いいえ

はい

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

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

このパラメーターを指定する場合は、HTTPS プロトコルを使用して API を呼び出し、パスワードの漏洩を防ぎます。

PasswordInherit

Boolean

いいえ

いいえ

イメージのプリセットパスワードを使用するかどうかを指定します。

有効値:

  • true: イメージのプリセットパスワードを使用します。

  • false: イメージのプリセットパスワードを使用しません。

説明

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

DiskMappings

List

いいえ

はい

マウントするディスク。

最大 16 個のディスクをアタッチできます。

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

Period

Number

いいえ

はい

サブスクリプション期間。

有効値: 1、2、3、4、5、6、7、8、9、12、24、36、48、および 60。

単位: 月。

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

Tags

List

いいえ

はい

カスタムタグです。

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

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

ZoneId

String

いいえ

いいえ

ゾーンの ID です。

なし

KeyPairName

String

いいえ

はい

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

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

RamRoleName

String

いいえ

はい

新しいインスタンスの RAM ロール名。

ListRoles 操作を呼び出して、インスタンスの RAM ロール名をクエリできます。詳細については、「CreateRole」および「ListRoles」をご参照ください。

SpotPriceLimit

String

いいえ

いいえ

新しいインスタンスの 1 時間あたりの最大価格。

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

SpotStrategy

String

いいえ

はい

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

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

有効値:

  • NoSpot (デフォルト): インスタンスは通常の従量課金インスタンスとして作成されます。

  • SpotWithPriceLimit: インスタンスは、ユーザー定義の 1 時間あたりの最大価格を持つスポットインスタンスとして作成されます。

  • SpotAsPriceGo: システムはインスタンスに対して自動的に入札を行います。最大入札額は従量課金価格です。

SystemDiskDiskName

String

いいえ

はい

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

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

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 です。

AutoRenewPeriod

Number

いいえ

はい

自動更新期間。

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

有効値:

  • 1 (デフォルト)

  • 2

  • 3

  • 6

  • 12

AutoRenew

String

いいえ

はい

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

有効値:

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

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

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

EniMappings

List

いいえ

はい

インスタンスにアタッチする Elastic Network Interface (ENI)。

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

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

AutoReleaseTime

String

いいえ

いいえ

新しい ECS インスタンスが自動的にリリースされる時間。

ISO 8601 標準で時間を yyyy-MM-ddTHH:mm:ssZ 形式で指定します。リリース時間は、将来 3 年を超えることはできません。

SystemDiskCategory

String

いいえ

はい

システムディスクのカテゴリです。

有効値:

  • cloud: 基本ディスク。

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

  • cloud_ssd: 標準 SSD。

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

SystemDiskProvisionedIops

Integer

いいえ

はい

システムディスクのプロビジョンド IOPS です。

なし

SystemDiskBurstingEnabled

Boolean

いいえ

はい

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

有効値:

  • true: バーストを有効にします。

  • false (デフォルト): バーストを無効にします。

LaunchTemplateName

String

いいえ

はい

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

なし

LaunchTemplateVersion

String

いいえ

はい

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

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

LaunchTemplateId

String

いいえ

はい

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

なし

SystemDiskDescription

String

いいえ

はい

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

なし

DeletionProtection

Boolean

いいえ

いいえ

新しいインスタンスのリリース保護属性。このパラメーターは、コンソールで、または DeleteInstance 操作を呼び出すことによってインスタンスをリリースできるかどうかを指定します。

有効値:

  • true: サポートされています。

  • false: この機能はサポートされていません。

DeploymentSetId

String

いいえ

はい

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

なし

Ipv6AddressCount

Integer

いいえ

はい

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

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

Ipv6Addresses

List

いいえ

はい

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

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

SystemDiskAutoSnapshotPolicyId

String

いいえ

はい

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

なし

SystemDiskKMSKeyId

String

いいえ

はい

システムディスクの KMS キーの ID。

なし

SystemDiskStorageClusterId

String

いいえ

はい

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

なし

InternetMaxBandwidthIn

Integer

いいえ

いいえ

最大インターネットインバウンド帯域幅を指定します。

単位: Mbit/s。

有効値: 0 ~ 200。

デフォルト値: 200。

UpdatePolicy

String

いいえ

はい

更新ポリシーです。

有効値:

  • ForNewInstance (デフォルト): 更新ポリシーは新しいインスタンスに対して有効になります。

  • ForAllInstances: 更新ポリシーはすべてのインスタンスに対して有効になります。

SystemDiskEncryptAlgorithm

String

いいえ

はい

システムディスクの暗号化アルゴリズム。

有効値:

  • AES-256。

  • SM4-128。

SystemDiskEncrypted

String

いいえ

はい

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

有効値:

  • true: データは暗号化されます。

  • false: システムディスクを暗号化しません。

SecurityOptions

Map

いいえ

いいえ

信頼済みシステムのプロパティ。

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

ImageOptions

Map

いいえ

いいえ

イメージのプロパティ。

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

NetworkOptions

Map

いいえ

いいえ

ネットワークプロパティのパラメーター。

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

HostNames

List

いいえ

いいえ

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

なし

NetworkInterfaceQueueNumber

Integer

いいえ

いいえ

プライマリ ENI のキューの数。

注:

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

  • インスタンス上のすべての ENI のキューの総数は、インスタンスタイプのキュークォータを超えることはできません。 DescribeInstanceTypes 操作を呼び出して、MaximumQueueNumberPerEni および TotalEniQueueQuantity フィールドから、ENI あたりの最大キュー数とインスタンスタイプのキュークォータをクエリできます。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、NetworkInterfaceQueueNumber を設定することはできません。NetworkInterface.N.QueueNumber のみ設定できます。

UniqueSuffix

Boolean

いいえ

いいえ

複数のインスタンスを作成するときに、HostNameInstanceName にシーケンシャルなサフィックスを自動的に追加するかどうかを指定します。

シーケンシャルなサフィックスは 001 から始まり、増分します。最大値は 999 です。有効値:

  • true: 追加操作を実行します。

  • false (デフォルト): シーケンシャルなサフィックスを追加しません。

HostName または InstanceName が指定された並べ替え形式で設定され、命名サフィックス name_suffix が設定されていない場合、つまり命名形式が name_prefix[begin_number,bits] である場合、UniqueSuffix は有効になりません。名前は指定された順序でのみ並べ替えられます。

詳細については、「シーケンシャルなインスタンス名またはホスト名を一括設定する」をご参照ください。

CpuOptions

Map

いいえ

いいえ

CPU プロパティのパラメーター。

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

DiskMappings 構文

"DiskMappings": [
  {
    "Category": String, // カテゴリ
    "DiskName": String, // ディスク名
    "Description": String, // 説明
    "Encrypted": String, // 暗号化
    "KMSKeyId": String, // KMSキーID
    "Device": String, // デバイス
    "SnapshotId": String, // スナップショットID
    "Size": String, // サイズ
    "PerformanceLevel": String, // パフォーマンスレベル
    "AutoSnapshotPolicyId": String, // 自動スナップショットポリシーID
    "ProvisionedIops": Integer, // プロビジョンドIOPS
    "BurstingEnabled": Boolean, // バースト有効化
    "StorageClusterId": String // ストレージクラスタID
  }
]

DiskMappings プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Size

String

はい

いいえ

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

単位:GB。

Category

String

いいえ

いいえ

データディスクのカテゴリ。

有効な値:

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

  • cloud_ssd: 標準 SSD。

  • cloud_essd: ESSD。

  • cloud_efficiency: Ultra ディスク。

DiskName

String

いいえ

いいえ

データディスクの名前。

名前は 128 文字以内でなければなりません。文字、漢字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。

Description

String

いいえ

いいえ

データディスクの説明。

説明は 2~256 文字の長さでなければなりません。http:// または https:// で始めることはできません。

Device

String

いいえ

いいえ

ECS 内のデータディスクの名前。

例: /dev/xvd[a-z]

SnapshotId

String

いいえ

いいえ

スナップショットの ID。

なし

Encrypted

String

いいえ

いいえ

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

有効な値:

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

  • false (デフォルト): データディスクを暗号化しません。

KMSKeyId

String

いいえ

いいえ

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

なし

AutoSnapshotPolicyId

String

いいえ

いいえ

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

なし

PerformanceLevel

String

いいえ

いいえ

システムディスクとして使用する ESSD を作成するときに、ディスクのパフォーマンスレベルを設定します。

有効な値:

  • PL0: 1 つのディスクで最大 10,000 のランダム読み取り/書き込み IOPS を実現できます。

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

  • PL2: 1 つのディスクで最大 100,000 のランダム読み取り/書き込み IOPS を実現できます。

  • PL3: 1 つのディスクで最大 1,000,000 のランダム読み取り/書き込み IOPS を実現できます。

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

ProvisionedIops

Integer

いいえ

いいえ

プロビジョニングされた IOPS。

なし

BurstingEnabled

Boolean

いいえ

いいえ

バーストを有効にするかどうかを指定します。

有効な値:

  • true: パラメーターは有効です。

  • false (デフォルト): バーストを無効にします。

StorageClusterId

String

いいえ

いいえ

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

なし

EniMappings 構文

"EniMappings": [
  {
    "SecurityGroupId": String, // セキュリティグループ ID
    "VSwitchId": String, // 仮想スイッチ ID
    "Description": String, // 説明
    "NetworkInterfaceName": String, // ネットワークインターフェース名
    "PrimaryIpAddress": String, // プライマリ IP アドレス
    "InstanceType": String, // インスタンスタイプ
    "Ipv6AddressCount": Integer, // IPv6 アドレス数
    "NetworkInterfaceTrafficMode": String, // ネットワークインターフェーストラフィックモード
    "Ipv6Addresses": List, // IPv6 アドレスリスト
    "QueueNumber": Integer, // キュー番号
    "SecurityGroupIds": List, // セキュリティグループ ID リスト
    "QueuePairNumber": Integer, // キューペア番号
    "NetworkInterfaceId": String, // ネットワークインターフェース ID
    "DeleteOnRelease": Boolean, // リリース時に削除
    "NetworkCardIndex": Integer // ネットワークカードインデックス
  }
]

EniMappings プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

SecurityGroupId

String

いいえ

はい

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

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

VSwitchId

String

いいえ

いいえ

vSwitch の ID です。

なし

Description

String

いいえ

はい

ENI の説明です。

説明は 2~256 文字の長さで、http:// または https:// で始めることはできません。

NetworkInterfaceName

String

いいえ

はい

ENI の名前です。

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

PrimaryIpAddress

String

いいえ

いいえ

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

指定された IP アドレスは、vSwitch の CIDR ブロック内のアイドル IP アドレスでなければなりません。

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

InstanceType

String

いいえ

いいえ

ENI のタイプです。

最大 2 つのネットワークカードを設定できます。1 つの ENI を設定する場合、プライマリまたはセカンダリ ENI として設定できます。2 つの ENI を設定する場合、1 つをプライマリ ENI、もう 1 つをセカンダリ ENI としてのみ設定できます。

有効値:

  • Primary: プライマリ ENI。

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

Ipv6AddressCount

Integer

いいえ

いいえ

プライマリ ENI に割り当てるランダムに生成された IPv6 アドレスの数。

有効な値:1 ~ 10。

注:

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

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

NetworkInterfaceTrafficMode

String

いいえ

いいえ

ネットワークカードの通信モード。

有効な値:

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

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

説明

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

Ipv6Addresses

List

いいえ

いいえ

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

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

注:

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

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

QueueNumber

Integer

いいえ

いいえ

ENI のキューの数。

注:

  • 有効値: 1 および 2。1 つの ENI を設定する場合、プライマリまたはセカンダリ ENI として設定できます。2 つの ENI を設定する場合、1 つをプライマリ ENI、もう 1 つをセカンダリ ENI としてのみ設定できます。

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

  • インスタンス上のすべての ENI のキューの総数は、インスタンスタイプのキュークォータを超えることはできません。 DescribeInstanceTypes 操作を呼び出して、MaximumQueueNumberPerEni および TotalEniQueueQuantity フィールドから、ENI あたりの最大キュー数とインスタンスタイプのキュークォータをクエリできます。

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

SecurityGroupIds

List

いいえ

いいえ

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

注:

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

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

QueuePairNumber

Integer

いいえ

いいえ

RDMA ネットワークカードのキューの数。

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

NetworkInterfaceId

String

いいえ

いいえ

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

このパラメーターはセカンダリ ENI に対してのみ有効です。既存のセカンダリ ENI を指定した後、ネットワークカードを作成するための他のパラメーターを構成することはできません。

DeleteOnRelease

Boolean

いいえ

いいえ

インスタンスがリリースされたときにネットワークカードを保持するかどうかを指定します。

有効な値:

  • true: リソースは保持されません。

  • false: リソースは保持されます。

NetworkCardIndex

Integer

いいえ

いいえ

ネットワークカードに指定された物理ネットワークカードのインデックス。

  • 特定のインスタンスタイプのみが物理ネットワークカードインデックスの指定をサポートします。

  • NetworkInterface.N.InstanceType が Primary に設定されている場合、物理ネットワークカードをサポートするインスタンスタイプに対してこのパラメーターを 0 にのみ設定できます。

  • NetworkInterface.N.InstanceType が Secondary に設定されているか、空の場合、物理ネットワークカードをサポートするインスタンスタイプに対してインスタンスタイプに基づいてこのパラメーターを設定できます。詳細については、「インスタンスファミリー」をご参照ください。

SecurityOptions 構文

"SecurityOptions": {
  "TrustedSystemMode": String
}

SecurityOptions のプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

TrustedSystemMode

String

いいえ

いいえ

信頼システムモード。

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

Alibaba Cloud Trusted System を使用する場合、このパラメーターを vTPM に設定します。これにより、Alibaba Cloud Trusted System はインスタンスの起動時に信頼性検証を実行できます。Alibaba Cloud Trusted System を使用しない場合は、このパラメーターを空のままにすることができます。エンクレーブベースの機密コンピューティングモード (SecurityOptions.ConfidentialComputingMode=Enclave) を使用する ECS インスタンスを作成する場合、ECS インスタンスに対しても信頼済みシステムが有効になることに注意してください。OpenAPI を使用して信頼済みシステムを使用する ECS インスタンスを作成する場合、RunInstances 操作のみを呼び出すことができます。CreateInstance 操作は SecurityOptions.TrustedSystemMode パラメーターをサポートしていません。

説明

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

構文

"ImageOptions": {
  "LoginAsNonRoot": ブール値
}

ImageOptions のプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

LoginAsNonRoot

ブール値

いいえ

いいえ

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

有効な値:

  • true: はい。

  • false: いいえ。

CpuOptions 構文

"CpuOptions": {
  "ThreadsPerCore": Integer, // スレッド数/コア
  "Core": Integer // コア数
}

CpuOptions プロパティ

プロパティ

必須

編集可能

説明

制約

ThreadsPerCore

整数

いいえ

いいえ

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

ECS インスタンスの vCPU の数は、次の数式を使用して計算されます: vCPU の数 = CpuOptions.Core の値 × CpuOptions.ThreadsPerCore の値。

Core

整数

いいえ

いいえ

CPU コアの数。

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

デフォルト値: 詳細については、「CPU オプションの変更」をご参照ください。

NetworkOptions 構文

"NetworkOptions": {
  "EnableJumboFrame": Boolean // ジャンボフレームを有効にするかどうか
}

NetworkOptions のプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

EnableJumboFrame

ブール値

いいえ

いいえ

インスタンスのジャンボフレーム機能を有効にするかどうかを指定します。

有効な値:

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

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

説明

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

タグの構文

"Tags": [
  {
    "Value": String, // 値
    "Key": String // キー
  }
]

タグのプロパティ

プロパティ

タイプ

必須

更新の許可

説明

制約

キー

文字列

はい

いいえ

タグキー。

キーは 1~128 文字の長さでなければなりません。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

文字列

いいえ

いいえ

タグ値。

値は 0~128 文字の長さでなければなりません。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

戻り値

Fn::GetAtt

  • InstanceIds: 新しいインスタンスの ID。インスタンス ID は、システムによって生成されるグローバルに一意の識別子です。

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

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

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

  • 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 インスタンスのグループをクローンします。新しいインスタンスは、インスタンスタイプ、イメージ ID、ネットワーク課金方法、最大パブリックアウトバウンド帯域幅、システムディスク、データディスク、VPC プロパティなど、ソースインスタンスの構成を継承します。ソースインスタンスの ID を指定するだけで済みます。
Parameters:
  SourceInstanceId:
    Type: String
    Description:
      en: クローンするソース ECS インスタンスの ID。
      zh-cn: 需要克隆的ECS实例ID
    Label:
      zh-cn: 源实例ID
      en: ソースインスタンス ID
  InstanceName:
    Type: String
    Description:
      en: インスタンスの名前。名前は 2~128 文字の長さで、文字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。
      zh-cn: 实例名称。长度为2~128个字符,可包含英文、汉字、数字、下划线(_)、半角句号(.)和短划线(-)。
    ConstraintDescription:
      en: 名前は 2~128 文字の長さでなければなりません。
      zh-cn: 长度为2~128个字符,可包含英文字母、数字或特殊字符。
    Label:
      zh-cn: 实例名称
      en: インスタンス名
    Default: ClonedECS
    MaxLength: 128
    MinLength: 2
  MaxAmount:
    Type: Number
    Description:
      en: 作成する ECS インスタンスの最大数。
      zh-cn: 一次性创建ECS实例的最大个数,必须大于或等于一次性创建ECS实例的最小个数。
    ConstraintDescription:
      en: 1~100 の整数でなければなりません。
      zh-cn: 1~100内的整数
    Label:
      zh-cn: 最大个数
      en: 最大数
    MaxValue: 100
    MinValue: 1
    Default: 1
  Password:
    Type: String
    Description:
      en: 'ECS インスタンスのパスワード。長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。サポートされている特殊文字は次のとおりです: ( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; '' , . ? /'
      zh-cn: '长度为8~30个字符。必须同时包含大写英文字母、小写英文字母、数字和特殊字符中的三项,支持的特殊字符为: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /。'
    ConstraintDescription:
      en: パスワードは 8~30 文字の長さで、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。
      zh-cn: 长度为8~30个字符。必须同时包含大写英文字母、小写英文字母、数字和特殊字符中的三项,支持的特殊字符为()`~!@#$%^*_-+=|{}[]:;' ,.?/。
    Label:
      zh-cn: ECS实例密码
      en: 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: 作成された ECS インスタンスのゾーン ID のリスト。
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - ZoneIds
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "指定されたソースインスタンスから ECS インスタンスのグループをクローンします。新しいインスタンスは、インスタンスタイプ、イメージ ID、ネットワーク課金方法、最大パブリックアウトバウンド帯域幅、システムディスク、データディスク、VPC プロパティなど、ソースインスタンスの構成を継承します。ソースインスタンスの ID を指定するだけで済みます。",
  "Parameters": {
    "SourceInstanceId": {
      "Type": "String",
      "Description": {
        "en": "クローンするソース ECS インスタンスの ID。",
        "zh-cn": "需要克隆的ECS实例ID"
      },
      "Label": {
        "zh-cn": "源实例ID",
        "en": "ソースインスタンス ID"
      }
    },
    "InstanceName": {
      "Type": "String",
      "Description": {
        "en": "インスタンスの名前。名前は 2~128 文字の長さで、文字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。",
        "zh-cn": "实例名称。长度为2~128个字符,可包含英文、汉字、数字、下划线(_)、半角句号(.)和短划线(-)。"
      },
      "ConstraintDescription": {
        "en": "名前は 2~128 文字の長さでなければなりません。",
        "zh-cn": "长度为2~128个字符,可包含英文字母、数字或特殊字符。"
      },
      "Label": {
        "zh-cn": "实例名称",
        "en": "インスタンス名"
      },
      "Default": "ClonedECS",
      "MaxLength": 128,
      "MinLength": 2
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": {
        "en": "作成する ECS インスタンスの最大数。",
        "zh-cn": "一次性创建ECS实例的最大个数,必须大于或等于一次性创建ECS实例的最小个数。"
      },
      "ConstraintDescription": {
        "en": "1~100 の整数でなければなりません。",
        "zh-cn": "1~100内的整数"
      },
      "Label": {
        "zh-cn": "最大个数",
        "en": "最大数"
      },
      "MaxValue": 100,
      "MinValue": 1,
      "Default": 1
    },
    "Password": {
      "Type": "String",
      "Description": {
        "en": "ECS インスタンスのパスワード。長さは 8~30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。サポートされている特殊文字は次のとおりです: ( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? /",
        "zh-cn": "长度为8~30个字符。必须同时包含大写英文字母、小写英文字母、数字和特殊字符中的三项,支持的特殊字符为: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /。"
      },
      "ConstraintDescription": {
        "en": "パスワードは 8~30 文字の長さで、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。",
        "zh-cn": "长度为8~30个字符。必须同时包含大写英文字母、小写英文字母、数字和特殊字符中的三项,支持的特殊字符为()`~!@#$%^*_-+=|{}[]:;' ,.?/。"
      },
      "Label": {
        "zh-cn": "ECS实例密码",
        "en": "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": "作成された ECS インスタンスのゾーン ID のリスト。",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "ZoneIds"
        ]
      }
    }
  }
}