ECS インスタンスのクローンを作成するための ALIYUN::ECS::InstanceGroupClone の使用方法 - Resource Orchestration Service

ALIYUN::ECS::InstanceGroupClone は、Elastic Compute Service (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
  }
}

プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
ResourceGroupId	String	いいえ	いいえ	ECS インスタンスが属するリソースグループの ID。	なし。
HpcClusterId	String	いいえ	はい	ECS インスタンスが属する Elastic High Performance Computing (E-HPC) クラスタの ID。	なし。
SourceInstanceId	String	はい	いいえ	ソース ECS インスタンスの ID。	インスタンスタイプ、イメージ、帯域幅測定方法、帯域幅制限、ネットワークタイプなど、ECS インスタンスの仕様をクローンできます。ソース ECS インスタンスが複数のセキュリティグループに属している場合、新しいインスタンスはソース ECS インスタンスの最初のセキュリティグループに追加されます。
MaxAmount	Integer	はい	はい	一度に作成できる ECS インスタンスの数。	有効な値: 1 ～ 100。
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 というイメージ ID と一致します。 ubuntu_14 と入力すると、システムは ubuntu_14_0405_64_20G_alibase_20170824.vhd というイメージ ID と一致します。 ubuntu1432 と入力すると、システムは ubuntu_14_0405_32_40G_alibase_20170711.vhd というイメージ ID と一致します。 ubuntu_16_0402_32 と入力すると、システムは ubuntu_16_0402_32_40G_alibase_20170711.vhd というイメージ ID と一致します。
InternetMaxBandwidthOut	Integer	いいえ	いいえ	最大アウトバウンドパブリック帯域幅。	単位: Mbit/s。帯域幅課金方式を使用する場合の有効な値: 0 ～ 200。データ転送課金方式を使用する場合の有効な値: 1 ～ 200。
SecurityGroupId	String	いいえ	いいえ	ECS インスタンスが属するセキュリティグループ。	SecurityGroupId と SecurityGroupIds の両方を指定することはできません。
SecurityGroupIds	List	いいえ	いいえ	ECS インスタンスが属するセキュリティグループ。	詳細については、「セキュリティグループの制限」をご参照ください。 SecurityGroupId と SecurityGroupIds の両方を指定することはできません。
InstanceName	String	いいえ	いいえ	新しい ECS インスタンスの名前。	名前は最大 128 文字まで入力でき、文字、数字、アンダースコア (_)、ピリオド (.)、ハイフン (-) を使用できます。
Password	String	いいえ	はい	ECS インスタンスのログオンパスワード。	パスワードは 8 ～ 30 文字である必要があります。文字、数字、および次の特殊文字を使用できます:( ) ` ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? /。このプロパティを指定する場合は、パスワードの漏洩を防ぐために HTTPS を使用して Resource Orchestration Service (ROS) API オペレーションを呼び出す必要があります。
PasswordInherit	Boolean	いいえ	いいえ	イメージのプリセットパスワードを使用するかどうかを指定します。	有効な値: true false 説明このプロパティを true に設定する場合は、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 インスタンスへの接続に使用するキーペアの名前。	ECS Windows インスタンスの場合、KeyPairName は無視できます。KeyPairName を指定した場合でも、ECS インスタンスには Password の値が使用されます。ただし、ECS Linux インスタンスではパスワードベースのログオンは無効になっています。
RamRoleName	String	いいえ	はい	ECS インスタンスの Resource Access Management (RAM) ロールの名前。	ListRoles オペレーションを呼び出して、RAM ロールの名前をクエリできます。詳細については、「CreateRole」および「ListRoles」をご参照ください。
SpotPriceLimit	String	いいえ	いいえ	ECS インスタンスの 1 時間あたりの最大価格。	このプロパティの値には、小数点以下 3 桁まで含めることができます。このプロパティは、SpotStrategy が SpotWithPriceLimit に設定されている場合に有効になります。
SpotStrategy	String	いいえ	はい	従量課金制インスタンスの入札ポリシー。	InstanceChargeType を PostPaid に設定する場合は、このプロパティを指定する必要があります。有効な値: NoSpot (デフォルト): インスタンスは通常の従量課金制インスタンスとして作成されます。 SpotWithPriceLimit: インスタンスは、ユーザー定義の 1 時間あたりの最大価格を持つプリエンプティブインスタンスとして作成されます。 SpotAsPriceGo: インスタンスは、購入時の市場価格に基づいて入札価格が決定されるプリエンプティブインスタンスとして作成されます。市場価格は従量課金制価格まで上がることがあります。
SystemDiskDiskName	String	いいえ	はい	システムディスクの名前。	名前は 2 ～ 128 文字である必要があります。文字で始まり、`http://` または `https://` で始めることはできません。文字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を使用できます。
PeriodUnit	String	いいえ	はい	ECS インスタンスの請求サイクルの単位。	有効な値: Week PeriodUnit を Week に設定した場合、Period の有効な値は 1 ～ 4、AutoRenewPeriod の有効な値は 1 ～ 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	いいえ	はい	ECS インスタンスの elastic network interface (ENI)。	インスタンスには最大 1 つの ENI を接続できます。詳細については、「EniMappings プロパティ」をご参照ください。
AutoReleaseTime	String	いいえ	いいえ	システムが新しい ECS インスタンスを自動的にリリースする時点。	ISO 8601 標準の `yyyy-MM-ddTHH:mm:ssZ` 形式で時間を指定します。時点は、新しい ECS インスタンスが作成されてから 3 年以内である必要があります。
SystemDiskCategory	String	いいえ	はい	システムディスクのカテゴリ。	有効な値: cloud: ベーシックディスク cloud_efficiency (デフォルト): ウルトラディスク 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	いいえ	いいえ	ECS インスタンスの削除保護プロパティ。このプロパティを使用して、ECS コンソールまたは DeleteInstance オペレーションの呼び出しで ECS インスタンスを削除できるかどうかを指定できます。	有効な値: 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	いいえ	はい	システムディスクに使用する Key Management Service (KMS) キーの ID。	なし。
SystemDiskStorageClusterId	String	いいえ	はい	システムディスクが存在する専用ブロックストレージクラスタの ID。	なし。
InternetMaxBandwidthIn	Integer	いいえ	いいえ	最大インバウンドパブリック帯域幅。	単位: Mbit/s。有効な値: 0 ～ 200。デフォルト値: 200。
UpdatePolicy	String	いいえ	はい	更新ポリシー。	有効な値: ForNewInstance (デフォルト): 更新ポリシーは新しい ECS インスタンスに有効になります。 ForAllInstances: 更新ポリシーはすべての ECS インスタンスに有効になります。
SystemDiskEncryptAlgorithm	String	いいえ	はい	システムディスクに使用する暗号化アルゴリズム。	有効な値: AES-256 SM4-128
SystemDiskEncrypted	String	いいえ	はい	システムディスクを暗号化するかどうかを指定します。	有効な値: true false
SecurityOptions	Map	いいえ	いいえ	信頼できるシステムオプション。	詳細については、「SecurityOptions プロパティ」をご参照ください。
ImageOptions	Map	いいえ	いいえ	イメージオプション。	詳細については、「ImageOptions プロパティ」をご参照ください。
NetworkOptions	Map	いいえ	いいえ	ネットワークオプション。	詳細については、「NetworkOptions プロパティ」をご参照ください。
HostNames	List	いいえ	いいえ	複数のインスタンスを作成する場合の ECS インスタンスのホスト名。	なし。
NetworkInterfaceQueueNumber	Integer	いいえ	いいえ	プライマリ ENI でサポートされるキューの数。	次の点に注意してください。このプロパティの値は、インスタンスタイプで許可される ENI あたりの最大キュー数を超えることはできません。インスタンス上のすべての ENI のキューの総数は、インスタンスタイプのキュークォータを超えることはできません。インスタンスタイプの ENI あたりの最大キュー数とインスタンスタイプのキュークォータをクエリするには、DescribeInstanceTypes オペレーションを呼び出し、`MaximumQueueNumberPerEni` 値と `TotalEniQueueQuantity` 値を確認します。 `NetworkInterface.N.InstanceType` が `Primary` に設定されている場合、`NetworkInterfaceQueueNumber` は指定できませんが、`NetworkInterface.N.QueueNumber` は指定できます。
UniqueSuffix	Boolean	いいえ	いいえ	複数のインスタンスを作成する場合に、`HostName` 値と `InstanceName` 値に連続するサフィックスを自動的に追加するかどうかを指定します。	連続するサフィックスの範囲は 001 ～ 999 です。有効な値: true false (デフォルト) `name_suffix` で指定されたサフィックスを含まない `name_prefix[begin_number,bits]` 形式で `HostName` 値または `InstanceName` 値を指定した場合、`UniqueSuffix` は有効になりません。名前は指定された順序でのみソートされます。詳細については、「複数のインスタンスに対して連続した名前またはホスト名をバッチ設定する」をご参照ください。
CpuOptions	Map	いいえ	いいえ	CPU オプション。	詳細については、「CpuOptions プロパティ」をご参照ください。

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。
Category	String	いいえ	いいえ	データディスクのカテゴリ。	有効な値: cloud (デフォルト): ベーシックディスク cloud_ssd: 標準 SSD cloud_essd: ESSD cloud_efficiency: ウルトラディスク
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 のパフォーマンスレベル (PL)。	有効な値: PL0: ESSD は最大 10,000 ランダム読み取り/書き込み IOPS を提供できます。 PL1 (デフォルト): ESSD は最大 50,000 ランダム読み取り/書き込み IOPS を提供できます。 PL2: ESSD は最大 100,000 ランダム読み取り/書き込み IOPS を提供できます。 PL3: ESSD は最大 1,000,000 ランダム読み取り/書き込み IOPS を提供できます。 ESSD の PL の選択方法の詳細については、「ESSD」をご参照ください。
ProvisionedIops	Integer	いいえ	いいえ	プロビジョンド IOPS。	なし。
BurstingEnabled	Boolean	いいえ	いいえ	パフォーマンスバースト機能を有効にするかどうかを指定します。	有効な値: true false (デフォルト)
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 プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
SecurityGroupId	String	いいえ	はい	ENI が属するセキュリティグループの ID。	ENI のセキュリティグループと ENI は、同じ virtual private cloud (VPC) に存在する必要があります。
VSwitchId	String	いいえ	いいえ	vSwitch ID。	なし。
Description	String	いいえ	はい	ENI の説明。	説明は 2 ～ 256 文字である必要があり、`http://` または `https://` で始めることはできません。
NetworkInterfaceName	String	いいえ	はい	ENI 名。	名前は 2 ～ 128 文字である必要があります。文字で始まり、`http://` または `https://` で始めることはできません。文字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を使用できます。
PrimaryIpAddress	String	いいえ	いいえ	ENI のプライマリプライベート IP アドレス。	プライマリ IP アドレスは、ENI の vSwitch CIDR ブロック内のアイドル IP アドレスである必要があります。このプロパティを空のままにすると、vSwitch の CIDR ブロックからアイドル IP アドレスがランダムに割り当てられます。
InstanceType	String	いいえ	いいえ	ENI タイプ。	最大 2 つの ENI を接続できます。1 つの ENI のみを接続する場合は、プライマリまたはセカンダリ ENI を構成できます。2 つの ENI を接続する場合は、プライマリ ENI とセカンダリ ENI を構成する必要があります。有効な値: Primary Secondary (デフォルト)
Ipv6AddressCount	Integer	いいえ	いいえ	プライマリ ENI にランダムに生成する IPv6 アドレスの数。	有効な値: 1 ～ 10。次の点に注意してください。このプロパティは、`NetworkInterface.InstanceType` が `Primary` に設定されている場合にのみ有効になります。`NetworkInterface.InstanceType` が `Secondary` に設定されているか、空のままになっている場合、NetworkInterface.Ipv6AddressCount は指定できません。 NetworkInterface.Ipv6AddressCount を指定した後、`Ipv6AddressCount`、`Ipv6Address`、または `NetworkInterface.Ipv6Address` は指定できません。
NetworkInterfaceTrafficMode	String	いいえ	いいえ	ENI の通信モード。	有効な値: Standard (デフォルト): TCP 通信モードを使用します。 HighPerformance: Elastic RDMA Interface (ERI) 機能が有効になっているリモートダイレクトメモリアクセス (RDMA) 通信モードを使用します。説明インスタンスに接続できる RDMA モードの ENI の数は、インスタンスタイプがサポートする ENI の最大数を超えることはできません。詳細については、「インスタンスファミリの概要」をご参照ください。
Ipv6Addresses	List	いいえ	いいえ	プライマリ ENI に割り当てる 1 つ以上の IPv6 アドレス。	最大 10 個の IPv6 アドレスを指定できます。次の点に注意してください。このプロパティは、`NetworkInterface.InstanceType` が `Primary` に設定されている場合にのみ有効になります。`NetworkInterface.InstanceType` が `Secondary` に設定されているか、空のままになっている場合、NetworkInterface.Ipv6Addresses は指定できません。 NetworkInterface.Ipv6Addresses を指定した後、`Amount` を 1 に設定する必要があり、`Ipv6AddressCount`、`Ipv6Address.N`、または `NetworkInterface.N.Ipv6AddressCount` は指定できません。
QueueNumber	Integer	いいえ	いいえ	ENI でサポートされるキューの数。	次の点に注意してください。有効な値: 1 と 2。1 つの ENI のみを接続する場合は、プライマリまたはセカンダリ ENI を構成できます。2 つの ENI を接続する場合は、プライマリ ENI とセカンダリ ENI を構成する必要があります。このプロパティの値は、インスタンスタイプで許可される ENI あたりの最大キュー数を超えることはできません。インスタンス上のすべての ENI のキューの総数は、インスタンスタイプのキュークォータを超えることはできません。インスタンスタイプの ENI あたりの最大キュー数とインスタンスタイプのキュークォータをクエリするには、DescribeInstanceTypes オペレーションを呼び出し、`MaximumQueueNumberPerEni` 値と `TotalEniQueueQuantity` 値を確認します。 `NetworkInterface.InstanceType` が `Primary` に設定されていて、QueueNumber が指定されている場合、`NetworkInterfaceQueueNumber` は指定できません。
SecurityGroupIds	List	いいえ	いいえ	ENI が属する 1 つ以上のセキュリティグループの ID。	次の点に注意してください。 `NetworkInterface.N.InstanceType` が `Primary` に設定されている場合、NetworkInterface.SecurityGroupIds または `NetworkInterface.SecurityGroupId` を指定する必要があります。この場合、NetworkInterface.SecurityGroupIds は `SecurityGroupIds` と同じ効果があります。また、`SecurityGroupId`、`SecurityGroupIds`、または `NetworkInterface.SecurityGroupId` は指定できません。 `NetworkInterface.N.InstanceType` が `Secondary` に設定されているか、空のままになっている場合、NetworkInterface.SecurityGroupIds はオプションです。デフォルト値は、ECS インスタンスが属する 1 つ以上のセキュリティグループの ID です。
QueuePairNumber	Integer	いいえ	いいえ	RDMA モードの ENI でサポートされるキューの数。	QueuePairNumber は Long データ型です。シリアル化またはデシリアル化プロセス中にプロパティ値の精度が失われる可能性があります。値が 9007199254740991 を超えないようにする必要があります。
NetworkInterfaceId	String	いいえ	いいえ	ECS インスタンスの ENI ID。	このプロパティはセカンダリ ENI にのみ有効です。このプロパティを使用して既存のセカンダリ ENI を指定した後、ENI の作成に使用する他のプロパティを構成することはできません。
DeleteOnRelease	Boolean	いいえ	いいえ	関連付けられているインスタンスがリリースされたときに ENI を削除するかどうかを指定します。	有効な値: true false
NetworkCardIndex	Integer	いいえ	いいえ	ENI に指定するネットワークカードインデックス。	特定のインスタンスタイプでのみ、ネットワークカードインデックスを指定できます。 NetworkInterface.N.InstanceType が Primary に設定されている場合、ネットワークカードをサポートするインスタンスタイプの場合は NetworkCardIndex を 0 に設定する必要があります。 NetworkInterface.N.InstanceType が Secondary に設定されているか、空のままになっている場合、インスタンスタイプがネットワークカードをサポートしている場合は、インスタンスタイプに基づいて NetworkCardIndex を指定できます。詳細については、「インスタンスファミリの概要」をご参照ください。

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 インスタンスにエンクレーブベースの機密コンピューティング環境を使用すると、インスタンスに対して Alibaba Cloud Trusted System が有効になることに注意してください。API オペレーションを呼び出して Alibaba Cloud Trusted System を使用する ECS インスタンスを作成する場合、RunInstances オペレーションのみを呼び出して SecurityOptions.TrustedSystemMode を指定できます。CreateInstance オペレーションは SecurityOptions.TrustedSystemMode をサポートしていません。

