createLaunchConfiguration

VPC環境で利用できます。

Launch Configurationを作成します。

構文

createLaunchConfiguration構文は次の通りです。

./ncloud vautoscaling createLaunchConfiguration \
    --serverImageNo <image-no> | --memberServerImageInstanceNo <member-image-no> | --serverImageProductCode <image-product-code> \
    --serverSpecNo <spec-no>] | --serverSpecCode <spec-code> | --serverProductCode <product-code>] \
    [--isEncryptedVolume <true|false>] \
    [--initScriptNo <init-script-no>] \
    [--launchConfigurationName <launch-configuration-name>] \
    [--loginKeyName <login-key-name>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

createLaunchConfigurationの実行時に指定できるオプションについて説明します。

必須オプション

createLaunchConfigurationの必須オプションです。

オプション	タイプ	必須の有無	説明
`--serverImageNo`	String	Conditional	サーバイメージ番号新規サーバイメージでサーバ作成(Scale-out)時に入力(KVM、RHV、XEN) `serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`のいずれかは必ず入力複数入力時、`serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`の順で適用 getServerImageListを参照
`--memberServerImageInstanceNo`	String	Conditional	サーバイメージのインスタンス番号ユーザーが作成したサーバイメージでサーバ作成(Scale-out)時に入力 `serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`のいずれかは必ず入力複数入力時、`serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`の順で適用 getMemberServerImageInstanceListを参照
`--serverImageProductCode`	String	Conditional	サーバイメージ商品コード新しいサーバイメージでサーバ作成(Scale-out)時に入力 (RHV、XEN) `serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`のいずれかは必ず入力複数入力時、`serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`の順で適用 getServerImageProductListを参照
`--serverSpecNo`	String	Conditional	サーバスペック番号 `serverSpecNo`、`serverSpecCode`、`serverProductCode`のいずれかは必ず入力複数入力時、`serverSpecNo`、`serverSpecCode`、`serverProductCode`の順で適用 `serverImageProductCode`使用時、サーバスペックを設定 getServerSpecListを参照
`--serverSpecCode`	String	Conditional	サーバスペックコード `serverSpecNo`、`serverSpecCode`、`serverProductCode`のいずれかは必ず入力複数入力時、`serverSpecNo`、`serverSpecCode`、`serverProductCode`の順で適用 getServerSpecListを参照
`--serverProductCode`	String	Conditional	サーバ商品コード、`serverSpecNo`、`serverSpecCode`、`serverProductCode`のいずれかは必ず入力複数入力時、`serverSpecNo`、`serverSpecCode`、`serverProductCode`の順で適用 getServerProductListを参照

任意オプション

createLaunchConfigurationの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--isEncryptedVolume`	Boolean	Optional	基本ブロックストレージボリュームを暗号化するか `true` \| `false` (デフォルト) `true`: 暗号化 `false`: 暗号化しない RHVサーバイメージでのみ設定可能
`--initScriptNo`	String	Optional	初期化スクリプト番号最初の起動時、ユーザーが設定した初期化スクリプトを実行 getInitScriptListを参照
`--launchConfigurationName`	String	Optional	Launch Configuration名英字の小文字、数字、記号の`-`を組み合わせて1~255文字以内で入力先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用未入力時、自動作成
`--loginKeyName`	String	Optional	認証キー名デフォルト: 最近作成した認証キー getLoginKeyListを参照

共通オプション

vautoscalingコマンドで共通して使用するオプションについては、Auto Scaling (VPC)のオプションをご参照ください。

例

Launch Configurationの作成リクエストが成功すると、Launch Configurationの構成情報と作成状態が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vautoscaling createLaunchConfiguration \
    --serverImageNo 123456789 \
    --serverSpecCode s2-g3a \
    --launchConfigurationName launch-config-01 \
    --loginKeyName test-key \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "createLaunchConfigurationResponse": {
    "totalRows": 1,
    "launchConfigurationList": [
      {
        "regionCode": "KR",
        "launchConfigurationNo": "12345",
        "launchConfigurationName": "launch-config-01",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.09.G003",
        "serverProductCode": "SVR.VSVR.AMD.STAND.C002.M008.G003",
        "loginKeyName": "test-key",
        "createDate": "2026-08-06T16:51:17+0900",
        "launchConfigurationStatus": {
          "code": "CREAT",
          "codeName": "CREATED"
        },
        "initScriptNo": "",
        "isEncryptedVolume": false,
        "serverImageNo": "123456789",
        "osInformation": "rocky-9.8",
        "serverSpecNo": "1234",
        "serverSpecCode": "s2-g3a",
        "serverSpecDescription": "vCPU 2EA, Memory 8GB"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}