getLaunchConfigurationList

Available in VPC

Get the list of launch configurations.

Syntax

The getLaunchConfigurationList syntax is as follows:

./ncloud vautoscaling getLaunchConfigurationList \
    [--launchConfigurationNoList <launch-configuration-no-list>] \
    [--launchConfigurationNameList <launch-configuration-name-list>] \
    [--pageNo <page-no>] \
    [--pageSize <page-size>] \
    [--sortList <sort-condition>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running getLaunchConfigurationList.

Required options

The following options are required for getLaunchConfigurationList.

Options	Type	Required	Description
`--pageSize`	Integer	Conditional	Number of items per page `1`-N Required when entering `pageNo`

Optional options

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

Options	Type	Required	Description
`--launchConfigurationNoList`	List	Optional	Launch configuration number list You can enter multiple items separated by spaces (e.g., `--launchConfigurationNoList 1234 2345`).
`--launchConfigurationNameList`	List	Optional	Launch configuration name list You can enter multiple items separated by spaces (e.g., `--launchConfigurationNameList test1 test2`).
`--pageNo`	Integer	Optional	Page number `1`-N
`--sortList`	List	Optional	Sort criteria Enter {field='value'} pairs enclosed in quotes and separated by commas. `sortedBy` (optional): Sort target. Valid value: `launchConfigurationName` (launch configuration name). `sortingOrder` (optional): Sort order. `ASC` (ascending, default) \| `DESC` (descending).

Common options

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

Examples

If the request to retrieve the list of launch configurations is successful, the configuration information for each launch configuration is returned.

Command

The command example is as follows:

./ncloud vautoscaling getLaunchConfigurationList \
    --launchConfigurationNoList 18305791 18305792 \
    --launchConfigurationNameList test-launch-config-01 test-launch-config-02 \
    --pageNo 0 \
    --pageSize 10 \
    --sortList "sortedBy='launchConfigurationName',sortingOrder='ASC'" \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
    "getLaunchConfigurationListResponse": {
        "totalRows": 2,
        "launchConfigurationList": [
            {
                "regionCode": "KR",
                "launchConfigurationNo": "18305791",
                "launchConfigurationName": "test-launch-config-01",
                "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050",
                "serverProductCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002",
                "loginKeyName": "test-key",
                "createDate": "2026-07-07T10:12:41+0900",
                "launchConfigurationStatus": {
                    "code": "CREAT",
                    "codeName": "Created"
                },
                "initScriptNo": "",
                "isEncryptedVolume": false,
                "serverImageNo": "25624115",
                "osInformation": "Rocky Linux 8.10",
                "serverSpecNo": "43",
                "serverSpecCode": "s2-g2-s50",
                "serverSpecDescription": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB"
            },
            {
                "regionCode": "KR",
                "launchConfigurationNo": "18305792",
                "launchConfigurationName": "test-launch-config-02",
                "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.0810.B050",
                "serverProductCode": "SVR.VSVR.STAND.C002.M008.NET.SSD.B050.G002",
                "loginKeyName": "test-key",
                "createDate": "2026-07-07T10:12:41+0900",
                "launchConfigurationStatus": {
                    "code": "CREAT",
                    "codeName": "Created"
                },
                "initScriptNo": "",
                "isEncryptedVolume": false,
                "serverImageNo": "25624115",
                "osInformation": "Rocky Linux 8.10",
                "serverSpecNo": "43",
                "serverSpecCode": "s2-g2-s50",
                "serverSpecDescription": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB"
            }
        ],
        "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
        "returnCode": "0",
        "returnMessage": "success"
    }
}