すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:RunInstances

最終更新日:Apr 04, 2026

この API は、Elastic Compute Service (ECS) インスタンスを一括で作成するために使用され、自動起動、パブリック IP アドレスの割り当て、自動リリース時刻の設定をサポートします。

操作説明


この API を使用する前に、ECS プロダクトの課金方法とその料金を十分に理解していることを確認してください。

この API は非同期です。インスタンス作成のリクエストが成功すると、インスタンス ID がすぐに返されます。ただし、インスタンスの作成と起動は即座に完了するわけではありません。DescribeInstanceStatus を呼び出してインスタンス情報を確認できます。レスポンスのステータスが Running になると、インスタンスが正常に作成され、起動したことを示します。

前提条件

  • リソース在庫が不足しているためにリクエストされたインスタンスを作成できない場合、Alibaba Cloud はインスタンス作成失敗 (SystemFailure.Delete) を示すシステムイベントを直ちに送信します。DescribeInstanceHistoryEvents を使用して、このようなイベントを確認できます。詳細については、「インスタンス作成失敗イベント」をご参照ください。

  • 作成するインスタンスの総数、またはすべてのインスタンスタイプにわたる vCPU の合計数がシステムのクォータを超えないようにしてください。詳細については、「クォータセンター」をご参照ください。

  • Virtual Private Cloud (VPC) タイプのインスタンスを作成する前に、対応する Alibaba Cloud リージョンに事前に VPC を作成してください。詳細については、「VPC の作成」をご参照ください。

注意事項

  • インスタンスの課金方法がサブスクリプション (PrePaid) の場合、支払い時に利用可能なクーポンがデフォルトで自動的に適用されます。

  • 1 回のリクエストで最大 100 個のインスタンスを作成できます。100 個を超えるインスタンスを作成する必要がある場合は、リクエストをバッチに分割するか、同時呼び出しを行うことを推奨します。

  • パラメーター InternetMaxBandwidthOut の値が 0 より大きい場合、パブリック IP アドレスがインスタンスに自動的に割り当てられます。

説明

1 つの Alibaba Cloud アカウントが 1 つのリージョンで帯域幅課金で請求されるインターネット帯域幅の合計ピーク値には制限があります。詳細については、「インターネット帯域幅の制限」をご参照ください。

推奨事項

  • テストシナリオDryRun=true を設定して、ドライランリクエストを送信できます。

  • インスタンスのリリースAutoReleaseTime パラメーターを使用して自動リリース時刻を設定するか、DeleteInstances を呼び出してインスタンスを手動でリリースできます。

  • 管理と検索:起動するインスタンスの各バッチにタグ (Tag.N.KeyTag.N.Value) を割り当て、ホスト名 (HostName) とインスタンス名 (InstanceName) に逐次サフィックス (UniqueSuffix) を追加することを推奨します。詳細については、「インスタンス名またはホスト名の連番一括設定」をご参照ください。

  • 起動テンプレート:起動テンプレートを使用すると、インスタンス作成時に多数の構成パラメーターを繰り返し指定する必要がなくなります。CreateLaunchTemplate で起動テンプレートを作成した後、RunInstances リクエストで LaunchTemplateIdLaunchTemplateVersion を指定してテンプレートを使用できます。

  • ハイパースレッディングの無効化:メモリ集約型のシナリオでは、CpuOptions.ThreadsPerCore=1 を設定してハイパースレッディングを無効にすることで、メモリと vCPU の比率を向上させることができます。

  • ジャンボフレームの有効化:インスタンス作成時に NetworkOptions.EnableJumboFrame=true を設定することで、ジャンボフレーム機能を有効にできます。詳細については、「ECS インスタンスの MTU」をご参照ください。

リクエスト例

中国 (杭州) リージョンに複数の ECS インスタンスを作成するとします。特定のイメージ、インスタンスタイプ、セキュリティグループ、vSwitch を使用し、特定の容量のシステムディスクとデータディスクを構成し、パブリック IP アドレスを割り当て、インスタンス名とパスワードを設定します。対応するリクエストパラメーターは次のとおりです:

RegionId:"cn-hangzhou", // リージョンを中国 (杭州) に設定
ImageId:"aliyun_3_x64_20G_alibase_20221102.vhd", // イメージ ID を設定
InstanceType:"ecs.g7.large", // インスタンスタイプを設定
SecurityGroupId:"sg-bp150uqocpf9jj70****", // セキュリティグループ ID を設定
VSwitchId:"vsw-bp1qo7s91cbch5i4l****", // vSwitch ID を設定
SystemDisk:{
  Category:"cloud_essd", // システムディスクのカテゴリを ESSD (エンタープライズ SSD) に設定
  Size:40, // システムディスクのサイズを 40 GiB に設定
},
DataDisk:[
  {
    Category:"cloud_essd", // データディスクのカテゴリを ESSD (エンタープライズ SSD) に設定
    Size:100, // データディスクのサイズを 100 GiB に設定
  }
],
HostName:"ECS-test", // インスタンスのホスト名を設定
Password:"ECS@test1234", // ログインパスワードを設定
InternetMaxBandwidthOut:10 // パブリックアウトバウンドトラフィックを 10 Mbit/s に設定

上記の設定に基づいて、さまざまなタイプのインスタンスを作成します:

例:自動更新サブスクリプションインスタンスを 5 台作成

Amount:5, // 5 台のインスタンスを作成
InstanceChargeType:"PrePaid", // サブスクリプション課金を示す
PeriodUnit:"Month", // 期間の単位を「月」に設定
Period:1, // サブスクリプション期間を 1 か月に設定
AutoRenew:true, // 自動更新を有効にする
AutoRenewPeriod:1 // 自動更新期間を 1 か月に設定

例:従量課金インスタンスを 10 台作成

Amount:10, // 10 台のインスタンスを作成
InstanceChargeType:"PostPaid", // 従量課金を示す
SpotStrategy:"NoSpot" // デフォルト値、標準の従量課金を示す

例:入札戦略と保持期間を指定してスポットインスタンスを 20 台作成

Amount:20, // 20 台のインスタンスを作成
InstanceChargeType:"PostPaid",
SpotStrategy:"SpotAsPriceGo", // 市場価格に基づく入札を示す
SpotDuration:1 // スポットインスタンスの保持期間を 1 時間に設定

CreateLaunchTemplate を使用して起動テンプレートをすでに作成しており、このテンプレートを使用して中国 (杭州) リージョンにいくつかの ECS インスタンスを作成したいとします。例は次のとおりです:

例:起動テンプレートを使用して 10 台の ECS インスタンスを作成

RegionId:"cn-hangzhou", // リージョンを中国 (杭州) に設定
Amount:10, // 10 台のインスタンスを作成
LaunchTemplateId:"lt-bp14xczpoxvb6rre****" // 起動テンプレート ID を指定
重要 インスタンスパラメーターとテンプレートパラメーターの両方が指定されている場合、インスタンスパラメーターが優先されます。たとえば、テンプレートの課金方法がサブスクリプションであっても、InstanceChargeTypePostPaid に設定されている場合、作成されるインスタンスは従量課金インスタンスになります。

例:完全なイメージ (システムディスクとデータディスクの両方を含むカスタムイメージ) を使用して 1 台のインスタンスを作成

RegionId:"cn-hangzhou", // リージョンを中国 (杭州) に設定
ImageId = m-bp13ohd32cvzpq9e****, // カスタムイメージ ID
InstanceType = ecs.u1-c1m1.large, // インスタンスタイプ
SecurityGroupId = sg-bp10jztp6b0sdsyl****, // セキュリティグループ ID
VSwitchId = vsw-bp19wo63nleroq22g****, // vSwitch ID
SystemDisk.Size = 50, // 完全なイメージに含まれるシステムディスクのサイズを設定
SystemDisk.Category = cloud_auto, // 完全なイメージに含まれるシステムディスクのディスクカテゴリを設定
DataDisk.0.Device = /dev/xvdb, // 完全なイメージに含まれるデータディスクのマウントポイントを設定
DataDisk.0.Size = 50, // 完全なイメージに含まれるデータディスクのサイズを設定
DataDisk.0.Category = cloud_essd, // 完全なイメージに含まれるデータディスクのディスクカテゴリを設定
DataDisk.1.Device = /dev/xvdc, // 追加のデータディスクのマウントポイント。完全なイメージに含まれるデータディスクを置き換えるには、DataDisk.1.Device = /dev/xvdb (完全なイメージのデフォルトのマウントポイント) を設定します。
DataDisk.1.Size = 70, // 追加のデータディスクのサイズ
DataDisk.1.Category = cloud_auto, // 追加のデータディスクのディスクカテゴリ

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:RunInstances

create

*All Resource

*

  • vpc:IsDefaultVSwitch
  • vpc:IsDefaultVpc
  • vpc:VPC
  • ecs:IsDiskEncrypted
  • ecs:InstanceTypeFamily
  • ecs:InstanceType
  • ecs:ImageOwnerId
  • ecs:ImageSource
  • ecs:NotSpecifySecurityGroupId
  • ecs:LoginAsNonRoot
  • ecs:IsSystemDiskByokEncrypted
  • ecs:IsDiskByokEncrypted
  • ecs:PasswordInherit
  • ecs:PasswordCustomized
  • ecs:IsSystemDiskEncrypted
  • ecs:ImagePlatform
  • ecs:IsDiskEncrypted
  • ecs:SecurityHardeningMode
  • ecs:AssociatePublicIpAddress
  • vpc:CreateDefaultVpc
  • ecs:SecurityEnhancementStrategy
  • ecs:InstanceChargeType
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

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

cn-hangzhou

RegionId

string

必須

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

cn-hangzhou

ImageId

string

任意

イメージの ID。DescribeImages 操作を呼び出して、利用可能なイメージをクエリできます。LaunchTemplateId または LaunchTemplateName を使用して起動テンプレートを指定せず、ImageFamily を設定して指定されたイメージファミリーから最新の利用可能なカスタムイメージを取得しない場合は、ImageId を指定する必要があります。

aliyun_2_1903_x64_20G_alibase_20200324.vhd

ImageFamily

string

任意

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

名前は 2~128 文字の長さでなければなりません。名前は数字、特殊文字、http://、または https:// で始めることはできません。名前には、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-)、コロン (:) を含めることができます。

次の点にご注意ください:

  • ImageId を指定した場合、ImageFamily は指定できません。

  • ImageId を指定せず、LaunchTemplateId または LaunchTemplateName を使用して ImageId が指定された起動テンプレートを指定した場合、ImageFamily は指定できません。

  • ImageId を指定せず、LaunchTemplateId または LaunchTemplateName を使用して ImageId が指定されていない起動テンプレートを指定した場合、ImageFamily を指定できます。

  • ImageIdLaunchTemplateId、または LaunchTemplateName を指定しない場合、ImageFamily を指定できます。

説明

Alibaba Cloud の公式イメージに関連するイメージファミリーについては、「パブリックイメージの概要」をご参照ください。

hangzhou-daily-update

InstanceType

string

任意

インスタンスタイプ。LaunchTemplateId または LaunchTemplateName を使用して起動テンプレートを指定しない場合は、InstanceType パラメーターを設定する必要があります。

ecs.g6.large

SecurityGroupId

string

任意

インスタンスを割り当てるセキュリティグループの ID。同じセキュリティグループ内のインスタンスは互いに通信できます。セキュリティグループで許可されるインスタンスの最大数は、セキュリティグループのタイプによって異なります。詳細については、「制限とクォータ」の「セキュリティグループの制限」セクションをご参照ください。

説明

新しいインスタンスのネットワークタイプは、SecurityGroupId で指定されたセキュリティグループのネットワークタイプと同じです。たとえば、指定されたセキュリティグループが VPC タイプの場合、新しいインスタンスも VPC タイプであり、VSwitchId を指定する必要があります。

LaunchTemplateId または LaunchTemplateName を使用して起動テンプレートを指定しない場合は、セキュリティグループ ID を指定する必要があります。このパラメーターを指定する際は、次の点にご注意ください:

  • SecurityGroupId を設定して単一のセキュリティグループを指定するか、SecurityGroupIds.N を設定して 1 つ以上のセキュリティグループを指定できます。ただし、同じリクエストで SecurityGroupIdSecurityGroupIds.N の両方を指定することはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、SecurityGroupId または SecurityGroupIds.N は指定できませんが、NetworkInterface.N.SecurityGroupId または NetworkInterface.N.SecurityGroupIds.N は指定できます。

sg-bp15ed6xe1yxeycg7****

VSwitchId

string

任意

インスタンスに接続する vSwitch の ID。VPC タイプのインスタンスを作成する際にこのパラメーターを設定する必要があります。指定された vSwitch とセキュリティグループは同じ VPC に属している必要があります。DescribeVSwitches 操作を呼び出して、利用可能な vSwitch をクエリできます。

次の点にご注意ください:

  • VSwitchId パラメーターを指定する場合、ZoneId パラメーターで指定されたゾーンは、指定された vSwitch が存在するゾーンでなければなりません。また、ZoneId パラメーターを空にすることもできます。その場合、システムは指定された vSwitch が存在するゾーンを選択します。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、VSwitchId は指定できませんが、NetworkInterface.N.VSwitchId は指定できます。

vsw-bp1s5fnvk4gn2tws0****

InstanceName

string

任意

ECS インスタンスの名前。名前は 2~128 文字の長さで、文字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。このパラメーターのデフォルト値は InstanceId の値です。

インスタンスを一括作成する際、インスタンスの連番名を一括で設定できます。連番名には角括弧 ([ ]) とカンマ (,) を含めることができます。詳細については、「複数インスタンスの連番名またはホスト名の一括設定」をご参照ください。

