---
title: "createLaunchConfiguration "
slug: "cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
tags: ["Auto Scaling", "Launch Configuration"]
updated: 2026-06-25T09:10:27Z
published: 2026-06-25T09:10:27Z
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

## 개요<a name="개요"></a>


Launch Configuration을 생성합니다.

## 요청<a name="요청"></a>
:::(Info)
**XEN/RHV/KVM** 하이퍼바이저 타입의 서버 이미지로 Launch Configuration을 생성하려면 serverImageNo와 serverSpecCode를 사용합니다.
또한, serverImageProductCode와 serverProductCode를 이용하면 **XEN/RHV** 하이퍼바이저 타입의 서버 이미지로만 생성할 수 있습니다.
:::

### 요청 파라미터<a name="요청파라미터"></a>


| 파라미터명                            | 필수 여부      | 타입                   | 제약 사항                   | 설명                                         |
| ---------------------------------- | ------------ | --------------------- | ------------------------- | ------------------------------------------- |
| regionCode                         | No           | String                |                           | - 리전 코드<br/>Launch Configuration이 생성될 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택   |
| serverImageProductCode             | Conditional  | String                |                           | - 서버 이미지 상품 코드<br/>Scale-out 으로 서버를 생성할 때 새로운 서버 이미지를 이용하도록 설정 가능<br/>서버 이미지 상품 코드(serverImageProductCode)와 회원 서버 이미지 인스턴스 번호(memberServerImageInstanceNo) 중 반드시 한개를 필수로 입력<br/>serverImageProductCode는 [getServerImageProductList](/docs/cli-vserver-server-common-getserverimageproductlist) 액션을 통해 획득 가능  |
| memberServerImageInstanceNo        | Conditional  | String                |                           | - 회원 서버 이미지 인스턴스 번호<br/>Scale-out 으로 서버를 생성할 때 직접 생성한 서버 이미지를 이용하도록 설정 가능<br/>서버 이미지 상품 코드(serverImageProductCode)와 회원 서버 이미지 인스턴스 번호(memberServerImageInstanceNo) 중 반드시 한개를 필수로 입력함<br/>memberServerImageInstanceNo는 [getMemberServerImageInstanceList](/docs/cli-vserver-serverimage-getmemberserverimageinstancelist) 액션을 통해 획득 가능 |
| serverImageNo                            | Conditional  | String                |                           | - 서버 이미지 번호<br/>Scale-out 으로 서버를 생성할 때 새로운 서버 이미지를 이용하도록 설정 가능<br/>회원 서버 이미지 인스턴스 번호(memberServerImageInstanceNo), 서버 이미지 상품 코드(serverImageProductCode)와 동시 사용 불가능<br/>serverImageNo는 [getServerImageList](/docs/cli-vserver-serverimage-getServerImageList) 액션을 통해 획득 가능 |
| serverProductCode                  | No           | String                |                           | - 서버 상품 코드<br/>Scale-out 으로 서버를 생성할 때 생성할 서버의 스펙 결정 가능<br/>serverProductCode는 [getServerProductList](/docs/cli-vserver-server-common-getserverproductlist) 액션을 통해 획득 가능<br/>Default : 최소 사양으로 선택되며 최소 사양의 기준은<br/>1. 메모리 2. CPU 3. 기본 블록 스토리지 사이즈 4. 디스크 유형(NET) 순서로 결정됨  |
| serverSpecCode                                 | Conditional           | String                |                           | - 서버 스펙 코드<br/>Scale-out 으로 서버를 생성할 때 생성할 서버의 스펙 결정<br/>serverSpecCode는 [getServerSpecList](/docs/cli-vserver-server-common-getserverspeclist) 액션을 통해 획득 가능<br/>serverImageNo 사용시 사용 가능.<br/>Default : 최소 사양으로 선택. 최소 사양의 기준은<br/>1. 메모리 2. CPU 3. 기본 블록 스토리지 사이즈 4. 디스크 유형(NET) 순서로 결정    |
| isEncryptedVolume                  | No           | Boolean               |                           | - 기본 블록 스토리지 볼륨 암호화 여부<br/>RHV 서버 이미지 상품인 경우에 기본 블록 스토리지 암호화 여부 결정 가능<br/>Options : true \| false<br/>Default : false    |
| initScriptNo                       | No           | String                |                           | - 초기화 스크립트 번호<br/>서버가 최초 부팅시 사용자가 설정한 초기화 스크립트 실행 가능<br/>initScriptNo는 [getInitScriptList](/docs/cli-vserver-initscript-getinitscriptlist) 액션을 통해 획득 가능 |
| launchConfigurationName            | No           | String                | Min : 1, Max : 255<br/>소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함<br/>영어 또는 숫자로 끝나야 함  | - Launch Configuration 이름<br/>Default : NAVER Cloud Platform가 자동으로 부여함   |
| loginKeyName                       | No           | String                |                           | - 로그인 키 이름<br/>서버 인스턴스에 접속시 비밀번호를 암호화하고 복호화하는 키 결정 가능<br/>loginKeyName은 [getLoginKeyList](/docs/cli-vserver-server-loginkey-getloginkeylist) 액션을 통해 획득 가능<br/>Default : 가장 최근에 생성된 로그인 키 이름을 사용함 |
| responseFormatType                 | No           | String                |                           | - 응답 결과의 포맷 타입<br/>Options : xml \| json<br/>Default : xml |

## 응답<a name="응답"></a>


### 응답 데이터 타입<a name="응답데이터타입"></a>

- LaunchConfigurationList 타입

| LaunchConfigurationList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<LaunchConfiguration> launchConfigurationList = new ArrayList<>(); |

| LaunchConfiguration |
| ---------- |
| private String regionCode; |
| private String launchConfigurationNo; |
| private String launchConfigurationName; |
| private String serverImageProductCode; |
| private String memberServerImageInstanceNo; |
| private String serverProductCode; |
| private String loginKeyName; |
| private Date createDate; |
| private CommonCode launchConfigurationStatus; |
| private String initScriptNo; |
| private Boolean isEncryptedVolume; |


## 예시<a name="예시"></a>

### 요청 예시<a name="요청예시"></a>


```
ncloud vautoscaling createLaunchConfiguration --regionCode FKR --serverImageProductCode SW.VSVR.OS.LNX64.CNTOS.0703.B050 --serverProductCode SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002 --isEncryptedVolume false --launchConfigurationName test-***
```

### 응답 예시<a name="응답예시"></a>


```xml
<createLaunchConfigurationResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <launchConfigurationList>
    <launchConfiguration>
      <regionCode>FKR</regionCode>
      <launchConfigurationNo>***163</launchConfigurationNo>
      <launchConfigurationName>test-***</launchConfigurationName>
      <serverImageProductCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</serverImageProductCode>
      <memberServerImageInstanceNo></memberServerImageInstanceNo>
      <serverProductCode>SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002</serverProductCode>
      <loginKeyName>test-***</loginKeyName>
      <createDate>2020-12-07T13:08:50+0900</createDate>
      <launchConfigurationStatus>
        <code>CREAT</code>
        <codeName>Created</codeName>
      </launchConfigurationStatus>
      <initScriptNo></initScriptNo>
      <isEncryptedVolume>false</isEncryptedVolume>
    </launchConfiguration>
  </launchConfigurationList>
</createLaunchConfigurationResponse>
```