updateAutoScalingGroup

VPC環境で利用できます。

Auto Scaling Groupの詳細情報と設定された Launch Configurationを変更します。

構文

updateAutoScalingGroup構文は次の通りです。

./ncloud vautoscaling updateAutoScalingGroup \
    --autoScalingGroupNo <auto-scaling-group-no> \
    [--minSize <min-size>] \
    [--maxSize <max-size>] \
    [--desiredCapacity <desired-capacity>] \
    [--launchConfigurationNo <launch-configuration-no>] \
    [--serverNamePrefix <server-name-prefix>] \
    [--defaultCoolDown <default-cooldown>] \
    [--healthCheckTypeCode <SVR|LOADB>] \
    [--healthCheckGracePeriod <grace-period>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--autoScalingGroupNo`	String	Required	Auto Scaling Group番号 getAutoScalingGroupListを参照
`--healthCheckGracePeriod`	Integer	Conditional	ヘルスチェックの猶予期間 (秒) サーバの初期処理を考慮し、ヘルスチェックに失敗してもサーバを異常とみなさない時間 `0`~`2147483647` (デフォルト: `300`) `healthCheckTypeCode`が`LOADB`の場合、必ず入力

任意オプション

updateAutoScalingGroupの任意オプションです。指定されていないオプションについては、既存の値が維持されます。

オプション	タイプ	必須の有無	説明
`--minSize`	Integer	Optional	Auto Scaling Groupの最小サーバ数 `0`~`30` `maxSize`以下に設定サーバを保持しない場合は`0`を入力
`--maxSize`	Integer	Optional	Auto Scaling Groupの最大サーバ数 `0`~`30` `minSize`以上に設定
`--desiredCapacity`	Integer	Optional	Auto Scaling Groupの期待サーバ数 `minSize`以上、`maxSize`以下に設定 (デフォルト: `minSize`) 入力値に応じてサーバ数を自動調整
`--launchConfigurationNo`	String	Optional	Launch Configuration番号 getLaunchConfigurationListを参照
`--serverNamePrefix`	String	Optional	サーバ名の接頭辞英字の小文字、数字、記号の`-`を組み合わせて3~7文字以内で入力先頭は英字の小文字、末尾は英字の小文字または数字のみ使用サーバ名ルール: {接頭辞}-{英字\|数字}」で、接頭辞以外の部分は自動作成
`--defaultCoolDown`	Integer	Optional	クールダウンのデフォルト値 (秒) `0`~`2147483647` (デフォルト: `300`) Scaling後のサーバ準備に向けたモニタリングの待機時間
`--healthCheckTypeCode`	String	Optional	ヘルスチェックタイプコード `SVR` (デフォルト) \| `LOADB` `SVR`: サーバ `LOADB`: ロードバランサ `LOADB`の場合、`healthCheckGracePeriod`は必ず入力

共通オプション

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

例

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

コマンド

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

./ncloud vautoscaling updateAutoScalingGroup \
    --autoScalingGroupNo 20461037 \
    --minSize 0 \
    --maxSize 2 \
    --desiredCapacity 0 \
    --defaultCoolDown 600 \
    --regionCode KR \
    --output json

出力

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

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