RunInstances

インスタンスのリージョン ID 。 DescribeRegionsを実行すると、最新のリージョンリストが表示されます。

実行する操作。 値を RunInstances に設定します。

指定されたリージョンで使用可能なゾーン ID 。 DescribeZonesを呼び出して、最新のゾーンリストを取得できます。 デフォルトでは、システムによってランダムに割り当てられます。

インスタンスを作成するときに指定するイメージリソースの ID 。 DescribeImages を呼び出して、利用可能な画像リソースを表示することができます。 インスタンス起動テンプレートの指定にLaunchTemplateIdまたはLaunchTemplateNameを使用しない場合、ImageIdが必要になります。

インスタンスが属するリソースグループの ID 。 同じセキュリティグループ内のインスタンスは相互にアクセスすることができます。 1 つのセキュリティグループには、最大 1,000 個のインスタンスを含めることができます。

インスタンス起動テンプレートの指定にLaunchTemplateIdまたはLaunchTemplateNameを使用しない場合、SecurityGroupIdが必要です。

VSwitch の ID。 VPC ベースのインスタンスの作成時に指定する必要があります。

インスタンスの種類 詳細については、インスタンスタイプファミリーを参照するか、またはDescribeInstanceTypesの操作を行って最新のインスタンスタイプのリストを取得してください。LaunchTemplateId または LaunchTemplateName を使用してインスタンス起動テンプレートを指定しない場合、InstanceType が必要になります。

パブリックネットワークのインバウンド帯域幅の最大値。 単位：Mbit/s。 有効値：1〜200。

既定値 : 200

パブリックネットワークのアウトバウンド帯域幅の最大値。 単位：Mbit/s。 有効値：0〜100。

既定値：0。

インスタンスの名前。 長さは 2〜128 文字で、大文字と小文字、数字、コロン（:)、アンダースコア（_）、ハイフン（-）を含めることができます。 先頭は文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。デフォルトではInstanceIdが使用されます。

インスタンスのホスト名

• 文頭および文末をピリオド (.) やハイフン (-) にすることはできません。 ピリオド (.) やハイフン (-) を連続して使用することはできません。
• Windows の場合：ホスト名は 2〜15 文字の長さである必要があります。大文字と小文字、数字、ピリオド (.)、ハイフン (-) を含めることができます。 数字のみにすることはできません。
• その他のオペレーティングシステムの場合：ホスト名の長さは 2〜64 文字である必要があります。大文字と小文字、数字、ハイフン (-) を含めることができます。 ピリオド (.) でセグメントを区切ることができます。

連続したサフィックスをHostNameおよびInstanceNameに追加するかを示します。 連続したサフィックス の範囲は 001 〜 999 です。 例：LocalHost001, LocalHost002, MyInstance001 、およびMyInstance002. 既定値：false

インスタンスの説明。 長さは 2 ～ 256 文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。

イメージで事前定義されたパスワードを使用するかを示します。 PasswordInherit が指定されている場合、 Password は null である必要があります。 選択したイメージにパスワードが設定されていることをご確認ください。

インスタンスのパスワード。 長さは 8～30 文字である必要があります。大文字、小文字、数字、記号のすべてを含める必要があります。 以下の記号が使用可能です。

 ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

Windows の場合、パスワードの先頭をスラッシュ (/) にすることはできません。

キーペアの名前。

• Windows インスタンスの場合は、このパラメーターを無視してください。 既定値 : null 。 このパラメーターが指定されている場合でも、 パスワード値が使用されます。
• Linux インスタンスの場合、初期化の段階ではパスワードログオン方法は禁止されています。

システムディスクのサイズ。 単位：GiB。 有効値：20 〜 500 。

この値は、最大 {20, ImageSize} 以上である必要があります。 既定値：最大 {40, ImageSize}

システムディスクのカテゴリ。 非 I/O 最適化のフェーズアウトインスタンスタイプの、非 I/O 最適化インスタンス規定値は cloud です。 その他のインスタンスの規定値は cloud_efficiency です。 有効値：

