---
title: "createLaunchConfiguration "
slug: "cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
tags: ["Auto Scaling", "Launch Configuration"]
updated: 2026-04-23T09:04:54Z
published: 2026-04-23T09:07:31Z
---

> ## 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을 생성합니다.

## 요청

          
          

**XEN/RHV/KVM** 하이퍼바이저 타입의 서버 이미지로 Launch Configuration을 생성하려면 serverImageNo와 serverSpecCode를 사용합니다. 또한, serverImageProductCode와 serverProductCode를 이용하면 **XEN/RHV** 하이퍼바이저 타입의 서버 이미지로만 생성할 수 있습니다.

### 요청 파라미터

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

## 응답

### 응답 데이터 타입

- LaunchConfigurationList 타입

| LaunchConfigurationList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<launchconfiguration data-tomark-pass=""> launchConfigurationList = new ArrayList&lt;&gt;();</launchconfiguration> |

| 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; |

## 예시

### 요청 예시

```
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-***
```

### 응답 예시

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