k8s-node-[1,4]-alibabacloud

Description

string

任意

インスタンスの説明。説明は 2~256 文字の長さでなければならず、http:// または https:// で始めることはできません。

Instance_Description

InternetMaxBandwidthIn

integer

任意

最大パブリックインバウンドトラフィック。単位:Mbit/s。有効値:

  • 購入したパブリックアウトバウンドトラフィックが 10 Mbit/s 以下の場合、InternetMaxBandwidthIn の有効値は 1~10 で、デフォルト値は 10 です。

  • 購入したパブリックアウトバウンドトラフィックが 10 Mbit/s を超える場合、このパラメーターの有効値は 1 から InternetMaxBandwidthOut の値までで、デフォルト値は InternetMaxBandwidthOut の値です。

10

InternetMaxBandwidthOut

integer

任意

最大パブリックアウトバウンドトラフィック。単位:Mbit/s。有効値:0~100。

デフォルト値:0。

10

HostName

string

任意

インスタンスのホスト名。次の点にご注意ください:

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

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

  • Linux などの他のオペレーティングシステムを実行するインスタンスの場合、次の点にご注意ください:

    • ホスト名は 2~64 文字の長さでなければなりません。ピリオド (.) を使用してホスト名を複数のセグメントに分割できます。各セグメントには、文字、数字、ハイフン (-) を含めることができます。

    • ${instance_id} プレースホルダーを使用して、HostName で指定されたホスト名にインスタンス ID を渡すことができます。たとえば、HostName を k8s-${instance_id} に設定し、インスタンスに i-123abc**** という ID が割り当てられた場合、インスタンスのホスト名は k8s-i-123abc**** になります。

複数のインスタンスを作成する場合、次の操作を実行できます:

  • インスタンスの連番ホスト名の一括設定。詳細については、「複数インスタンスの連番名またはホスト名の一括設定」をご参照ください。

  • HostNames.N パラメーターを使用して、インスタンスに異なるホスト名を設定します。HostNameHostNames.N の両方のパラメーターを同時に指定することはできません。

k8s-node-[1,4]-ecshost

UniqueSuffix

boolean

任意

インスタンスを一括作成する際に、HostName パラメーターで指定されたホスト名と InstanceName パラメーターで指定されたインスタンス名に、増分サフィックスを自動的に追加するかどうかを指定します。増分サフィックスは 001 から 999 の範囲です。有効値:

  • true

  • false

デフォルト値:false。

HostName または InstanceName の値が name_prefix[begin_number,bits] 形式で設定され、name_suffix がない場合、UniqueSuffix パラメーターは効果がありません。名前は指定された順序でソートされます。

詳細については、「複数インスタンスの連番名またはホスト名の一括設定」をご参照ください。

true

Password

string

任意

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

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

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

説明

Password パラメーターを指定する場合、パスワードの漏洩を防ぐために HTTPS 経由でリクエストを送信することを推奨します。

EcsV587!

PasswordInherit

boolean

任意

イメージにプリセットされたパスワードを使用するかどうかを指定します。有効値:

  • true:プリセットされたパスワードを使用します。

  • false:プリセットされたパスワードを使用しません。

デフォルト値:false。

説明

このパラメーターを true に設定する場合、Password パラメーターを空にし、選択したイメージにプリセットされたパスワードがあることを確認してください。

false

ZoneId

string

任意

インスタンスを作成するゾーンの ID。DescribeZones 操作を呼び出して、最新のゾーンリストをクエリできます。

説明

VSwitchId パラメーターを指定する場合、ZoneId パラメーターで指定されたゾーンは、vSwitch が存在するゾーンでなければなりません。また、ZoneId パラメーターを空にすることもできます。その場合、システムは指定された vSwitch が存在するゾーンを選択します。

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

cn-hangzhou-g

InternetChargeType

string

任意

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

  • PayByBandwidth:帯域幅課金

  • PayByTraffic:トラフィック課金

デフォルト値:PayByTraffic。

説明

ネットワーク使用量のトラフィック課金方法を使用する場合、最大インバウンドおよびアウトバウンド帯域幅は、保証されたパフォーマンス仕様ではなく、帯域幅の上限として使用されます。需要がリソース供給を上回るシナリオでは、これらの最大帯域幅値に達しない場合があります。インスタンスに保証された帯域幅が必要な場合は、ネットワーク使用量の帯域幅課金方法を使用してください。

PayByTraffic

SystemDisk.Size

string

任意

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

  • 基本ディスク:20~500。

  • ESSD:有効値は ESSD のパフォーマンスレベルによって異なります。

    • PL0 ESSD:1~2048。

    • PL1 ESSD:20~2048。

    • PL2 ESSD:461~2048。

    • PL3 ESSD:1261~2048。

  • ESSD AutoPL ディスク:1~2048。

  • その他のディスクカテゴリ:20~2048。

このパラメーターの値は、少なくとも 1 であり、イメージサイズ以上でなければなりません。

デフォルト値:40 またはイメージサイズのうち大きい方。

40

SystemDisk.Category

string

任意

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

  • cloud_efficiency:超高信頼性ディスク

  • cloud_ssd:標準 SSD

  • cloud_essd:拡張 SSD (ESSD)

  • cloud:基本ディスク

  • cloud_auto:ESSD AutoPL ディスク

  • cloud_essd_entry:ESSD エントリーディスク

説明

このパラメーターの値は、InstanceTypeecs.u1 または ecs.e に設定されている場合にのみ cloud_essd_entry になります。ecs.u1 は u1 汎用インスタンスファミリーを示し、ecs.e は e エコノミーインスタンスファミリーを示します。u1 および e インスタンスファミリーの詳細については、「汎用インスタンスファミリー」トピックの「u1、汎用インスタンスファミリー」セクションおよび「共有インスタンスファミリー」トピックの「e、エコノミーインスタンスファミリー」セクションをご参照ください。

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

cloud_ssd

SystemDisk.DiskName

string

任意

システムディスクの名前。名前は 2~128 文字の長さで、Decimal Number カテゴリおよび名前に Letter を含むカテゴリの Unicode 文字をサポートします。名前にはコロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。

cloud_ssdSystem

SystemDisk.Description

string

任意

システムディスクの説明。説明は 2~256 文字の長さでなければなりません。説明には文字を含めることができますが、http:// または https:// で始めることはできません。

SystemDisk_Description

SystemDisk.PerformanceLevel

string

任意

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

  • PL0:単一の ESSD で最大 10,000 のランダム読み取り/書き込み IOPS を提供できます。

  • PL1:単一の ESSD で最大 50,000 のランダム読み取り/書き込み IOPS を提供できます。

  • PL2:単一の ESSD で最大 100,000 のランダム読み取り/書き込み IOPS を提供できます。

  • PL3:単一の ESSD で最大 1,000,000 のランダム読み取り/書き込み IOPS を提供できます。

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

PL0

SystemDisk.AutoSnapshotPolicyId

string

任意

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

sp-bp67acfmxazb4p****

IoOptimized

string

任意

インスタンスが I/O 最適化されているかどうかを指定します。廃止されたインスタンスタイプのインスタンスの場合、デフォルト値は none です。その他のインスタンスタイプの場合、デフォルト値は optimized です。有効値:

  • none:インスタンスは I/O 最適化されていません。

  • optimized:インスタンスは I/O 最適化されています。

optimized

UserData

string

任意

インスタンスのユーザーデータ。Base64 エンコードされたデータを指定する必要があります。インスタンスのユーザーデータは、Base64 エンコーディング前で 32 KB を超えることはできません。

インスタンスユーザーデータの制限、形式、実行頻度については、「インスタンスユーザーデータ」をご参照ください。

説明

セキュリティを確保するため、パスワードや秘密鍵などの機密情報をプレーンテキストでユーザーデータとして渡さないことを推奨します。機密情報を渡す必要がある場合は、情報を暗号化して Base64 でエンコードし、インスタンス内で同じ方法でデコードおよび復号することを推奨します。

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

任意

キーペアの名前。

説明

Windows インスタンスの場合、このパラメーターは無視されます。このパラメーターはデフォルトで空です。KeyPairName パラメーターが指定されていても、Password パラメーターが有効になります。

KeyPair_Name

RamRoleName

string

任意

Resource Access Management (RAM) ロールの名前。RAM が提供する ListRoles 操作を呼び出して、作成したインスタンス RAM ロールをクエリできます。

RAM_Name

Amount

integer

任意

作成したい ECS インスタンスの希望数。有効値:1~100。

作成できる ECS インスタンスの数は、Amount と MinAmount の値によって異なります。

  • MinAmount を指定しない場合、RunInstances 操作は Amount の値に基づいて ECS インスタンスを作成します。利用可能なリソースが希望数の ECS インスタンスを作成するのに不十分な場合、RunInstances 操作はエラー応答を返し、ECS インスタンスは作成されません。

  • MinAmount を指定する場合、次の点にご注意ください:

    • 利用可能なリソースが最小数の ECS インスタンスを作成するのに不十分な場合、ECS インスタンスは作成されず、RunInstances 操作はエラー応答を返します。

    • 利用可能なリソースが希望数の ECS インスタンスを作成するのに不十分であるが、最小数の ECS インスタンスを作成するのに十分な場合、RunInstances 操作は利用可能なリソースを使用して ECS インスタンスを作成し、成功応答を返します。この場合、作成できる ECS インスタンスの数は希望数よりも少なくなります。

    • 利用可能なリソースが希望数の ECS インスタンスを作成するのに十分な場合、RunInstances 操作は利用可能なリソースを使用して希望数の ECS インスタンスを作成し、成功応答を返します。

デフォルト値:1。

3

MinAmount

integer

任意

作成したい ECS インスタンスの最小数。有効値:1~100。

作成できる ECS インスタンスの数は、Amount と MinAmount の値によって異なります。

  • MinAmount を指定しない場合、RunInstances 操作は Amount の値に基づいて ECS インスタンスを作成します。利用可能なリソースが希望数の ECS インスタンスを作成するのに不十分な場合、RunInstances 操作はエラー応答を返し、ECS インスタンスは作成されません。

  • MinAmount を指定する場合、次の点にご注意ください:

    • 利用可能なリソースが最小数の ECS インスタンスを作成するのに不十分な場合、ECS インスタンスは作成されず、RunInstances 操作はエラー応答を返します。

    • 利用可能なリソースが希望数の ECS インスタンスを作成するのに不十分であるが、最小数の ECS インスタンスを作成するのに十分な場合、RunInstances 操作は利用可能なリソースを使用して ECS インスタンスを作成し、成功応答を返します。この場合、作成できる ECS インスタンスの数は希望数よりも少なくなります。

    • 利用可能なリソースが希望数の ECS インスタンスを作成するのに十分な場合、RunInstances 操作は利用可能なリソースを使用して希望数の ECS インスタンスを作成し、成功応答を返します。

2

AutoReleaseTime

string

任意

従量課金インスタンスを自動的にリリースする時刻。ISO 8601 標準yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。時刻は協定世界時 (UTC) である必要があります。

  • 秒 (ss) の値が 00 でない場合、開始時刻は分 (mm) の値に基づいて最も近い分に自動的に四捨五入されます。

  • 指定された時刻は、現在時刻より少なくとも 30 分後でなければなりません。

  • 指定された時刻は、現在時刻より最大で 3 年後までです。

2018-01-01T12:05:00Z

SpotStrategy

string

任意

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

  • NoSpot:インスタンスは従量課金インスタンスとして作成されます。

  • SpotWithPriceLimit:インスタンスは、ユーザー定義の最大時間料金を持つスポットインスタンスとして作成されます。

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

デフォルト値:NoSpot。

NoSpot

SpotDuration

integer

任意

スポットインスタンスの保護期間。単位:時間。有効値:

  • 1:スポットインスタンスが作成された後、Alibaba Cloud はインスタンスが 1 時間以内に自動的にリリースされないことを保証します。1 時間の保護期間が終了すると、システムは入札価格と市場価格を比較し、リソース在庫を確認してインスタンスを保持するかリリースするかを決定します。

  • 0:スポットインスタンスが作成された後、Alibaba Cloud はインスタンスが 1 時間実行できることを保証しません。システムは入札価格と市場価格を比較し、リソース在庫を確認してインスタンスを保持するかリリースするかを決定します。

デフォルト値:1。

説明
  • このパラメーターは 0 または 1 にのみ設定できます。

  • スポットインスタンスは秒単位で課金されます。適切な保護期間を指定してください。

  • Alibaba Cloud は、インスタンスがリリースされる 5 分前に ECS システムイベントを送信して通知します。

1

SpotPriceLimit

number

任意

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

0.97

SpotInterruptionBehavior

string

任意

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

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

  • Stop:インスタンスは節約モードで停止されます。

    節約モードの詳細については、「節約モード」をご参照ください。

デフォルト値:Terminate。

Terminate

SecurityEnhancementStrategy

string

任意

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

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

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

Active

ClientToken

string

任意

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

123e4567-e89b-12d3-a456-426655440000

HpcClusterId

string

任意

インスタンスが属するハイパフォーマンスコンピューティング (HPC) クラスターの ID。

Supper Computing Cluster (SCC) インスタンスタイプのインスタンスを作成する際に、このパラメーターは必須です。HPC クラスターの作成方法については、「CreateHpcCluster」をご参照ください。

hpc-bp67acfmxazb4p****

DryRun

boolean

任意

