---
title: "putScheduledUpdateGroupAction "
slug: "cli-vautoscaling-autoscalinggroup-putscheduledupdategroupaction"
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.

# putScheduledUpdateGroupAction 

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


Scaling Action 일정을 생성 또는 수정합니다.<br/>
일회성 스케쥴과 반복 스케쥴을 설정할 수 있습니다.<br/>
일회성 스케쥴을 생성하려면 startTime 을 지정하고 recurrence 를 설정하지 않습니다.<br/>
반복 스케쥴을 생성하려면 recurrence 를 설정합니다. (startTime 과 동시에 설정하면 startTime 이후부터 반복 스케쥴이 수행됩니다.)

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


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


| 파라미터명                            | 필수 여부      | 타입                   | 제약 사항                   | 설명                                         |
| ---------------------------------- | ------------ | --------------------- | ------------------------- | ------------------------------------------- |
| regionCode                         | No           | String                |                           | - 리전 코드<br/>Scheduled Action을 생성 또는 수정할 Auto Scaling Group의 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택   |
| autoScalingGroupNo                 | Yes          | String                |                           | - Auto Scaling Group 번호<br/>autoScalingGroupNo는 [getAutoScalingGroupList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalinggrouplist) 액션을 통해 획득 가능    |
| scheduledActionNo                  | Conditional  | String                |                           | - 수정할 Scheduled Action 번호<br/>Scheduled Action 번호를 이용하여 수정할 스케쥴을 지정 가능<br/>새로운 Scheduled Action을 생성하는 경우에는 입력하지 않음<br/>수정하는 경우 scheduledActionNo와 scheduledActionName 중 반드시 한개를 필수로 입력함<br/>scheduledActionNo는 [getScheduledActionList](/docs/cli-vautoscaling-autoscalinggroup-getscheduledactionlist) 액션을 통해 획득 가능   |
| scheduledActionName                | Conditional  | String                | Min : 1, Max : 255<br/>소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함<br/>영어 또는 숫자로 끝나야 함  | - Scheduled Action 이름<br/>새로 생성할 Scheduled Action 이름을 입력하거나 수정할 Scheduled Action 이름 입력 가능<br/>지정한 이름의 Scheduled Action이 이미 존재하는경우 해당 Scheduled Action의 내용이 수정됨<br/>수정하는 경우 scheduledActionNo와 scheduledActionName 중 반드시 한개를 필수로 입력함<br/>생성하는 경우에는 scheduledActionName을 필수로 입력함<br/>scheduledActionName는 [getScheduledActionList](/docs/cli-vautoscaling-autoscalinggroup-getscheduledactionlist) 액션을 통해 획득 가능  |
| minSize                            | Yes          | Integer               | Min : 0, Max : 30         | - 최소 용량<br/>Auto Scaling Group의 최소 서버 수이며 항상 이 값보다 크거나 같은 서버 수가 유지됨<br/>서버를 한 대도 보유하지 않을 수 있게하려면 0으로 설정함<br/>해당 Action에 의해서 Auto Scaling Group의 최소 용량 설정이 변경됨<br/>maxSize 보다 작거나 같은 값이어야 함    |
| maxSize                            | Yes          | Integer               | Min : 0, Max : 30         | - 최대 용량<br/>Auto Scaling Group에서 생성 가능한 최대 서버 수<br/>해당 Action에 의해서 Auto Scaling Group의 최대 용량 설정이 변경됨<br/>minSize 보다 크거나 같은 값이어야 함 |
| desiredCapacity                    | Yes          | Integer               | Min : 0, Max : 30         | - 기대 용량<br/>기대 용량값에 따라서 서버의 수가 조정됨<br/>해당 Action에 의해서 Auto Scaling Group의 기대 용량 설정이 변경됨<br/>minSize 보다 크거나 같고, maxSize 보다 작거나 같은 값이어야 함    |
| startTime                          | Conditional  | Date                  | yyyy-MM-ddTHH:mm:ssZ      | - 스케쥴 시작 일시<br/>스케쥴이 최초로 시작되는 날짜와 시각 결정 가능<br/>recurrence와 동시에 입력하면 startTime 이후 가장 빠른 반복일정에 Action이 수행됨<br/>recurrence만 입력하는 경우 가장 빠른 반복일정이 startTime으로 지정됨<br/>recurrence를 입력하지 않는 경우 startTime을 반드시 입력함<br/>다른 스케쥴의 startTime 과 중복될 수 없으며 현재보다 이후의 시각, endTime 보다 이전의 시각이어야 함<br/>`format : yyyy-MM-ddTHH:mm:ssZ`<br/>ex) 2020-07-25T17:50:00+0900, 2020-07-25T17:50:00+09:00    |
| endTime                            | No           | Date                  | yyyy-MM-ddTHH:mm:ssZ      | - 스케쥴 종료 일시<br/>반복 스케쥴이 종료되는 날짜와 시각 결정 가능<br/>현재보다 이후의 시각, startTime보다 이후의 시각이어야 함<br/>`format : yyyy-MM-ddTHH:mm:ssZ`<br/>ex) 2020-07-25T17:50:00+0900, 2020-07-25T17:50:00+09:00  |
| recurrence                         | No           | String                | crontab expression        | - 반복 설정<br/>반복 스케쥴을 crontab 형식으로 지정 가능<br/>분(minute) / 시(hour) / 날짜(day of month) / 달(month) / 요일(day of week) 필드를 공백 문자를 분리자로 이용하여 기재함<br/><br/>- 각 필드에 입력될 수 있는 유효한 값:<br/>`0-59`<br/>`0-23`<br/>`1-31`<br/>`1-12(또는 달 영어 이름)`<br/>`0-7(또는 요일 영어 이름, 0 또는 7이 일요일)`<br/>또한 모든 필드 값으로 asterisk `*` 문자를 사용할 수 있으며, 처음 값부터 마지막 값 모두를 의미함<br/>ex 1) 매시 정각 `0 * * * *`<br/>ex 2) 매주 토요일 16시 30분 `30 16 * * 6`<br/>ex 3) 매월 1일 자정 `0 0 1 * *`<br/>ex 4) 매해 1월 1일 자정 `0 0 1 Jan *` |
| timeZone                           | No           | String                |                           | - 시간 대역<br/>반복 설정의 시간 대역 지정 가능<br/>Options : KST (UTC+9) \| UTC (UTC+0)<br/>Default : KST    |
| responseFormatType                 | No           | String                |                           | - 응답 결과의 포맷 타입<br/>Options : xml \| json<br/>Default : xml |

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


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

- ScheduledUpdateGroupActionList 타입

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

| 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; |


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

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


```
ncloud vautoscaling putScheduledUpdateGroupAction --regionCode FKR --autoScalingGroupNo ***700 --scheduledActionName test-*** --minSize 0 --maxSize 0 --desiredCapacity 0 --startTime "2020-12-15T17:00:00+0900" --endTime "2020-12-15T18:00:00+0900" --recurrence "5 * * * *" --timeZone KST
```

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


```xml
<putScheduledUpdateGroupActionResponse>
  <requestId></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>
</putScheduledUpdateGroupActionResponse>
```