RunInstances

作成する SLB インスタンスのリージョン ID です。 DescribeRegionsを呼び出すと、最新のリージョンリストを照会できます。

実行する API HTTP および HTTPS メソッドを使用する API リクエストの場合、Action パラメーターが必要になります。 値を RunInstances に設定します。

インスタンスのゾーン ID 。 DescribeZones を呼び出すと、ゾーンリストを照会できます。

デフォルトでは、システムによってランダムに割り当てられます。

インスタンスの作成に使用されるイメージの ID。 DescribeImages を呼び出すと、利用可能なイメージを表示できます。 LaunchTemplateId または LaunchTemplateName パラメーターを指定しないで起動テンプレートを設定するには、ImageId パラメーターを指定する必要があります。

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

LaunchTemplateId または LaunchTemplateName パラメーターを指定しないで、起動テンプレートを設定するには、SecurityGroupIdパラメーターを指定する必要があります。

インスタンスが属するセキュリティグループの ID 。 N の有効な値は、インスタンスが属することができるセキュリティグループの最大数に基づいています。 詳細については、「セキュリティグループの制限事項」をご参照ください。

VSwitch の ID。 VPC でインスタンスを作成するときに必要です。 VSwitch とセキュリティグループは同じ VPC である必要があります。

インスタンスのタイプ。 詳細は、インスタンスファミリーを参照するか、DescribeInstanceTypesを呼び出して、最新のインスタンスタイプを照会してください。

LaunchTemplateId または LaunchTemplateName パラメーターを指定しないで起動テンプレートを設定するには、InstanceTypeパラメーターを指定する必要があります。

<td class="en-UStry align-left colsep-1 rowsep-1">最大インバウンドパブリック帯域幅。 </td> 単位：Mbit/s。 有効値：1~200。

デフォルト値 : 200

<td class="en-UStry align-left colsep-1 rowsep-1">最大アウトバウンドパブリック帯域幅。 </td> 単位：Mbit/s。 有効値：0~100。

デフォルト値：0

インスタンスの名前。 名前の長さは 2~128 文字で、英字で始まる必要があります。先頭文字列は http:// または https:// にすることはできません。 英数字、コロン (:)、アンダースコア (_)、ピリオド (.) およびハイフン (-) を使用できます。 デフォルト値：インスタンスのID (InstanceId)。

サフィックス (name_suffix) をインスタンス名またはホスト名に追加しないが、name_prefix[begin_number,bits]形式を使用する場合、UniqueSuffix パラメーターは無視されます。 たとえば、 InstanceNameを instance-[99,3]に設定し、 UniqueSuffixをtrueに設定すると、結果のインスタンス名は、instance099001 ではなく instance099になります。

インスタンスのホスト名

• 文頭および文末をピリオド (.) やハイフン (-) にすることはできません。 また、ピリオド (.) やハイフン (-) を連続して使用することはできません。
• Windows では、ホスト名の長さは 2~15 文字である必要があります。 ホスト名にピリオド（.）を含めたり、数字のみを含めたりすることはできません。 英数字、およびハイフン (-) を使用できます。
• Linux などの他の OS の場合：ホスト名は 2~64 文字の長さにする必要があります。 ピリオド (.) でセグメントを区切ることができます。 各セグメントには、英数字、およびハイフン（-）を含めることができます。

サフィックス (name_suffix ) をインスタンス名またはホスト名に追加しないが、 name_prefix[begin_number,bits] 形式を使用する場合、UniqueSuffix パラメーターは無視されます。 たとえば、 InstanceNameを instance-[99,3]に設定し、UniqueSuffixを trueに設定すると、結果のインスタンス名は instance099001 ではなく、instance099になります。

連続したサフィックスをホスト名 (HostName) とインスタンス名 (InstanceName ) に追加するかどうかを指定します。 連続したサフィックス の範囲は 001～999 です。 たとえば、名前にはLocalHost001と LocalHost002、およびMyInstance001 と MyInstance002 を使用できます。

デフォルト値：false

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

イメージで事前定義されたパスワードを使用するかどうかを指定します。

インスタンスのパスワード。 パスワードの長さは 8~30 文字である必要があります。 大文字、小文字、数字、および次のような特殊文字の 3 種類以上の文字で構成されなければなりません。 特殊文字：

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

Windows インスタンスのパスワードは、スラッシュ (/) で始めることはできません。

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

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

