---
title: "createLaunchConfiguration  "
slug: "compute-autoscaling-createlaunchconfiguration"
tags: ["Auto Scaling"]
updated: 2026-10-22T10:47:05Z
published: 2026-10-22T10:47:05Z
canonical: "api-gov.ncloud-docs.com/compute-autoscaling-createlaunchconfiguration"
---

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

# createLaunchConfiguration

## 개요

Launch Configuration은 Auto Scaling이 클라우드 서버 인스턴스를 생성하여 서비스에 투입하기 위해 사용되는 템플릿(template)입니다. 그 템플릿은 Auto Scaling이 서버 인스턴스를 생성하기 위한 모든 정보를 포함하고 있습니다. Launch Configuration 속성은 한 번 생성되면 이후 변경이 안됩니다.

## 요청

### 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| launchConfigurationName | No | String | Min : 1 Max : 255 | 론치설정의 이름으로 식별자 역할을 함 `default : NAVER Cloud Platform 에서 알아서 배정` |
| serverImageProductCode | Conditional | String | Min : 1 Max : 20 | - 서버 이미지에 설치된 SW(OS 포함)의 상품 코드 `serverImageProductCode(소프트웨어상품코드)` `memberServerImageNo(회원서버이미지번호)` 두값중 하나만 지정되어야 함 |
| serverProductCode | No | String | Min : 1 Max : 20 | 서버 HW spec과 관련된 서버 상품 코드 `default : 최소사양으로 만들어집니다.` |
| memberServerImageNo | Conditional | String | - | - 회원이 직접 만든 내 서버 이미지 번호 `serverImageProductCode(소프트웨어상품코드)` `memberServerImageNo(회원서버이미지번호)` 두값중 하나만 지정되어야 함 |
| accessControlGroupConfigurationNoList | No | List | 중복 불가 | Access Control Group(ACG) 설정 번호로 값을 지정하지 않으면, 기본 Access Control Group(ACG)가 지정됨 |
| loginKeyName | No | String | Min : 3 Max : 30 | - 로그인 키 이름 지정되어 있지 않으면 사용자가 최근에 만든 로그인 키 이름이 지정됨 `default : 가장최근에 만든 로그인키명 사용` |
| userData | No | String | Min : 1 Max : 21847 | 사용자데이터로 BASE64 encoding 문자열만 허용 서버 인스턴스가 첫 부팅을 할 때, BASE64 encoding된 문자열을 decoding하여 평문이 된 문자열로 구성된 스크립트 파일이 실행됨 사용자데이터(userData)와 초기화스크립트번호(initScriptNo) 두 개의 파라미터를 같이 전달하면 생성 오류 처리됨 |
| initScriptNo | No | String |  | - 초기화스크립트번호 서버가 최초 부팅시 사용자가 설정한 초기화 스크립트 실행 초기화 스크립트의 초기화스크립트번호를 매개변수로 전달 사용자데이터(userData)와 초기화스크립트번호(initScriptNo) 두 개의 파라미터를 같이 전달하면 생성 오류 처리됨 initScriptNo는 [getInitScriptList](/docs/compute-server-getinitscriptlist) 액션을 통해 얻을 수 있음 |
| regionNo | No | String |  | 입력가능한 상태는 [getRegionList](/docs/compute-vserver-server-common-getregionlist) 액션을 통해 획득 가능 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [LaunchConfigurationList](/docs/common-apidatatype-launchconfigurationlist)

## 예시

### 요청 예시

```
{AUTOSCALILNG_API_URL}/createLaunchConfiguration
?launchConfigurationName=lc-0228
&serverImageProductCode=SPSW0LINUX000009
```

### 응답 예시

```
<createLaunchConfigurationResponse>
   <requestId>19fff23d-d5cd-49fd-8a0a-986ae02bf660</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
   <totalRows>1</totalRows>
   <launchConfigurationList>
      <launchConfiguration>
         <launchConfigurationName>lc-0228</launchConfigurationName>
         <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
         <serverProductCode>SPSVRSTAND000043</serverProductCode>
         <memberServerImageNo />
         <loginKeyName>hkey-0217</loginKeyName>
         <createDate>2014-02-28T17:11:36+0900</createDate>
         <userData />
         <initScriptNo />
      </launchConfiguration>
   </launchConfigurationList>
</createLaunchConfigurationResponse>
```