---
title: "putScheduledUpdateGroupAction"
slug: "cli-vautoscaling-autoscalinggroup-putscheduledupdategroupaction"
tags: ["Auto Scaling"]
updated: 2026-04-23T08:57:02Z
published: 2026-04-23T08:58:56Z
canonical: "cli.ncloud-docs.com/cli-vautoscaling-autoscalinggroup-putscheduledupdategroupaction"
---

> ## 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.

# putScheduledUpdateGroupAction

VPC 환경에서 이용 가능합니다.

## 개요

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

## 요청

### 요청 파라미터

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

### 응답 예시

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