このパラメーターの値は、少なくとも 20 GiB、またはイメージのサイズ以上である必要があります。

デフォルト値：40 またはイメージのサイズ (どちらか大きい方)。

システムディスクの名前。 名前の長さは 2~128 文字である必要があります。 名前は英字で始まる必要がありますが、先頭文字列は http:// または https:// にすることはできません。 英数字、ピリオド (.)、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

デフォルト値 : null 。

システムディスクのカテゴリ。 有効値：

• cloud：ベーシックディスク
• cloud_efficiency：Ultra ディスク
• cloud_ssd: SSD クラウドディスク

フェーズアウトされたインスタンスタイプの非 I/O 最適化インスタンスの場合、デフォルト値は cloud です。 それ以外のインスタンス場合、デフォルト値は cloud_efficiency です。

N 番目のデータディスクのサイズ。 N の有効値：1~16。 単位：GiB。 有効値：

• cloud_efficiency: 20~32768
• cloud_ssd: 20~32768
• cloud_essd：20~32768
• ephemeral_ssd: 5~800
• cloud：5~2000

このパラメーターの値は、SnapshotId パラメーターで指定されたスナップショットのサイズ以上にする必要があります。

N 番目のデータディスクの作成に使用されたスナップショットの ID。 N の有効値：1~16。

DataDisk.N.SnapshotId パラメーターが指定されている場合、DataDisk.N.Size パラメーターは無視され、作成されたディスクのサイズは、指定されたスナップショットのサイズになります。 2013 年 7 月 15 日以前に作成されたスナップショットはここでは使用できません。 それ以外の場合、エラーが返され、リクエストは拒否されます。

N 番目のデータディスクのカテゴリ。 有効値：

• cloud：ベーシックディスク
• cloud_efficiency：Ultra ディスク。
• cloud_ssd: SSD クラウドディスク
• ephemeral_ssd: ローカル SSD
• cloud_essd: ESSD クラウドディスク

I/O 最適化インスタンスの場合、デフォルト値は cloud_efficiency です。 非 I/O 最適化インスタンスの場合、デフォルト値は cloud です。

N 番目のデータディスクが暗号化されるかどうかを指定します。

デフォルト値：false

N番目のデータディスクに対応する KMS キー ID。

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

インスタンスとともに N 番目のデータディスクがリリースされるかどうかを指定します。

デフォルト値：true

セカンダリ ENI のプライマリ IP アドレス。 N の有効値：1。

デフォルト値は、ENI が属する VSwitch の CIDR ブロック内からランダムに選択される IP アドレスです。

セカンダリ ENI が属する VSwitch の ID。 N の有効値：1。

デフォルト値は、ECS インスタンスが属する VSwitch の ID です。

セカンダリ ENI が属するセキュリティグループの ID。 SecurityGroupIds.N の N の有効な値は、ENI が属することができるセキュリティグループの最大数に基づいています。 詳細については、「セキュリティグループの制限事項」をご参照ください。

N 番目のデータディスクに適用される自動スナップショットポリシーの ID。

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

N 番目のデータディスクの名前。 名前の長さは 2~128 文字で、英字で始まる必要があります。先頭文字列は http:// または https:// にすることはできません。 英数字、ピリオド (.)、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

デフォルト値 : null 。

セカンダリ ENI の名前。 N の有効値：1。

セカンダリ ENI の説明。 N の有効値：1。 説明は、長さが 2 ~ 256 文字である必要があります。先頭文字列は http:// または https:// にすることはできません。

キーペアの名前。

• Windows ECS インスタンスの場合、このパラメーターは無視されます。 デフォルト値 : null 。 Password パラメーターは、KeyPairName パラメーターが指定されている場合でも有効です。
• Linux ECS インスタンスの場合、ユーザー名とパスワードの認証方法はデフォルトで無効になっています。

インスタンスが I/O 最適化されているかを指定します。 たとえば、フェーズアウトされたインスタンスタイプの場合、デフォルト値は none です。 それ以外のインスタンスの場合、デフォルト値は optimized です。 有効値：

• none : インスタンスは I/O 最適化インスタンスではありません。
• optimized：インスタンスは I/O 最適化インスタンスです。

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

インスタンスの RAM ロール名。 RAM によって提供されるListRoles を呼び出すと、作成した RAM ロールを照会できます。

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

