getLaunchConfigurationList

VPC環境で利用できます。

Launch Configurationリストを照会します。

構文

getLaunchConfigurationList構文は次の通りです。

./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>]

オプション

getLaunchConfigurationListの実行時に指定できるオプションについて説明します。

必須オプション

getLaunchConfigurationListの必須オプションです。

オプション	タイプ	必須の有無	説明
`--pageSize`	Integer	Conditional	ページごとの項目数 `1`~N `pageNo`入力時、必ず入力

任意オプション

getLaunchConfigurationListの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--launchConfigurationNoList`	List	Optional	Launch Configuration番号リストスペースで区切って複数入力可能 (例: `--launchConfigurationNoList 1234 2345`)
`--launchConfigurationNameList`	List	Optional	Launch Configuration名リストスペースで区切って複数入力可能 (例: `--launchConfigurationNameList test1 test2`)
`--pageNo`	Integer	Optional	ページ番号 `1`~N
`--sortList`	List	Optional	ソートの条件二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 `sortedBy` (任意): ソート対象。有効な値: `launchConfigurationName` (Launch Configuration名) `sortingOrder` (任意): ソート順。`ASC` (上昇、デフォルト) \| `DESC` (下降)

共通オプション

vautoscalingコマンドで共通して使用するオプションについては、Auto Scaling (VPC)のオプションをご参照ください。

例

Launch Configurationリストの照会リクエストが成功すると、各 Launch Configurationの構成情報が返されます。

コマンド

コマンドの例は次の通りです。

./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

出力

出力の例は次の通りです。

{
    "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"
    }
}