---
title: "getScheduledActionList "
slug: "cli-vautoscaling-autoscalinggroup-getscheduledactionlist"
updated: 2026-04-23T09:04:54Z
published: 2026-04-23T09:07:31Z
---

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

# getScheduledActionList 

## 개요

아직 실행되지 않은 Scaling Action 일정 리스트를 조회합니다. 이미 실행된 Action 기록은 [getAutoScalingActivityLogList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalinggrouplist) 액션을 통해서 조회할 수 있습니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 Auto Scaling Group의 Scheduled Action 리스트가 조회될 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| autoScalingGroupNo | Yes | String |  | - Auto Scaling Group 번호 autoScalingGroupNo는 [getAutoScalingGroupList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalinggrouplist) 액션을 통해 획득 가능 |
| scheduledActionNoList.N | No | List<String> |  | - Scheduled Action 번호 리스트 Scheduled Action 번호로 필터링하여 검색 가능 scheduledActionNo는 [getScheduledActionList](/docs/cli-vautoscaling-autoscalinggroup-getscheduledactionlist) 액션을 통해 획득 가능 ex) scheduledActionNoList.1=1234&scheduledActionNoList.2=2345 |
| scheduledActionNameList.N | No | List<String> | Min : 1, Max : 255 | - Scheduled Action 이름 리스트 Scheduled Action 이름으로 필터링하여 검색 가능 scheduledActionName는 [getScheduledActionList](/docs/cli-vautoscaling-autoscalinggroup-getscheduledactionlist) 액션을 통해 획득 가능 ex) scheduledActionNameList.1=test1&scheduledActionNameList.2=test2 |
| startTime | No | Date | yyyy-MM-ddTHH:mm:ssZ | - 스케쥴 시작 일시 시작 일시가 startTime 보다 크거나 같은 Scheduled Action을 조회 가능 scheduledActionNoList 또는 scheduledActionNameList 가 명시되어 있다면 현재 필드를 무시함 `format : yyyy-MM-ddTHH:mm:ssZ` ex) 2020-07-25T17:50:00+0900, 2020-07-25T17:50:00+09:00 |
| endTime | No | Date | yyyy-MM-ddTHH:mm:ssZ | - 스케쥴 종료 일시 종료 일시가 endTime 보다 작거나 같은 Scheduled Action을 조회 가능 scheduledActionNoList 또는 scheduledActionNameList 가 명시되어 있다면 현재 필드를 무시함 `format : yyyy-MM-ddTHH:mm:ssZ` ex) 2020-07-25T17:50:00+0900, 2020-07-25T17:50:00+09:00 |
| pageNo | No | Integer |  | - 페이징된 결과의 페이지 번호 결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 |
| pageSize | Conditional | Integer |  | - 페이징 시 보여줄 각 페이지 사이즈 결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 pageNo 입력시 반드시 입력함 |
| sortList.N.sortedBy | No | String |  | - 정렬 대상 결과값을 Scheduled Action 이름으로 정렬 가능 Options : scheduledActionName ex) sortList.1.sortedBy=scheduledActionName |
| sortList.N.sortingOrder | No | String |  | - 정렬 순서 sortedBy 이용시 오름차순/내림차순 정렬을 설정함 Options : ASC (오름차순) \| DESC (내림차순) Default : ASC ex) sortList.1.sortingOrder=DESC |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 데이터 타입

- ScheduledUpdateGroupActionList 타입

| ScheduledUpdateGroupActionList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<scheduledupdategroupaction data-tomark-pass=""> scheduledUpdateGroupActionList = new ArrayList&lt;&gt;();</scheduledupdategroupaction> |

| ScheduledUpdateGroupAction |
| --- |
| private String autoScalingGroupNo; |
| private String scheduledActionNo; |
| private String scheduledActionName; |
| private Integer minSize; |
| private Integer maxSize; |
| private Integer desiredCapacity; |
| private Date startTime; |
| private Date endTime; |
| private String recurrence; |
| private String timeZone; |

## 예시

### 요청 예시

```
ncloud vautoscaling getScheduledActionList --regionCode FKR --autoScalingGroupNo ***700 --startTime "2020-12-15T17:00:00+0900" --endTime "2020-12-15T18:00:00+0900"
```

### 응답 예시

```
<getScheduledActionListResponse>
  <requestId>cc4084f6-f32c-4894-b2b8-430982320159</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <scheduledUpdateGroupActionList>
    <scheduledUpdateGroupAction>
      <autoScalingGroupNo>***700</autoScalingGroupNo>
      <scheduledActionNo>***281</scheduledActionNo>
      <scheduledActionName>test-***</scheduledActionName>
      <minSize>0</minSize>
      <maxSize>0</maxSize>
      <desiredCapacity>0</desiredCapacity>
      <startTime>2020-12-15T17:05:00+0900</startTime>
      <endTime>2020-12-15T18:00:00+0900</endTime>
      <recurrence>5 * * * *</recurrence>
      <timeZone>KST</timeZone>
    </scheduledUpdateGroupAction>
  </scheduledUpdateGroupActionList>
</getScheduledActionListResponse>
```