デフォルト値：1

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

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

プリエンプティブルインスタンスの最高額/時。 小数点以下 3 桁まで正確であり、 SpotStrategy が SpotWithPriceLimit に設定されている場合に有効です。

プリエンプティブインスタンスの中断モード。 有効なデフォルト値：Terminate。インスタンスがリリースされたことを示します。

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

• NoSpot：通常の従量課金インスタンス。
• SpotWithPriceLimit：ユーザー定義最高額/時のプリエンプティブルインスタンス。
• SpotAsPriceGo：購入時の市場価格で設定されたプリエンプティブルインスタンス。

バースト可能インスタンスのパフォーマンスモード。 有効値：

• 標準：標準モード。 詳細については、「バースト可能インスタンス」の「標準モード」セクションをご参照ください。
• Unlimited：無制限モード。 詳細については、「バースト可能インスタンス」の「無制限モード」セクションをご参照ください。

デフォルト値 : null 。

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

インスタンス、ディスク、およびプライマリ ENI の N 番目のタグのキー。 N の有効値：1～20。 空の文字列は使用不可です。 長さは 128 文字以内である必要があり、先頭文字列を aliyun または acs: にすることはできません。 http:// または https:// を含めることはできません。

インスタンス、ディスク、およびプライマリ ENI の N 番目のタグの値。 N の有効値：1～20。 空の文字列も使用可能です。 長さは 128 文字以内である必要があり、先頭文字列を aliyun または acs: にすることはできません。 http:// または https:// を含めることはできません。

インスタンスの専用ホストの ID。 専用ホストでプリエンプティブルインスタンスを作成することはできません。 したがって、DedicatedHostId パラメーターを指定した後、システムは自動的にリクエストの SpotStrategy と SpotPriceLimit の設定を無視します。

DescribeDedicatedHosts を呼び出すと、専用ホストのリストを照会できます。

セキュリティ強化を有効にするかどうかを指定します。 有効値：

• Active：パブリックイメージのセキュリティ強化を有効にします。
• Deactive：すべてのイメージタイプのセキュリティ強化を無効にします。

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

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

起動テンプレートのバージョン。 LaunchTemplateId またはLaunchTemplateName を指定するとき、起動テンプレートのバージョンではない場合、デフォルトのテンプレートバージョンが使用されます。

起動テンプレートの ID。 詳細については、 DescribeLaunchTemplatesを呼び出してください。

LaunchTemplateId または LaunchTemplateName を指定して、起動テンプレートを設定する必要があります。

起動テンプレートの名前。 LaunchTemplateId または LaunchTemplateName を指定して、起動テンプレートを設定する必要があります。

インスタンスのリリース保護を有効にするかどうかを指定します。 ECS コンソールでインスタンスのリリースが可能か、またはDeleteInstanceでインスタンスのリリースが可能かを指定します。 デフォルト値 : false 。 有効値：

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

インスタンスが自動的にリリースされた時刻。 ISO 8601 標準時の時刻を、yyyy-MM-ddTHH:mm:ssZ 形式で指定します。 時刻は UTC である必要があります。

• 秒フィールドの値 (ss) が00 でなければ、時刻は自動的に現在時刻の分 (mm) に設定されます。
• 現在の時刻の少なくとも 30 分後にする必要があります。
• 自動リリースの時間は、現在の時刻から 3 年未満である必要があります。

インスタンスのサブスクリプション期間。 単位：月。 このパラメーターは、InstanceChargeType パラメーターの値がPrePaid の場合にのみ有効で、必須です。 DedicatedHostIdパラメーターが指定されている場合、指定された期間は、インスタンスをホストする専用ホストのサブスクリプション期間を超えることはできません。 有効値：

• PeriodUnit パラメーターが Month に設定されている場合：1、2、3、4、5、6、7、8、9、12、24、36、48、および 60。

ネットワーク使用量の課金方法。 デフォルト値 : PayByTraffic 有効値：

• PayByBandwidth：帯域幅課金
• PayByTraffic：トラフィック課金

サブスクリプション期間の単位。 デフォルト値：Month 。 有効値：

• Month

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

• PeriodUnit パラメーターが Month に設定されている場合：1、2、3、6、12、24、36、48、および 60。

デフォルト値：1