説明

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

ImageOptions 構文

"ImageOptions": {
  "LoginAsNonRoot": Boolean
}

ImageOptions プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

LoginAsNonRoot

Boolean

いいえ

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

有効な値:

true
false

CpuOptions 構文

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

CpuOptions プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

ThreadsPerCore

Integer

いいえ

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

ECS インスタンスの vCPU の数は、次の式に基づいて計算されます。vCPU の数 = CpuOptions.Core 値 × CpuOptions.ThreadsPerCore 値。

Core

Integer

いいえ

物理 CPU コアの数。

このプロパティのカスタム値を指定することはできません。このプロパティをデフォルト値のいずれかに設定する必要があります。

デフォルト値の詳細については、「CPU オプションを指定して表示する」をご参照ください。

NetworkOptions 構文

"NetworkOptions": {
  "EnableJumboFrame": Boolean
}

NetworkOptions プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

EnableJumboFrame

Boolean

いいえ

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

有効な値:

false: ECS インスタンスのジャンボフレーム機能を有効にしません。インスタンス上のすべての ENI の最大伝送単位 (MTU) 値は 1500 に設定されます。
true: ECS インスタンスのジャンボフレーム機能を有効にします。インスタンス上のすべての ENI の MTU 値は 8500 に設定されます。

