---
title: "createLaunchConfiguration"
slug: "cli-autoscaling-createlaunchconfiguration"
tags: ["Auto Scaling"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
canonical: "cli.ncloud-docs.com/cli-autoscaling-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

## 개요

론치 설정 생성

## 설명

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

## 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| launchConfigurationName | No | String | Min : 1, Max : 255 | 론치 설정의 이름으로 식별자 역할을 함 Default: Ncloud에서 알아서 배정 |
| 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 액션을 통해서 얻을 수 있음 |
| regionNo | No | String |  | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |

## 응답 데이터 타입

- LaunchConfigurationList 타입

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

| LaunchConfiguration extends BaseObject |
| --- |
| private String launchConfigurationName; |
| private String serverImageProductCode; |
| private String serverProductCode; |
| private String memberServerImageNo; |
| private String loginKeyName; |
| private Date createDate; |
| private String userData; |
| private String initScriptNo; |
| private List<accesscontrolgroup data-tomark-pass=""> accessControlGroupList;</accesscontrolgroup> |

| AccessControlGroup extends BaseObject |
| --- |
| private String accessControlGroupConfigurationNo; |
| private String accessControlGroupName; |
| private String accessControlGroupDescription; |
| private boolean isDefault; |
| private Date createDate; |

## 예시

### 호출

```
ncloud autoscaling createLaunchConfiguration --serverImageProductCode SPSW0LINUX000044 --launchConfigurationName test-autoscaling
```

### 응답

```
{
  "createLaunchConfigurationResponse": {
    "requestId": "9de32408-bb3d-4c68-bc42-aa5a3e7f4612",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "launchConfigurationList": [
      {
        "launchConfigurationName": "test-autoscaling",
        "serverImageProductCode": "SPSW0LINUX000044",
        "serverProductCode": "SPSVRSTAND000003",
        "memberServerImageNo": "",
        "loginKeyName": "packer-1522153936",
        "createDate": "2018-04-05T14:53:16+0900",
        "userData": "",
        "initScriptNo": ""
      }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8" ?>
<createLaunchConfigurationResponse>
  <requestId>9de32408-bb3d-4c68-bc42-aa5a3e7f4612</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <launchConfigurationList>
    <launchConfigurationName>test-autoscaling</launchConfigurationName>
    <serverImageProductCode>SPSW0LINUX000044</serverImageProductCode>
    <serverProductCode>SPSVRSTAND000003</serverProductCode>
    <memberServerImageNo></memberServerImageNo>
    <loginKeyName>packer-1522153936</loginKeyName>
    <createDate>2018-04-05T14:53:16+0900</createDate>
    <userData></userData>
    <initScriptNo></initScriptNo>
  </launchConfigurationList>
</createLaunchConfigurationResponse>
```