Elastic Compute Service:CreateInstance

インスタンスのリージョン ID。 DescribeRegions を呼び出して最新のリージョンリストをクエリできます。

インスタンスの起動に使用するイメージの ID。Alibaba Cloud Marketplace イメージを使用するには、イメージ製品ページで ImageId を確認できます。ImageFamily を使用してイメージ ファミリーから最新の利用可能なイメージを選択しない場合、このパラメーターは必須です。

イメージ ファミリーの名前。このパラメーターを設定すると、指定されたイメージ ファミリーから最新の利用可能なイメージを取得してインスタンスを作成します。

• ImageId が指定されている場合、このパラメーターは設定できません。

• ImageId が指定されていない場合、このパラメーターを設定できます。

インスタンスタイプ。

• インスタンスタイプの選択: インスタンスファミリーを参照するか、 DescribeInstanceTypes を呼び出してターゲットインスタンスタイプのパフォーマンスデータをクエリしてください。インスタンスタイプ選択のベストプラクティスも参照して、インスタンスタイプの選択方法を確認できます。

• アクティブなリソースの確認: DescribeAvailableResource を呼び出して、特定のリージョンまたはゾーンのアクティブなリソースをクエリしてください。

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

インスタンスの名前。名前は 2～128 文字で、Unicode 文字カテゴリの文字（英語および中国語の文字を含む）と数字を含めることができます。名前にはコロン (:)、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。このパラメーターが指定されていない場合、デフォルト値はインスタンス ID です。

ネットワーク使用量の課金方法。有効な値:

• PayByBandwidth: 帯域幅課金。

• PayByTraffic (デフォルト): トラフィック課金。

自動更新を有効にするかどうかを指定します。このパラメーターは InstanceChargeType が PrePaid に設定されている場合にのみ有効です。有効な値:

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

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

自動更新期間。このパラメーターは AutoRenew が True に設定されている場合に必須です。

PeriodUnit が Month に設定されている場合、AutoRenewPeriod の有効な値は 1、2、3、6、12 です。

最大インバウンドパブリック帯域幅（Mbit/s 単位）。有効な値:

• 購入したアウトバウンド帯域幅が 10 Mbit/s 以下の場合: 1～10。デフォルト値: 10。

• 購入したアウトバウンド帯域幅が 10 Mbit/s を超える場合: 1～InternetMaxBandwidthOut の値。デフォルト値: InternetMaxBandwidthOut の値。

最大アウトバウンドパブリック帯域幅（Mbit/s 単位）。有効な値: 0～100。

デフォルト値: 0。

サーバーのホスト名。

• ホスト名はピリオド (.) またはハイフン (-) で開始または終了できず、連続するピリオドまたはハイフンを含めることはできません。

• Windows インスタンス: ホスト名は 2～15 文字で、ピリオド (.) を含めることはできず、数字のみで構成することはできません。大文字と小文字の英字、数字、ハイフン (-) を含めることができます。

• その他のインスタンス（Linux など）: ホスト名は 2～64 文字で、複数のピリオド (.) を含めることができます。ピリオドで区切られた各セグメントには、大文字と小文字の英字、数字、ハイフン (-) を含めることができます。

インスタンスのパスワード。パスワードは 8～30 文字で、大文字、小文字、数字、特殊文字のうち少なくとも 3 種類を含める必要があります。以下の特殊文字がサポートされています:

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

以下の点に注意してください:

• セキュリティのため、Password パラメーターが指定されている場合は HTTPS を使用してリクエストを送信してください。

• Windows インスタンスの場合、パスワードはスラッシュ (/) で開始できません。

• 特定のオペレーティングシステムを実行するインスタンスでは、パスワードはサポートされていません。キーペアのみがサポートされます。例: Others Linux および Fedora CoreOS。

イメージにプリセットされたパスワードを使用するかどうかを指定します。このパラメーターを使用する場合、Password パラメーターは空にする必要があります。イメージにパスワードが設定されていることを確認してください。

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

デプロイメントセット内のインスタンスのグループ番号。このパラメーターは、デプロイメントセットが高可用性グループ戦略 (AvailabilityGroup) を使用している場合にのみ有効です。有効な値: 1～7。

