---
title: "createLaunchConfiguration"
slug: "cli-autoscaling-createlaunchconfiguration"
updated: 2026-04-23T08:57:03Z
published: 2026-04-23T08:58:56Z
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

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


론치 설정 생성


## 설명<a name="설명"></a>


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


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


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

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


- LaunchConfigurationList 타입

| LaunchConfigurationList extends CommonResponse                                                    |
| ------------------------------------------------------------------------------------------------- |
| private Integer totalRows;                                                                        |
| private List<LaunchConfiguration> launchConfigurationList = new ArrayList<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> accessControlGroupList;                                          |


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


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

### 호출<a name="호출"></a>

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

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


```json
{
  "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
<?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>
```