実際にリクエストを行わずにリクエストの有効性を確認するかどうかを指定します。デフォルト値:false。有効値:

  • true:リクエストの有効性が確認されますが、リクエストは行われません。確認項目には、必須パラメーターが指定されているか、リクエスト形式、サービス制限、利用可能な ECS リソースが含まれます。確認に失敗した場合、対応するエラーコードが返されます。確認に成功した場合、DryRunOperation エラーコードが返されます。

  • false:リクエストの有効性が確認され、確認に成功した場合にリクエストが行われます。

false

DedicatedHostId

string

任意

専用ホストの ID。

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

説明

スポットインスタンスは専用ホスト上では作成できません。DedicatedHostId を指定すると、SpotStrategy と SpotPriceLimit は自動的に無視されます。

dh-bp67acfmxazb4p****

LaunchTemplateId

string

任意

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

起動テンプレートを使用してインスタンスを作成するには、LaunchTemplateId または LaunchTemplateName パラメーターを使用して起動テンプレートを指定する必要があります。

lt-bp1apo0bbbkuy0rj****

LaunchTemplateName

string

任意

起動テンプレートの名前。

起動テンプレートを使用してインスタンスを作成するには、LaunchTemplateId または LaunchTemplateName パラメーターを使用して起動テンプレートを指定する必要があります。

LaunchTemplate_Name

LaunchTemplateVersion

integer

任意

起動テンプレートのバージョン。LaunchTemplateId または LaunchTemplateName パラメーターを設定しても、起動テンプレートのバージョン番号を設定しない場合、デフォルトのテンプレートバージョンが使用されます。

3

ResourceGroupId

string

任意

インスタンスを割り当てるリソースグループの ID。

rg-bp67acfmxazb4p****

Period

integer

任意

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

  • PeriodUnit が Week に設定されている場合の有効値:1、2、3、4。

  • PeriodUnit が Month に設定されている場合の有効値:1、2、3、4、5、6、7、8、9、12、24、36、48、60。

1

PeriodUnit

string

任意

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

  • Week

  • Month

Month

AutoRenew

boolean

任意

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

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

  • false:自動更新を有効にしません。

デフォルト値:false。

true

AutoRenewPeriod

integer

任意

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

  • PeriodUnit が Week に設定されている場合の有効値:1、2、3。

  • PeriodUnit が Month に設定されている場合の有効値:1、2、3、6、12、24、36、48、60。

デフォルト値:1。

1

InstanceChargeType

string

任意

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

  • PrePaid:サブスクリプション

  • PostPaid:従量課金

デフォルト値:PostPaid。

このパラメーターを PrePaid に設定する場合、アカウントに十分な残高またはクレジットがあることを確認してください。そうでない場合、InvalidPayMethod エラーが返されます。

PrePaid

DeploymentSetId

string

任意

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

ds-bp1brhwhoqinyjd6****

DeploymentSetGroupNo

integer

任意

インスタンスをデプロイするデプロイメントセットグループの番号。DeploymentSetId パラメーターで指定されたデプロイメントセットが高可用性グループ戦略 (AvailabilityGroup) を使用する場合、DeploymentSetGroupNo パラメーターを使用してデプロイメントセット内のデプロイメントセットグループを指定できます。有効値:1~7。

1

PrivateIpAddress

string

任意

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

次の点にご注意ください:

  • PrivateIpAddress が指定されている場合、次の点にご注意ください:

    • Amount が 1 に設定されている場合、単一のインスタンスが作成され、指定されたプライベート IP アドレスがインスタンスに割り当てられます。

    • Amount が 1 より大きい数値に設定されている場合、指定された数のインスタンスが作成され、指定された IP アドレスから始まる連続したプライベート IP アドレスがインスタンスに割り当てられます。この場合、NetworkInterface.N で始まるパラメーターを指定してインスタンスにセカンダリ ENI をアタッチすることはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、PrivateIpAddress は指定できませんが、NetworkInterface.N.PrimaryIpAddress は指定できます。

説明

各 vSwitch CIDR ブロックの最初の IP アドレスと最後の 3 つの IP アドレスは予約されています。これらの IP アドレスは指定できません。たとえば、vSwitch CIDR ブロックが 192.168.1.0/24 の場合、IP アドレス 192.168.1.0、192.168.1.253、192.168.1.254、192.168.1.255 は予約されています。

10.1.**.**

CreditSpecification

string

任意

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

Standard

Ipv6AddressCount

integer

任意

プライマリ ENI のためにランダムに生成する IPv6 アドレスの数。有効値:1~10。

次の点にご注意ください:

  • Ipv6Addresses.NIpv6AddressCount の両方のパラメーターを同時に指定することはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、Ipv6Address.N または Ipv6AddressCount は指定できませんが、NetworkInterface.N.Ipv6Address.N または NetworkInterface.N.Ipv6AddressCount は指定できます。

1

NetworkInterfaceQueueNumber

integer

任意

プライマリ ENI がサポートするキューの数。次の点にご注意ください:

  • このパラメーターの値は、インスタンスタイプで許可されている ENI ごとの最大キュー数を超えることはできません。

  • インスタンス上のすべての ENI のキューの合計数は、インスタンスタイプのキュークォータを超えることはできません。ENI ごとの最大キュー数とインスタンスタイプのキュークォータをクエリするには、DescribeInstanceTypes 操作を呼び出して MaximumQueueNumberPerEniTotalEniQueueQuantity の値を確認できます。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、NetworkInterfaceQueueNumber は指定できませんが、NetworkInterface.N.QueueNumber は指定できます。

8

DeletionProtection

boolean

任意

インスタンスのリリース保護を有効にするかどうかを指定します。このパラメーターは、ECS コンソールを使用するか、DeleteInstance 操作を呼び出してインスタンスをリリースできるかどうかを決定します。有効値:

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

  • false:インスタンスのリリース保護を無効にします。

デフォルト値:false。

説明

このパラメーターは従量課金インスタンスにのみ適用されます。手動解放からインスタンスを保護できますが、自動リリースからは保護できません。

false

HibernationOptions.Configured

boolean

任意

説明

このパラメーターは招待プレビュー中であり、利用できません。

false

Affinity

string

任意

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

  • default:インスタンスを専用ホストに関連付けません。節約モードで停止されたインスタンスを起動すると、元の専用ホストの利用可能なリソースが不十分な場合、インスタンスは自動デプロイリソースプール内の別の専用ホストに自動的にデプロイされます。

  • host:インスタンスを専用ホストに関連付けます。節約モードで停止されたインスタンスを起動すると、インスタンスは元の専用ホスト上に残ります。元の専用ホストの利用可能なリソースが不十分な場合、インスタンスは起動できません。

デフォルト値:default。

default

Tenancy

string

任意

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

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

  • host:インスタンスを専用ホスト上に作成します。DedicatedHostId パラメーターを設定しない場合、Alibaba Cloud はインスタンスのために専用ホストを選択します。

デフォルト値:default。

default

StorageSetId

string

任意

ストレージセットの ID を示します。

ss-bp67acfmxazb4p****

StorageSetPartitionNumber

integer

任意

ストレージクラスター内のパーティションの最大数。有効値:1 以上の整数。

2

CpuOptions.Core

integer

任意

CPU コアの数。

2

CpuOptions.ThreadsPerCore

integer

任意

CPU コアあたりのスレッド数。インスタンスの vCPU 数は次の数式で計算されます:CpuOptions.Core の値 × CpuOptions.ThreadsPerCore の値。

  • CpuOptionsThreadPerCore が 1 に設定されている場合、ハイパースレッディング (HT) は無効になります。

  • このパラメーターは特定のインスタンスタイプにのみ適用されます。

2

CpuOptions.Numa

string

任意

このパラメーターは使用されなくなりました。

1

CpuOptions.TopologyType

string

任意

インスタンスの CPU トポロジータイプ。有効値:

  • ContinuousCoreToHTMapping:HT テクノロジーにより、インスタンスの CPU トポロジー内で連続したスレッドが同じコア上で実行されます。``

  • DiscreteCoreToHTMapping:HT テクノロジーにより、インスタンスの CPU トポロジー内で離散したスレッドが同じコア上で実行されます。``

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

説明

このパラメーターは特定のインスタンスファミリーでのみサポートされています。サポートされているインスタンスファミリーの詳細については、「CPU トポロジーの表示と変更」をご参照ください。

DiscreteCoreToHTMapping

SecurityOptions.TrustedSystemMode

string

任意

信頼済みシステムモード。値を vTPM に設定します。

信頼済みシステムモードは、次のインスタンスファミリーをサポートしています:

  • g7、c7、r7

  • セキュリティ強化インスタンスファミリー:g7t、c7t、r7t

上記のインスタンスファミリーのインスタンスを作成する際には、このパラメーターを設定する必要があります。次の点にご注意ください:

  • Alibaba Cloud Trusted System を使用するには、このパラメーターを vTPM に設定します。その後、Alibaba Cloud Trusted System はインスタンスの起動時に信頼性検証を実行します。

  • Alibaba Cloud Trusted System を使用したくない場合は、このパラメーターを空のままにします。作成したインスタンスがエンクレーブベースのコンフィデンシャルコンピューティング環境を使用する場合 (SecurityOptions.ConfidentialComputingMode が Enclave に設定されている場合)、Alibaba Cloud Trusted System はインスタンスに対して有効になることに注意してください。

  • ECS API を使用して信頼済みシステムを使用するインスタンスを作成する場合、RunInstances 操作のみを呼び出すことができます。CreateInstance 操作は SecurityOptions.TrustedSystemMode パラメーターをサポートしていません。

説明

インスタンス作成時にインスタンスを信頼済みとして構成した場合、インスタンスのシステムディスクを置き換えるには、信頼済みシステムをサポートするイメージのみを使用できます。

信頼済みシステムの詳細については、「概要」をご参照ください。

vTPM

SecurityOptions.ConfidentialComputingMode

string

任意

コンフィデンシャルコンピューティングモード。値を Enclave に設定します。

Enclave の値は、インスタンス上にエンクレーブベースのコンフィデンシャルコンピューティング環境が構築されることを示します。RunInstances 操作を呼び出す際、エンクレーブベースのコンフィデンシャルコンピューティングを使用するために、このパラメーターを c7、g7、または r7 インスタンスに対してのみ設定できます。次の点にご注意ください:

  • コンフィデンシャルコンピューティング機能は招待プレビュー中です。

  • ECS API を使用してエンクレーブベースのコンフィデンシャルコンピューティングをサポートするインスタンスを作成する場合、RunInstances 操作のみを呼び出すことができます。CreateInstance 操作は SecurityOptions.ConfidentialComputingMode パラメーターをサポートしていません。

  • エンクレーブベースのコンフィデンシャルコンピューティングは、Alibaba Cloud Trusted System (vTPM) に基づいて実装されています。Enclave を使用してインスタンス上にコンフィデンシャルコンピューティング環境を構築すると、Alibaba Cloud Trusted System がインスタンスで有効になります。この操作を呼び出す際に SecurityOptions.ConfidentialComputingMode を Enclave に設定すると、作成されたインスタンスは、SecurityOptions.TrustedSystemMode が vTPM に設定されているかどうかに関わらず、エンクレーブベースのコンフィデンシャルコンピューティングと Alibaba Cloud Trusted System を使用します。

コンフィデンシャルコンピューティングの詳細については、「Enclave を使用したコンフィデンシャルコンピューティング環境の構築」をご参照ください。

Enclave

HttpEndpoint

string

任意

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

  • enabled

  • disabled

デフォルト値:enabled。

説明

インスタンスメタデータの詳細については、「ECS インスタンスメタデータの概要」をご参照ください。

enabled

HttpTokens

string

任意

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

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

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

デフォルト値:optional。

説明

インスタンスメタデータへのアクセスモードの詳細については、「インスタンスメタデータのアクセスモード」をご参照ください。

optional

HttpPutResponseHopLimit

integer

任意

説明

このパラメーターは公開されていません。

0

PrivatePoolOptions.MatchCriteria

string

任意

インスタンスを作成するために使用するプライベートプールのタイプ。プライベートプールは、エラスティックアシュアランスまたはキャパシティ予約が有効になった後に生成されます。インスタンスを起動する際にプライベートプールを選択できます。有効値:

  • Open:オープン プライベートプール。システムは一致するオープン プライベートプールを選択してインスタンスを作成します。一致するオープン プライベートプールが見つからない場合、パブリックプールのリソースが使用されます。このパラメーターを Open に設定する場合、PrivatePoolOptions.Id パラメーターを空にすることができます。

  • Target:指定されたプライベートプール。システムは指定されたプライベートプール内のキャパシティを使用してインスタンスを作成します。指定されたプライベートプールが利用できない場合、インスタンスは作成できません。このパラメーターを Target に設定する場合、PrivatePoolOptions.Id パラメーターを指定する必要があります。

  • None:プライベートプールなし。プライベートプールのキャパシティは使用されません。

デフォルト値:None。

次のシナリオでは、PrivatePoolOptions.MatchCriteria パラメーターは None に設定するか、空にするしかありません:

  • スポットインスタンスが作成されます。

  • インスタンスはクラシックネットワークで作成されます。

  • インスタンスは専用ホスト上に作成されます。

Open

PrivatePoolOptions.Id

string

任意

プライベートプールの ID。プライベートプールの ID は、プライベートプールが生成されたエラスティックアシュアランスまたはキャパシティ予約の ID と同じです。

eap-bp67acfmxazb4****

Isp

string

任意

説明

このパラメーターは招待プレビュー中であり、利用できません。

null

SchedulerOptions.DedicatedHostClusterId

string

任意