• cloud：ベーシックディスク
• cloud_efficiency：ウルトラディスク。
• cloud_ssd：SSD
• ephemeral_ssd: ローカル SSD
• cloud_essd：ESSD ESSD はパブリックベータテスト段階にあるため、一部の地域のみで利用が可能です。 詳細については、ESSD FAQをご参照ください。

システムディスクの名前。 長さは 2〜128 文字である必要があります。大文字と小文字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 先頭は文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。 既定値 : null 。

システムディスクの説明。 長さは 2 ～ 256 文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。

n 番目のデータディスクのサイズ。n の範囲は 1〜16 です。 単位：GiB。 有効値：

• cloud：5〜2,000。
• cloud_efficiency: 20 〜 32768
• cloud_ssd: 20 〜 32768
• cloud_essd：20 〜 32768
• ephemeral_ssd: 5 〜 800

この値のサイズはSnapshotId以上である必要があります。

n 番目のデータディスクの作成に使用されるスナップショットの ID。n の範囲は 1〜16 です。 DataDisk.n.SnapshotIdが指定されている場合、 DataDisk.n.Sizeの値は無視されます。 新しいデータディスクのサイズは、指定されたスナップショットと同じサイズになります。 2013 年 7 月 15 日以前に作成されたスナップショットはここでは使用できません。 それ以外の場合、エラーが返され、リクエストは拒否されます。

n 番目のデータディスクのカテゴリ。 既定値：cloud 有効値：

• cloud：ベーシックディスク
• cloud_efficiency：ウルトラディスク。
• cloud_ssd：SSD
• ephemeral_ssd: ローカル SSD
• cloud_essd：ESSD ESSD はまだパブリックベータテスト段階であるため、一部の地域のみで利用が可能です。 詳細については、ESSD FAQをご参照ください。

n 番目のデータディスクが暗号化されているかを示します。 既定値：false

n 番目のデータディスクの KMS ID 。

n 番目のデータディスクの名前。 長さは 2〜128 文字である必要があります。大文字と小文字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 先頭は文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。 既定値 : null 。

n 番目のデータディスクの説明。 長さは 2 ～ 256 文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。

n 番目のデータディスクのマウントポイント。

インスタンスとともにデータディスクがリリースされるかどうかを示します。 既定値：true

インスタンスが I/O 最適化インスタンスであるかを示します。フェーズアウトインスタンスタイプの既定値は none 、その他のインスタンスの場合は optimized です。 有効値：

• none。
• optimized。

n 番目の ENI のプライマリ IP アドレス。

n 番目の ENI の VSwitch の ID 。

n 番目の ENI のセキュリティグループの ID 。

n 番目の ENI の名前。

n 番目の ENI の説明。 長さは 2 ～ 256 文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。

インスタンスの RAM ロール名。 ListRoles を呼び出して、指定したインスタンスの RAM ロールを表示できます。

インスタンスのユーザーデータ。 Base64 でエンコードする必要があります。 ユーザーデータの最大サイズは 16 KB です。

指定インスタンスの最小購入数。 有効値：1 ～ 100 。

• 在庫の ECS インスタンスの数が MinAmount 値よりも少ない場合、インスタンス作成の操作は失敗します。
• 在庫の ECS インスタンスの数が MinAmount 値以上である場合、インスタンス作成の操作は成功します。

作成するインスタンス数。 有効値：1 ～ 100 。

既定値：1

インスタンスの最高価格/時。 小数点以下 3 桁まで正確です。 SpotStrategy がSpotWithPriceLimit に設定されている場合にのみ有効になります。

従量課金インスタンスのプリエンプティブポリシー。 このパラメーターは、 InstanceChargeTypeがPostPaidに設定されている場合にのみ有効になります。 有効値：

• NoSpot：通常の従量課金インスタンス。
• SpotWithPriceLimit：価格上限が定義されたプリエンプティブインスタンス。
• SpotAsPriceGo：現在の市場価格に基づいた従量課金のインスタンス。

