---
title: "getScheduledActionList"
slug: "cli-autoscaling-getscheduledactionlist"
tags: ["Auto Scaling"]
updated: 2026-09-17T09:16:03Z
published: 2026-09-17T09:16:03Z
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

## 개요

스케줄 액션리스트 조회

## 설명

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

## 요청 파라미터

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

## 응답 데이터 타입

- ScheduledUpdateGroupActionList 타입

| ScheduledUpdateGroupActionList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<scheduledupdategroupaction data-tomark-pass=""> scheduledUpdateGroupActionList = new ArrayList<scheduledupdategroupaction data-tomark-pass="">();</scheduledupdategroupaction></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; |

## 예시

### 호출

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

### 응답

```
{
  "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 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>
```