インスタンスを作成する専用ホストクラスターの ID。このパラメーターが指定されると、システムは指定されたクラスターから 1 つの専用ホストを選択してインスタンスを作成します。

説明

このパラメーターは、Tenancy パラメーターが host に設定されている場合にのみ有効です。

DedicatedHostIdSchedulerOptions.DedicatedHostClusterId の両方のパラメーターを指定する場合、次の点にご注意ください:

  • 指定された専用ホストが指定された専用ホストクラスターに属している場合、インスタンスは優先的に指定された専用ホストにデプロイされます。

  • 指定された専用ホストが指定された専用ホストクラスターに属していない場合、インスタンスは作成できません。

DescribeDedicatedHostClusters 操作を呼び出して、専用ホストクラスター ID のリストをクエリできます。

dc-bp12wlf6am0vz9v2****

SecurityGroupIds

array

任意

インスタンスを割り当てるセキュリティグループの ID。N の有効値は、インスタンスが属することができるセキュリティグループの最大数によって異なります。詳細については、「制限」トピックの「セキュリティグループの制限」セクションをご参照ください。

このパラメーターを指定する際は、次の点にご注意ください:

  • 同じリクエストで SecurityGroupIdSecurityGroupIds.N の両方を指定することはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、SecurityGroupId または SecurityGroupIds.N は指定できませんが、NetworkInterface.N.SecurityGroupId または NetworkInterface.N.SecurityGroupIds.N は指定できます。

sg-bp15ed6xe1yxeycg7****

string

任意

インスタンスを割り当てるセキュリティグループ N の ID。N の有効値は、インスタンスが属することができるセキュリティグループの最大数によって異なります。詳細については、「制限」トピックの「セキュリティグループの制限」セクションをご参照ください。

このパラメーターを指定する際は、次の点にご注意ください:

  • 同じリクエストで SecurityGroupIdSecurityGroupIds.N の両方を指定することはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、SecurityGroupId または SecurityGroupIds.N は指定できませんが、NetworkInterface.N.SecurityGroupId または NetworkInterface.N.SecurityGroupIds.N は指定できます。

sg-bp15ed6xe1yxeycg7****

HostNames

array

任意

インスタンス N のホスト名。このパラメーターを使用して、複数のインスタンスに異なるホスト名を指定できます。

ecs-host-01

string

任意

インスタンス N のホスト名。このパラメーターを使用して、複数のインスタンスに異なるホスト名を指定できます。次の点にご注意ください:

  • N の最大値は Amount の値と同じでなければなりません。たとえば、Amount を 2 に設定した場合、HostNames.1 と HostNames.2 を使用して個々のインスタンスのホスト名を指定できます。例:HostNames.1=test1 および HostNames.2=test2

  • HostNameHostNames.N の両方のパラメーターを同時に指定することはできません。

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

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

  • Linux などの他のオペレーティングシステムを実行するインスタンスの場合、ホスト名は 2~64 文字の長さでなければなりません。ピリオド (.) を使用してホスト名を複数のセグメントに分割できます。各セグメントには、文字、数字、ハイフン (-) を含めることができます。

ecs-host-01

DataDisk

array<object>

任意

データディスク。

object

任意

データディスク N。

PerformanceLevel

string

任意

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

  • PL0:単一の ESSD で最大 10000 のランダム読み取り/書き込み IOPS を提供できます。

  • PL1 (デフォルト):単一の ESSD で最大 50000 のランダム読み取り/書き込み IOPS を提供できます。

  • PL2:単一の ESSD で最大 100000 のランダム読み取り/書き込み IOPS を提供できます。

  • PL3:単一の ESSD で最大 1000000 のランダム読み取り/書き込み IOPS を提供できます。

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

PL1

AutoSnapshotPolicyId

string

任意

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

sp-bp67acfmxazb4p****

Encrypted

string

任意

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

  • true:データディスクを暗号化します。

  • false:データディスクを暗号化しません。

デフォルト値:false。

説明

暗号化されたスナップショットに基づいてディスクを作成するために共有暗号化イメージを使用する場合、ディスクが独自の暗号鍵を使用するように Encrypted を true に設定する必要があります。

false

Description

string

任意

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

DataDisk_Description

SnapshotId

string

任意

データディスク N を作成するために使用するスナップショットの ID。N の有効値:1~16。

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

s-bp17441ohwka0yuh****

Device

string

任意

データディスク N のマウントポイント。マウントポイントはデータディスクの数に基づいて命名されます:

  • 1 番目から 25 番目のデータディスク:/dev/xvd[b-z]

  • 26 番目以降のデータディスク:/dev/xvd[aa-zz]。たとえば、26 番目のデータディスクは /dev/xvdaa、27 番目のデータディスクは /dev/xvdab と命名されます。

説明
  • このパラメーターは、完全なイメージを使用してインスタンスを作成するシナリオに適用されます。完全なイメージとは、オペレーティングシステム、アプリケーションソフトウェア、ビジネスデータを含むイメージです。これらのシナリオでは、このパラメーターを完全なイメージ内のデータディスク N のマウントポイントに設定し、DataDisk.N.SizeDataDisk.N.Category を変更して、イメージに基づいて作成されるデータディスク N のカテゴリとサイズを変更できます。

  • 完全なイメージを使用して ECS インスタンスを作成する場合、イメージ内のデータディスクはインスタンスの最初の N 個のデータディスクとして作成されます。

/dev/xvdb

Size

integer

任意

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

  • DataDisk.N.Category が cloud_efficiency に設定されている場合の有効値:20~32768。

  • DataDisk.N.Category が cloud_ssd に設定されている場合の有効値:20~32768。

  • DataDisk.N.Category が cloud_essd に設定されている場合の有効値:DataDisk.N.PerformanceLevel の値によって異なります。

    • DataDisk.N.PerformanceLevel が PL0 に設定されている場合の有効値:1~65536。

    • DataDisk.N.PerformanceLevel が PL1 に設定されている場合の有効値:20~65536。

    • DataDisk.N.PerformanceLevel が PL2 に設定されている場合の有効値:461~65536。

    • DataDisk.N.PerformanceLevel が PL3 に設定されている場合の有効値:1261~65536。

  • DataDisk.N.Category が cloud に設定されている場合の有効値:5~2000。

  • DataDisk.N.Category が cloud_auto に設定されている場合の有効値:1~65536。

  • DataDisk.N.Category が cloud_essd_entry に設定されている場合の有効値:10~32768。

説明

このパラメーターの値は、DataDisk.N.SnapshotId で指定されたスナップショットのサイズ以上でなければなりません。

2000

DiskName

string

任意

データディスク N の名前。名前は 2~128 文字の長さで、文字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。

cloud_ssdData

Category

string

任意

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

  • cloud_efficiency:超高信頼性ディスク。

  • cloud_ssd:標準 SSD。

  • cloud_essd:ESSD。

  • cloud:基本ディスク。

  • cloud_auto:ESSD AutoPL ディスク。

  • cloud_regional_disk_auto:リージョン ESSD。

  • cloud_essd_entry:ESSD エントリーディスク。

    **

    このパラメーターは、InstanceTypeecs.u1 または ecs.e に設定されている場合にのみ cloud_essd_entry に設定できます。

  • elastic_ephemeral_disk_standard:標準エラスティック一時ディスク。

  • elastic_ephemeral_disk_premium:プレミアムエラスティック一時ディスク

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

cloud_ssd

EncryptAlgorithm

string

任意

説明

このパラメーターは公開されていません。

null

DeleteWithInstance

boolean

任意

関連付けられたインスタンスがリリースされたときにデータディスク N をリリースするかどうかを指定します。有効値:

  • true:関連付けられたインスタンスがリリースされたときにデータディスクをリリースします。

  • false:関連付けられたインスタンスがリリースされたときにデータディスクをリリースしません。

デフォルト値:true。

true

KMSKeyId

string

任意

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

0e478b7a-4262-4802-b8cb-00d3fb40****

StorageClusterId

string

任意

データディスク N が属する専用ブロックストレージクラスターの ID。インスタンス作成時に専用ブロックストレージクラスター内のディスクをデータディスク N として使用したい場合は、このパラメーターを指定する必要があります。

dbsc-j5e1sf2vaf5he8m2****

ProvisionedIops

integer

任意

データディスク N として使用する ESSD AutoPL ディスクのプロビジョニングされた読み取り/書き込み IOPS。有効値:0~min{50,000, 1,000 × 容量 - ベースライン IOPS}。

ベースライン IOPS = min{1,800 + 50 × 容量, 50,000}。

説明

このパラメーターは、DataDisk.N.Category を cloud_auto に設定した場合にのみ利用可能です。詳細については、「ESSD AutoPL ディスク」をご参照ください。

40000

BurstingEnabled

boolean

任意

データディスク N のパフォーマンスバースト機能を有効にするかどうかを指定します。有効値:

  • true:システムディスクのパフォーマンスバースト機能を有効にします。

  • false:データディスクのパフォーマンスバースト機能を無効にします。

説明

このパラメーターは、DataDisk.N.Category を cloud_auto に設定した場合にのみ利用可能です。詳細については、「ESSD AutoPL ディスク」をご参照ください。

false

Arn

array<object>

任意

説明

このパラメーターは公開されていません。

object

任意

説明

このパラメーターは公開されていません。

RoleType

string

任意

説明

このパラメーターは公開されていません。

null

Rolearn

string

任意

説明

このパラメーターは公開されていません。

null

AssumeRoleFor

integer

任意

説明

このパラメーターは公開されていません。

null

NetworkInterface

array<object>

任意

Elastic Network Interface (ENI) の情報。

object

任意

ENI N の情報。

VSwitchId

string

任意

ENI N に接続する vSwitch の ID。

このパラメーターを指定する際は、次の点にご注意ください:

  • N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、このパラメーターを指定する必要があります。この場合、このパラメーターは VSwitchId と同等です。同じリクエストで NetworkInterface.N.VSwitchId と VSwitchId の両方を指定することはできません。

  • NetworkInterface.N.InstanceTypeSecondary に設定されているか、空のままの場合、このパラメーターを指定する必要はありません。デフォルト値は VSwitchId の値です。

vsw-bp67acfmxazb4p****

NetworkInterfaceName

string

任意

ENI N の名前。名前は 2~128 文字の長さで、文字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。

次の点にご注意ください:

  • N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、このパラメーターを指定する必要はありません。

Network_Name

Description

string

任意

ENI N の説明。

次の点にご注意ください:

  • N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • 説明は 2~256 文字の長さで、http:// または https:// で始めることはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、このパラメーターを指定する必要はありません。

Network_Description

SecurityGroupId

string

任意

ENI N を割り当てるセキュリティグループの ID。

次の点にご注意ください:

  • N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、このパラメーターを指定する必要があります。この場合、このパラメーターは SecurityGroupId と同等であり、SecurityGroupIdSecurityGroupIds.N、または NetworkInterface.N.SecurityGroupIds.N を指定することはできません。

  • NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、このパラメーターを指定する必要はありません。デフォルト値は、インスタンスを割り当てるセキュリティグループの ID です。

sg-bp67acfmxazb4p****

PrimaryIpAddress

string

任意

ENI N に割り当てるプライマリ IP アドレス。

次の点にご注意ください:

  • N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

    • N の値が 1 の場合、プライマリまたはセカンダリ ENI を構成できます。このパラメーターを指定し、Amount を 1 より大きい数値に設定し、NetworkInterface.N.InstanceType を Primary に設定すると、指定された数のインスタンスが作成され、指定された IP アドレスから始まる連続したプライマリ IP アドレスがインスタンスに割り当てられます。この場合、インスタンスにセカンダリ ENI をアタッチすることはできません。

    • このパラメーターを指定し、Amount を 1 より大きい数値に設定し、NetworkInterface.N.InstanceType を Primary に設定した場合、NetworkInterface.2.InstanceType を Secondary に設定してセカンダリ ENI をアタッチすることはできません。

  • NetworkInterface.N.InstanceTypePrimary に設定した場合、このパラメーターは PrivateIpAddress と同等です。同じリクエストでこのパラメーターと PrivateIpAddress の両方を指定することはできません。

  • NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、指定されたプライマリ IP アドレスがセカンダリ ENI に割り当てられます。デフォルト値は、セカンダリ ENI を接続する vSwitch の CIDR ブロック内からランダムに選択された IP アドレスです。

説明
  • 各 vSwitch CIDR ブロックの最初の IP アドレスと最後の 3 つの IP アドレスは予約されています。これらの IP アドレスは指定できません。たとえば、vSwitch CIDR ブロックが 192.168.1.0/24 の場合、IP アドレス 192.168.1.0、192.168.1.253、192.168.1.254、192.168.1.255 は予約されています。

172.16.**.**

QueueNumber

integer

任意

ENI N がサポートするキューの数。

次の点にご注意ください:

  • N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • このパラメーターの値は、ENI ごとに許可される最大キュー数を超えることはできません。

  • インスタンスのすべての ENI のキューの合計数は、インスタンスタイプのキュークォータを超えることはできません。ENI ごとの最大キュー数とインスタンスタイプのキュークォータをクエリするには、DescribeInstanceTypes 操作を呼び出し、レスポンスの MaximumQueueNumberPerEniTotalEniQueueQuantity の値を確認してください。

  • このパラメーターを指定し、NetworkInterface.N.InstanceTypePrimary に設定した場合、NetworkInterfaceQueueNumber を指定することはできません。

8

SecurityGroupIds

array

任意

ENI N を割り当てるセキュリティグループの ID。

  • このパラメーターの最初の N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • このパラメーターの 2 番目の N は、1 つ以上のセキュリティグループ ID を指定できることを示します。2 番目の N の有効値は、インスタンスが属することができるセキュリティグループの最大数によって異なります。詳細については、「セキュリティグループの制限」をご参照ください。

