ECS インスタンスを作成します。

説明

インスタンスを作成する前に、DescribeAvailableResource を呼び出して、指定されたリージョンまたはゾーンで利用可能なリソースを表示することができます。 インスタンスの自動作成や、自動的に実行(Running)状態に入ることを希望する場合は、RunInstances を呼び出すことをお勧めします。

インスタンスの作成にはリソースに対する課金が発生するため、インスタンスを作成する前に ECS の課金方法を十分にご確認ください。 詳しくは、課金方法 をご参照ください。 請求方法がPrePaidに設定されている場合、アカウントで利用可能なクーポンが使用されます。

本インターフェイスを呼び出す際は次の点に留意してください。

instance types

  • IoOptimizedパラメーターを使用して、最適化されたインスタンスを作成するかどうかを示すことができます。
  • ephemeral_ssdインスタンスの場合、インスタンスタイプは作成後に変更できません。

images

インスタンスを作成するときは、image を選択して、新しいインスタンスのシステムディスク構成を決定する必要があります。 インスタンスが作成されると、そのシステムディスクはその image のクローンになります。

  • インスタンスメモリが 512 MiB の場合、Windows Server 1709 image のみを使用できます。
  • インスタンスメモリが 4 GiB 以上の場合、32 bit OS image は使用できません。

network configuration

  • VPC タイプのインスタンスを作成するには、VPC ネットワークと VSwitch を指定する必要があります。 1 つのインスタンスは 1 つの VSwitch にのみ属することができます。
  • VSwitchIdを指定する場合は、SecurityGroupIdVSwitchIdと同じ VPC に存在する必要があります。
  • VSwitchIdPrivateIpAddressの両方を指定する場合、PrivateIpAddress は VSwitch と同じ CIDR ブロックに存在する必要があります。
  • PrivateIpAddressVSwitchId に依存しているため、PrivateIpAddress のみを指定することはできません。
  • この API を呼び出してインスタンスを作成する場合、インスタンスにパブリック IP アドレスは割り当てられません。 AllocatePublicIpAddress を呼び出して、パブリック IP アドレスをインスタンスに割り当てることができます。
  • InternetChargeTypeInternetMaxBandwidthOut パラメータを使用して、帯域幅料金を制限できます。 インスタンスのインバウンドトラフィックは無料であるため、InternetMaxBandwidthIn は帯域幅の請求とは関係ありません。
  • InternetChargeTypeInternetMaxBandwidthOut との関係は次のとおりです:
    • InternetChargeType=PayByTrafficはインスタンスが実際のトラフィックに基づいて課金されることを示します。そのため、InternetMaxBandwidthOut の値は指定された帯域幅の上限値と同様です。 従量課金が使用されています。

security groups

  • CreateSecurityGroup を呼び出して、セキュリティグループを作成できます。
  • インスタンスを作成するときにセキュリティグループの指定や、ModifyInstanceAttribute を呼び出してインスタンスのセキュリティグループを変更することができます。
  • 同じセキュリティグループに属するインスタンスは相互にアクセスできますが、異なるセキュリティグループに属するインスタンスの間では相互アクセスはできません。 ただし、セキュリティグループ認証を使用してファイアウォールアクセス許可を構成し、異なるセキュリティグループのインスタンスが相互にアクセスできるようにすることができます。 詳細は、AuthorizeSecurityGroupAuthorizeSecurityGroupEgress をご参照ください。
  • 1 つのセキュリティグループには、最大 1,000 個のインスタンスを含めることができます。

storage

  • データディスクの最大容量は、ディスクのカテゴリによって異なります:
    • シングルベーシックディスク(cloud)の最大容量は 2,000 GiB です。
    • シングルウルトラディスク(cloud_efficiency)の最大容量は 32 TiB(32,768 GiB)です。
    • シングル SSD(cloud_ssd)の最大容量は 32 TiB(32,768 GiB)です。
    • シングル ESSD(cloud_essd)の最大容量は 32 TiB(32,768 GiB)です。
    • シングルローカル SSD(ephemeral_ssd)の最大容量は 800 GiB です。
  • ECS は、作成したインスタンスに適切なサイズのシステムディスクを割り当てます。 システムディスクのキャパシティは、最大 {20, ImageSize} 以上である必要があります。 システムディスクは、ベーシックディスク(cloud)、ウルトラディスク(cloud_efficiency)、SSD(cloud_ssd)、またはローカル SSD(ephemeral_ssd)です。
  • システムディスクがベーシックディスク(cloud)、ウルトラディスク(cloud_efficiency)、または SSD(cloud_ssd)の場合、データディスクをローカル SSD(ephemeral_ssd)にすることはできません。
  • 最適化されたインスタンスを選択すると、システムディスクはウルトラディスク(cloud_efficiency)または SSD(cloud_ssd)のみになります。
  • 1 つのインスタンスに最大 16 個のデータディスクを接続できます。 データディスクのマウントポイントは、システムによってデフォルトの順序で /dev/xvdb から /dev/xvdz に割り当てられます。 ローカル SSD(ephemeral_ssd)がデータディスクとして使用される場合、システムディスクはローカル SSD である必要があります。 インスタンスのローカル SSD の合計容量は 1 TiB(システムディスクを除く 1,024 GiB)を超えることはできません。
  • インスタンスを作成するときに、ローカル SSD ephemeral_ssdを指定する必要があります。 インスタンスの作成後に追加することはできません。 詳細は、インスタンスタイプファミリー をご参照ください。

