---
title: "createLaunchConfiguration"
slug: "cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
tags: ["Auto Scaling", "Launch Configuration"]
updated: 2026-09-17T09:10:32Z
published: 2026-09-17T09:10:32Z
canonical: "cli-fin.ncloud-docs.com/cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
---

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

# createLaunchConfiguration

Launch Configuration을 생성합니다.

## 구문

`createLaunchConfiguration` 구문은 다음과 같습니다.

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

## 옵션

`createLaunchConfiguration` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`createLaunchConfiguration`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--serverImageProductCode` | String | Conditional | 서버 이미지 상품 코드 - 신규 서버 이미지로 서버 생성(Scale-out) 시 입력 (RHV, XEN) - `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 - [getServerImageProductList](/docs/cli-vserver-server-common-getserverimageproductlist) 참조 |
| `--serverImageNo` | String | Conditional | 서버 이미지 번호 - 신규 서버 이미지로 서버 생성(Scale-out) 시 입력 (KVM, RHV, XEN) - `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 - [getServerImageList](/docs/cli-vserver-serverimage-getServerImageList) 참조 |
| `--memberServerImageInstanceNo` | String | Conditional | 서버 이미지 인스턴스 번호 - 사용자가 생성한 서버 이미지로 서버 생성(Scale-out) 시 입력 - `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 - [getMemberServerImageInstanceList](/docs/cli-vserver-serverimage-getmemberserverimageinstancelist) 참조 |
| `--serverProductCode` | String | Conditional | 서버 상품 코드 - 기본값: 최소 사양 (메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형 순) - `serverImageProductCode` 사용 시 서버 스펙 설정 - [getServerProductList](/docs/cli-vserver-server-common-getserverproductlist) 참조 |
| `--serverSpecCode` | String | Conditional | 서버 스펙 코드 - 기본값: 최소 사양 (메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형 순) - `serverImageNo` 사용 시 서버 스펙 설정 - [getServerSpecList](/docs/cli-vserver-server-common-getserverspeclist) 참조 |

### 선택 옵션

`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 옵션](/docs/cli-vautoscaling#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

Launch Configuration 생성 요청이 성공하면 Launch Configuration의 구성 정보와 생성 상태가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vautoscaling createLaunchConfiguration \
    --serverImageProductCode SW.VSVR.OS.LNX64.ROCKY.0810.B050 \
    --serverProductCode SVR.VSVR.STAND.C002.M004.NET.SSD.B050.G001 \
    --launchConfigurationName test-launch-config-01 \
    --loginKeyName test-key \
    --regionCode FKR \
    --output json
```

### 출력

출력 예시는 다음과 같습니다.

```
{
  "createLaunchConfigurationResponse": {
    "totalRows": 1,
    "launchConfigurationList": [
      {
        "regionCode": "FKR",
        "launchConfigurationNo": "345678901",
        "launchConfigurationName": "test-launch-config-01",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050",
        "serverProductCode": "SVR.VSVR.STAND.C002.M004.NET.SSD.B050.G001",
        "loginKeyName": "test-key",
        "createDate": "2026-08-06T14:15:28+0900",
        "launchConfigurationStatus": {
          "code": "CREAT",
          "codeName": "CREATED"
        },
        "initScriptNo": "",
        "isEncryptedVolume": false,
        "serverImageNo": "27515872",
        "osInformation": "Rocky Linux 8.10",
        "serverSpecNo": "37",
        "serverSpecCode": "sd2-g1-s50",
        "serverSpecDescription": "vCPU 2EA, Memory 4GB, [SSD]Disk 50GB"
      }
    ],
    "requestId": "e058ece0-7809-4e7c-8791-30d4c8f45db5",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```