---
title: "getScheduledActionList"
slug: "cli-autoscaling-getscheduledactionlist"
updated: 2026-04-23T08:57:03Z
published: 2026-04-23T08:58:56Z
canonical: "cli.ncloud-docs.com/cli-autoscaling-getscheduledactionlist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getScheduledActionList

## 개요<a name="개요"></a>

스케줄 액션리스트 조회


## 설명<a name="설명"></a>


아직 실행되지 않은 사용자의 모든 스케일링 액션 스케줄을 나열합니다. 이미 실행된 action 기록은 getAutoScalingActivityLogList을 호출해서 볼 수 있습니다.
또한 페이징이 가능하여 사용자가 각 페이지 사이즈(항목 수)와 페이지 번호를 지정할 수 있습니다.


## 요청 파라미터<a name="요청파라미터"></a>


| 파라미터 명             | 필수   여부 | 타입         | 제약사항               | 설명                                                         |
| ----------------------- | ----------- | ------------ | ---------------------- | ------------------------------------------------------------ |
| autoScalingGroupName    | No          | String       | Min : 1, Max : 255     | 조회하고자 하는 오토 스케일링 그룹명 입력           |
| scheduledActionNameList | No          | List<String> | Min : 1, Max : 255     | 결과로 받을 스케일링 액션 스케줄명이 리스트로 보여짐    |
| startTime               | No          | Date         | yyyy-MM-dd'T'HH:mm:ssZ | 스케줄 시작일시보다 작거나 같은 시간(datetime)   scheduledActionNameList이 명시되어 있다면 이 필드 무시<br>format:   yyyy-MM-dd'T'HH:mm:ssZ<br>예)2013-07-25T17:50:00+0900,   2013-07-25T17:50:00+09:00 |
| endTime                 | No          | Date         | yyyy-MM-dd'T'HH:mm:ssZ | 스케줄 종료일시보다 작거나 같은 시간   (datetime) scheduledActionNameList 이 명시되어 있다면 이 필드 무시<br>format:   yyyy-MM-dd'T'HH:mm:ssZ<br>예)2013-07-25T17:50:00+0900, 2013-07-25T17:50:00+09:00 |
| pageNo                  | No          | Integer      | Min:0, Max:2147483647  | 리스트 조회시 Pagination의 페이지 정보 입력<br>기본 값 0으로 입력한 경우 모든 리스트 조회 |
| pageSize                | No          | Integer      | Min:0, Max:2147483647  | 리스트 조회시   Pagination의 보여질 정보의 개수 입력<br>기본 값 0으로 입력한 경우 모든 목록 조회 |
| sortedBy                | No          | String       | -                      | 스케줄 액션명(scheduledActionName)   \| 생성일시(createDate) [대소문자 구분 없음]<br>Default:   스케줄 액션명(scheduledActionName) |
| sortingOrder            | No          | String       | -                      | 오름차순(asceding) \| 내림차순(descending) [대소문자 구분 없음]<br>Default: 오름차순(asceding) |



## 응답 데이터 타입<a name="응답데이터타입"></a>


- ScheduledUpdateGroupActionList 타입

| ScheduledUpdateGroupActionList extends CommonResponse                                                                  |
| ---------------------------------------------------------------------------------------------------------------------- |
| private Integer totalRows;                                                                                             |
| private List<ScheduledUpdateGroupAction> scheduledUpdateGroupActionList = new ArrayList<ScheduledUpdateGroupAction>(); |


| ScheduledUpdateGroupAction extends BaseObject                                                                          |
| ---------------------------------------------------------------------------------------------------------------------- |
| private String autoScalingGroupName;                                                                                   |
| private String scheduledActionName;                                                                                    |
| private Integer desiredCapacity;                                                                                       |
| private Integer minSize;                                                                                               |
| private Integer maxSize;                                                                                               |
| private Date startTime;                                                                                                |
| private Date endTime;                                                                                                  |
| private String recurrenceInKST;                                                                                        |



## 예시<a name="예시"></a>

### 호출<a name="호출"></a>

```
ncloud autoscaling getScheduledActionList --autoScalingGroupName soso02 --scheduledActionNameList test-autoscaling-schedule
```

### 응답<a name="응답"></a>


```json
{
  "getScheduledActionListResponse": {
    "requestId": "dfee1ecb-c335-4225-8872-538940aac950",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "scheduledUpdateGroupActionList": [
      {
        "autoScalingGroupName": "soso02",
        "scheduledActionName": "test-autoscaling-schedule",
        "desiredCapacity": 2,
        "minSize": 0,
        "maxSize": 3,
        "startTime": "2018-04-05T19:00:00+0900",
        "endTime": "2020-04-05T20:00:00+0900",
        "recurrenceInKST": ""
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<getScheduledActionListResponse>
  <requestId>dfee1ecb-c335-4225-8872-538940aac950</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <scheduledUpdateGroupActionList>
    <autoScalingGroupName>soso02</autoScalingGroupName>
    <scheduledActionName>test-autoscaling-schedule</scheduledActionName>
    <desiredCapacity>2</desiredCapacity>
    <minSize>0</minSize>
    <maxSize>3</maxSize>
    <startTime>2018-04-05T19:00:00+0900</startTime>
    <endTime>2020-04-05T20:00:00+0900</endTime>
    <recurrenceInKST></recurrenceInKST>
  </scheduledUpdateGroupActionList>
</getScheduledActionListResponse>
```