user data

インスタンスがユーザーデータの要件を満たしている場合、UserData 情報をインポートできます。 ユーザーデータは Base64 でエンコードされています。 ユーザーデータはプレーンテキストモードでインポートされるため、パスワードやキーなどの機密情報をインポートしないことをお勧めします。 機密情報を転送する必要がある場合、インスタンスでインポートおよび暗号化解除する前に、情報を暗号化して Base64 でエンコードすることをお勧めします。

others

Alibaba Cloud CLI および SDK でこの API を呼び出す場合、まず次のパラメータからピリオド(。)を削除します:SystemDisk.CategorySystemDisk.SizeSystemDisk.DescriptionDataDisk.n.SizeDataDisk.n.CategoryDataDisk.n.SnapshotIdDataDisk.n.DiskNameDataDisk.n.DescriptionDataDisk.n.DeleteWithInstance および DataDisk.N.PerformanceLevel

たとえば、Alibaba Cloud CLI および SDK では、SystemdiskcategorySystemDisk.Category を表すために使用されます。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメーター

名前 データ型 必須/省略可能 説明
ImageId String 必須 win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd

インスタンスを作成するときに指定するイメージファイルの ID 。 Marketplace イメージの詳細は、Alibaba Cloud Marketplace の[製品の詳細]ページで ImageId をご参照ください。

InstanceType String 必須 ecs.g5.large

インスタンスの種類 詳細については、インスタンスタイプファミリーを参照するか、またはDescribeInstanceTypes を呼び出して最新のインスタンスタイプのリストを取得します。

RegionId String 必須 cn-hangzhou

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

Action String 省略可能 CreateInstance

実行する操作。 値を CreateInstance に設定します。

AutoRenew Boolean 省略可能 true

自動更新が有効になっているかを示します。 このパラメーターは、InstanceChargeTypePrePaidに設定されている場合にのみ有効になります。 有効値:

  • true
  • false
AutoRenewPeriod Integer 省略可能 2

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

PeriodUnit が Month に設定されている場合: {“1”, “2”, “3”, “6”, “12”}。

ClientToken String 省略可能 123e4567-e89b-12d3-a456-426655440000

べき等性を保証するために使用されるトークン。 クライアントでトークンの生成が可能ですが、トークンはグローバル一意である必要があります。ClientToken には ASCII 文字のみが使用可能です。 長さは 64 文字以下である必要があります。 詳細については、べき等性を確保する方法 をご参照ください。

ClusterId String 省略可能 c-clusterid1

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

このパラメーターは削除予定です。 互換性を確保するために他のパラメーターを使用することを推奨します。
CreditSpecification String 省略可能 Standard

バースト可能なインスタンスの実行モード (t5)。 有効値:

既定値 : NULL。

DataDisk.n.Category String 省略可能 cloud-ssd

n 番目のデータディスクのカテゴリ。 既定値:cloud 有効値:

  • cloud:ベーシックディスク
  • cloud_efficiency:ウルトラディスク。
  • cloud_ssd:SSD
  • ephemeral_ssd: ローカル SSD
  • cloud_essd:ESSD ESSD はまだパブリックベータテスト段階であるため、一部の地域のみで利用が可能です。 詳細については、ESSD FAQをご参照ください。
DataDisk.n.DeleteWithInstance Boolean 省略可能 true

インスタンスとともにデータディスクがリリースされるかどうかを示します。 既定値:true

DataDisk.n.Description String 省略可能 DataDiskFinance

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

DataDisk.N.Device String 省略可能 /dev/xvda

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

DataDisk.N.DiskName String 省略可能 DataDisk

n 番目のデータディスクの名前。 長さは 2〜128 文字である必要があります。大文字と小文字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 先頭は文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。 既定値 : null 。

DataDisk.n.Encrypted Boolean 省略可能 false

n 番目のデータディスクが暗号化されているかを示します。 既定値:false

DataDisk.n.Size Integer 省略可能 2,000

n 番目のデータディスクのサイズ。n の範囲は 1〜16 です。 単位:GiB。 有効値:

  • cloud:5〜2,000。
  • cloud_efficiency: 20 〜 32768
  • cloud_ssd: 20 〜 32768
  • cloud_essd:20 〜 32768
  • ephemeral_ssd: 5 〜 800

この値のサイズはSnapshotId以上である必要があります。

DataDisk.n.SnapshotId String 省略可能 s-bp17441ohwka0yuhx3h0