インスタンスの自動更新を有効にするかどうかを指定します。 このパラメーターは、InstanceChargeType パラメーターの値がPrePaid に設定されている場合にのみ有効です。 デフォルト値 : false 。 有効値：

• true：インスタンスの自動更新を有効にします。
• false：インスタンスの自動更新を無効にします。

インスタンスの課金方法です。 デフォルト値：PostPaid。 有効値：

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

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

ENI 用にランダムに生成された IPv6 アドレスの数。

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

VPC タイプの ECS インスタンスにプライベート IP アドレスを割り当てるには、IP アドレスが、VSwitchIdで指定された VSwitch の CIDR ブロック内のアイドル IP アドレスであることを確認してください 。

ENI に割り当てられた N 番目の IPv6 アドレス。 N の有効値：1。 例：Ipv6Address.1=2001:db8:1234:1a00::***.

この要求だけを確認するかどうかを指定します。 有効値：

• true：要求は確認され、インスタンスは作成されません。 確認項目は、必須パラメーター、要求形式、サービス制限、および利用可能な ECS リソースです。 確認が失敗した場合、対応するエラーコードが返されます。 確認が成功した場合、DryRunOperationが返されます。
• false：要求が確認され、確認が成功するとインスタンスが作成されます。 デフォルト値 : false 。

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確実にする必要があります。ClientToken パラメーターには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。 詳細は、「べき等性を確保する方法」をご参照ください。

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

• PL1：単一の ESSD が最大 50,000 のランダムな読み取り/書き込み IOPS を提供します。
• PL2：単一の ESSD が最大 100,000 のランダムな読み取り/書き込み IOPS を提供します。
• PL3：単一の ESSD が最大 1,000,000 のランダムな読み取り/書き込み IOPS を提供します。

ESSD パフォーマンスレベルの詳細については、「Enhanced SSD (ESSD)」をご参照ください。

システムディスクとして使用される ESSD のパフォーマンスレベル。 デフォルト値 : 1。 有効値：

• PL1：単一の ESSD が最大 50,000 のランダムな読み取り/書き込み IOPS を提供します。
• PL2：単一の ESSD が最大 100,000 のランダムな読み取り/書き込み IOPS を提供します。
• PL3：単一の ESSD が最大 1,000,000 のランダムな読み取り/書き込み IOPS を提供すします。

ESSD パフォーマンスレベルの詳細については、「Enhanced SSD (ESSD)」をご参照ください。

システムディスクに適用される自動スナップショットポリシーの ID。

専用ホストにインスタンスを作成するかどうかを指定します。 有効値：

• default：非専用ホストにインスタンスを作成します。
• host：専用ホストにインスタンスを作成します。 DedicatedHostId パラメーターを指定しない場合、ECS はインスタンスの専用ホストを自動的に選択します。

デフォルト値：default

専用ホスト上のインスタンスを専用ホストに関連付けるかどうかを指定します。 有効値：

• default：インスタンスは専用ホストに関連付けられません。 停止済みインスタンスの非課金化 (VPC 接続) 機能が有効になっていると、停止後にインスタンスを再起動したときに、元の専用ホストのリソースが不十分な場合に、自動デプロイリソースプール内の別の専用ホストに自動的にデプロイされます。
• host：インスタンスは専用ホストに関連付けられます。 停止済みインスタンスの非課金化 (VPC 接続) 機能が有効になっていると、停止後にインスタンスを再起動しても、元の専用ホストのままです。 元の専用ホストのリソースが不十分な場合、インスタンスの再起動は失敗します。

デフォルト値：default

セカンダリ ENI が属するセキュリティグループの ID 。 N の有効値：1。

デフォルト値は、インスタンスが属するセキュリティグループの ID です。

CPU コア数。 このパラメーターは指定できませんが、デフォルト値のみを使用します。

デフォルト値については、「CPU オプションをカスタマイズする」をご参照ください。

CPU スレッド数。 ECS インスタンスの vCPU の数は次のように計算されます。ECS インスタンスの vCPU の数= CpuOptions.Core 値 × CpuOptions.ThreadPerCore値

• CpuOptions.ThreadPerCoreの値が 1 に設定されている場合、CPU ハイパースレッドが無効になっています。
• このパラメーターは、いくつかのインスタンスタイプにのみ適用されます。

有効な値とデフォルト値については、「CPU オプションをカスタマイズする」をご参照ください 。