プリエンプティブインスタンスの中断モード。 インスタンスがリリースされる終了モードのみがサポートされています。

バースト可能なインスタンスの実行モード (t5)。 有効値：

• 標準：標準モード。 詳細については、標準モードをご参照ください。
• Unlimited：無制限モード。 詳細については、無制限モードをご参照ください。

既定値 : null 。

セキュリティー強化を有効化するかを示します。 有効値：

• Active：セキュリティ強化を有効化します。 Alibaba Cloud パブリックイメージにのみ適用可能です。
• Deactive：セキュリティ強化を無効化します。 すべてのイメージに適用可能です。

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

指定された専用ホスト (DDH) で ECS インスタンスを作成するかを示します。 DescribeDedicatedHostsを呼び出して DDH リストを表示することができます。

DDH でプリエンプティブインスタンスを作成することはできません。 指定した場合DedicatedHostId を指定した場合、SpotStrategy とSpotpricelimit の値は無視されます。

インスタンス、ディスク、プライマリ NIC のタグキー。 n の範囲は 1〜20 です。 このパラメーターは空白のままにできません。 長さは 64 文字以下である必要があります。 先頭文字列を aliyunまたはacs： にすることはできません。また、 http:// または https:// を含めることはできません。

インスタンス、ディスク、プライマリ NIC のタグ値。 n の範囲は 1〜20 です。 このパラメーターは空白のままも可能です。 長さは 128 文字以下である必要があります。 先頭文字列を aliyunまたはacs： にすることはできません。また、 http:// または https:// を含めることはできません。

インスタンスが属する EHPC クラスターの ID。

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

インスタンス起動テンプレートの ID 。 詳細については、 DescribeLaunchTemplatesを実行してください。 インスタンス起動テンプレートを指定するには、 LaunchTemplateIdまたはLaunchTemplateNameを使用する必要があります。

インスタンス起動テンプレートの名前。 インスタンス起動テンプレートを指定するには、LaunchTemplateIdまたはLaunchTemplateNameを使用する必要があります。

インスタンス起動テンプレートのバージョン。 LaunchTemplateIdまたはLaunchTemplateNameを指定したが LaunchTemplateVersion をスキップした場合、デフォルトのテンプレートバージョンが使用されます。

インスタンスのリリース保護の属性。 ECS コンソール上で、またはDeleteInstance操作でインスタンスのリリースが可能かを示します。 既定値：false 有効値：

• true：リリース保護を有効化します。
• false：リリース保護を無効化します。

インスタンスの自動リリースの時刻。 時間は、ISO 8601標準、UTC 時間です。 形式：yyyy-MM-ddTHH:mm:ssZ。

• ssが00以外の値に設定されている場合、mmの値のみが使用されます (ss が 00 に変わります)。
• 自動リリースの時間は、現在の時刻から 30 分以上あとである必要があります。
• 自動リリースの時間は、現在の時刻から 3 年未満である必要があります。

インスタンスの課金方法。 既定値 : PayByTraffic 有効値：

• PayByTraffic：実際のトラフィックに基づいて課金されます。

インスタンスのサブスクリプション期間。 単位：month 。 このパラメーターは、InstanceChargeTypeがPrePaidに設定されている場合にのみ有効・必要になります。 DedicatedHostId が指定されている場合、Period パラメーター値の範囲は DDH のサブスクリプション期間内である必要があります。 有効値：

• {“1”, “2”, “3”, “4”} PeriodUnit が Week に設定されている場合。
• { “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “12”, “24”, “36”,”48”,”60”} PeriodUnit が Month に設定されている場合。

自動更新が有効になっているかを示します。 このパラメーターは、 InstanceChargeTypeがPrePaidに設定されている場合にのみ有効になります。 既定値：false 有効値：

• true 。
• false 。

サブスクリプション期間の単位。 既定値：Month 。 有効値：

• Week
• Month

インスタンスの自動更新期間。 有効値：

• {“1”, “2”, “3”} PeriodUnit が Week に設定されている場合。
• PeriodUnit が Month に設定されている場合、 {"1", "2", "3", "12", "24", "36","48", "60"}