次の点にご注意ください:

  • NetworkInterface.N.InstanceTypePrimary に設定した場合、このパラメーターまたは NetworkInterface.N.SecurityGroupId を指定する必要があります。この場合、このパラメーターは SecurityGroupIds.N と同等であり、SecurityGroupIdSecurityGroupIds.N、または NetworkInterface.N.SecurityGroupId を指定することはできません。

  • NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、このパラメーターを指定する必要はありません。デフォルト値は、インスタンスを割り当てるセキュリティグループの ID です。

sg-bp15ed6xe1yxeycg7****

string

任意

ENI N を割り当てるセキュリティグループ N の ID。

  • このパラメーターの最初の N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

  • このパラメーターの 2 番目の N は、1 つ以上のセキュリティグループ ID を指定できることを示します。2 番目の N の有効値は、インスタンスが属することができるセキュリティグループの最大数によって異なります。詳細については、「セキュリティグループの制限」をご参照ください。

次の点にご注意ください:

  • NetworkInterface.N.InstanceTypePrimary に設定した場合、このパラメーターまたは NetworkInterface.N.SecurityGroupId を指定する必要があります。この場合、このパラメーターは SecurityGroupIds.N と同等であり、SecurityGroupIdSecurityGroupIds.N、または NetworkInterface.N.SecurityGroupId を指定することはできません。

  • NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、このパラメーターを指定する必要はありません。デフォルト値は、インスタンスを割り当てるセキュリティグループの ID です。

sg-bp15ed6xe1yxeycg7****

NetworkInterfaceTrafficMode

string

任意

ENI N の通信モード。有効値:

  • Standard:TCP 通信モードを使用します。

  • HighPerformance:Elastic RDMA Interface (ERI) を有効にしたリモートダイレクトメモリアクセス (RDMA) 通信モードを使用します。

デフォルト値:Standard。

説明

インスタンス上の ERI の数は、インスタンスタイプがサポートする ERI の最大数を超えることはできません。詳細については、「インスタンスファミリーの概要」をご参照ください。

Standard

QueuePairNumber

integer

任意

ERI がサポートするキューペア (QP) の数。

作成したインスタンスに複数の ERI をアタッチしたい場合は、インスタンスタイプがサポートする QueuePairNumber の値と使用したい ERI の数に基づいて、各 ERI の QueuePairNumber を指定することを推奨します。すべての ERI の QP の合計数が、インスタンスタイプがサポートする QP の最大数を超えないようにしてください。インスタンスタイプがサポートする QP の最大数については、「DescribeInstanceTypes」をご参照ください。

説明

ERI の QueuePairNumber を指定しない場合、インスタンスタイプがサポートする QP の最大数が ERI がサポートする QP の数として使用されます。この場合、インスタンスに追加の ERI をアタッチすることはできません。ただし、他のタイプの ENI をインスタンスにアタッチすることはできます。

0

InstanceType

string

任意

ENI N のタイプ。このパラメーターの最初の N の値は、インスタンスタイプがサポートするインスタンスあたりの ENI の最大数を超えることはできません。インスタンスタイプがサポートするインスタンスあたりの ENI の最大数については、「インスタンスファミリーの概要」をご参照いただくか、DescribeInstanceTypes 操作を呼び出してください。

有効値:

  • Primary:プライマリ ENI

  • Secondary

デフォルト値:Secondary。

Secondary

Ipv6AddressCount

integer

任意

プライマリ ENI のためにランダムに生成する IPv6 アドレスの数。有効値:1~10。

次の点にご注意ください:

  • このパラメーターは、NetworkInterface.N.InstanceTypePrimary に設定されている場合にのみ有効です。NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、このパラメーターを指定することはできません。

  • このパラメーターを指定する場合、Ipv6AddressCountIpv6Address.N、または NetworkInterface.N.Ipv6Address.N を指定することはできません。

1

Ipv6Address

array

任意

プライマリ ENI に割り当てる IPv6 アドレス。プライマリ ENI には最大 10 個の IPv6 アドレスを割り当てることができます。2 番目の N の有効値:1~10。

例:Ipv6Address.1=2001:db8:1234:1a00::***

次の点にご注意ください:

  • このパラメーターは、NetworkInterface.N.InstanceTypePrimary に設定されている場合にのみ有効です。NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、このパラメーターを指定することはできません。

  • このパラメーターを指定する場合、Amount を 1 に設定し、Ipv6AddressCountIpv6Address.N、または NetworkInterface.N.Ipv6AddressCount を指定することはできません。

string

任意

プライマリ ENI に割り当てる IPv6 アドレス N。プライマリ ENI には最大 10 個の IPv6 アドレスを割り当てることができます。2 番目の N の有効値:1~10。

例:Ipv6Address.1=2001:db8:1234:1a00::***

次の点にご注意ください:

  • このパラメーターは、NetworkInterface.N.InstanceTypePrimary に設定されている場合にのみ有効です。NetworkInterface.N.InstanceTypeSecondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、このパラメーターを指定することはできません。

  • このパラメーターを指定する場合、Amount を 1 に設定し、Ipv6AddressCountIpv6Address.N、または NetworkInterface.N.Ipv6AddressCount を指定することはできません。

2001:db8:1234:1a00::***

NetworkCardIndex

integer

任意

ENI N のネットワークカードのインデックス。

次の点にご注意ください:

  • NIC インデックスは、特定のインスタンスタイプのインスタンスに対してのみ指定できます。

  • NetworkInterface.N.InstanceType を Primary に設定した場合、ネットワークカードをサポートするインスタンスタイプに対して NetworkInterface.N.NetworkCardIndex を 0 にのみ設定できます。

  • NetworkInterface.N.InstanceType を Secondary に設定するか、NetworkInterface.N.InstanceType を空のままにする場合、インスタンスタイプがネットワークカードをサポートしていれば、インスタンスタイプに基づいて NetworkInterface.N.NetworkCardIndex を指定できます。詳細については、「インスタンスファミリーの概要」をご参照ください。

0

DeleteOnRelease

boolean

任意

関連付けられたインスタンスがリリースされたときに ENI N をリリースするかどうかを指定します。有効値:

  • true:関連付けられたインスタンスがリリースされたときに ENI をリリースします。

  • false:関連付けられたインスタンスがリリースされたときに ENI を保持します。

デフォルト値:true。

説明

このパラメーターはセカンダリ ENI にのみ有効です。

true

NetworkInterfaceId

string

任意

インスタンスにアタッチする ENI の ID。

このパラメーターを指定する場合、Amount を 1 に設定する必要があります。

説明

このパラメーターはセカンダリ ENI にのみ有効です。既存のセカンダリ ENI を指定した後、他の ENI 作成パラメーターを指定することはできません。

eni-bp1gn106np8jhxhj****

RxQueueSize

integer

任意

ENI N の受信 (Rx) キューの深さ。

説明

このパラメーターは招待プレビュー中であり、公開されていません。このパラメーターを使用するには、チケットを送信してください。

次の点にご注意ください:

  • このパラメーターは第 7 世代以降の ECS インスタンスタイプにのみ適用されます。

  • このパラメーターは Linux イメージに適用されます。

  • Rx キューの深さが大きいほど、インバウンドスループットが高くなり、パケット損失率が減少しますが、より多くのメモリを消費します。

8192

TxQueueSize

integer

任意

ENI N の送信 (Tx) キューの深さ。

説明

このパラメーターは招待プレビュー中であり、公開されていません。このパラメーターを使用するには、チケットを送信してください。

次の点にご注意ください:

  • このパラメーターは第 7 世代以降の ECS インスタンスタイプにのみ適用されます。

  • このパラメーターは Linux イメージに適用されます。

  • Tx キューの深さが大きいほど、アウトバウンドスループットが高くなり、パケット損失率が減少しますが、より多くのメモリを消費します。

8192

SourceDestCheck

boolean

任意

ソース/宛先 IP アドレスチェック機能を有効にするかどうかを指定します。ネットワークセキュリティを向上させるために、この機能を有効にすることを推奨します。有効な値:

  • true:ソース/宛先 IP アドレスチェックを有効にします。

  • false:ソース/宛先 IP アドレスチェックを無効にします。

デフォルト値:false。

説明

この機能は一部のリージョンでのみ利用可能です。このメソッドを使用する前に、「ソース/宛先 IP アドレスチェック」をご参照ください。

false

SecondaryPrivateIpAddressCount

integer

任意

ENI に割り当てるセカンダリプライベート IPv4 アドレスの数。有効値:1~49。

  • 値はインスタンスタイプの IP アドレス制限を超えてはなりません。詳細については、「インスタンスファミリー」をご参照ください。

  • NetworkInterface.N.SecondaryPrivateIpAddressCount は、ENI に割り当てるセカンダリプライベート IPv4 アドレスの数を指定します (ENI のプライマリプライベート IP アドレスを除く)。システムは、ENI が属する仮想スイッチ (NetworkInterface.N.VSwitchId) の利用可能なセグメントからこれらのアドレスをランダムに割り当てます。

10

Tag

array<object>

任意

インスタンス、ディスク、プライマリ ENI に追加するタグ。

object

任意

インスタンス、ディスク、プライマリネットワークインターフェースカードのタグ情報。

Key

string

任意

インスタンス、ディスク、プライマリ ENI に追加するタグ N のキー。N の有効値:1~20。タグキーは空の文字列にすることはできません。タグキーは最大 128 文字の長さで、http:// または https:// を含めることはできません。タグキーは acs: または aliyun で始めることはできません。

TestKey

Value

string

任意

インスタンス、ディスク、プライマリ ENI に追加するタグ N の値。N の有効値:1~20。タグ値は空の文字列にすることができます。タグ値は最大 128 文字の長さで、http:// または https:// を含めることはできません。

TestValue

Ipv6Address

array

任意

プライマリ ENI に割り当てる IPv6 アドレス N。N の有効値:1~10。

例:Ipv6Address.1=2001:db8:1234:1a00::***

次の点にご注意ください:

  • Ipv6Address.N パラメーターが指定されている場合、Amount パラメーターを 1 に設定し、Ipv6AddressCount パラメーターを空にする必要があります。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、Ipv6Addresses.N または Ipv6AddressCount を設定することはできず、NetworkInterface.N.Ipv6Addresses.N または NetworkInterface.N.Ipv6AddressCount を設定する必要があります。

Ipv6Address.1=2001:db8:1234:1a00::***

string

任意

プライマリ ENI に割り当てる IPv6 アドレス N。N の有効値:1~10。

例:Ipv6Address.1=2001:db8:1234:1a00::***

次の点にご注意ください:

  • Ipv6Address.N パラメーターが指定されている場合、Amount パラメーターを 1 に設定し、Ipv6AddressCount パラメーターを空にする必要があります。

  • NetworkInterface.N.InstanceTypePrimary に設定されている場合、Ipv6Addresses.N または Ipv6AddressCount を設定することはできず、NetworkInterface.N.Ipv6Addresses.N または NetworkInterface.N.Ipv6AddressCount を設定する必要があります。

2001:db8:1234:1a00::***

SystemDisk

object

任意

システムディスク関連のパラメーター。SystemDisk.StorageClusterId を設定して、専用ブロックストレージクラスターの ID を指定できます。

StorageClusterId

string

任意

システムディスクが属する専用ブロックストレージクラスターの ID。インスタンス作成時に専用ブロックストレージクラスター内のディスクをシステムディスクとして使用したい場合は、このパラメーターを指定します。

dbsc-j5e1sf2vaf5he8m2****

ProvisionedIops

integer

任意

システムディスクとして使用する ESSD AutoPL ディスクのプロビジョニングされた読み取り/書き込み IOPS。有効値:0~min{50,000, 1,000 × 容量 - ベースライン IOPS}。

ベースライン IOPS = min{1,800 + 50 × 容量, 50,000}。

説明

このパラメーターは、SystemDisk.Categorycloud_auto に設定した場合にのみ利用可能です。詳細については、「ESSD AutoPL ディスク」をご参照ください。

40000

BurstingEnabled

boolean

任意

システムディスクのパフォーマンスバースト機能を有効にするかどうかを指定します。有効値:

  • true:システムディスクのパフォーマンスバースト機能を有効にします。

  • false:システムディスクのパフォーマンスバースト機能を無効にします。

説明

このパラメーターは、SystemDisk.Categorycloud_auto に設定した場合にのみ利用可能です。詳細については、「ESSD AutoPL ディスク」をご参照ください。

false

Encrypted

string

任意

システムディスクを暗号化するかどうかを指定します。有効値:

  • true:システムディスクを暗号化します。

  • false:システムディスクを暗号化しません。

デフォルト値:false。

説明

香港ゾーン D またはシンガポールゾーン A でのインスタンス作成中、インスタンスのシステムディスクは暗号化できません。

説明

暗号化されたスナップショットに基づいてディスクを作成するために共有暗号化イメージを使用する場合、ディスクが独自の暗号鍵を使用するように Encrypted を true に設定する必要があります。

false

KMSKeyId

string

任意

システムディスクに使用する KMS キーの ID。

0e478b7a-4262-4802-b8cb-00d3fb40****

EncryptAlgorithm

string

任意

説明

このパラメーターは公開されていません。

null

ImageOptions

object

任意

イメージオプションに関する詳細。

LoginAsNonRoot

boolean

任意

イメージを使用するインスタンスが ecs-user ユーザーのログインをサポートするかどうかを指定します。有効値:

  • true

  • false

