すべてのプロダクト
Search

このプロダクト

    Elastic Compute Service:CreateLaunchTemplateVersion

    ドキュメントセンター

    Elastic Compute Service:CreateLaunchTemplateVersion

    最終更新日:Jun 29, 2026

    指定された ECS 起動テンプレートに新しいバージョンを作成し、後続の ECS インスタンス、弾力的スケーリンググループ、または自動プロビジョニンググループの作成に使用します。

    操作説明

    操作説明

    特定のバージョンのパラメーターを変更するには、新しいテンプレートバージョンを作成します。各インスタンス起動テンプレートは最大 30 バージョンをサポートします。

    今すぐお試しください

    この 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:CreateLaunchTemplateVersion

    create

    *LaunchTemplate

    acs:ecs:{#regionId}:{#accountId}:launchtemplate/{#launchtemplateId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

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

    cn-hangzhou
    RegionId

    string

    必須

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

    cn-hangzhou
    LaunchTemplateId

    string

    任意

    起動テンプレートの ID。詳細については、 DescribeLaunchTemplates を呼び出してください。起動テンプレートを特定するには、LaunchTemplateId または LaunchTemplateName を指定する必要があります。

    lt-m5eiaupmvm2op9d****
    LaunchTemplateName

    string

    任意

    起動テンプレートの名前。名前は 2～128 文字で、英字で始まる必要があり、http:// または https:// で始めることはできません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

    testLaunchTemplateName
    VersionDescription

    string

    任意

    起動テンプレートバージョンの説明。説明は 2～256 文字で、http:// または https:// で始めることはできません。

    testVersionDescription
    ImageId

    string

    任意

    インスタンスの作成に使用するイメージの ID。 DescribeImages を呼び出して、利用可能なイメージリソースをクエリできます。

    win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
    ImageOwnerAlias

    string

    任意

    イメージのソース。

    説明

    このパラメーターは廃止予定です。互換性を向上させるため、他のパラメーターを使用してください。

    system
    PasswordInherit

    boolean

    任意

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

    • true

    • false

    デフォルト値: false。

    説明

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

    false
    InstanceType

    string

    任意

    インスタンスタイプ。詳細については、「インスタンスファミリー」をご参照ください。 DescribeInstanceTypes を呼び出して、最新のインスタンスタイプリストをクエリすることもできます。

    ecs.g5.large
    SecurityGroupId

    string

    任意

    このバージョンを使用して作成されたインスタンスが属するセキュリティグループの ID。同じセキュリティグループ内のインスタンスは相互に通信できます。

    説明

    SecurityGroupId と SecurityGroupIds.N を同時に指定することはできません。

    sg-bp15ed6xe1yxeycg****
    VpcId

    string

    任意

    インスタンスが属する仮想プライベートクラウド (VPC) の ID。

    vpc-bp12433upq1y5scen****
    VSwitchId

    string

    任意

    vSwitch の ID。VPC 接続インスタンスを作成する場合、このパラメーターを指定する必要があります。

    vsw-bp1s5fnvk4gn2tws0****
    InstanceName

    string

    任意

    インスタンスの名前。名前は 2～128 文字で、英字、数字、および Unicode 文字カテゴリの文字 (各種言語の文字を含む) を含めることができます。名前にはコロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を含めることができます。デフォルト値はインスタンスの InstanceId です。

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

    k8s-node-[1,4]-alibabacloud
    Description

    string

    任意

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

    testDescription
    InternetMaxBandwidthIn

    integer

    任意

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

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

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

    50
    InternetMaxBandwidthOut

    integer

    任意

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

    5
    HostName

    string

    任意

    Elastic Compute Service (ECS) サーバーのホスト名。

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

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

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

    testHostName
    ZoneId

    string

    任意

    インスタンスのゾーン ID

    cn-hangzhou-g
    SystemDisk.Category

    string

    任意

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

    • cloud: 基本ディスク。

    • cloud_efficiency: Ultra ディスク。

    • cloud_ssd: 標準 SSD。

    • cloud_auto: ESSD AutoPL ディスク。

    • cloud_essd: ESSD (エンタープライズ SSD)。SystemDisk.PerformanceLevel パラメーターを使用してディスクのパフォーマンスレベルを設定できます。

    • cloud_essd_entry: ESSD Entry ディスク。

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

    cloud_ssd
    SystemDisk.Size

    integer

    任意

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

    • cloud: 20～500。

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

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

    40
    SystemDisk.DiskName

    string

    任意

    システムディスクの名前。名前は 2～128 文字で、英字で始まる必要があり、http:// または https:// で始めることはできません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

    cloud_ssdSystem
    SystemDisk.Description

    string

    任意

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

    testSystemDiskDescription
    SystemDisk.Iops

    integer

    任意

    説明

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

    30000
    SystemDisk.PerformanceLevel

    string

    任意

    システムディスクとして使用する ESSD のパフォーマンスレベル。以下の有効な値に基づいてパフォーマンスレベルを設定します:

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

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

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

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

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

    PL0
    SystemDisk.DeleteWithInstance

    boolean

    任意

    インスタンスのリリース時にシステムディスクをリリースするかどうかを指定します。有効な値:

    • true: インスタンスのリリース時にシステムディスクをリリースします。

    • false: インスタンスのリリース時にシステムディスクをリリースしません。

    デフォルト値: true。

    true
    SystemDisk.AutoSnapshotPolicyId

    string

    任意

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

    sp-bp1dgzpaxwc4load****
    SystemDisk.ProvisionedIops

    integer

    任意

    システムディスクとして使用する ESSD AutoPL ディスクのプロビジョニング済み読み取り/書き込み IOPS。有効な値: 0～min{50000, 1000 × 容量 - ベースラインパフォーマンス}。

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

    説明

    このパラメーターは、DiskCategory が cloud_auto に設定されている場合にのみ使用できます。詳細については、「ESSD AutoPL ディスク」および「ESSD AutoPL ディスクのプロビジョニング済みパフォーマンスの変更」をご参照ください。

    50000
    SystemDisk.BurstingEnabled

    boolean

    任意

    バースト機能を有効にするかどうかを指定します。有効な値:

    • true: バースト機能を有効にします。

    • false: バースト機能を有効にしません。

    true
    IoOptimized

    string

    任意

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

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

    • optimized: I/O 最適化が有効なインスタンスです。

    optimized
    InstanceChargeType

    string

    任意

    インスタンスの支払い方法。有効な値:

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

    • PostPaid: 従量課金。

    PrePaid
    Period

    integer

    任意

    リソースのサブスクリプション期間。単位: 月。このパラメーターは、InstanceChargeType が PrePaid に設定されている場合にのみ有効であり、必須です。有効な値: 1、2、3、4、5、6、7、8、9、12、24、36、48、60。

    1
    InternetChargeType

    string

    任意

    アウトバウンドインターネット帯域幅の支払い方法。有効な値:

    • PayByBandwidth: 帯域幅課金。

    • PayByTraffic: トラフィック課金。

    説明

    トラフィック課金モードでは、ピークインバウンドおよびアウトバウンド帯域幅は、保証されたパフォーマンス仕様ではなく、帯域幅の上限として使用されます。リソース競合が発生した場合、ピーク帯域幅が制限される場合があります。帯域幅を保証したい場合は、帯域幅課金モードを使用してください。

    PayByTraffic
    EnableVmOsConfig

    boolean

    任意

    インスタンスのオペレーティングシステム構成を有効にするかどうかを指定します。

    false
    NetworkType

    string

    任意

    インスタンスのネットワークタイプ。有効な値:

    • vpc: VPC。

    • classic: クラシックネットワーク。クラシックネットワークは廃止されました。詳細については、「廃止のお知らせ」をご参照ください。

    vpc
    UserData

    string

    任意

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

    ZWNobyBoZWxsbyBl****
    KeyPairName

    string

    任意

    キーペアの名前。

    • Windows インスタンスの場合、このパラメーターは無視されます。このパラメーターを指定しても、Password の内容のみが使用されます。

    • Linux インスタンスの場合、初期化時にパスワードベースのログインが無効になります。

    testKeyPairName
    RamRoleName

    string

    任意

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

    testRamRoleName
    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
    SpotPriceLimit

    number

    任意

    インスタンスの最大時間単価。小数点以下 3 桁までサポートされます。

    0.97
    SpotDuration

    integer

    任意

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

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

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

    Alibaba Cloud はインスタンスがリリースされる 5 分前に ECS システムイベント通知を送信します。スポットインスタンスは秒単位で課金されます。予想されるタスク実行時間に基づいて適切な保護期間を選択することをお勧めします。

    説明

    このパラメーターは、SpotStrategy が SpotWithPriceLimit または SpotAsPriceGo に設定されている場合にのみ有効です。

    1
    ResourceGroupId

    string

    任意

    リソースグループの ID。

    rg-bp67acfmxazb4p****
    SecurityEnhancementStrategy

    string

    任意

    オペレーティングシステムのセキュリティ強化を有効にするかどうかを指定します。有効な値:

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

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

    Active
    PrivateIpAddress

    string

    任意

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

    VPC 接続 ECS インスタンスにプライベート IP アドレスを指定する場合、IP アドレスは vSwitch (VSwitchId) のアイドル CIDR ブロックからのものである必要があります。

    10.1.**.**
    Ipv6AddressCount

    integer

    任意

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

    1
    DeploymentSetId

    string

    任意

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

    ds-bp1brhwhoqinyjd6****
    DataDisk

    array<object>

    任意

    データディスクのリスト。

    object

    任意

    データディスクのリスト。

    PerformanceLevel

    string

    任意

    データディスクとして使用する ESSD のパフォーマンスレベル。N の値は DataDisk.N.Category=cloud_essd の値と同じである必要があります。以下の有効な値に基づいてパフォーマンスレベルを設定します:

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

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

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

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

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

    PL1
    Description

    string

    任意

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

    testDataDiskDescription
    SnapshotId

    string

    任意

    データディスク N の作成に使用するスナップショットの ID。N の有効な値: 1～16。DataDisk.N.SnapshotId を指定した場合、DataDisk.N.Size は無視されます。作成されるディスクの実際のサイズは、指定されたスナップショットのサイズになります。

    2013 年 7 月 15 日以前に作成されたスナップショットは使用できません。そのようなスナップショットを使用するリクエストは拒否されます。

    s-bp17441ohwka0yuh****
    Size

    integer

    任意

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

    • cloud: 5～2000。

    • cloud_efficiency: 20～32768。

    • cloud_ssd: 20～32768。

    • cloud_essd: 有効な値の範囲は DataDisk.N.PerformanceLevel の値によって異なります。

      • PL0: 1～32768。

      • PL1: 20～32768。

      • PL2: 461～32768。

      • PL3: 1261～32768。

    • cloud_auto: 1～32,768。

    • cloud_essd_entry: 10～32,768。

    このパラメーターの値は、SnapshotId で指定されたスナップショットのサイズ以上である必要があります。

    2000
    Device

    string

    任意

    データディスクのマウントポイント。マウントポイントの命名規則は、アタッチされたデータディスクの数によって異なります:

    • 1～25 個のデータディスク: /dev/xvd[b-z]

    • 25 個を超えるデータディスク: /dev/xvd[aa-zz]。例えば、26 番目のデータディスクは /dev/xvdaa、27 番目のデータディスクは /dev/xvdab という名前になります。

    説明

    このパラメーターはフルイメージ (システムイメージ) シナリオにのみ適用されます。このパラメーターをフルイメージ内のデータディスクのマウントポイントに設定し、対応する DataDisk.N.Size および DataDisk.N.Category パラメーターを変更して、フルイメージ内のデータディスクのディスクカテゴリとサイズを変更できます。

    /dev/xvdb

    DiskName

    string

    任意

    データディスクの名前。名前は 2～128 文字で、英字で始まる必要があり、http:// または https:// で始めることはできません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

    testDataDiskName
    Category

    string

    任意

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

    • cloud_efficiency: Ultra ディスク。

    • cloud_ssd: 標準 SSD。

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

    • cloud: 基本ディスク。

    • cloud_auto: ESSD AutoPL ディスク。

    • cloud_regional_disk_auto: リージョン ESSD。

    • cloud_essd_entry: ESSD Entry ディスク。
      説明

      cloud_essd_entry の値は、InstanceType が ecs.u1 または ecs.e インスタンスファミリーのインスタンスタイプに設定されている場合にのみサポートされます。

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

    • elastic_ephemeral_disk_premium: エラスティック一時ディスク - Premium Edition。

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

    • InstanceType が廃止された I/O 最適化でないインスタンスタイプに設定されている場合、デフォルトのパラメーター値は cloud です。

    • その他の場合、デフォルト値は cloud_efficiency です。

    cloud_ssd
    DeleteWithInstance

    boolean

    任意

    インスタンスのリリース時にデータディスクをリリースするかどうかを指定します。有効な値:

    • true: インスタンスのリリース時にデータディスクをリリースします。

    • false: インスタンスのリリース時にデータディスクをリリースしません。

    デフォルト値: true。

    true
    Encrypted

    string

    任意

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

    false
    ProvisionedIops

    integer

    任意

    システムディスクとして使用する ESSD AutoPL ディスクのプロビジョニング済み読み取り/書き込み IOPS。有効な値: 0～min{50000, 1000 × 容量 - ベースラインパフォーマンス}。

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

    説明

    このパラメーターは、DiskCategory が cloud_auto に設定されている場合にのみ使用できます。詳細については、「ESSD AutoPL ディスク」および「ESSD AutoPL ディスクのプロビジョニング済みパフォーマンスの変更」をご参照ください。

    50000
    BurstingEnabled

    boolean

    任意

    バースト機能を有効にするかどうかを指定します。有効な値:

    • true: バースト機能を有効にします。

    • false: バースト機能を有効にしません。

    true
    AutoSnapshotPolicyId

    string

    任意

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

    sp-bp67acfmxazb4p****
    KMSKeyId

    string

    任意

    データディスクの KMS キー ID。

    0e478b7a-4262-4802-b8cb-00d****
    NetworkInterface

    array<object>

    任意

    ネットワークインターフェース コントローラー (NIC) の情報。

    object

    任意

    ネットワークインターフェース コントローラー (NIC) の情報。

    VSwitchId

    string

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) が属する vSwitch の ID。インスタンスとセカンダリ NIC は同じ VPC および同じアクティブなゾーンに属する必要がありますが、異なる vSwitch に属することができます。NetworkInterface.N の N の値は 1 を超えることはできません。

    vsw-bp1s5fnvk4gn2tws0****
    NetworkInterfaceName

    string

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) の名前。NetworkInterface.N の N の値は 1 を超えることはできません。

    testNetworkInterfaceName
    Description

    string

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) の説明。説明は 2～256 文字で、http:// または https:// で始めることはできません。NetworkInterface.N の N の値は 1 を超えることはできません。

    testNetworkInterfaceDescription
    SecurityGroupId

    string

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) が属するセキュ。

    sg-bp15ed6xe1yxeycg****
    PrimaryIpAddress

    string

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) のプライマリプライベート IP アドレス。NetworkInterface.N の N の値は 1 を超えることはできません。

    192.168.**.**
    SecurityGroupIds

    array

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) が属する 1 つ以上のセキュリティグループの ID。セキュリティグループとセカンダリ NIC は同じ VPC に属する必要があります。SecurityGroupIds.N の N の有効な値は、セカンダリ NIC が属できるセキュリティグループの最大数のクォータによって異なります。詳細については、「使用制限」をご参照ください。NetworkInterface.N の N の値は 1 を超えることはできません。

    説明

    NetworkInterface.N.SecurityGroupId と NetworkInterface.N.SecurityGroupIds.N を同時に指定することはできません。

    sg-bp67acfmxazb4p****

    string

    任意

    セカンダリネットワークインターフェース コントローラー (NIC) が属する 1 つ以上のセキュリティグループの ID。セキュリティグループとセカンダリ NIC は同じ VPC に属する必要があります。SecurityGroupIds.N の N の有効な値は、セカンダリ NIC が属できるセキュリティ

    sg-bp67acfmxazb4p****
    InstanceType

    string

    任意

    The type of the ENI. Valid values of N: 1 to 2. If you configure one ENI, you can configure either a primary network interface controller (NIC) or a secondary ENI. If you configure two ENIs, you must configure one primary NIC and one secondary ENI.

    Valid values:

    • Primary: primary NIC.

    • Secondary: secondary ENI.

    Default value: Secondary.

    Secondary
    NetworkInterfaceTrafficMode

    string

    任意

    The communication mode of the primary ENI. Valid values:

    • Standard: uses the TCP communication mode.

    • HighPerformance: enables the Elastic RDMA Interface (ERI) and uses the RDMA communication mode.

    Standard
    DeleteOnRelease

    boolean

    任意

    Specifies whether to retain the ENI when the instance is released. Valid values:

    • true: does not retain the ENI.

    • false: retains the ENI.

    Default value: true.

    説明

    This parameter takes effect only for secondary ENIs.

    true
    Tag

    array<object>

    任意

    このバージョンを使用して作成されたインスタンス、ディスク、およびプライマリ ENI のタグ。

    object

    任意

    このバージョンを使用して作成されたインスタンス、ディスク、およびプライマリ ENI のタグ。

    Key

    string

    任意

    このバージョンを使用して作成されたインスタンス、ディスク、およびプライマリ ENI のタグキー。N の有効な値: 1～20。タグキーは空文字列にできません。最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。 [parameters.48.

    TestKey
    Value

    string

    任意

    The tag value of the instances, disks, and primary ENIs created by using this version. Valid values of N: 1 to 20. The tag value can be an empty string. It can be up to 128 characters in length and cannot contain http:// or https://.

    TestValue
    SecurityGroupIds

    array

    任意

    The IDs of one or more security groups to which the instance belongs. The valid values of N depend on the maximum number of security groups to which an instance can belong. For more information, see Limits.

    説明

    You cannot specify both SecurityGroupId and SecurityGroupIds.N.

    sg-bp15ed6xe1yxeycg7****

    string

    任意

    The IDs of one or more security groups to which the instance belongs. The valid values of N depend on the maximum number of security groups to which an instance can belong. For more information, see Limits.

    説明

    You cannot specify both SecurityGroupId and SecurityGroupIds.N.

    sg-bp15ed6xe1yxeycg7****
    SystemDisk.Encrypted

    string

    任意

    Specifies whether to encrypt the system disk. Valid values:

    • true: encrypts the system disk.

    • false: does not encrypt the system disk.

    Default value: false.

    説明

    System disk encryption is not supported in Zone D of the Hong Kong (China) region or Zone A of the Singapore region when you create an instance.

    false
    DeletionProtection

    boolean

    任意

    The release protection attribute of the instance. Specifies whether the instance can be released from the console or by calling DeleteInstance. Valid values:

    • true: enables release protection.

    • false: disables release protection.

    Default value: false.

    説明

    This attribute is applicable only to pay-as-you-go instances. It can only restrict manual release operations and does not take effect on system-initiated release operations.

    false
    CreditSpecification

    string

    任意

    The running mode of the burstable instance. Valid values:

    Standard
    AutoRenew

    boolean

    任意

    Specifies whether to enable auto-renewal. This parameter takes effect only when InstanceChargeType is set to PrePaid. Valid values:

    • true: enables auto-renewal.

    • false: does not enable auto-renewal.

    Default value: false.

    true
    AutoRenewPeriod

    integer

    任意

    The auto-renewal period. Valid values:

    If PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60.

    Default value: 1.

    1
    PeriodUnit

    string

    任意

    The unit of the subscription duration. Valid values:

    Month (default).

    Month
    HttpEndpoint

    string

    任意

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

    • enabled: enables the access channel.

    • disabled: disables the access channel.

    Default value: enabled.

    説明

    For more information about instance metadata, see Overview of ECS instance metadata.

    enabled
    HttpTokens

    string

    任意

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

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

    • required: forcefully uses the security-hardened mode. After you set this value, the normal mode cannot be used to access instance metadata.

    Default value: optional.

    説明

    For more information about the modes for accessing instance metadata, see Overview of ECS instance metadata.

    optional
    HttpPutResponseHopLimit

    integer

    任意

    説明

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

    3
    SystemDisk.KMSKeyId

    string

    任意

    The KMS key ID of the system disk.

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

    object

    任意

    The image-related property information.

    LoginAsNonRoot

    boolean

    任意

    Specifies whether instances that use this image support logon with the ecs-user user. Valid values:

    • true: supported.

    • false: not supported.

    false
    SecurityOptions

    object

    任意

    The security options.

    TrustedSystemMode

    string

    任意

    The trusted system mode. Set the value to vTPM.

    The following instance families support trusted system mode:

    • g7, c7, and r7.

    • Security-enhanced instance family (g7t, c7t, and r7t).

    When you create ECS instances of the preceding instance families, you must configure this parameter. Details:

    • To use the Alibaba Cloud Trusted System, set this parameter to vTPM. The trusted verification is completed by the Alibaba Cloud Trusted System when the instance starts.

    • If you do not use the Alibaba Cloud Trusted System, you can leave this parameter empty. However, if the ECS instance that you create uses the Enclave-based confidential computing mode (SecurityOptions.ConfidentialComputingMode=Enclave), the trusted system is also enabled for the instance.

    • When you create a trusted ECS instance by invoking an API operation, you can only invoke RunInstances. CreateInstance does not support configuring the SecurityOptions.TrustedSystemMode parameter.

    説明

    If you specify an instance as a trusted instance during creation, you can only use images that support the trusted system when you replace the system disk.

    For more information about the trusted system, see Overview of trusted features for security-enhanced instances.

    vTPM

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    LaunchTemplateVersionNumber

    integer

    The version number of the launch template that is created.

    2
    RequestId

    string

    リクエスト ID

    473469C7-AA6F-4DC5-B3DB-A3DC0DEX****
    LaunchTemplateId

    string

    The ID of the launch template. For more information, see DescribeLaunchTemplates.

    When you use a launch template to create an instance, you must specify LaunchTemplateId or LaunchTemplateName to determine the launch template.

    lt-bp1apo0bbbkuy0rj****

    例

    成功レスポンス

    JSONJSON

    {
  "LaunchTemplateVersionNumber": 2,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DEX****",
  "LaunchTemplateId": "lt-bp1apo0bbbkuy0rj****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidRegion.NotExist %s
    400 MissingParameter %s
    400 InvalidParameter %s
    400 InvalidDescription.Malformed The specified parameter "Description" is not valid.
    400 InvalidUserData.SizeExceeded %s
    400 InvalidUserData.Base64FormatInvalid %s
    400 InvalidHostName.Malformed The specified parameter "HostName" is not valid.
    400 InvalidParams.CreateEniParams %s
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    500 InternalError The request processing has failed due to some unknown error.
    403 LaunchTemplateVersionLimitExceed %s
    404 InvalidLaunchTemplate.NotFound %s
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.

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

    変更履歴

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