既定値 : 1。

インスタンスの課金方法。 既定値：PostPaid。 有効値：

• PrePaid：サブスクリプション
• PostPaid：従量課金

PrePaid に設定されている場合、支払口座に十分なクレジットがあることを確認してください。 それ以外の場合は、InvalidPayMethodエラーコードが返されます。

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

インスタンスのプライベート IP アドレス。 PrivateIpAddress は VSwitchId に依存し、個別に指定することはできません。

1 つ以上の IPv6 アドレスを ENI に割り当てます。 N は 1 にしかすることはできません。

サンプル：

チェックリクエストのみを送信するかを示します。 既定値：false

• true: 確認要求は送信されますが、インスタンスは作成されません。 システムが必要なパラメーターが設定されているかを確認し、要求形式、サービス制限、使用可能な ECS インスタンスを検証します。 確認が失敗した場合、対応するエラーコードが返されます。 確認が成功した場合、DryRunOperationが返されます。
• false：要求が送信され、インスタンスが作成されます。

べき等性を保証するために使用されるトークン。 クライアントでトークンの生成が可能ですが、トークンはグローバル一意である必要があります。ClientToken には ASCII 文字のみが使用可能です。 長さは 64 文字以下である必要があります。 詳細については、「べき等性を確保する方法」をご参照ください。

インスタンスが作成された DDH にECS インスタンスを関連付けるかを示します。 有効値：

• デフォルト ：インスタンスが作成される DDH にインスタンスが関連付けられていません。 [停止した VPC インスタンスへの無課金 (VPC 接続)] 機能が有効化されているインスタンスでは、インスタンスの再起動後に元の DDH に十分なリソースがない場合、自動 DDH リソースプールで該当のインスタンスは別の DDH でホストされます。
• ホスト ：インスタンスは、インスタンスが作成されるDDHに関連付けられます。 [停止した VPC インスタンスへの無課金 (VPC 接続) ] 機能が有効化されているインスタンスは、再起動後も元のDDH でホストされます。 元の DDH に十分なリソースがない場合、インスタンスの再起動は失敗します。

規定値：false

データディスクとして使用される ESSD クラウドディスクに対して選択するパフォーマンスレベル。 N の値は、DataDisk.N.Category = cloud_essdの値と同じである必要があります。 有効値：

• PL1 (既定値) ：1 つのディスクのランダム読み取り/書き込み IOPS は最大 50,000 です。
• PL2 ：1 つのディスクのランダム読み取り/書き込み IOPS は最大 100,000 です。
• PL3 ：1 つのディスクのランダム読み取り/書き込み IOPS は最大 1,000,000 です。

ESSD クラウドディスクのパフォーマンスレベルを選択する方法については、 ESSD クラウドディスクをご参照ください。

ECS インスタンスが属するセキュリティグループの ID 。 1つの ECS インスタンスを複数のセキュリティグループに追加できます。 N の値の範囲は、ECS インスタンスを追加できるセキュリティグループの最大数によって異なります。 詳細については、「セキュリティグループの制限」をご参照ください。

システムディスクとして使用される ESSD クラウドディスクに対して選択するパフォーマンスレベル。 有効値：

• PL1 (既定値)：単1 つのディスクのランダム読み取り/書き込み IOPS は最大 50,000 です。
• PL2 ：単1 つのディスクのランダム読み取り/書き込み IOPS は最大 100,000 です。
• PL3 ：単1 つのディスクのランダム読み取り/書き込み IOPS は最大 1,000,000 です。

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

DDH で ECS インスタンスを作成するかを示します。 有効値：

• デフォルト ： DDH 上にECS インスタンスが作成されません。
• ホスト：DDH 上に ECS インスタンスが作成されます。 DedicatedHostIdを指定しない場合、Alibaba Cloud がインスタンスの DDH を自動的に選択します。

規定値：default

インスタンス ID のリスト (InstanceId。

リクエスト ID。