インスタンスのゾーン ID。詳細については、 DescribeZones を呼び出してゾーンリストをクエリしてください。

デフォルト値: 空。システムがゾーンを自動的に選択します。

インスタンスのクラスター ID。

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

仮想ローカルエリアネットワーク ID。

インスタンスの内部 IP アドレス。

システムディスクのサイズ（GiB 単位）。有効な値:

• 基本ディスク: 20～500

• その他のディスクタイプ: 20～2048

このパラメーターの値は max{20, ImageSize} 以上である必要があります。

デフォルト値: max{40, ImageSize}。

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

• cloud_efficiency: Ultra ディスク。

• cloud_ssd: 標準 SSD。

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

• cloud: 基本ディスク。

• cloud_auto: ESSD AutoPL ディスク。

• cloud_essd_entry: ESSD Entry ディスク。

廃止された I/O 最適化されていないインスタンスタイプの場合、デフォルト値は cloud です。その他のインスタンスタイプの場合、デフォルト値は cloud_efficiency です。

システムディスクの名前。名前は 2～128 文字で、Unicode 文字カテゴリの文字（英語および中国語の文字と数字を含む）を含めることができます。名前にはコロン (:)、アンダースコア (_)、ピリオド (.)、またはハイフン (-) を含めることができます。

デフォルト値: 空。

システムディスクの説明。説明は 2～256 文字で、http:// または https:// で開始できません。

デフォルト値: 空。

システムディスクとして使用される ESSD (エンタープライズ SSD) のパフォーマンスレベル (PL)。このパラメーターの設定は、ディスクカテゴリが標準 SSD でない場合にのみ適用されます。有効な値:

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

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

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

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

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

インスタンスの説明。説明は 2～256 文字で、http:// または https:// で開始できません。

デフォルト値: 空。

vSwitch ID。VPC 接続インスタンスを作成する場合、このパラメーターは必須です。 DescribeVSwitches を呼び出して利用可能な vSwitch をクエリできます。

インスタンスの非公開 IP アドレス。IP アドレスは、指定された vSwitch (VSwitchId) の CIDR ブロック内の利用可能なアドレスである必要があります。

インスタンスが I/O 最適化されているかどうかを指定します。有効な値:

• none: I/O 最適化されていません。

• optimized: I/O 最適化されています。

廃止されたインスタンスタイプのデフォルト値は none です。

その他のインスタンスタイプのデフォルト値は optimized です。

Alibaba Cloud が提供する仮想マシンシステム構成（Windows: NTP および KMS。Linux: NTP および YUM）を使用するかどうかを指定します。

インスタンスの課金方法。有効な値:

• PrePaid: サブスクリプション。このパラメーターを PrePaid に設定する場合、アカウントがクレジット支払いまたは残高支払いをサポートしていることを確認してください。サポートしていない場合、InvalidPayMethod エラーが返されます。

• PostPaid (デフォルト): 従量課金。

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

PeriodUnit が Month に設定されている場合、Period の有効な値は 1、2、3、6、12 です。

サブスクリプション期間の単位。有効な値:

Month。

デフォルト値: Month。

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

インスタンスの入札ポリシー。このパラメーターは InstanceChargeType が PostPaid に設定されている場合にのみ有効です。有効な値:

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

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

• SpotAsPriceGo: インスタンスは購入時の市場価格が自動的に入札価格として使用されるスポットインスタンスです。

キーペアの名前。

インスタンスの最大時間単価。この値は小数点以下 3 桁まで指定できます。このパラメーターは SpotStrategy が SpotWithPriceLimit に設定されている場合にのみ有効です。

スポットインスタンスの保護期間（時間単位）。デフォルト値: 1。有効な値:

• 1: インスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間自動的にリリースされないことを保証します。1 時間後、システムは入札価格と市場価格を自動的に比較し、リソースの可用性を確認して、インスタンスを保持するか自動リリースするかを決定します。

