:CreateInstance

実行する API 操作。 カスタム HTTP URL または HTTPS URL を使用して API リクエストを行う場合は、このパラメーターを指定する必要があります。 値を CreateInstance に設定します。

インスタンスのインスタンスタイプ。

• インスタンスタイプの選択：「インスタンスファミリー」を参照するか、もしくは DescribeInstanceTypes 操作を呼び出して、対象インスタンスタイプのパフォーマンスデータを照会するかで、または「インスタンスタイプの選択」を参照することで、インスタンスタイプの選択方法を調べられます。
• 使用可能な ECS インスタンスの照会：DescribeAvailableResource を呼び出して、指定されたリージョンまたはゾーンで使用可能なリソースを照会できます。

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

インスタンスの作成に使用されるイメージの ID。 Alibaba Cloud Marketplace のイメージを使用したい場合は、Alibaba Cloud Marketplace イメージの製品ページで ImageId を参照できます。 ImageFamily パラメーターを指定して最新の利用可能なカスタムイメージを選択しない場合、ImageIdを指定する必要があります。

イメージファミリーの名前。 このパラメーターを設定して、現在のイメージファミリーから最新の利用可能なカスタムイメージを選択してインスタンスを作成できます。

• ImageId が設定されている場合、ImageFamily は空である必要があります。
• ImageId が設定されていない場合、ImageFamily を指定できます。

インスタンスが属するセキュリティグループの ID。 同じセキュリティグループ内のインスタンスは、相互に通信できます。

インスタンスの名前。 名前の長さは 2〜128 文字で、英数字、コロン(:)、アンダースコア (_)、およびハイフン (-) を使用できます。 名前は英字で始める必要があります。http:// や https:// で始めることはできません。 このパラメーターが指定されていない場合、名前はデフォルトでインスタンス ID に設定されます。

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

• PayByBandwidth
• PayByTraffic

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

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

インスタンスの自動更新期間。 このパラメーターは、AutoRenew が true に設定されている場合に必要です。

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

インターネットからのインバウンド帯域幅の最大値。 単位：Mbit/s。有効値：

• 購入したアウトバウンド帯域幅が10 Mbit/s 以下の場合、InternetMaxBandwidthIn の有効な値は 1〜10 です。デフォルト値：10。
• 購入した送信帯域幅が 10 Mbit/s を超える場合、InternetMaxBandwidthIn の有効な値は 1〜InternetMaxBandwidthOut の値です。このパラメーターのデフォルト値は、InternetMaxBandwidthOutパラメーターと同じ値です。

インターネットへのアウトバウンド帯域幅の最大値。 単位：Mbit/s。有効値：0〜100。

デフォルト値：0。

インスタンスのホスト名。

• ホスト名の先頭と末尾の文字にはピリオド (.) またはハイフン (-) を指定できません。 ピリオド (.) やハイフン (-) を連続して使用することはできません。
• Windows インスタンス：ホスト名は 2〜15 文字で、英数字、およびハイフン (-) を使用できます。 ホスト名にピリオド (.) は使用できません。また、数字だけの名前は使用できません。
• 非 Windows インスタンス：ホスト名の長さは 2〜64 文字です。 ピリオド (.) を使用して、名前を複数のセグメントに分割できます。 各セグメントには、英数字、およびハイフン (-) を使用できます。

インスタンスのパスワード。 パスワードの長さは 8~30 文字です。 英大文字、英小文字、数字、および特殊文字 (次に示します) のうち、3 種類以上の文字種で構成されなければなりません。 特殊文字は次の通り：

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

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

イメージで事前定義されたパスワードを使用するかどうかを指定します。 PasswordInherit パラメーターを使用するには、Password パラメーターを空にし、選択したイメージにパスワードが設定されていることを確認する必要があります。

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

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

このパラメーターはデフォルトで空となります。 ゾーンを指定しない場合、システムはランダムにゾーンを選択します。

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

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

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

インスタンスのイントラネット IP アドレス。

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

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

デフォルト値は 40 またはイメージのサイズのいずれか大きい方です。

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

• cloud_efficiency：Ultra ディスク。
• cloud_ssd：SSD クラウドディスク。
• cloud：基本クラウドディスク。
• ephemeral_ssd：ローカル SSD。

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

インスタンスに接続されているシステムディスクの名前。 名前の長さは 2〜128 文字で、英数字、コロン(:)、アンダースコア (_)、およびハイフン (-) を使用できます。 名前は英字で始める必要があります。http:// や https:// で始めることはできません。

このパラメーターはデフォルトで空となります。

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

このパラメーターはデフォルトで空となります。

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

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

詳細については、「ESSD クラウドディスク」をご参照ください。

データディスク 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_efficiency：Ultra ディスク。
• cloud_ssd：SSD クラウドディスク。
• ephemeral_ssd：ローカル SSD。
• cloud_essd：ESSD。
• cloud：基本クラウドディスク。

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

データディスク N の名前。名前の長さは 2〜128 文字で、英数字、コロン(:)、アンダースコア (_)、およびハイフン (-) を使用できます。 名前は英字で始める必要があります。http:// や https:// で始めることはできません。

このパラメーターはデフォルトで空となります。

データディスク N の説明。説明は、長さが 2〜256 文字である必要があります。http:// または https:// で始めることはできません。

このパラメーターはデフォルトで空となります。

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

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

デフォルト値：true。

データディスク N を暗号化するかどうかを指定します。