説明

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

Tags 構文

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

Tags プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
Key	String	はい	いいえ	タグキー。	タグキーは 1 ～ 128 文字である必要があり、`http://` または `https://` を含めることはできません。`aliyun` または `acs:` で始めることはできません。
Value	String	いいえ	いいえ	タグ値。	タグ値は最大 128 文字まで入力でき、`http://` または `https://` を含めることはできません。`aliyun` または `acs:` で始めることはできません。

戻り値

Fn::GetAtt

InstanceIds: 新しい ECS インスタンスの ID。インスタンス ID は、システムがインスタンスに対して生成する GUID です。
PrivateIps: VPC 内の ECS インスタンスのプライベート IP アドレス。このプロパティは、NetworkType が vpc に設定されている場合に有効になります。値は JSON 配列で、コンマ (,) で区切られた最大 100 個の IP アドレスを含めることができます。例: ["172.16.XX.XX", "172.16.XX.XX", … "172.16.XX.XX"]。
InnerIps: クラシックネットワーク内の ECS インスタンスのプライベート IP アドレス。このプロパティは、NetworkType が classic に設定されている場合に有効になります。値は JSON 配列で、コンマ (,) で区切られた最大 100 個の IP アドレスを含めることができます。例: ["10.1.XX.XX", "10.1.XX.XX", … "10.1.XX.XX"]。
PublicIps: クラシックネットワーク内の ECS インスタンスのパブリック IP アドレス。このプロパティは、NetworkType が classic に設定されている場合に有効になります。値は JSON 配列で、コンマ (,) で区切られた最大 100 個の IP アドレスを含めることができます。例: ["42.1.XX.XX", "42.1.XX.XX", … "42.1.XX.XX"]。
HostNames: ECS インスタンスのホスト名。
OrderId: 新しい ECS インスタンスの注文 ID。
ZoneIds: ゾーン ID。
Ipv6AddressIds: 新しい ECS インスタンスの IPv6 アドレス ID。IPv6 アドレス ID は、2 レベルのネストを持つリストで返されます。ECS インスタンスに IPv6 アドレスがない場合、リスト内の関連する位置の要素は空になります。すべての ECS インスタンスに IP アドレスがない場合は、null が返されます。
Ipv6Addresses: 新しい ECS インスタンスの IPv6 アドレス。IPv6 アドレスは、2 レベルのネストを持つリストで返されます。ECS インスタンスに IPv6 アドレスがない場合、リスト内の関連する位置の要素は null になります。すべての ECS インスタンスに IP アドレスがない場合は、null が返されます。

