createLaunchConfiguration

Available in VPC

Create a Launch Configuration.

Syntax

The createLaunchConfiguration syntax is as follows:

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

Options

This section describes the options available when running createLaunchConfiguration.

Required options

The following options are required for createLaunchConfiguration.

Options	Type	Required	Description
`--serverImageNo`	String	Conditional	Server image number Enter this when creating a server with a new server image (scale-out) (KVM, RHV, XEN). At least one among `serverImageNo`, `memberServerImageInstanceNo`, or `serverImageProductCode` must be entered. If multiple values are entered, they are applied in the order of `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode`. See getServerImageList.
`--memberServerImageInstanceNo`	String	Conditional	Server image Instance number Enter when creating a server using a user-created server image (scale-out). At least one among `serverImageNo`, `memberServerImageInstanceNo`, or `serverImageProductCode` must be entered. If multiple values are entered, they are applied in the order of `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode`. See getMemberServerImageInstanceList.
`--serverImageProductCode`	String	Conditional	Server image product code Enter this when creating a server with a new server image (scale-out) (RHV, XEN). At least one among `serverImageNo`, `memberServerImageInstanceNo`, or `serverImageProductCode` must be entered. If multiple values are entered, they are applied in the order of `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode`. See getServerImageProductList.
`--serverSpecNo`	String	Conditional	Server spec number At least one among `serverSpecNo`, `serverSpecCode`, or `serverProductCode` must be entered. If multiple values are entered, they are applied in the order of `serverSpecNo`, `serverSpecCode`, `serverProductCode`. When using `serverImageProductCode`, configures the server spec. See getServerSpecList.
`--serverSpecCode`	String	Conditional	Server spec code At least one among `serverSpecNo`, `serverSpecCode`, or `serverProductCode` must be entered. If multiple values are entered, they are applied in the order of `serverSpecNo`, `serverSpecCode`, `serverProductCode`. See getServerSpecList.
`--serverProductCode`	String	Conditional	Server product code At least one among `serverSpecNo`, `serverSpecCode`, or `serverProductCode` must be entered. If multiple values are entered, they are applied in the order of `serverSpecNo`, `serverSpecCode`, `serverProductCode`. See getServerProductList.

Optional options

These are the optional options for createLaunchConfiguration. Options that are not specified will use their default values.

Options	Type	Required	Description
`--isEncryptedVolume`	Boolean	Optional	Whether to encrypt the default block storage volume `true` \| `false` (default) `true`: Encrypted `false`: Not encrypted Can only be set on RHV server images.
`--initScriptNo`	String	Optional	Init script number Run user-set Init script on first boot. See getInitScriptList.
`--launchConfigurationName`	String	Optional	Launch configuration name Enter 1-255 characters, including lowercase English letters, numbers, and special character `-`. The string must start with a lowercase English letter and end with a lowercase English letter or number. Auto-generated on no input.
`--loginKeyName`	String	Optional	Authentication key name Default: Most recently created authentication key. See getLoginKeyList.

Common options

For information on options commonly used in the vautoscaling command, see Auto Scaling (VPC) options.

Examples

If the request to create a launch configuration is successful, the configuration details and creation status of the launch configuration are returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "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:51:17+0900",
        "launchConfigurationStatus": {
          "code": "CREAT",
          "codeName": "CREATED"
        },
        "initScriptNo": "",
        "isEncryptedVolume": false,
        "serverImageNo": "123456789",
        "osInformation": "rocky-9.8",
        "serverSpecNo": "1234",
        "serverSpecCode": "s2-g3a",
        "serverSpecDescription": "vCPU 2EA, Memory 8GB"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}