createAutoScalingGroup

VPC環境で利用できます。

Auto Scaling Groupを作成します。

構文

createAutoScalingGroup構文は次の通りです。

./ncloud vautoscaling createAutoScalingGroup \
    --vpcNo <vpc-no> \
    --subnetNo <subnet-no> \
    --accessControlGroupNoList <acg-no-list> \
    --launchConfigurationNo <launch-configuration-no> \
    --minSize <min-size> \
    --maxSize <max-size> \
    [--desiredCapacity <desired-capacity>] \
    [--autoScalingGroupName <auto-scaling-group-name>] \
    [--serverNamePrefix <server-name-prefix>] \
    [--defaultCoolDown <default-cooldown>] \
    [--healthCheckTypeCode <SVR|LOADB>] \
    [--healthCheckGracePeriod <grace-period>] \
    [--targetGroupNoList <target-group-no-list>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--vpcNo`	String	Required	VPC番号 getVpcListを参照
`--subnetNo`	String	Required	Subnet番号 getSubnetListを参照
`--accessControlGroupNoList`	List	Required	ACG番号リスト Scale-out時に作成されるサーバに適用 1~3個以内で入力可能スペースで区切って複数入力可能 (例: `--accessControlGroupNoList 1234 2345`) getAccessControlGroupListを参照
`--launchConfigurationNo`	String	Required	Launch Configuration番号 Scale-out時に適用する Launch Configurationを指定 getLaunchConfigurationListを参照
`--minSize`	Integer	Required	Auto Scaling Groupの最小サーバ数 `0`~`30` `maxSize`以下に設定サーバを保持しない場合は`0`を入力
`--maxSize`	Integer	Required	Auto Scaling Groupの最大サーバ数 `0`~`30` `minSize`以上に設定
`--healthCheckGracePeriod`	Integer	Conditional	ヘルスチェックの猶予期間 (秒) サーバの初期処理を考慮し、ヘルスチェックに失敗してもサーバを異常とみなさない時間 `0`~`2147483647` (デフォルト: `300`) `healthCheckTypeCode`が`LOADB`の場合、必ず入力

任意オプション

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

オプション	タイプ	必須の有無	説明
`--desiredCapacity`	Integer	Optional	Auto Scaling Groupの期待サーバ数 `minSize`以上、`maxSize`以下に設定 (デフォルト: `minSize`) 入力値に応じてサーバ数を自動調整
`--autoScalingGroupName`	String	Optional	Auto Scaling Group名英字の小文字、数字、記号の`-`を組み合わせて1~255文字以内で入力先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用未入力時、自動作成
`--serverNamePrefix`	String	Optional	サーバ名の接頭辞 `s` (デフォルト) 英字の小文字、数字、記号の`-`を使用して3~7文字以内で入力先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用サーバ名ルール: {接頭辞}-{英字\|数字}」で、接頭辞以外の部分は自動作成
`--defaultCoolDown`	Integer	Optional	クールダウンのデフォルト値 (秒) `0`~`2147483647` (デフォルト: `300`) Scaling後のサーバ準備に向けたモニタリングの待機時間
`--healthCheckTypeCode`	String	Optional	ヘルスチェックタイプコード `SVR` (デフォルト) \| `LOADB` `SVR`: サーバ `LOADB`: ロードバランサ `LOADB`の場合、`healthCheckGracePeriod`は必ず入力
`--targetGroupNoList`	List	Optional	Target Group番号リスト `healthCheckTypeCode`が`LOADB`の場合にのみ有効各グループのヘルスチェック方式と基準に基づき、サーバの状態を判断スペースで区切って複数入力可能 (例: `--targetGroupNoList 1234 2345`) getTargetGroupListを参照

共通オプション

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

例

Auto Scaling Groupの作成リクエストが成功すると、Auto Scaling Groupの構成情報と作成状態が返されます。

コマンド

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

./ncloud vautoscaling createAutoScalingGroup \
    --vpcNo 12345678 \
    --subnetNo 23456789 \
    --accessControlGroupNoList 67890123 \
    --launchConfigurationNo 18305791 \
    --minSize 0 \
    --maxSize 0 \
    --desiredCapacity 0 \
    --autoScalingGroupName asg-01 \
    --serverNamePrefix test \
    --defaultCoolDown 300 \
    --healthCheckTypeCode SVR \
    --regionCode KR \
    --output json

出力

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

{
    "createAutoScalingGroupResponse": {
        "totalRows": 1,
        "autoScalingGroupList": [
            {
                "vpcNo": "12345678",
                "subnetNo": "23456789",
                "serverNamePrefix": "test",
                "autoScalingGroupNo": "20461037",
                "autoScalingGroupName": "asg-01",
                "launchConfigurationNo": "18305791",
                "minSize": 0,
                "maxSize": 0,
                "desiredCapacity": 0,
                "defaultCoolDown": 300,
                "healthCheckGracePeriod": 300,
                "healthCheckType": {
                    "code": "SVR",
                    "codeName": "サーバ"
                },
                "createDate": "2026-07-07T10:22:20+0900",
                "autoScalingGroupStatus": {
                    "code": "CREAT",
                    "codeName": "Created"
                },
                "targetGroupNoList": [],
                "inAutoScalingGroupServerInstanceList": [],
                "accessControlGroupNoList": [
                    "67890123"
                ],
                "suspendedProcessList": []
            }
        ],
        "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "returnCode": "0",
        "returnMessage": "success"
    }
}