n 番目のデータディスクの作成に使用されるスナップショットの ID。n の範囲は 1〜16 です。 DataDisk.n.SnapshotIdが指定されている場合、DataDisk.n.Sizeの値は無視されます。 新しいデータディスクのサイズは、指定されたスナップショットと同じサイズになります。 2013 年 7 月 15 日以前に作成されたスナップショットはここでは使用できません。 それ以外の場合、エラーが返され、リクエストは拒否されます。

DedicatedHostId String 省略可能 dh-dedicatedhost1

指定された専用ホスト (DDH) で ECS インスタンスを作成するかを示します。 DescribeDedicatedHosts を呼び出して DDH リストを表示することができます。

DDH でプリエンプティブインスタンスを作成することはできません。 指定した場合DedicatedHostId を指定した場合、SpotStrategy SpotPriceLimit の値は無視されます。

DeletionProtection Boolean 省略可能 false

インスタンスのリリース保護の属性。 ECS コンソール上で、またはDeleteInstance操作でインスタンスのリリースが可能かを示します。 既定値:false 有効値:

  • true:リリース保護を有効化します。
  • false:リリース保護を無効化します。
この属性は従量課金のインスタンスに適用可能です。 手動のリリース操作をブロックする際に使用できます。システムによる自動リリース操作はブロックできません。
SystemDisk.PerformanceLevel String 省略可能 PL1

システムディスクとして使用される ESSD クラウドディスクに対して選択するパフォーマンスレベル。 有効値:

  • PL1 (既定値):単1 つのディスクのランダム読み取り/書き込み IOPS は最大 50,000 です。
  • PL2 :単1 つのディスクのランダム読み取り/書き込み IOPS は最大 100,000 です。
  • PL3 :単1 つのディスクのランダム読み取り/書き込み IOPS は最大 1,000,000 です。

ESSD クラウドディスクのパフォーマンスレベルを選択する方法については、「ESSD クラウドディスク」をご参照ください。

DataDisk.N.PerformanceLevel String 省略可能 PL2

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

  • PL1 (既定値):単1 つのディスクのランダム読み取り/書き込み IOPS は最大 50,000 です。
  • PL2 :単1 つのディスクのランダム読み取り/書き込み IOPS は最大 100,000 です。
  • PL3 :単1 つのディスクのランダム読み取り/書き込み IOPS は最大 1,000,000 です。

ESSD クラウドディスクのパフォーマンスレベルを選択する方法については、ESSD クラウドディスク をご参照ください。

Affinity String 省略可能 default

インスタンスが作成された DDH にECS インスタンスを関連付けるかを示します。 有効値:

  • デフォルト :インスタンスが作成される DDH にインスタンスが関連付けられていません。 停止した VPC インスタンスへの無課金 (VPC 接続) 機能が有効化されているインスタンスでは、インスタンスの再起動後に元の DDH に十分なリソースがない場合、自動 DDH リソースプールで該当のインスタンスは別の DDH でホストされます。
  • ホスト :インスタンスは、インスタンスが作成されるDDHに関連付けられます。 停止した VPC インスタンスへの無課金 (VPC 接続) 機能が有効化されているインスタンスは、再起動後も元のDDH でホストされます。 元の DDH に十分なリソースがない場合、インスタンスの再起動は失敗します。

規定値:default

Tenancy String 省略可能 default

DDH で ECS インスタンスを作成するかを示します。 有効値:

  • デフォルト : DDH 上にECS インスタンスが作成されません。
  • ホスト:DDH 上に ECS インスタンスが作成されます。 DedicatedHostIdを指定しない場合、Alibaba Cloud がインスタンスの DDH を自動的に選択します。

規定値:default

DeploymentSetId String 省略可能 ds-bp1brhwhoqinyjd6tn3x

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

Description String 省略可能 InstanceFinance

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

DryRun Boolean 省略可能 false

チェックリクエストのみを送信するかを示します。 既定値:false

  • true: 確認要求は送信されますが、インスタンスは作成されません。 システムが必要なパラメーターが設定されているかを確認し、要求形式、サービス制限、使用可能な ECS インスタンスを検証します。 確認が失敗した場合、対応するエラーコードが返されます。 確認が成功した場合、DryRunOperationが返されます。
  • false:要求が送信され、インスタンスが作成されます。
HostName String 省略可能 LocalHost

インスタンスのホスト名

  • 名前の先頭または末尾の文字はピリオド (.) またはハイフン (-) にすることはできず、連続するピリオド (.) またはハイフン (-) は指定できません。
  • Windows の場合:ホスト名は 2〜15 文字の長さである必要があります。大文字と小文字、数字、ハイフン (-) を含めることができます。 ピリオド (.) や数字だけを指定することはできません。
  • その他のオペレーティングシステムの場合:ホスト名の長さは 2〜64 文字である必要があります。大文字と小文字、数字、ハイフン (-) を含めることができます。 ピリオド (.) で区切ることができます。
HpcClusterId String 省略可能 hpc-hpcclusterid

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

InnerIpAddress String 省略可能 XX.XXX.XX.XXX

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

