---
title: "createLaunchConfiguration"
slug: "cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
tags: ["Auto Scaling", "VPC"]
updated: 2026-10-08T09:45:25Z
published: 2026-10-08T09:45:25Z
canonical: "cli.ncloud-docs.com/cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/docs/ja/cli-vserver-serverimage-getServerImageList)を参照 |
| `--memberServerImageInstanceNo` | String | Conditional | サーバイメージのインスタンス番号 - ユーザーが作成したサーバイメージでサーバ作成(Scale-out)時に入力 - `serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`のいずれかは必ず入力 - 複数入力時、`serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`の順で適用 - [getMemberServerImageInstanceList](/docs/ja/cli-vserver-serverimage-getmemberserverimageinstancelist)を参照 |
| `--serverImageProductCode` | String | Conditional | サーバイメージ商品コード - 新しいサーバイメージでサーバ作成(Scale-out)時に入力 (RHV、XEN) - `serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`のいずれかは必ず入力 - 複数入力時、`serverImageNo`、`memberServerImageInstanceNo`、`serverImageProductCode`の順で適用 - [getServerImageProductList](/docs/ja/cli-vserver-server-common-getserverimageproductlist)を参照 |
| `--serverSpecNo` | String | Conditional | サーバスペック番号 - `serverSpecNo`、`serverSpecCode`、`serverProductCode`のいずれかは必ず入力 - 複数入力時、`serverSpecNo`、`serverSpecCode`、`serverProductCode`の順で適用 - `serverImageProductCode`使用時、サーバスペックを設定 - [getServerSpecList](/docs/ja/cli-vserver-server-common-getserverspeclist)を参照 |
| `--serverSpecCode` | String | Conditional | サーバスペックコード - `serverSpecNo`、`serverSpecCode`、`serverProductCode`のいずれかは必ず入力 - 複数入力時、`serverSpecNo`、`serverSpecCode`、`serverProductCode`の順で適用 - [getServerSpecList](/docs/ja/cli-vserver-server-common-getserverspeclist)を参照 |
| `--serverProductCode` | String | Conditional | サーバ商品コード - 、`serverSpecNo`、`serverSpecCode`、`serverProductCode`のいずれかは必ず入力 - 複数入力時、`serverSpecNo`、`serverSpecCode`、`serverProductCode`の順で適用 - [getServerProductList](/docs/ja/cli-vserver-server-common-getserverproductlist)を参照 |

### 任意オプション

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

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

### 共通オプション

`vautoscaling`コマンドで共通して使用するオプションについては、[Auto Scaling (VPC)のオプション](/docs/ja/cli-vautoscaling#%EC%98%B5%EC%85%98)をご参照ください。

## 例

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"
  }
}
```