例

`YAML` 形式

ROSTemplateFormatVersion: '2015-09-01'
Description: 既存の ECS インスタンスに基づいて、同じ構成 (InstanceType、ImageId、InternetChargeType、InternetMaxBandwidthOut、システムディスク、データディスクの構成、VPC プロパティ) を持つ ECS インスタンスのセットをクローンします。ユーザーは SourceInstanceId を指定するだけで済みます。
Parameters:
  SourceInstanceId:
    Type: String
    Description:
      en: The source ECS instance ID to be cloned
      ja: クローン元の ECS インスタンス ID
    Label:
      en: Source Instance ID
      ja: ソースインスタンス ID
  InstanceName:
    Type: String
    Description:
      en: '[2, 128] alphanumeric letters, underline, dot or hyphen'
      ja: '[2, 128] 英数字、アンダースコア、ドット、またはハイフン'
    ConstraintDescription:
      en: '[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.'
      ja: '[2, 128] 文字、大文字、小文字、数字、または特殊文字で構成されます。'
    Label:
      en: Instance Name
      ja: インスタンス名
    Default: ClonedECS
    MaxLength: 128
    MinLength: 2
  MaxAmount:
    Type: Number
    Description:
      en: The maximum of ECS instances, must be greater than or equal to the minimum.
      ja: ECS インスタンスの最大数、最小値以上である必要があります。
    ConstraintDescription:
      en: An integer within [1, 100]
      ja: [1, 100] 内の整数
    Label:
      en: The Maximum of ECS Instances
      ja: ECS インスタンスの最大数
    MaxValue: 100
    MinValue: 1
    Default: 1
  Password:
    Type: String
    Description:
      en: '[8, 30] characters, consists of uppercase letter, lowercase letter, number or special characters such as ( ) ` ~ !     / '
      ja: '[8, 30] 文字、大文字、小文字、数字、または ( ) ` ~ !     / などの特殊文字で構成されます。'
    ConstraintDescription:
      en: 'Length 8-30, must contain upper case letters, lower case letters, Numbers, special symbols three; special characters include the following: ()`~!@#$%^*_-+=|{}[]:;'',.?/'
      ja: '長さ 8 ～ 30、大文字、小文字、数字、特殊記号 3 つを含む必要があります。特殊文字には、() `~!@#$%^*_-+=|{}[]:;'',.?/ が含まれます。'
    Label:
      en: ECS Instance Password
      ja: 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: ECS: Specify SourceInstanceId to create multiple clones of an ECS instance that have the same configurations.
      - acs:example: ECS: SourceInstanceId を指定して、同じ構成を持つ ECS インスタンスの複数のクローンを作成します。