InstanceChargeType String 省略可能 PrePaid

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

  • PrePaid:サブスクリプション PrePaid に設定されている場合は、支払口座に十分な残高またはクレジットがあることを確認してください。 それ以外の場合はInvalidPayMethodエラーコードが返されます。
  • PostPaid:従量課金
InstanceName String 省略可能 yk201812061032

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

InternetChargeType String 省略可能 PayByTraffic

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

  • PayByTraffic:実際のトラフィックに基づいて課金されます。
InternetMaxBandwidthIn Integer 省略可能 200

パブリックネットワークのインバウンド帯域幅の最大値。 単位:Mbit/s。 有効値:1〜200。

既定値 : 200

InternetMaxBandwidthOut Integer 省略可能 5

パブリックネットワークのアウトバウンド帯域幅の最大値。 単位:Mbit/s。 有効値:0〜100。

既定値:0

IoOptimized String 省略可能 optimized

インスタンスが I/O 最適化インスタンスであるかを示します。フェーズアウトインスタンスタイプの既定値は none で、その他のインスタンスの場合は optimized です。 有効値:

  • none。
  • optimized。
KeyPairName String 省略可能 インスタンステスト

キーペアの名前。

  • Windows インスタンスの場合は、このパラメーターを無視してください。 既定値 : null 。 このパラメーターが指定されている場合でも、パスワード値が使用されます。
  • Linux インスタンスの場合、初期化の段階ではパスワードログオン方法は禁止されています。 インスタンスのセキュリティを改善するには、キーペア接続方法を使用することをお勧めします。
NodeControllerId String 省略可能 nc-nodecontroller

このパラメータは破棄されました。

OwnerAccount String 省略可能 ECSforCloud@Alibaba.com

RAM ユーザーのログインネーム。

パスワード String 省略可能 EcsV587!

インスタンスのパスワード。 長さは 8~30 文字である必要があります。大文字、小文字、数字、特殊文字が使用可能です。 以下の記号が使用可能です。