• 0: インスタンスの作成後、Alibaba Cloud はインスタンスが 1 時間実行されることを保証しません。システムは入札価格と市場価格を自動的に比較し、リソースの可用性を確認して、インスタンスを保持するか自動リリースするかを決定します。

スポットインスタンスの中断モード。有効な値:

• Terminate: インスタンスは直接リリースされます。

• Stop: インスタンスは節約モードに入ります。

  節約モードの詳細については、従量課金インスタンスの節約モードを参照してください。

デフォルト値: Terminate。

インスタンス RAM ロールの名前。RAM API ListRoles を呼び出して、作成済みのインスタンス RAM ロールをクエリできます。

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

• Active: セキュリティ強化を有効にします。この値はパブリックイメージにのみ適用されます。

• Deactive: セキュリティ強化を無効にします。この値はすべてのイメージタイプに適用されます。

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

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

ドライランのみを実行するかどうかを指定します。有効な値:

• true: ドライランのみを実行します。システムは、必須パラメーターが指定されているか、リクエスト形式が有効か、サービス制限が満たされているか、指定された ECS リソースが利用可能かを確認します。確認に失敗した場合、対応するエラーが返されます。確認に成功した場合、DryRunOperation エラーコードが返されます。

• false (デフォルト): ドライランを実行し、リクエストを送信します。確認に成功した場合、インスタンスが作成されます。

専用ホストの ID。

DescribeDedicatedHosts を呼び出して専用ホスト ID のリストをクエリできます。

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

• Standard: 標準モード。詳細については、バースト可能インスタンスとはのパフォーマンス制約モードセクションを参照してください。

• Unlimited: 無制限版モード。詳細については、バースト可能インスタンスとはの無制限パフォーマンスモードセクションを参照してください。

インスタンスのリリース保護属性。ECS コンソールまたは DeleteInstance の呼び出しによるインスタンスのリリースを防止するかどうかを指定します。

• true: リリース保護を有効にします。

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

インスタンスが専用ホストに関連付けられているかどうかを指定します。有効な値:

• default: インスタンスは専用ホストに関連付けられていません。節約モードが有効なインスタンスが停止後に再起動された場合、元の専用ホストのリソースが不足していると、自動デプロイリソースプール内の別の専用ホストにデプロイされます。

• host: インスタンスは専用ホストに関連付けられています。節約モードが有効なインスタンスが停止後に再起動された場合、インスタンスは元の専用ホストに残ります。元の専用ホストのリソースが不足している場合、インスタンスの再起動は失敗します。

デフォルト値: default。

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

• default: 専用ホスト以外にインスタンスを作成します。

• host: 専用ホスト上にインスタンスを作成します。DedicatedHostId を指定しない場合、Alibaba Cloud がインスタンスの専用ホストを自動的に選択します。

デフォルト値: default。

ストレージセットの ID。

The maximum number of partitions in the storage set. Valid values: greater than or equal to 2.

Specifies whether to enable the access channel for instance metadata. Valid values:

• enabled: enabled.

• disabled: disabled.

Default value: enabled.

Specifies whether to forcefully use the security-hardened mode (IMDSv2) to access instance metadata. Valid values:

• optional: does not forcefully use the security-hardened mode.

• required: forcefully uses the security-hardened mode. After this value is set, instance metadata cannot be accessed in normal mode.

Default value: optional.

The private pool option for launching the instance. A private pool is generated when an elasticity assurance or capacity reservation takes effect. You can select a private pool when you start an instance. Valid values:

• Open: open mode. The system automatically matches an open private pool. If no matching private pool is available, the instance is launched using public pool resources. You do not need to set PrivatePoolOptions.Id.

• Target: specified mode. The instance is launched using the specified private pool. If the specified private pool is unavailable, the instance fails to launch. In this mode, you must specify the private pool ID. Set PrivatePoolOptions.Id to the private pool ID.

• None: does not use a private pool. The instance is launched without using any private pool.

Default value: None.

In any of the following scenarios, the private pool option can only be set to None or left empty:

• Creating a spot instance.

• Creating an ECS instance on a dedicated host.

The private pool ID, which is the ID of the elasticity assurance or capacity reservation.