---
title: "createLaunchConfiguration"
slug: "cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
tags: ["Auto Scaling", "VPC"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
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/cli-vserver-serverimage-getServerImageList) 참조 |
| `--memberServerImageInstanceNo` | String | Conditional | 서버 이미지 인스턴스 번호 - 사용자가 생성한 서버 이미지로 서버 생성(Scale-out) 시 입력 - `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode` 중 하나는 필수 입력 - 여러 개 입력 시 `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode` 순으로 적용 - [getMemberServerImageInstanceList](/docs/cli-vserver-serverimage-getmemberserverimageinstancelist) 참조 |
| `--serverImageProductCode` | String | Conditional | 서버 이미지 상품 코드 - 신규 서버 이미지로 서버 생성(Scale-out) 시 입력 (RHV, XEN) - `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode` 중 하나는 필수 입력 - 여러 개 입력 시 `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode` 순으로 적용 - [getServerImageProductList](/docs/cli-vserver-server-common-getserverimageproductlist) 참조 |
| `--serverSpecNo` | String | Conditional | 서버 스펙 번호 - `serverSpecNo`, `serverSpecCode`, `serverProductCode` 중 하나는 필수 입력 - 여러 개 입력 시 `serverSpecNo`, `serverSpecCode`, `serverProductCode` 순으로 적용 - `serverImageProductCode` 사용 시 서버 스펙 설정 - [getServerSpecList](/docs/cli-vserver-server-common-getserverspeclist) 참조 |
| `--serverSpecCode` | String | Conditional | 서버 스펙 코드 - `serverSpecNo`, `serverSpecCode`, `serverProductCode` 중 하나는 필수 입력 - 여러 개 입력 시 `serverSpecNo`, `serverSpecCode`, `serverProductCode` 순으로 적용 - [getServerSpecList](/docs/cli-vserver-server-common-getserverspeclist) 참조 |
| `--serverProductCode` | String | Conditional | 서버 상품 코드 - `serverSpecNo`, `serverSpecCode`, `serverProductCode` 중 하나는 필수 입력 - 여러 개 입력 시 `serverSpecNo`, `serverSpecCode`, `serverProductCode` 순으로 적용 - [getServerProductList](/docs/cli-vserver-server-common-getserverproductlist) 참조 |

### 선택 옵션

`createLaunchConfiguration`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--isEncryptedVolume` | Boolean | Optional | 기본 블록 스토리지 볼륨 암호화 여부 - `true` \| `false` (기본값) - `true`: 암호화 - `false`: 암호화 안 함 - RHV 서버 이미지에서만 설정 가능 |
| `--initScriptNo` | String | Optional | 초기화 스크립트 번호 - 최초 부팅 시 사용자가 설정한 초기화 스크립트 실행 - [getInitScriptList](/docs/cli-vserver-initscript-getinitscriptlist) 참조 |
| `--launchConfigurationName` | String | Optional | Launch Configuration 이름 - 영문 소문자, 숫자, 특수문자 `-`를 조합하여 1~255자 이내로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - 미입력 시 자동 생성 |
| `--loginKeyName` | String | Optional | 인증키 이름 - 기본값: 최근 생성 인증키 - [getLoginKeyList](/docs/cli-vserver-server-loginkey-getloginkeylist) 참조 |

### 공통 옵션

`vautoscaling` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Auto Scaling (VPC) 옵션](/docs/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"
  }
}
```