false

NetworkOptions

object

任意

ネットワークオプションに関する詳細。

EnableJumboFrame

boolean

任意

インスタンスのジャンボフレーム機能を有効にするかどうかを指定します。有効値:

  • false:インスタンスのジャンボフレーム機能を有効にしません。インスタンス上のすべての ENI の最大転送単位 (MTU) 値は 1500 に設定されます。

  • true:インスタンスのジャンボフレーム機能を有効にします。インスタンス上のすべての ENI の MTU 値は 8500 に設定されます。

デフォルト値:true。

説明

ジャンボフレーム機能は、第 8 世代以降のインスタンスタイプでのみサポートされています。詳細については、「ジャンボフレーム」をご参照ください。

false

EnableNetworkEncryption

boolean

任意

説明

このパラメーターは招待プレビュー中であり、まだ公開されていません。

BandwidthWeighting

string

任意

インスタンスの帯域幅の重み値。有効範囲はインスタンスタイプによって異なります。特定のインスタンスタイプでサポートされている帯域幅の重みレベルを決定するには、DescribeInstanceTypes API を呼び出します。レスポンスの BandwidthWeighting フィールドは、そのインスタンスタイプでサポートされている帯域幅の重み層を示します。返された辞書値から Vpc-L1 や Ebs-L1 などの name フィールドを使用できます。

Default

AutoPay

boolean

任意

インスタンス作成の支払いを自動的に完了するかどうかを指定します。有効値:

  • true:支払いは自動的に完了します。

    **

    アカウントの残高が十分であることを確認してください。そうでない場合、注文は無効になり、キャンセルされます。アカウントの残高が不十分な場合は、AutoPayfalse に設定して未払いの注文を生成できます。その後、ECS コンソールにログインして注文の支払いを行うことができます。

  • false:注文は生成されますが、支払いは行われません。

    **

    InstanceChargeTypePostPaid に設定されている場合、AutoPayfalse に設定することはできません。

デフォルト値:true。

true

PrivateDnsNameOptions

object

任意

インスタンスのプライベートドメイン名オプション。

ECS プライベートドメイン名の解決については、「ECS プライベート DNS 解決」をご参照ください。

EnableInstanceIdDnsARecord

boolean

任意

インスタンス ID ベースのホスト名からインスタンスのプライマリプライベート IPv4 アドレスへの DNS 解決 (A レコード) が有効になっているかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

false

EnableInstanceIdDnsAAAARecord

boolean

任意

インスタンス ID ベースのホスト名からインスタンスのプライマリプライベート IPv6 アドレスへの DNS 解決 (AAAA レコード) が有効になっているかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

true

EnableIpDnsARecord

boolean

任意

IP アドレスベースのホスト名からインスタンスのプライマリプライベート IPv4 アドレスへの DNS 解決 (A レコード) が有効になっているかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

true

EnableIpDnsPtrRecord

boolean

任意

インスタンスのプライマリプライベート IPv4 アドレスから IP アドレスベースのホスト名への逆引き DNS 解決 (PTR レコード) が有効になっているかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

false

HostnameType

string

任意

ホスト名のタイプ。有効値:

  • Custom:カスタムホスト名

  • IpBased:IP アドレスベースのホスト名

  • InstanceIdBased:インスタンス ID ベースのホスト名

デフォルト値:Custom。

Custom

ClockOptions

object

任意

インスタンスのクロックプロパティに関連するパラメーター。

PtpStatus

string

任意

PTP ステータス。有効値:

  • enabled:PTP を有効にします。

  • disabled:PTP を無効にします。

デフォルト値:disabled。

列挙値:

  • disabled :

    PTP 無効

  • enabled :

    PTP 有効

enabled

レスポンスフィールド

フィールド

説明

object

作成されたインスタンスに関する情報。

RequestId

string

リクエスト ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

OrderId

string

注文 ID。このパラメーターは、InstanceChargeType が PrePaid に設定されている場合にのみ返されます。

123456****

TradePrice

number

取引価格。

0.165

InstanceIdSets

object

InstanceIdSet

array

インスタンス ID。

string

インスタンス ID。

