Elastic Compute Service:CreateInstance

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

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

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

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

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

インスタンスタイプ。

• インスタンスタイプの選択: インスタンスファミリー を参照するか、DescribeInstanceTypes を呼び出して、ターゲットインスタンスタイプのパフォーマンスデータを照会します。インスタンスタイプ選択のベストプラクティス を参照して、インスタンスタイプの選択方法を学ぶこともできます。

• アクティブなリソースの確認: DescribeAvailableResource を呼び出して、特定のリージョンまたはゾーン内のアクティブなリソースを照会します。 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。

Elastic Compute サービスサーバーのホスト名。

• ホスト名の先頭または末尾をピリオド (.) またはハイフン (-) にすることはできず、連続したピリオドまたはハイフンを含めることはできません。

• Windows インスタンス: ホスト名は 2～15 文字で、ピリオド (.) を含めること、またはすべて数字にすることはできません。大文字と小文字、数字、およびハイフン (-) を含めることができます。

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

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

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

次の点に注意してください。

• セキュリティ上の理由から、Password パラメーターが指定されている場合は、HTTPS を使用してリクエストを送信することを推奨します。

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

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

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

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

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

インスタンスを作成するゾーンの ID。詳細については、DescribeZones を呼び出してゾーンリストを照会してください。

デフォルト値: 空。システムはゾーンを自動的に選択します。 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) のパフォーマンスレベル。システムディスクとして ESSD を作成するときにこのパラメーターを設定します。有効な値:

• 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 を照会できます。VPC 接続インスタンスを作成する前に、対応するリージョンに VPC を作成してください。

インスタンスのプライベート 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 に設定されている場合: 1、2、3、6、および 12。

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

Month。

デフォルト値: Month。

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

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

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

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

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

SSH キーペアの名前。

インスタンスの最大値時間単価。このパラメーターは最大 3 桁の 10 進数をサポートし、SpotStrategy が SpotWithPriceLimit にセットされている場合にのみ効果があります。

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

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

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

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

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

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

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

デフォルト値: Terminate。

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

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

• 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。

ストレージセット内の最大パーティション数。有効な値: 2 以上。

インスタンスメタデータへのアクセスチャンネルを有効にするかどうかを指定します。有効な値:

• enabled: アクセスチャンネルを有効にします。

• disabled: アクセスチャンネルを無効にします。

デフォルト値: enabled。

インスタンスメタデータへのアクセスにセキュリティ強化モード (IMDSv2) を強制的に使用するかどうかを指定します。有効な値:

• optional: セキュリティ強化モードを強制的に使用しません (オプション)。

• required: セキュリティ強化モードを強制的に使用します (必須)。この値がセットされると、通常モードではインスタンスメタデータにアクセスできません。

デフォルト値: optional。

インスタンスを起動するための非公開プールオプション。非公開プールは、エラスティシティ保証またはキャパシティ予約が効果を持った後に生成されます。インスタンスを起動するときに非公開プールを選択できます。有効な値:

• Open: オープンモード。システムはオープンな非公開プールを自動的にマッチングします。一致する非公開プールが利用できない場合、インスタンスはパブリックプールリソースを使用して起動されます。PrivatePoolOptions.Id をセットする必要はありません。

• Target: 指定モード。インスタンスは、指定された非公開プールの容量を使用して起動されます。指定された非公開プールが利用できない場合、インスタンスの起動は失敗します。このモードでは、非公開プール ID を指定する必要があります。PrivatePoolOptions.Id を非公開プールの ID にセットします。

• None: なしモード。インスタンスの起動に非公開プールは使用されません。

デフォルト値: None。

次のシナリオでは、非公開プールオプションは None にセットするか、空のままにすることしかできません。

• スポットインスタンスの作成。

• 専用ホスト上での ECS インスタンスの作成。

非公開プールの ID。エラスティシティ保証またはキャパシティ予約の ID。

プラットフォーム管理ホストの一意の ID (例: mh-f2d3647ca21****)。