デフォルト値：false。

ディスクで使用される KMS キーの ID。

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

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

詳細については、「ESSD クラウドディスク」をご参照ください。

ノードコントローラーの ID。

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

このパラメーターはデフォルトで空となります。

VSwitch の ID。 VPC タイプのインスタンスを作成するときに、このパラメーターを指定する必要があります。

インスタンスのプライベート IP アドレス。 プライベート IP アドレスは、VSwitch の空き CIDR ブロックの範囲内にある必要があります。

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

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

フェーズアウトされたインスタンスタイプの場合、デフォルト値は none です。 詳細については、「フェーズアウトしたインスタンスタイプ」をご参照ください。

それ以外のインスタンスタイプの場合、デフォルト値は optimized です。

Alibaba Cloud によって提供される仮想マシンシステム構成を使用するかどうかを指定します (Windows：NTP と KMS。 Linux：NTP と YUM)。

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

• PrePaid：サブスクリプション。 このパラメーターを PrePaid に設定する場合は、アカウントに十分な残高があることを確認してください。 残高が不足した場合、InvalidPayMethod エラーが返されます。
• PostPaid： 従量課金。

インスタンスのサブスクリプション期間。 単位：月。 有効値：

PeriodUnit が Month に設定されている場合、Period の有効な値は 1、2、3、4、5、6、7、8、9、12、24、36、48、および 60 です。

• このパラメーターは InstanceChargeType が PrePaid に設定されている場合にのみ有効であり必須です。
• DedicatedHostId パラメーターが指定されている場合、インスタンスのサブスクリプション期間は、専用ホストのサブスクリプション期間より長くすることはできません。

サブスクリプション期間の単位。

値を Month に設定します。

タグ N の値。

タグ N のキー。

インスタンス、ディスク、およびプライマリネットワークインターフェースのタグ N のキー。 N の有効値：1〜20。 空の文字列にすることはできません。 タグキーの長さは、最大 128 文字です。 http:// または https:// を含むことはできず、acs: または aliyun で始めることはできません。

インスタンス、ディスク、およびプライマリネットワークインターフェースのタグ N の値。 N の有効値：1〜20。 空の文字列にすることが可能です。 タグの値の長さは、最大 128 文字です。 http:// または https:// を含むことはできず、acs: または aliyun で始めることはできません。

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

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

• NoSpot：通常の従量課金インスタンス。
• SpotWithPriceLimit：ユーザー定義の上限価格のあるプリエンプティブルインスタンス。
• SpotAsPriceGo：価格が現在の市場価格に従うプリエンプティブルインスタンス。

キーペアの名前。

• Windows インスタンスの場合、このパラメーターは無視され、デフォルトで空となります。 たとえ KeyPairName パラメーターが指定されていたとしても、Password パラメーターが有効になります。
• Linux インスタンスの場合、ユーザー名とパスワードの認証方法はデフォルトで無効になっています。 インスタンスのセキュリティを向上させるには、接続に SSH キーペアを使用することを推奨します。

インスタンスの 1 時間当たり価格の最大値。 このパラメーターは、SpotStrategy が SpotWithPriceLimit に設定されている場合にのみ有効です。 小数点第 3 位まで指定できます。

プリエンプティブルインスタンスの保持期間。 単位：時間。 有効値：1、2、3、4、5、および 6。

デフォルト値：1。

プリエンプティブルインスタンスの中断モード。 Terminate モードのみがサポートされており、このモードではインスタンスがリリースされます。 デフォルト値：Terminate。

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

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

• Active：セキュリティ強化を有効化します。 この値は、システムイメージにのみ適用されます。
• Deactive：セキュリティ強化を無効化します。 この値はすべてのイメージタイプに適用されます。

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

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

このリクエストをチェックするだけかどうかを指定します。 デフォルト値：false。 有効値：

• true：リクエストはチェックされますが、インスタンスは作成されません。 チェック項目には、リクエスト形式、サービス制限、使用可能な ECS リソース、および必須パラメーターが指定されているかどうかが含まれます。 チェックが失敗した場合、対応するエラーコードが返されます。 チェックが成功した場合、エラーコード DryRunOperation が返されます。
• false：リクエストがチェックされ、チェックが成功するとインスタンスが作成されます。

ECS インスタンスの専用ホストの ID。

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

DedicatedHostId パラメーターが指定されている場合、SpotStrategy および SpotPriceLimit パラメーターは無視されます。 これは、専用ホストではプリエンプティブルインスタンスを作成できないからです。

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

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

このパラメーターはデフォルトで空となります。

インスタンスのリリース保護プロパティ。 インスタンスを ECS コンソールで、または DeleteInstance 操作でリリースできるかどうかを指定します。 デフォルト値：false。 有効値：

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

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

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

デフォルト値：default。

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

• default：非専用ホストにインスタンスを作成します。
• host：専用ホストにインスタンスを作成します。 DedicatedHostId を指定しない場合、Alibaba Cloud は、インスタンスをデプロイする専用ホストを自動的に選択します。

デフォルト値：default。

ストレージセットの ID。

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

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

• enabled
• disabled

デフォルト値：enabled。

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

• optional：セキュリティ強化モード (IMDSv2) を強制的に使用しません。
• required：セキュリティ強化モード (IMDSv2) を強制的に使用します。 このパラメーターを required に設定すると、通常モードでインスタンスメタデータにアクセスできなくなります。

デフォルト値：optional。