Resources:
  ECSInstanceGroup:
    Type: ALIYUN::ECS::InstanceGroupClone
    Properties:
      SourceInstanceId:
        Ref: SourceInstanceId
      MaxAmount:
        Ref: MaxAmount
      Password:
        Ref: Password
Outputs:
  InstanceIds:
    Description: The instance ID list of created ecs instance
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - InstanceIds
  PublicIps:
    Description: Public IP address list of created ecs instance.
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - PublicIps
  ZoneIds:
    Description: Zone ID of created instance.
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - ZoneIds

`JSON` 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "既存の ECS インスタンスに基づいて、同じ構成 (InstanceType、ImageId、InternetChargeType、InternetMaxBandwidthOut、システムディスク、データディスクの構成、VPC プロパティ) を持つ ECS インスタンスのセットをクローンします。ユーザーは SourceInstanceId を指定するだけで済みます。",
  "Parameters": {
    "SourceInstanceId": {
      "Type": "String",
      "Description": {
        "en": "The source ECS instance ID to be cloned",
        "ja": "クローン元の ECS インスタンス ID"
      },
      "Label": {
        "en": "Source Instance ID",
        "ja": "ソースインスタンス ID"
      }
    },
    "InstanceName": {
      "Type": "String",
      "Description": {
        "en": "[2, 128] alphanumeric letters, underline, dot or hyphen",
        "ja": "[2, 128] 英数字、アンダースコア、ドット、またはハイフン"
      },
      "ConstraintDescription": {
        "en": "[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.",
        "ja": "[2, 128] 文字、大文字、小文字、数字、または特殊文字で構成されます。"
      },
      "Label": {
        "en": "Instance Name",
        "ja": "インスタンス名"
      },
      "Default": "ClonedECS",
      "MaxLength": 128,
      "MinLength": 2
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": {
        "en": "The maximum of ECS instances, must be greater than or equal to the minimum.",
        "ja": "ECS インスタンスの最大数、最小値以上である必要があります。"
      },
      "ConstraintDescription": {
        "en": "An integer within [1, 100]",
        "ja": "[1, 100] 内の整数"
      },
      "Label": {
        "en": "The Maximum of ECS Instances",
        "ja": "ECS インスタンスの最大数"
      },
      "MaxValue": 100,
      "MinValue": 1,
      "Default": 1
    },
    "Password": {
      "Type": "String",
      "Description": {
        "en": "[8, 30] characters, consists of uppercase letter, lowercase letter, number or special characters such as ( ) ` ~ !     / ",
        "ja": "[8, 30] 文字、大文字、小文字、数字、または ( ) ` ~ !     / などの特殊文字で構成されます。"
      },
      "ConstraintDescription": {
        "en": "Length 8-30, must contain upper case letters, lower case letters, Numbers, special symbols three; special characters include the following: ()`~!@#$%^*_-+=|{}[]:;',.?/",
        "ja": "長さ 8 ～ 30、大文字、小文字、数字、特殊記号 3 つを含む必要があります。特殊文字には、() `~!@#$%^*_-+=|{}[]:;',.?/ が含まれます。"
      },
      "Label": {
        "en": "ECS Instance Password",
        "ja": "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: ECS: Specify SourceInstanceId to create multiple clones of an ECS instance that have the same configurations.",
        "acs:example: ECS: 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"
        ]
      }
    }
  }
}

構文

プロパティ

DiskMappings 構文

DiskMappings プロパティ

EniMappings 構文

EniMappings プロパティ

SecurityOptions 構文

SecurityOptions プロパティ

ImageOptions 構文

ImageOptions プロパティ

CpuOptions 構文

CpuOptions プロパティ

NetworkOptions 構文

NetworkOptions プロパティ

Tags 構文

Tags プロパティ

戻り値

例

YAML 形式

JSON 形式

`YAML` 形式

`JSON` 形式