putScheduledUpdateGroupAction

VPC環境で利用できます。

Auto Scaling Groupの Scalingスケジュールを作成したり変更したりします。1回限りと繰り返しのスケジュールを設定できます。

構文

putScheduledUpdateGroupAction構文は次の通りです。

./ncloud vautoscaling putScheduledUpdateGroupAction \
    --autoScalingGroupNo <auto-scaling-group-no> \
    --minSize <min-size> | --maxSize <max-size> | --desiredCapacity <desired-capacity> \
    [--scheduledActionNo <scheduled-action-no>] \
    [--scheduledActionName <scheduled-action-name>] \
    [--startTime <yyyy-MM-ddTHH:mm:ssZ>] \
    [--endTime <yyyy-MM-ddTHH:mm:ssZ>] \
    [--recurrence <crontab-expression>] \
    [--timeZone <KST|UTC>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--autoScalingGroupNo`	String	Required	Auto Scaling Group番号 getAutoScalingGroupListを参照
`--minSize`	Integer	Conditional	Auto Scaling Groupの最小サーバ数 `0`~`30` `maxSize`以下に設定サーバを保持しない場合は`0`を入力 `minSize`、`maxSize`、`desiredCapacity`のいずれかは必ず入力
`--maxSize`	Integer	Conditional	Auto Scaling Groupの最大サーバ数 `0`~`30` `minSize`以上に設定 `minSize`、`maxSize`、`desiredCapacity`のいずれかは必ず入力
`--desiredCapacity`	Integer	Conditional	Auto Scaling Groupの期待サーバ数 `minSize`以上、`maxSize`以下に設定入力値に応じてサーバ数を自動調整 `minSize`、`maxSize`、`desiredCapacity`のいずれかは必ず入力
`--scheduledActionNo`	String	Conditional	スケジュール番号スケジュール作成時は入力しないスケジュール変更時は、`scheduledActionNo`、`scheduledActionName`のいずれかは必ず入力 getScheduledActionListを参照
`--scheduledActionName`	String	Conditional	スケジュール名新しい名前を入力した場合はスケジュールを作成英字の小文字、数字、記号の`-`を組み合わせて1~255文字以内で入力先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用既存の名前を入力した場合はスケジュールを変更スケジュール作成時は必ず入力スケジュール変更時は`scheduledActionNo`、`scheduledActionName`のいずれかは必ず入力 getScheduledActionListを参照
`--startTime`	Date	Conditional	スケジュール開始日時 `yyyy-MM-ddTHH:mm:ssZ`形式現在時刻以降かつ`endTime`以前に設定 `recurrence`未設定時は必ず入力 `recurrence`設定時は`startTime`以降で最も早い繰り返しスケジュールを実行 `recurrence`のみ設定時は最も早い繰り返しスケジュールを`startTime`として実行他のスケジュールの開始時刻と重複不可

任意オプション

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

オプション	タイプ	必須の有無	説明
`--endTime`	Date	Optional	スケジュール終了日時 `yyyy-MM-ddTHH:mm:ssZ`形式 `startTime`以降に設定 `recurrence`を設定した場合、この時刻以降は繰り返し実行終了
`--recurrence`	String	Optional	繰り返し設定 crontab形式(分時日月曜日) 分: `0`~`59` 時: `0`~`23` 日: `1`~`31` 月: `1`~`12`または英語名曜日: `0`~`7`または英語名 (`0`=`7`=日曜日) ``: すべて選択例毎時: `0 * * ` 毎週土曜日16時30分: `30 16 * 6` 毎月1日午前0時: `0 0 1 * ` 毎年1月1日午前0時: `0 0 1 Jan `
`--timeZone`	String	Optional	基準時間帯繰り返し設定の時間帯域を指定可能 `KST` (デフォルト) \| `UTC` `KST`: UTC+9 `UTC`: UTC+0

共通オプション

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

例

Scalingスケジュールの作成または変更リクエストが成功すると、Scalingスケジュールの構成情報が返されます。

コマンド

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

./ncloud vautoscaling putScheduledUpdateGroupAction \
    --autoScalingGroupNo 20461037 \
    --scheduledActionName schedule-01 \
    --minSize 0 \
    --maxSize 2 \
    --desiredCapacity 1 \
    --startTime 2026-12-01T03:00:00+0900 \
    --regionCode KR \
    --output json

出力

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

{
    "putScheduledUpdateGroupActionResponse": {
        "totalRows": 1,
        "scheduledUpdateGroupActionList": [
            {
                "autoScalingGroupNo": "20461037",
                "scheduledActionNo": "13650027",
                "scheduledActionName": "schedule-01",
                "minSize": 0,
                "maxSize": 2,
                "desiredCapacity": 1,
                "startTime": "2026-12-01T03:00:00+0900",
                "recurrence": "",
                "timeZone": "KST"
            }
        ],
        "requestId": "e1f2a3b4-c5d6-7890-efab-123456789012",
        "returnCode": "0",
        "returnMessage": "success"
    }
}