i-bp67acfmxazb4ph****

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "OrderId": "123456****",
  "TradePrice": 0.165,
  "InstanceIdSets": {
    "InstanceIdSet": [
      "i-bp67acfmxazb4ph****"
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 LoginAsNonRoot.ImageNotSupport The specified image does not support login as non-root.
400 InvalidParam.NotSupportJumboFrame Not support jumbo frame.
400 InsufficientBalance.AgentCredit Insufficient agent credit. Please contact your agent.
400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s.
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can not exceed dedicated host expired date.
400 InvalidParam.SecondaryNetworkInterface When min amount greater than 1 and the PrivateIpAddress or Primary NetworkInterface is specified,the Secondary NetworkInterface IP parameter cannot be specified.
400 InvalidPrimaryIpAddress.SizeInvalid The NetworkInterface PrimaryIpAddress is used to create only one instance.
400 InvalidStorageClusterId.CapacityNotEnough The remaining capacity of the current dedicated storage cluster is less than the size of disk.
400 InvalidStorageClusterId.StatusNotSupport The current status of the dedicated storage cluster cannot create a cloud disk yet.
400 InvalidStorageClusterId.ZoneIdEmpty The specified param ZoneId cannot be empty when StorageClusterId given.
400 InvalidStorageClusterId.PerformanceLevelNotMatch The current dedicated storage cluster cannot create this performance level of disk.
400 InvalidStorageClusterId.CategoryNotMatch The current dedicated storage cluster cannot create this category of disk.
400 InvalidStorageClusterId.DiskSizeEmpty The specified param DiskSize cannot be empty when StorageClusterId given.
400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
400 InvalidInstanceType.ValueNotSupported The specified InstanceType beyond the permitted range.
400 InvalidDescription.Malformed The specified parameter "Description" is not valid.
400 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid.
400 InvalidParameter The specified parameter "InternetMaxBandwidthOut" is not valid.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid.
400 InvalidPassword.Malformed The specified parameter "Password" is not valid.
400 InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true.
400 InvalidSystemDiskCategory.ValueNotSupported The specified parameter "SystemDisk.Category" is not valid.
400 InvalidDiskName.Malformed The specified parameter "SyatemDisk.DiskName or DataDisk.n.DiskName" is not valid.
400 InvalidDiskDescription.Malformed The specified parameter "SyatemDisk.DiskDescription" or "DataDisk.n.Description" is not valid.
400 InvalidDataDiskSize.ValueNotSupported The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category.
400 InvalidDataDiskCategory.ValueNotSupported The specified parameter "DataDisk.n.Category" is not valid.
400 InvalidDataDevice.Malformed The specified parameter "DataDisk.n.Device" is not valid.
400 InvalidNodeControllerId.Malformed The specified parameter "NodeControllerId" is not valid.
400 InvalidInnerIpAddress.Malformed The specified parameter "InnerIpAddress" is not valid.
400 InvalidInnerIpAddress.Unusable The specified InnerIpAddress is already used or not found in usable ip range.
400 InvalidParameter.Conflict The specified image does not support the specified instance type.
400 ImageNotSupportCloudInit The specified image does not support cloud-init.
400 InvalidSnapshotId.BasedSnapshotTooOld The specified snapshot is created before 2013-07-15.
400 QuotaExceed.AfterpayInstance Living afterpay instances quota exceeded.
400 InvalidInstanceName.Malformed The specified parameter "InstanceName" is not valid.
400 InvalidInstanceName.CustomMalformed Customized section of instance or host name is invalid, please use valid format: [], [,], [m,], [,n], [m,n].
400 InvalidParameter.Mismatch Specified security group and virtual switch are not in the same VPC.
400 InvalidNetworkType.Mismatch Specified parameter "InternetMaxBandwidthIn" or "InternetMaxBandwidthOut" conflict with instance network type.
400 InvalidPrivateIpAddress Specified private IP address is not in the CIDR block of virtual switch.
400 InvalidPrivateIpAddress.Malformed Specified private IP address is malformed.
400 QuotaExceeded.PrivateIpAddress Don't have enough private IPs in this switch.
400 QuotaExceeded Living instances quota exceeded in this VPC.
400 IncorrectVSwitchStatus The current status of virtual switch does not support this operation.
400 ResourceNotAvailable Resource you requested is not available in this region or zone.
400 MissingParameter The input parameter "VSwitchId" that is mandatory for processing this request is not supplied.
400 InvalidDiskCategory.Mismatch The specified disk categories' combination is not supported.
400 MissingParamter The specified parameter "Period" is not null.
400 InvalidPeriod The specified period is not valid.
400 InstanceDiskCategoryLimitExceed The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category.
400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid.
400 InvalidIoOptimize.ValueNotSupported The specified IoOptimize is not valid.
400 InvalidSecurityGroupId.NotFound The SecurityGroupId provided does not exist in our records.
400 InvalidInternetMaxBandwidthOut.Malformed The specified parameter internetMaxBandwidthOut is not valid.
400 InvalidInternetMaxBandwidthIn.Malformed The specified parameter internetMaxBandwidthIn is not valid.
400 InvalidSnapshotId.NotFound The specified parameter SnapshotId is not exist.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
400 InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match.
400 InvalidTagCount The specified tags are beyond the permitted range.
400 InvalidMinAmount.Malformed The specified parameter MinAmount is not valid.
400 InvalidMaxAmount.Malformed The specified parameter MaxAmount is not valid.
400 InvalidAutoReleaseTime.Malformed The specified parameter AutoReleaseTime is not valid.
400 OperationDenied.NoVlan The specified parameter "VlanId" is not valid or vlan has not enough IP address.
400 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range.
400 Account.Arrearage Your account has been in arrears.
400 InvalidUserData.SizeExceeded The specified parameter "UserData" exceeds the size.
400 InvalidUserData.NotSupported TThe specified parameter "UserData" only support the vpc and IoOptimized Instance.
400 InvalidUserData.Base64FormatInvalid The specified UserData is not valid.
400 InstanceDiskNumber.LimitExceed The total number of specified disk in an instance exceeds.
400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid.
400 InvalidSpotStrategy The specified SpotStrategy is not valid.
400 InvalidSpotParam.EmptyZoneID The specified zoneid is empty when SpotStrategy is set.
400 InvalidSpotPriceLimit The specified SpotPriceLimitis not valid.
400 InvalidSpotDuration The specified SpotDuration is not valid.
400 InvalidSpotAuthorized The specified Spot param is unauthorized.
400 InvalidSpotPrepaid The specified Spot type is not support PrePay Instance.
400 InvalidSpotAliUid The specified UID is not authorized to use SPOT instance.
400 InvalidParameter.Bandwidth %s
400 RegionUnauthorized %s
400 Zone.NotOnSale %s
400 InvalidSystemDiskSize.ValueNotSupported %s
400 InvalidInstanceType.ElasticNetworkInterfaceNotSupported The specified instance type does not support Elastic Network Interface, you can not attach Elastic Network Interface to generation I instances.
400 InvalidParameter.EncryptedIllegal %s
400 InvalidParameter.EncryptedNotSupported %s
400 InvalidSpotPriceLimit.LowerThanPublicPrice The specified parameter "spotPriceLimit" can't be lower than current public price.
400 InvalidRelationResource.NotFound The relation resource has been deleted.
400 IncorrectRecycleBinStatus The operation is not permitted due to resource status.
400 InvalidHpcClusterId.Unnecessary The specified HpcClusterId is unnecessary.
400 InvalidVSwitchId.Necessary The VSwitchId is necessary.
400 InvalidHpcClusterId.Necessary The HpcClusterId is necessary.
400 InvalidHpcClusterId.NotFound The specified HpcClusterId is not found.
400 InvalidHpcClusterId.Creating The specified HpcClusterId is creating.
400 InvalidParameter.VSwitchId %s
400 InvalidSecurityGroup.NotInDefaultVpc %s
400 VpcNotFound Vpc is not found according to the specified VSwitch or the vpc does not belong to you.
400 InvalidSystemDiskSize.ImageNotSupportResize The specified image does not support resize.
400 InvalidSpotInterruptionBehavior %s
400 InvalidDeploymentOnHost %s
400 InvalidInstanceChargeType.NotSupport The Dedicated host not support the specified Instance charge type.
400 InvalidNetworkType.NotSupported The classic networkType not support create ECS on dedicatedHost.
400 NoAvaliableDedicatedHost No available dedicated host or not enough resource on dedicated host.
400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.
400 InvalidDedicatedHostStatus.NotSupport Operation denied due to dedicated host status.
400 IncorrectDedicatedHostStatus The current status of the resource does not support this operation.
400 ChargeTypeViolation.PostPaidDedicatedHost Prepaid instance onto postpaid dedicated host is not allowed.
400 DedicatedHostType.Unmatched The specified DedicatedHostType doesn?t match the instance type.
400 InvalidParam.NetworkInterface %s
400 InvalidParams.CreateEniParams %s
400 InvalidParameter.CreditSpecification The specified CreditSpecification is not supported in this region.
400 IncorrectVpcStatus Current VPC status does not support this operation.
400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the deployment set.
400 InvalidVpcZone.NotSupported The specified operation is not allowed in the zone to which your VPC belongs, please try in other zones.
400 IncorrectDefaultVpcStatus The status of the default VPC is invalid.
400 InvalidAutoRenewPeriod.ValueNotSupported The specified autoRenewPeriod is invalid.
400 InvalidMarketImageChargeType.NotSupport The specified chargeType of marketImage is unsupported.
400 OperationDenied The specified instanceType or zone is not available or not authorized.
400 InvalidPeriodType.ValueNotSupported The specified parameter PeriodType is invalid.
400 IncorrectImageStatus The specified image is an Alibaba Cloud Marketplace image. The sale of this image has ended. For more information, contact the image service provider.
400 InvalidParam.Tenancy The specified Tenancy is invalid.
400 InvalidParameter.Affinity The specified Affinity is invalid.
400 InvalidCustomInstanceType.NotSupported The specified custom instance type is invalid.
400 IoOptimized.NotSupported The specified instance must be IoOptimized instance when kmsKeyId is not empty.
400 InvalidSnapshotId.Malformed The specified SnapshotId is not valid.
400 InvalidCapacityReservationId.NotFound The specified CapacityReservationId does not exist.
400 LackResource There's no enough resource on the specified capacity reservation.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
400 InvalidSecurityGroup.NetworkType %s
400 InvalidSecurityGroup.VpcMismatch %s
400 InvalidParameter.SecurityGroupIdRepeated %s
400 InvalidSecurityGroupId.SingleIdAndMultiIdConflict %s
400 InvalidSecurityGroupId.MultiGroupIdNetworkTypeConflict %s
400 JoinedGroupLimitExceed %s
400 InvalidAccountStatus.PayAmountLimitExceeded Your account is being restricted, because you have no default payment method or you are not authorized.
400 InvalidPerformanceLevel.Malformed The specified parameter DataDisk.n.PerformanceLevel is not valid.
400 InvalidOperation.EniCountExceeded The maximum number of eni in a enterprise security group is exceeded.
400 QuotaExceeded.PrepayDataDiskCapacity The quota of prepay data disk capacity exceeds.
400 InvalidDiskCategory.ConflictSnapshotCategory The specified disk category conflict with snapshot category.
400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.
400 UnexpectedImageFamily.ImageIdSupplied The input parameter ImageFamily must be null when image id is set.
400 InvalidEncrypted.NotMatchEncryptAlgorithm The specified parameter Encrypted must be true when EncryptAlgorithm is not empty.
400 InvalidEncrypted.NotMatchKmsKeyId The specified parameter Encrypted must be true when KmsKeyId is not empty.
400 InvalidEncryptAlgorithm.NotMatchSnapshot The specified parameter EncryptAlgorithm is different from the encrypt algorithm of the snapshot.
400 InvalidKmsKeyId.NotMatchSnapshot The specified parameter KmsKeyId is different from the KmsKeyId of the snapshot.
400 InvalidEncryptAlgorithm The specified parameter EncryptAlgorithm is not valid.
400 InvalidHttpEndpoint.NotSupported The specified HttpEndpoint not supported, you can use enabled(default) or disabled.
400 InvalidHttpTokens.NotSupported The specified HttpTokens not supported, you can use optional(default) or required.
400 InvalidHttpPutResponseHopLimit.NotSupported The specified HttpPutResponseHopLimit not supported, more than 1 and less than 64 is reasonable.
400 InvalidOperation.VpcHasEnabledAdvancedNetworkFeature The specified vpc has enabled advanced network feature.
400 InvalidChargeType.CapacityReservationNotSupported %s
400 InvalidPerformanceLevel.ValueNotSupported The current ZoneId or InstanceType does not support PL0 of cloud_essd.
400 InvalidKMSKeyId.NotSymmetric The specified parameter KmsKeyId must be symmetric.
400 InvalidParameter.Arns The specified Arns is not valid.
400 InvalidDedicatedHostClusterId.NotFound The specified DedicatedHostClusterId does not exist.
400 InvalidDedicatedHostClusterId.InValid The specified Dedicated Host Cluster is invalid.
400 InvalidDeploymentSetId.NotFound The parameter DeploymentSetId is invalid.
400 InvalidOperation.UserNotSupported Reseller user do not support purchase at the moment.
400 InvalidManagedPrivateSpaceId.NotFound %s
400 InvalidSchedulerOptions The specified parameter SchedulerOptions is not valid.
400 MissingParameter.PrivatePoolOptionsId The specified PrivatePoolOptions.Id should not be null.
400 Invalid.PrivatePoolOptionsId The specified PrivatePoolOptions.Id is invalid.
400 DedicatedHostNotSupported DedicatedHost is not supported for PrivatePool.
400 SpotNotSupported Spot is not supported for PrivatePool.
400 ClassicNetworkNotSupported Classic network is not supported for PrivatePool.
400 Invalid.InstanceId Instance does not exist.
400 Invalid.PrivatePoolOptions.MatchCriteria Target mode does not support this operation.
400 MissingParameter.PrivatePoolOptions.Id The specified PrivatePoolOptions.Id should not be null.
400 Invalid.PrivatePoolOptions.Id The PrivatePool does not exist.
400 Invalid.InstanceType The InstanceType does not match the PrivatePool.
400 Invalid.InstanceChargeType The InstanceChargeType does not match the PrivatePool.
400 Invalid.ZoneId The ZoneId does not match the PrivatePool.
400 Invalid.PrivatePoolOptions.NoStock The PrivatePool has been used up.
400 InvalidPlatform.ValueNotSupported The Platform does not match the PrivatePool.
400 Invalid.PrivatePoolOptions.status The PrivatePool is expired or inactive.
400 InvalidAliUid The PrivatePool does not belong to the user of the Instance.
400 InvalidBandwidthOut.LessThanZero The bandwidth must be larger than 0 when specifying isp.
400 HibernationConfigured.InstanceTypeNotSupport The specified instance type is not support.
400 HibernationConfigured.ImageNotEncrypted The hibernation configured instance only support encrypted image.
400 HibernationConfigured.MemorySizeTooBig The hibernation configured instance memory size is too big.
400 InvalidSystemDiskSize.LessThanMemSize The specified parameter SystemDisk.Size is less than the memory size.
400 InvalidCloudBoxZone.OperationNotSupported The cloud box zone does not support creating prepaid or encrypted resources.
400 ProvisionedIopsForDiskCategoryUnsupported The specified disk category does not support provisioned iops.
400 InvalidProvisionedIops.LimitExceed The provisioned iops exceeds the limit.
400 BurstingEnabledForDiskCategoryUnsupported The specified disk category does not support bursting enabled.
400 BurstingEnabledForMultiAttachDiskUnsupported The multi attach disk does not support bursting enabled.
400 ProvisionedIopsForDiskCategoryRequired The provisioned iops is required for this disk category.
400 NotSupportSnapshotEncrypted.InstanceType The specified instance type does not support creating encrypted disks with native snapshot encrypt.
400 NotSupportSnapshotEncrypted.RegionId The specified region does not support creating encrypted disks with native snapshot encrypt.
400 NotSupportSnapshotEncrypted.ZoneId The specified zone does not support creating encrypted disks with native snapshot encrypt.
400 NotSupportSnapshotEncrypted.ShareImage Shared snapshot creating encrypted disks with native snapshot encrypt is not supported.
400 NotSupportSnapshotEncrypted.ImageOwnerAlias The specified image category does not support creating encrypted disks with native snapshot encrypt.
400 NotSupportSnapshotEncrypted.DiskCategory The specified disk category does not support creating encrypted disks with native snapshot encrypt.
400 NotSupport.SnapshotEncryptedAlgorithmConflict Changing encrypt algorithm with encrypted snapshot is not supported.
400 NoPermission.SystemTag The operator is not permission for the system tag.
400 NumberExceed.Tags The Tags parameter's number is exceed , Valid : 20.
400 InvalidZoneId.NotSupportShareEncryptedImage Creating instances by shared encrypted images is not supported in this zone.
400 InvalidDiskCategory.NotSupported The specified disk category is not supported.
400 InvalidParameter.CloudboxNotSupported %s
400 InvalidZoneId.NotSupportCreateWithShareEncryptedImage You cannot use shared encrypted images to create instances in this zone.
400 InvalidParameter.NetworkCardIndexInvalid Invalid network card index, please check your instance type.
400 InvalidOperation.UserNotSupportNetworkCard User not support network card.
400 InvalidAccount.NotSupportSpot According to business rules, this account cannot purchase ECS Spot instances.
400 AccountForbidden.AssociatedWithResellerPartner Your account is associated with your reseller partner. Your account or your reseller partner's account has been forbidden to create orders, please contact your reseller partner.
400 InvalidDestinationZone.DeploymentSetMismatch Error happened, %s.
400 NoPermission.Price The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.
400 InvalidAutoPay.PostPaidUnsupported The specified parameter AutoPay must be set as true for postpaid instance.
400 InvalidParam.EncryptedMismatch Creating encrypted disks with shared encrypted snapshots requires replacing encryption keys.
400 InvalidParameter.DedicatedRegionNotSupported The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.
400 InvalidParameter.CpuOptionsTopologyType The specified parameter CpuOptions.TopologyType: %s is not valid.
400 InvalidInstanceType.NotSupportCpuOptionsTopologyType The specified instance type does not support CpuOptions.TopologyType: %s.
400 InvalidEniQueueSize.RegionOrUserNotSupported The specified parameter RxQueueSize or TxQueueSize is not supported in this region, or this account is not in the whitelist of using eni QueueSize.
400 InvalidParameter.EniQueueSize The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.
400 InvalidParameter.KmsNotEnabled Failed to perform this operation because KMS is not activated.
400 InvalidParameter.Encrypted.KmsNotEnable Failed to perform this operation because KMS is not activated.
400 InvalidPrivateIpAddress.Duplicated The specified private IP address is already in use.
400 InvalidAdditionalInfoPvdConfig.SizeExceeded The specified parameter AdditionalInfo.PvdConfig exceeds the size.
400 InvalidParameter.Encrypted Creating non-encrypted disks with encrypted snapshots is not supported.
400 InvalidInstanceType.NotSupportHighDensityMode The specified instance type does not support the use of the high density mode.
400 QuotaExceeded.InternetBandwidth %s.
400 InvalidParameter.CpuOptionsAccelerators The specified parameter CpuOptionsAccelerators is not valid.
400 InvalidInstanceType.NotSupportCpuOptionsAccelerators The specified instance type does not support attach accelerator.
400 OperationDenied.TestAccountRetricted Test-account for testing has been prohibited from creating instance in this region. Please contact 400181.
400 InvalidBurstingEnabled.DiskSizeTooSmall The disk size must be greater than 3 GiB to enable burst.
400 InvalidImage.WindowsUnsupported The specified InstanceType does not support the specified Windows image.
400 InvalidParameter.CpuOptionsTurboMode The specified parameter TurboMode is not valid.
400 InvalidInstanceType.EnableNVSUnsupported The specified instance type does not support EnableNVS.
400 InvalidInstanceType.EnableVISSTUnsupported The specified instance type does not support EnableVISST.
400 InvalidInstanceType.EnableVRDTUnsupported The specified instance type does not support EnableVRDT.
400 InvalidInstanceType.SingleCoreMaxModeUnsupported The specified instance type does not support TurboMode: "SINGLE CORE MAX".
400 InvalidParameter.PtpStatus The specified parameter PtpStatus: %s is not valid.
400 InvalidInstanceType.NotSupportEnablePtp The specified instance type does not support enable PTP.
400 InvalidInstanceType.NetworkOptionsBandwidthWeightingUnsupported The current instance type does not support setting or modifying the BandwidthWeighting parameter.
400 InvalidParameter.NetworkOptionsBandwidthWeighting The specified parameter BandwidthWeighting is not valid.The correct value should be in [%s].
400 InvalidMarketImage.NotAuthorized The specified marketplace image is not authorized for your channel, please use other image.
401 InvalidRamRole.NotEcsRole The specified ram role is not authorized for ecs, please check your role policy.
500 InternalError The request processing has failed due to some unknown error.
403 OperationDenied.CashCouponsInsufficientOrExpired Cash coupon balance is insufficient or has expired, please retry.
403 InvalidParameter.PrivateIpAddressRepeated %s
403 InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded %s
403 InvalidParameter.EniNumExceededWithLaunchEcs %s
403 InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode %s
403 InvalidParameter.QueuePairNumberMustEmpty %s
403 InvalidParameter.EniTrafficMode %s
403 InvalidParameter.InvalidQueuePairNumber The parameter of QueuePairNumber is invalid.
403 InvalidParam.IpCount The parameter of ip count is invalid.
403 InvalidParameter.EniType %s
403 InvalidOperation.HighPerformanceTrafficModeIsNotAllowed %s
403 InvalidParameter.NetworkInterface %s
403 InvalidParameter.Combination %s
403 InvalidHostname.SingleAndMultiConflict %s
403 InvalidHostname.SizeInvalid %s
403 InvalidParams.InstanceNameExceed The uniqueSuffix takes three naming places, please shorten your InstanceName.
403 InvalidParams.HostnameExceed The uniqueSuffix takes three naming places, please shorten your Hostname.
403 ImageNotSubscribed The specified image has not be subscribed.
403 InvalidSystemDiskCategory.ValueUnauthorized The disk category is not authorized.
403 InvalidSnapshotId.NotReady The specified snapshot has not completed yet.
403 InstanceDiskCategoryLimitExceed The total size of specified disk category in an instance exceeds.
403 InvalidDevice.InUse The specified device has been occupied.
403 ImageRemovedInMarket The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed.
403 CategoryNotSupported The specified zone does not offer the specified disk category.
403 QuotaExceed.PortableCloudDisk The quota of portable cloud disk exceeds.
403 SecurityGroupInstanceLimitExceed Exceeding the allowed amount of instances of a security group.
403 NodeControllerUnavailable The Node Controller is temporarily unavailable.
403 RegionUnauthorized There is no authority to create instance in the specified region.
403 InvalidSnapshotId.NotDataDiskSnapshot The specified snapshot is system disk snapshot.
403 Forbbiden User not authorized to operate on the specified resource.
403 DeleteWithInstance.Conflict The specified disk is not a portable disk and cannot be set to DeleteWithInstance attribute.
403 InstanceDiskNumLimitExceed The number of specified disk in an instance exceeds.
403 IoOptimized.NotSupported The specified image is not support IoOptimized Instance.
403 InvalidDiskSize.TooSmall Specified disk size is less than the size of snapshot.
403 InvalidDiskCategory.Mismatch The specified disk categories combination is not supported.
403 InvalidDiskCategory.NotSupported The specified disk category is not support the specified instance type.
403 QuotaExceed.BuyImage The specified image is from the image market?You have not bought it or your quota has been exceeded.
403 InvalidResourceId.NotSupported The specified ResourceId does not support tagging.
403 OperationDenied The specified RegionId does not support the creation of the network type ECS instance.
403 OperationDenied.ImageNotValid The specified Image is disabled or is deleted.
403 OperationDenied.SnapshotNotValid The specified snapshot is not allowed to create disk.
403 OperationDenied.SnapshotNotAllowed The specified snapshot is not allowed to create disk.
403 OperationDenied.ZoneNotAllowed The creation of Instance to the specified Zone is not allowed.
403 OperationDenied.ZoneSystemCategoryNotMatch The specified Zone or cluster does not offer the specified disk category or the speicified zone and cluster do not match.
403 OperationDenied.ResourceControl The specified region is in resource control, please try later.
403 OperationDenied.NoStock The resource is out of usage.
403 OperationDenied.SnapshotParamsNotValid The capacity of snapshot exceeds the size limit of the specified disk category or the specified category is not authorizied.
403 OperationDenied.DiskTypeNotSupport The type of the disk does not support the operation.
403 InvalidUserData.Forbidden User not authorized to input the parameter "UserData", please apply for permission "UserData".
403 Zone.NotOpen The specified zone is not granted to you to buy resources yet.
403 Zone.NotOnSale The resource in the specified zone is no longer available for sale. Please try other regions and zones.
403 InvalidClusterId.NotFound The specified clusterId does not exist.
403 InvalidResourceType.NotSupported %s
403 InvalidInstanceType.ValueNotSupported The specified InstanceType beyond the permitted range.
403 InvalidInstanceType.ZoneNotSupported The specified zone does not support this instancetype.
403 InstanceType.Offline %s
403 DependencyViolation.WindowsInstance The instance creating is window, cannot use ssh key pair to login.
403 InvalidNetworkType.MismatchRamRole A RAM role can?t be used for classic instance.
403 InvalidUser.PassRoleForbidden The RAM user does not have the privilege to pass a RAM role.
403 InvalidParam.TrustedSystemMode The specified TrustedSystemMode is invalid.
403 InvalidParam.ConfidentialComputingMode The specified ConfidentialComputingMode is invalid.
403 InvalidInstanceType.NotSupported The specified instance type does not support trusted system.
403 InvalidSecurityOptions.NotSupported SecurityOptions for vTPM and Enclave can not both be set.
403 InvalidImage.NotSupported The specified vTPM instance need UEFI image.
403 Forbidden.RiskControl This operation is forbidden by Aliyun RiskControl system.
403 InvalidInstance.UnPaidOrder The specified Instance has unpaid order.
403 Account.Arrearage Your account has been in arrears.
403 RealNameAuthenticationError Your account has not passed the real-name authentication yet.
403 InvalidPayMethod The specified pay method is not valid.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 ImageNotSupportInstanceType The specified image does not support the specified InstanceType.
403 DryRun.InvalidAmount %s
403 OperationDenied.InvalidNetworkType %s
403 InvalidSpotInterruptionBehavior.ClassicNetworkNotSupport The specified SpotInterruptionBehavior does not support Classic network Instance.
403 InvalidSpotInterruptionBehavior.LocalDiskNotSupport The specified SpotInterruptionBehavior does not support local disk instance.
403 QuotaExceed.PostPaidDisk Living postPaid disks quota exceeded.
403 InvalidParameter.NotMatch %s
403 InvalidVSwitch.DefaultVSwitchNotSupport The specified zone in vpc can't support create default vSwitch.
403 OperationDenied.LocalDiskUnsupported The configuration change is not allowed when the specified instance has local disks mounted.
403 OperationDenied.InconsistentNetwork The specified security group and vswitch are not in the same vpc.
403 DefaultVswitch.Existed The default vswitch for VPC already exists.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 CategoryViolation The specified instance does not support this operation because of its disk category.
403 ResourcesNotInSameZone The specified instance and dedicated host are not in the same zone.
403 InvalidDisk.SystemDiskSize The specified SystemDiskSize beyond the permitted range.
403 InsufficientBalance Your account does not have enough balance.
403 InvalidOperation.NetworkInterface %s
403 MaxEniIpv6IpsCountExceeded %s
403 InvalidIp.IpRepeated %s
403 InvalidIp.IpAssigned %s
403 InvalidIp.Address %s
403 InvalidOperation.EniCountExceeded %s
403 InvalidOperation.Ipv4CountExceeded %s
403 InvalidOperation.Ipv6CountExceeded %s
403 InvalidOperation.Ipv6NotSupport %s
403 InvalidOperation.Ipv4NotSupport %s
403 InvalidParam.SecondaryIp %s
403 InvalidVSwitch.Ipv6NotTurnOn %s
403 InvalidParam.IpAssign %s
403 InvalidParam.Amount %s
403 InvalidParam.CpuOptionsCore %s
403 InvalidParam.CpuOptionsNuma %s
403 InvalidVSwitchId.IpInvalid %s
403 Forbidden.RegionId %s
403 QuotaExceed.DeploymentSetInstanceQuotaFull The instance quota in one deployment set exceeded.
403 InvalidChargeType.ValueNotSupported Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.
403 InvalidRegion.NotSupport The specified region does not support byok.
403 UserNotInTheWhiteList The user is not in byok white list.
403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS.
403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.
403 Mayi.InternalError The request processing has failed due to some unknown error.
403 InvalidNetworkType The network type is not support in this region.
403 InvalidAccountStatus Your account status is invalid, please contact customer service.
403 QuotaExceeded.PrivateIpAddress %s
403 OperationDenied.PerformanceLevelNotMatch The specified DataDisk.n.PerformanceLevel and DataDisk.n.Size do not match.
403 InvalidStorageSetName.Malformed Specified parameter StorageSetName is not valid.
403 InvalidDescription.Malformed Specified parameter Description is not valid.
403 InvalidMaxPartitionNumber.Malformed Specified parameter MaxPartitionNumber is not valid.
403 InvalidParameter.StorageSetPartitionNumber Specified parameter StorageSetPartitionNumber is not valid.
403 InvalidParameter.StorageSetId Specified parameter StorageSetId is not valid.
403 InvalidParameter.StorageSetZoneId Specified parameter StorageSetZoneId is not valid.
403 EnterpriseGroupLimited.MutliGroupType The specified instance can't join multi SecurityGroup types.
403 EnterpriseGroupLimited.InstanceType The specified instance type doesn't support Enterprise SecurityGroup.
403 QuotaExceed.Tags %s
403 OperationDenied.RegionIdNotSupported The specified region does not support spot duration instance.
403 OperationDenied.FlavorNotSupported Flavor not support spot duration instance.
403 OperationDenied.TimestampNotSupported Timestamp not support spot duration instance.
403 OperationDenied.PaygNotAvailable Pay-as-you-go instance is not available now.
403 OperationDenied.PrepayNotAvailable Prepay instance is not available now.
403 OperationDenied.BidOwnResource Bid user can not own resource.
403 OperationDenied.CloudSSDNotSupported The specified available zone does not offer the cloud_ssd disk, use cloud_essd instead.
403 QuotaExceed.ElasticQuota No additional quota is available for the specified ECS instance type.
403 QuotaExceeded.PostpaidDataDiskCapacity The quota of postpaid data disk capacity exceeds.
403 InvalidImageFamily.MissingAvailableImage There is no available image related to the specified image family.
403 InvalidRegionId.NotSupportEncryptAlgorithm The current region does not support creating encrypted disks with EncryptAlgorithm.
403 InvalidOperation.ResourceManagedByCloudProduct %s
403 InvalidManagedPrivateSpaceId.DedicatedHostIdConflict ManagedPrivateSpaceId and DedicatedHostId cannot be specified at the same time.
403 InvalidManagedPrivateSpaceId.TenancyConflict ManagedPrivateSpaceId and Tenancy cannot be specified at the same time.
403 InvalidParameter.InvalidEniQueueNumber %s
403 InvalidOperation.MaxEniQueueNumberExceeded %s
403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
403 InvalidIspType.ValueNotSupported %s
403 UnsupportedIspChargeType %s
403 UnsupportedIspClassicNetwork %s
403 InvalidIspBandwidthOut %s
403 UnsupportedIspNetworkChargeType %s
403 InvalidIspUID %s
403 UnsupportedIspRegion %s
403 Forbidden.OnlySupportEnterpriseGroup %s
403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance.
403 InstanceDiskLimitExceeded The amount of the disk on instance reach its limits.
403 InvalidInstanceType.NotSupportDiskCategory The instanceType of the specified instance does not support this disk category.
403 InvalidOperation.ConfidentialComputingModeInInviteOnlyTesting The specified confidential computing mode is in invite only testing: %s.
403 InvalidOperation.InvalidNetworkInterfaceId %s
403 InvalidOperation.RegionNotSupportNetworkInterfaceId The specific region does not support network interface id.
403 InvalidEniId.NotFound %s
403 NotSupportSnapshotEncrypted.DiskCategory The specified disk category does not support creating encrypted system disks or creating encrypted data disks from snapshots. Check the DiskCategory or Encrypted parameter, or check your account for default encryption settings.
403 InvalidOperation.PublicIpAddressNoStock The public IP address for the specified Region or ChargeType of the instance is out of stock. Please try another Region or ChargeType.
403 AclLimitExceed %s
403 InvalidParameter.DataEncryptedKeyCreateFailed Create kms data encrypted key fail. If you need further assistance, you can contact the KMS Technical Support.
403 InvalidParameter.CpuOptionsThreadsPerCore The specified parameter CpuOptions.ThreadsPerCore is not valid.
403 InvalidParameter.CpuOptionsCore The specified parameter CpuOptions.Core is not valid.
403 InvalidInstanceType.CpuOptionsThreadsPerCoreUnsupported The current instance type does not support setting or modifying the CpuOptions.ThreadsPerCore parameter.
403 InvalidParameter.CpuOptionsNuma The specified parameter CpuOptions.Numa is not valid.
403 InvalidParameter.KMSKeyId.CMKUnauthorized The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.
403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK (Customer Master Key) must be in an active state.
403 InvalidEncrypted.NotMatchSnapshot The specified parameter Encrypted must be set to true when creating disks with encrypted snapshots.
403 InvalidEncrypted.NotMatchDiskDefaultEncryption Enabling disk default encryption prevents the creation of non-encrypted disks.
403 InvalidOperation.InstanceTypeNotSupportNetworkEncryption The specified instance type does not support network encryption.
403 InvalidOperation.UserNotSupportNetworkEncryption User not support network encryption.
403 InvalidOperation.InstanceTypeNotSupportEniTrunking The current instance type does not support ENI trunking operation.
404 InvalidStorageClusterId.NotExist The specified StorageClusterId does not exist in current region.
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
404 InvalidZoneId.NotFound The ZoneId provided does not exist in our records.
404 InvalidSecurityGroupId The specified SecurityGroupId is invalid or does not exist.
404 InvalidSecurityGroupId.NotFound The SecurityGroupId provided does not exist in our records.
404 InvalidDataDiskSnapshotId.NotFound The specified parameter "DataDisk.n.SnapshotId" is not valid.
404 InvalidClusterId.NotFound The ClusterId provided does not exist in our records.
404 InvalidVSwitchId.NotFound Specified virtual switch does not exist.
404 InvalidImageId.NotFound The specified ImageId does not exist.
404 IoOptimized.NotSupported The specified instancetype is not support IoOptimized instance.
404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records.
404 DependencyViolation.IoOptimized The specified instancetype must be IoOptimized instance.
404 PaymentMethodNotFound No payment method has been registered on the account.
404 HOSTNAME_ILLEGAL The specified parameter HostName is not valid.
404 InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size.
404 InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size.
404 InvalidSystemDiskSize.MoreThanMaxSize The specified parameter SystemDisk.Size is more than the max size.
404 OperationDenied.ImageNotValid The specified Image is disabled or is deleted.
404 OperationDenied.CreatingConflict Another Instance has been creating.
404 InvalidKeyPairName.NotFound The specified parameter KeyPairName does not exist in our records.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.
404 InvalidRamRole.NotFound The specified parameter "RAMRoleName" does not exist.
404 InvalidLaunchTemplate.NotFound %s
404 InvalidLaunchTemplateVersion.NotFound %s
404 InvalidVSwitchId.NotExist %s
404 InvalidMarketImage.NotFound The specified marketplace image does not exist, please change the imageId and try again.
404 DeploymentSet.NotFound The specified deployment set does not exist.
404 InvalidParameter.DeploymentSetGroupNo Parameter DeploymentSetGroupNo is invalid.
404 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist.
404 InvalidDiskIds.NotPortable The specified DiskId is not portable.
404 InvalidAutoSnapshotPolicyId.NotFound Specified parameter AutoSnapshotPolicyId not found.
429 Throttling.Resource The request throttle by resource operation.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。