createLaunchConfiguration

VPC 환경에서 이용 가능합니다.

Launch Configuration을 생성합니다.

구문

createLaunchConfiguration 구문은 다음과 같습니다.

./ncloud vautoscaling createLaunchConfiguration \
    --serverImageProductCode <image-product-code> | --serverImageNo <image-no> | --memberServerImageInstanceNo <member-image-no> \
    [--serverProductCode <server-product-code>] \
    [--serverSpecCode <server-spec-code>] \
    [--isEncryptedVolume <true|false>] \
    [--initScriptNo <init-script-no>] \
    [--launchConfigurationName <launch-configuration-name>] \
    [--loginKeyName <login-key-name>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

createLaunchConfiguration 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createLaunchConfiguration의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--serverImageProductCode`	String	Conditional	서버 이미지 상품 코드 신규 서버 이미지로 서버 생성(Scale-out) 시 입력 (RHV, XEN) `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 getServerImageProductList 참조
`--serverImageNo`	String	Conditional	서버 이미지 번호 신규 서버 이미지로 서버 생성(Scale-out) 시 입력 (KVM, RHV, XEN) `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 getServerImageList 참조
`--memberServerImageInstanceNo`	String	Conditional	서버 이미지 인스턴스 번호 사용자가 생성한 서버 이미지로 서버 생성(Scale-out) 시 입력 `memberServerImageInstanceNo`, `serverImageNo`, `serverImageProductCode` 중 하나는 필수 입력 getMemberServerImageInstanceList 참조
`--serverProductCode`	String	Conditional	서버 상품 코드 기본값: 최소 사양 (메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형 순) `serverImageProductCode` 사용 시 서버 스펙 설정 getServerProductList 참조
`--serverSpecCode`	String	Conditional	서버 스펙 코드 기본값: 최소 사양 (메모리, CPU, 기본 블록 스토리지 용량, 디스크 유형 순) `serverImageNo` 사용 시 서버 스펙 설정 getServerSpecList 참조

선택 옵션

createLaunchConfiguration의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--isEncryptedVolume`	Boolean	Optional	기본 블록 스토리지 볼륨 암호화 여부 `true` \| `false` (기본값) `true`: 암호화 `false`: 암호화 안 함 RHV 서버 이미지에서만 설정 가능
`--initScriptNo`	String	Optional	초기화 스크립트 번호 최초 부팅 시 사용자가 설정한 초기화 스크립트 실행 getInitScriptList 참조
`--launchConfigurationName`	String	Optional	Launch Configuration 이름 영문 소문자, 숫자, 특수문자 `-`를 조합하여 1~255자 이내로 입력 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 미입력 시 자동 생성
`--loginKeyName`	String	Optional	인증키 이름 기본값: 최근 생성 인증키 getLoginKeyList 참조

공통 옵션

vautoscaling 명령에서 공통으로 사용하는 옵션에 대한 정보는 Auto Scaling (VPC) 옵션을 참조해 주십시오.

예시

Launch Configuration 생성 요청이 성공하면 Launch Configuration의 구성 정보와 생성 상태가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vautoscaling createLaunchConfiguration \
    --serverImageNo 123456789 \
    --serverSpecCode s2-g3a \
    --launchConfigurationName launch-config-01 \
    --loginKeyName test-key \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createLaunchConfigurationResponse": {
    "totalRows": 1,
    "launchConfigurationList": [
      {
        "regionCode": "KR",
        "launchConfigurationNo": "12345",
        "launchConfigurationName": "launch-config-01",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.09.G003",
        "serverProductCode": "SVR.VSVR.AMD.STAND.C002.M008.G003",
        "loginKeyName": "test-key",
        "createDate": "2026-08-06T16:42:26+0900",
        "launchConfigurationStatus": {
          "code": "CREAT",
          "codeName": "Created"
        },
        "initScriptNo": "",
        "isEncryptedVolume": false,
        "serverImageNo": "123456789",
        "osInformation": "rocky-9.6",
        "serverSpecNo": "1234",
        "serverSpecCode": "s2-g3a",
        "serverSpecDescription": "vCPU 2EA, Memory 8GB"
      }
    ],
    "requestId": "3be647d6-c841-42ed-87ae-ea4b9c7ed748",
    "returnCode": "0",
    "returnMessage": "success"
  }
}