括弧(())、グレイヴアクセント( `)、チルダ(〜)、感嘆符(!)、アットマーク(@)、番号記号(#)、ドル記号($)、パーセント記号(%)、キャレット(^ )、アンパサンド(&)、アスタリスク(*)、ハイフン(-)、アンダースコア(_)、プラス記号(+)、等号(=)、縦線(|)、中括弧({})、括弧([]] )、コロン(:)、セミコロン(;)、アキュートアクセント( ')、山括弧(<>)、コンマ(、)、ピリオド(。)、疑問符(?)、スラッシュ(/)。

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

パスワード が指定されている場合は、パスワードを機密に管理するために HTTPS プロトコルでリクエストを送信することを推奨します。 インスタンスのセキュリティを改善するには、キーペア接続方法を使用することをお勧めします。
PasswordInherit Boolean 省略可能 false

イメージで事前定義されたパスワードを使用するかを示します。 PasswordInherit が指定されている場合、 Password は null である必要があります。 選択したイメージにパスワードが設定されていることをご確認ください。

Period Integer No 1

インスタンスのサブスクリプション期間。 単位:month 。 このパラメーターは、InstanceChargeTypePrePaidに設定されている場合にのみ有効・必要になります。 DedicatedHostId が指定されている場合、Period パラメーター値の範囲は DDH のサブスクリプション期間内である必要があります。 有効値:

PeriodUnit が month に設定されている場合:{ “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “12”, “24”, “36”,”48”,”60”} 。

PeriodUnit String 省略可能 Month

サブスクリプション期間の単位。 既定値:Month 。 有効値:Week、Month。

PrivateIpAddress String 省略可能 172.16.236.14X

インスタンスのプライベート IP アドレス。 PrivateIpAddress は VSwitchId に依存し、個別に指定することはできません。

RamRoleName String 省略可能 FinanceDept

インスタンスの RAM ロール名。 ListRoles を呼び出して、指定したインスタンスの RAM ロールを表示できます。

ResourceGroupId String 省略可能 rg-resourcegroupid

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

SecurityEnhancementStrategy String 省略可能 Active

セキュリティー強化を有効化するかを示します。 有効値:

  • Active:セキュリティ強化を有効化します。 システムイメージにのみ適用できます。
  • Deactive:セキュリティ強化を無効化します。 すべてのイメージに適用可能です。
SecurityGroupId String 省略可能 sg-bp15ed6xe1yxeycg7ov3

インスタンスが属するリソースグループの ID 。 同じセキュリティグループ内のインスタンスは相互にアクセスすることができます。

SpotInterruptionBehavior String 省略可能 Terminate

プリエンプティブインスタンスの中断モード。 インスタンスがリリースされる終了モードのみがサポートされています。

SpotPriceLimit Float 省略可能 0.98

インスタンスの最高価格/時。 小数点以下 3 桁まで正確です。 SpotStrategy SpotWithPriceLimit に設定されている場合にのみ有効になります。

SpotStrategy String 省略可能 NoSpot

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

  • NoSpot:通常の従量課金インスタンス。
  • SpotWithPriceLimit:価格上限が定義されたプリエンプティブインスタンス。
  • SpotAsPriceGo:現在の市場価格に基づいた従量課金のインスタンス。
SystemDisk.Category String 省略可能 cloud-ssd

システムディスクのカテゴリ。フェースアウトインスタンスタイプの non-optimized インスタンスのデフォルト値は Cloud です。 その他のインスタンスの規定値は cloud_efficiency です。 有効値:

  • cloud:ベーシックディスク
  • cloud_efficiency:ウルトラディスク。
  • cloud_ssd:SSD
  • ephemeral_ssd: ローカル SSD
  • cloud_essd:ESSD ESSD クラウドディスクはまだパブリックベータテストフェーズにあり、一部のリージョンでのみ利用可能です。 詳細については、ESSD FAQをご参照ください。
SystemDisk.Description String 省略可能 SystemDiskFinance

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

SystemDisk.DiskName String 省略可能 SystemDisk

システムディスクの名前。 長さは 2〜128 文字である必要があります。大文字と小文字、数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。 先頭は文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。 既定値 : null 。

SystemDisk.Size Integer 省略可能 40

システムディスクのサイズ。 単位:GiB。 有効値:20 〜 500 。 この値は、最大 {20, ImageSize} 以上である必要があります。 既定値:最大 {40, ImageSize}

Tag.N.Key String 省略可能 FinanceDept

インスタンス、ディスク、プライマリ NIC のタグキー。 n の範囲は 1〜20 です。 このパラメーターを指定する場合、空にすることはできません。 長さは 64 文字以下である必要があります。 先頭文字列を ”aliyun”、”acs:”、”http://“ 、または “https://“ にすることはできません。

Tag.N.Value String 省略可能 FinanceDeptJoshua

インスタンス、ディスク、プライマリ NIC のタグ値。 n の範囲は 1〜20 です。 このパラメーターを指定する場合、空にすることができます。 長さは 128 文字以下である必要があります。 先頭文字列を ”aliyun”、”acs:”、”http://“ 、または “https://“ にすることはできません。

Tag.N.key String 省略可能 FinanceDept

インスタンス、ディスク、およびプライマリ NIC のタグキー。

このパラメーターは削除予定です。 互換性を確保するために、Tag.N.Key を使用することを推奨します。
Tag.N.value String 省略可能 FinanceDeptJoshua

インスタンス、ディスク、およびプライマリ NIC のタグキー。

このパラメーターは削除予定です。 互換性を確保するため、Tag.N.Value を使用することを推奨します。
UseAdditionalService Boolean 省略可能 true

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

UserData String 省略可能 ZWNobyBoZWxsbyBlY3Mh

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

VSwitchId String 省略可能 vsw-bp1s5fnvk4gn2tws03ziX

VSwitch の ID。 VPC タイプのインスタンスの作成時に指定する必要があります。

VlanId String 省略可能 10

インスタンスの VLAN ID 。

ZoneId String 省略可能 cn-hangzhou-d

インスタンスのゾーン ID 。 詳細は、 DescribeZonesをご参照ください。

既定値 : null 。 ゾーンを指定しない場合、システムはランダムにゾーンを選択します。

レスポンスパラメーター

名前 データ型 説明
InstanceId String i-instance1

インスタンスの ID 。 インスタンスの一意の識別子です。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエスト ID 。 API 操作の結果にかかわらず、各 API リクエストに対してシステムから固有の RequestId が返されます。

リクエストの例


https://ecs.aliyuncs.com/?Action=CreateInstance
&RegionId=cn-hangzhou 
&ImageId=_32_23c472_20120822172155_aliguest.vhd 
&SecurityGroupId=sg-c0003e8b9 
&HostName=Bctest01 
&InstanceType=ecs.t1.small
&<Common request parameters>

通常のレスポンスの例

XML 形式

<CreateInstanceResponse> 
  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId> 
  <InstanceId>i-instance1</InstanceId>
</CreateInstanceResponse> 

JSON 形式

{
	"InstanceId":"i-instance1",
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FE73368"
}

エラー

HTTP ステータスコード エラーコード エラーメッセージ 意味
400 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is not valid. 指定されたインスタンスタイプが存在しない場合に返されるエラーメッセージ。
400 InvalidSystemDiskCategory.ValueNotSupported The specified parameter " SystemDisk.Category" 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. 指定されたデータディスクの最大サイズに達した場合に返されるエラーメッセージ。
403 InvalidDiskCategory.NotSupported The specified disk category is not support the specified instance type. 指定されたディスクタイプが指定のインスタンスタイプでサポートされていない場合に返されるエラーメッセージ。
400 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. 指定のインスタンスタイプがサポートされていない場合に返されるエラーメッセージ。
404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 指定された SecurityGroupId がアカウントに存在しない場合に表示されるエラーメッセージ。 SecurityGroupId が正しいか確認してください。
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. 指定された HostName の形式が無効の場合に返されるエラーメッセージ。
400 InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true. PasswdInherit が true に設定されていてパスワードを設定できない場合に返されるエラーメッセージ。
400 InvalidSystemDiskCategory.ValueNotSupported The specified parameter "SystemDisk.Category" is not valid. 指定された SystemDisk.Category が無効な場合に返されるエラーメッセージ。
400 InvalidDiskDescription.Malformed The specified parameter "SystemDisk.DiskDescription" or "DataDisk.N.Description" is not valid. 指定された SyatemDisk.DiskDescription または DataDisk.N.Description が無効な場合に返されるエラーメッセージ。
400 InvalidDataDiskCategory.ValueNotSupported The specified parameter "DataDisk.N.Category" is not valid. 指定された DataDisk.N.Category が無効な場合に返されるエラーメッセージ。
400 OperationDenied The specified parameter "VlanId" is not valid or vlan has not enough IP address. 指定された VLAN ID が無効であるか、この VLAN で使用可能な IP アドレスがない場合に返されるエラーメッセージ。
400 InvalidSnapshotId.BasedSnapshotTooOld The specified snapshot is created before 2013-07-15. 指定されたスナップショットが 2013 年 7 月 15 日以前に作成されたときに返されるエラーメッセージ。
400 InvalidMarketImageChargeType.NotSupport The specified chargeType of marketImage is unsupported. マーケットプレイスイメージの課金方法が無効な場合に返されるエラーメッセージ。
403 OperationDenied The specified Image is disabled or is deleted. 指定されたイメージが無効、または削除された場合に表示されるエラーメッセージ。
403 InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 指定されたスナップショットが完了していない場合に返されるエラーメッセージ。
403 OperationDenied The specified snapshot is not allowed to create disk. 指定したスナップショットに対してディスクが作成できない場合に返されるエラーメッセージ。
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 including exact the same product code has been removed. 指定されたマーケットプレースイメージが使用可能の場合に返されるエラーメッセージ。
404 InvalidClusterId.NotFound The ClusterId provided does not exist in our records. 指定された ClusterId がが存在しない場合に返されるエラーメッセージ。
403 OperationDenied The creation of Instance to the specified Zone is not allowed. 指定したゾーンにインスタンスを作成できない場合に返されるエラーメッセージ。
403 OperationDenied The specified Zone or cluster does not offer the specified disk category or the specified zone and cluster do not match. 指定されたゾーンまたはクラスターで指定されたディスクカテゴリが使用できない場合、または指定されたゾーンとクラスターが一致しない場合に返されるエラーメッセージ。
400 InvalidDiskDescription.Malformed The specified parameter "SystemDisk.DiskDescription or DataDisk.N.Description" is not valid. 指定された SyatemDisk.DiskDescription または DataDisk.N.Description が無効な場合に返されるエラーメッセージ。
403 RegionUnautifiedized There is no authority to create instance in the specified region. 指定されたリージョンにインスタンスを作成する権限がない場合に返されるエラーメッセージ。
403 CategoryNotSupported The specified Zone or cluster does not offer the specified disk category. 指定されたディスクカテゴリが指定したゾーンまたはクラスターで使用できない場合に返されるエラーメッセージ。
403 CategoryNotSupported The specified cluster does not offer the specified disk category. 指定されたクラスターで指定のディスクカテゴリが使用できない場合に返されるエラーメッセージ。
404 InvalidVSwitchId.NotFound Specified virtual switch does not exist. 指定されたトレイルがが存在しない場合に表示されるエラーメッセージです。
400 InvalidParameter.Mismatch Specified security group and virtual switch are not in the same VPC. 指定されたセキュリティグループが VSwitch と同じ VPC 内にない場合に返されるエラーメッセージ。
400 InvalidPrivateIpAddress Specified private IP address is not in the CIDR block of virtual switch. 指定されたプライベート IP アドレスが、 VSwitch の 同じ CIDR ブロック内に存在しない場合に返されるエラーメッセージ。
400 InvalidPrivateIpAddress.Malformed Specified private IP address is malformed. 指定されたプライベート IP アドレスが無効な場合に返されるエラーメッセージ。
400 IncorrectVSwitchStatus The current status of virtual switch does not support this operation. 指定された VSwitch が保留状態にあり、削除できない場合に表示されるエラーメッセージ。
400 InvalidParameter.Mismatch Specified virtual switch is not in the specified zone. 指定された VSwithc が指定のゾーンに存在しない場合に返されるエラーメッセージ。
400 MissingParameter The input parameter "VSwitchId" that is mandatory for processing this request is not supplied. VSwitchId パラメーターが空の場合に返されるエラーメッセージ。
400 InvalidDiskCategory.Mismatch The specified disk categories' combination is not supported. 指定されたディスクタイプが一緒に使用されている場合に表示されるエラーメッセージ。
404 InvalidImageId.NotFound The specified ImageId does not exist. 指定されたイメージが該当のアカウントに存在しない場合に返されるエラーメッセージ。 イメージ ID が正しいか確認してください。
404 OperationDenied Another Instance has been creating 新しいインスタンスを作成できない場合に返されるエラーメッセージ。
403 InvalidDiskSize.TooSmall Specified disk size is less than the size of snapshot 指定されたディスクにスナップショット用のスペースが十分に確保できない場合に返されるエラーメッセージ。
403 OperationDenied The type of the disk does not support the operation 現行ディスクカテゴリが指定された操作をサポートしていない場合に返されるエラーメッセージ。
404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records 指定されたインスタンスタイプが存在しない場合に返されるエラーメッセージ。
400 InvalidPeriod The specified period is not valid. 指定されたパラメーターが無効な場合に返されるエラーメッセージ。
400 InvalidDataDiskCategory.ValueNotSupported The specified parameter " DataDisk.N.Category " 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. 指定されたデータディスクの最大サイズに達した場合に返されるエラーメッセージ。
403 OperationDenied The resource is out of usage. インスタンスが実行中のステータスではない場合に表示されるエラーメッセージ。 インスタンスを有効化するか、適切な操作が実行されているかを確認します。
404 InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size. 指定された SystemDisk.Size がイメージサイズより小さい場合に返されるエラーメッセージ。
400 InvalidSystemDiskCategory.ValueNotSupported The specified parameter SystemDisk.Category is not valid. 指定された DiskCategory が無効な場合に返されるエラーメッセージ。
403 InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. 指定された autoRenewPeriod が無効な場合に返されるエラーメッセージ。
403 InvalidUserData.Forbidden User not authorized to input the parameter "UserData", please apply for permission "UserData" UserData を設定する権限がない場合に表示されるエラーメッセージ。
400 InvalidUserData.NotSupported The specified parameter "UserData" only support the vpc and IoOptimized Instance. 指定された UserData が VPC タイプまたは最適化インスタンスのみでサポートされている場合に表示されるエラーメッセージ。
403 InvalidResourceType.NotSupported This resource type is not supported; please try other resource types. 指定されたリソースタイプが不足の場合に返されるエラーメッセージ。
403 InvalidInstanceType.ZoneNotSupported The specified zone does not support this instancetype. 指定されたインスタンスタイプが指定のゾーンでサポートされていない場合に返されるエラーメッセージ。
400 InstanceDiskNumber.LimitExceed The total number of specified disk in an instance exceeds. インスタンスにある指定のディスクの最大数に達した場合に返されるエラーメッセージ。
400 Account.Arrearage Your account has an outstanding payment. アカウントに未払いのオーダーがある場合に表示されるエラーメッセージ。
400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid. 指定された DiskCategory が無効な場合に返されるエラーメッセージ。
400 InvalidAutoRenewPeriod.ValueNotSupported The specified autoRenewPeriod is not valid. 指定された autoRenewPeriod が無効な場合に返されるエラーメッセージ。
400 InvalidParameter.Bandwidth %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidDataDiskCategory.ValueNotSupported %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidSystemDiskCategory.ValueNotSupported %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidParameter.Conflict %s パラメーターが別のパラメーターと競合している場合に返されるエラーメッセージ。
400 InvalidInternetChargeType.ValueNotSupported %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidInstanceType.ValueNotSupported %s 指定されたインスタンスタイプが無効な場合に表示されるエラーメッセージ。
403 InstanceType.Offline %s 指定されたインスタンスタイプが利用できない場合に表示されるエラーメッセージ。
500 InternalError %s 内部エラーが発生したときに返されるエラーメッセージ。
400 InvalidSystemDiskSize.ValueNotSupported %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidDataDiskSize.ValueNotSupported %s パラメーターが無効である場合に返されるエラーメッセージ。
404 InvalidKeyPairName.NotFound The specified parameter "KeyPairName" does not exist in our records. 指定された KeyPairName がが存在しない場合に返されるエラーメッセージ。
403 DependencyViolation.WindowsInstance The instance creating is window, cannot use ssh key pair to login. Windows で SSH キーペアがサポートされていない場合に返されるエラーメッセージ。
400 InvalidInstanceType.ValueNotSupported The specified parameter "KeyPairName" only support IoOptimized Instance. SSH キーペアが最適化インスタンスでサポートされていない場合に返されるエラーメッセージ。
403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. 実名認証に失敗したときに返されるエラーメッセージ。
400 OperationDenied The specified instance type or Zone is not available or not authorized. 指定されたインスタンスタイプまたはゾーンが使用できないか、許可されていない場合に返されるエラーメッセージ。
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. アカウントに十分な残高がない場合に返されるエラーメッセージ。
400 InvalidParameter.EncryptedIllegal %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidParameter.EncryptedNotSupported %s パラメーターが無効である場合に返されるエラーメッセージ。
400 EncryptedOption.Conflict %s パラメーターが無効である場合に返されるエラーメッセージ。
400 InvalidParameter.Encrypted.KmsNotEnabled The encrypted disk need enable KMS KMS が暗号化されたディスクに対して有効になっていない場合に返されるエラーメッセージ。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 未知のエラーが発生した場合に表示されるエラーメッセージ。
400 InvalidSpotPriceLimit.LowerThanPublicPrice The specified parameter "soptPriceLimit" can't be lower than current public price. 指定された spotPriceLimit が現在の価格より低い場合に返されるエラーメッセージ。
400 InvalidHpcClusterId.Unnecessary The specified HpcClusterId is unnecessary. 指定した HpcClusterId が無効な場合に返されるエラーメッセージ。
400 InvalidVSwitchId.Necessary The VSwitchId is necessary. VSwitchId が指定されていない場合に返されるエラーメッセージ。
400 InvalidHpcClusterId.Necessary The HpcClusterId is necessary. HpcClusterId が指定されていない場合に返されるエラーメッセージ。
400 InvalidHpcClusterId.NotFound The specified HpcClusterId is not found. 指定された HPC クラスター ID が存在しない場合に返されるエラーメッセージ。
400 InvalidHpcClusterId.Creating The specified HpcClusterId is creating. 指定された HPC クラスターが無効な場合に返されるエラーメッセージ。
400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. 指定された PeriodUnit が無効な場合に返されるエラーメッセージ。
400 IncorrectImageStatus Encrypted snapshots do not support this operation. 暗号化されたスナップショットで操作がサポートされていない場合に返されるエラーメッセージ。
400 InvalidTagValue.Malformed The specified Tag.N.Value is not valid. 指定された Tag.N.Value が無効な場合に表示されるエラーメッセージ。
400 InvalidSecurityGroup.NotInDefaultVpc %s 指定されたセキュリティグループがデフォルトの VPC に存在しない場合に返されるエラーメッセージ。
403 InvalidParameter.NotMatch %s パラメーターが別のパラメーターと競合している場合に返されるエラーメッセージ。
400 InvalidSpotInterruptionBehavior %s SpotInterruptionBehavior がサポートされていない場合に返されるエラーメッセージ。
403 InvalidSpotInterruptionBehavior.ClassicNetworkNotSupport The specified SpotInterruptionBehavior does not support Classic network Instance. プリエンプティブインスタンスがクラシックインスタンスである場合に返されるエラーメッセージ。
403 InvalidSpotInterruptionBehavior.LocalDiskNotSupport The specified SpotInterruptionBehavior does not support local disk instance. ローカルディスクを有するプリエンプティブインスタンスの使用を試みると返されるエラーメッセージす。
400 InvalidDeploymentOnHost %s 指定されたデプロイメントセットで DDH がサポートされていない場合に返されるエラーメッセージ。
400 InvalidInstanceChargeType.NotSupport The Dedicated host not support the specified Instance charge type. 該当の課金方法が DDH でサポートされていない場合に返されるエラーメッセージ。
400 InvalidNetworkType.NotSupported The classic networkType not support create ECS on dedicatedHost DDH でクラシックネットワークの使用を試みると返されるエラーメッセージ。
400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. 指定された DDH ID が存在しない場合に返されるエラーメッセージ。
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 DDH の課金方法が変更された場合に返されるエラーメッセージ。
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date. インスタンスの有効期限日が DDH の有効期限日よりも遅い場合に返されるエラーメッセージ。
400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorize. 該当のインスタンスタイプを使用する権限が付与されていない場合に返されるエラーメッセージ。
400 DedicatedHostType.Unmatched The specified DedicatedHostType doesn't match the instance type. プリエンプティブインスタンスが該当のイスタンスタイプをサポートしていない場合に返されるエラーメッセージ。
400 LackResource There's no enough resource on the specified dedicated host. DDH に十分なリソースがない場合に返されるエラーメッセージ。
400 ChargeTypeViolation.PostPaidDedicatedHost Prepaid instance onto postpaid dedicated host is not allowed. DDH の課金方法が変更されたときに返されるエラーメッセージ。
403 InvalidVSwitch.DefaultVSwitchNotSupport The specified zone in vpc can't support create default vSwitch. 指定されたゾーンの VPC でデフォルトの VSwitch がサポートされていない場合に返されるエラーメッセージ。
400 InvalidParameter.CreditSpecification The specified CreditSpecification is not supported in this region. 指定された CreditSpecification がこのリージョンでサポートされていない場合に表示されるエラーメッセージ。
400 IncorrectImageStatus The specified Image is not available. 指定されたソースイメージのステータスが正しくない場合に返されるエラーメッセージ。
404 InvalidMarketImage.NotFound The specified marketplace image does not exist, please change the imageId and try again. 指定されたマーケットプレイスイメージが存在しない場合に返されるエラーメッセージ。
400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the deployment set. 指定されたデプロイメントセットで指定のインスタンスタイプがサポートされていない場合に返されるエラーメッセージ。
400 InvalidVpcZone.NotSupported Zone of the specified VSwitch is not available for creating, please try in other zones. 指定されたゾーンの VPC でデフォルトの VSwitch がサポートされていない場合に返されるエラーメッセージ。
40 IncorrectDefaultVpcStatus The status of the default VPC is invalid. デフォルト VPC のステータスが正しくない場合に返されるエラーメッセージ。
404 DeploymentSet.NotFound The specified deployment set does not exist. 指定されたデプロイメントセットが存在しない場合に返されるエラーメッセージ。

エラーコードの表示