getScheduledActionList

Available in VPC

Get the list of scaling schedules in Auto Scaling Group that have not yet run.

Syntax

The getScheduledActionList syntax is as follows:

./ncloud vautoscaling getScheduledActionList \
    --autoScalingGroupNo <auto-scaling-group-no> \
    [--scheduledActionNoList <scheduled-action-no-list>] \
    [--scheduledActionNameList <scheduled-action-name-list>] \
    [--startTime <yyyy-MM-ddTHH:mm:ssZ>] \
    [--endTime <yyyy-MM-ddTHH:mm:ssZ>] \
    [--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 getScheduledActionList.

Required options

The following options are required for getScheduledActionList.

Options	Type	Required	Description
`--autoScalingGroupNo`	String	Required	Auto Scaling Group number See getAutoScalingGroupList.
`--pageSize`	Integer	Conditional	Number of items per page `1`-N Required when entering `pageNo`

Optional options

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

Options	Type	Required	Description
`--scheduledActionNoList`	List	Optional	Scheduled number list You can enter multiple items separated by spaces (e.g., `--scheduledActionNoList 1234 2345`).
`--scheduledActionNameList`	List	Optional	Schedule name list You can enter multiple items separated by spaces (e.g., `--scheduledActionNameList test1 test2`).
`--startTime`	Date	Optional	Schedule start date and time `yyyy-MM-ddTHH:mm:ssZ` format. Retrieves schedules after the specified time. Ignored if `scheduledActionNoList` or `scheduledActionNameList` is specified.
`--endTime`	Date	Optional	Schedule end date and time `yyyy-MM-ddTHH:mm:ssZ` format. Retrieves schedules prior to the specified time. Ignored if `scheduledActionNoList` or `scheduledActionNameList` is specified.
`--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. `scheduledActionName` (schedule 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 scaling schedules is successful, the configuration details for each scaling schedule are returned.

Command

The command example is as follows:

./ncloud vautoscaling getScheduledActionList \
    --autoScalingGroupNo 20461037 \
    --scheduledActionNoList 13650027 \
    --pageNo 0 \
    --pageSize 10 \
    --sortList "sortedBy='scheduledActionName',sortingOrder='ASC'" \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
    "getScheduledActionListResponse": {
        "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": "f2a3b4c5-d6e7-8901-fabc-234567890123",
        "returnCode": "0",
        "returnMessage": "success"
    }
}