--- title: "putScheduledUpdateGroupAction" slug: "cli-vautoscaling-autoscalinggroup-putscheduledupdategroupaction" updated: 2026-09-17T09:10:32Z published: 2026-09-17T09:10:32Z canonical: "cli-fin.ncloud-docs.com/cli-vautoscaling-autoscalinggroup-putscheduledupdategroupaction" --- > ## 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 Auto Scaling Group의 Scaling 일정을 생성하거나 수정합니다. 일회성 및 반복성 실행 일정을 설정할 수 있습니다. ## 구문 `putScheduledUpdateGroupAction` 구문은 다음과 같습니다. ``` ./ncloud vautoscaling putScheduledUpdateGroupAction \ --autoScalingGroupNo \ --minSize \ --maxSize \ [--scheduledActionNo ] \ [--scheduledActionName ] \ [--desiredCapacity ] \ [--startTime ] \ [--endTime ] \ [--recurrence ] \ [--timeZone ] \ [--regionCode ] \ [--output ] ``` ## 옵션 `putScheduledUpdateGroupAction` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `putScheduledUpdateGroupAction`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--autoScalingGroupNo` | String | Required | Auto Scaling Group 번호 - [getAutoScalingGroupList](/docs/cli-vautoscaling-autoscalinggroup-getautoscalinggrouplist) 참조 | | `--minSize` | Integer | Required | Auto Scaling Group의 최소 서버 수 - `0`~`30` - `maxSize` 이하로 설정 - 서버를 보유하지 않으려면 `0` 입력 | | `--maxSize` | Integer | Required | Auto Scaling Group의 최대 서버 수 - `0`~`30` - `minSize` 이상으로 설정 | | `--scheduledActionNo` | String | Conditional | 일정 번호 - 일정 생성 시 입력하지 않음 - 일정 수정 시 `scheduledActionNo`, `scheduledActionName` 중 하나는 필수 입력 - [getScheduledActionList](/docs/cli-vautoscaling-autoscalinggroup-getscheduledactionlist) 참조 | | `--scheduledActionName` | String | Conditional | 일정 이름 - 새로운 이름 입력 시 일정 생성 - 영문 소문자, 숫자, 특수문자 `-`를 조합하여 1~255자 이내로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - 기존 이름 입력 시 일정 수정 - 일정 생성 시 필수 입력 - 일정 수정 시 `scheduledActionNo`, `scheduledActionName` 중 하나는 필수 입력 - [getScheduledActionList](/docs/cli-vautoscaling-autoscalinggroup-getscheduledactionlist) 참조 | | `--startTime` | Date | Conditional | 일정 시작 일시 - `yyyy-MM-ddTHH:mm:ssZ` 형식 - 현재 시각 이후이며 `endTime` 이전으로 설정 - `recurrence` 미설정 시 필수 입력 - `recurrence` 설정 시 `startTime` 이후 가장 빠른 반복 일정 실행 - `recurrence`만 설정 시 가장 빠른 반복 일정을 `startTime`으로 실행 - 다른 일정의 시작 시각과 중복 불가 | ### 선택 옵션 `putScheduledUpdateGroupAction`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--desiredCapacity` | Integer | Optional | Auto Scaling Group의 기대 서버 수 - `minSize` 이상, `maxSize` 이하로 설정 (기본값: `minSize`) - 입력 값에 따라 서버 수 자동 조정 | | `--endTime` | Date | Optional | 일정 종료 일시 - `yyyy-MM-ddTHH:mm:ssZ` 형식 - `startTime` 이후로 설정 - `recurrence` 설정 시 해당 시각 이후 반복 실행 종료 | | `--recurrence` | String | Optional | 반복 설정 - crontab 형식(분 시 일 월 요일) - 분: `0`~`59` - 시: `0`~`23` - 일: `1`~`31` - 월: `1`~`12` 또는 영어 이름 - 요일: `0`~`7` 또는 영어 이름 (`0`=`7`=일요일) - `*`: 전체 선택 - 예시 - 매시 정각: `0 * * * *` - 매주 토요일 16시 30분: `30 16 * * 6` - 매월 1일 자정: `0 0 1 * *` - 매해 1월 1일 자정: `0 0 1 Jan *` | | `--timeZone` | String | Optional | 기준 시간대 - 반복 설정의 시간 대역 지정 가능 - `KST` (기본값) \| `UTC` - `KST`: UTC+9 - `UTC`: UTC+0 | ### 공통 옵션 `vautoscaling` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Auto Scaling 옵션](/docs/cli-vautoscaling#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 Scaling 일정 생성 또는 수정 요청이 성공하면 Scaling 일정의 구성 정보가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ``` ./ncloud vautoscaling putScheduledUpdateGroupAction \ --autoScalingGroupNo 456789012 \ --scheduledActionName schedule-01 \ --minSize 0 \ --maxSize 2 \ --desiredCapacity 1 \ --startTime 2026-08-01T03:00:00+0900 \ --regionCode FKR \ --output json ``` ### 출력 출력 예시는 다음과 같습니다. ``` { "putScheduledUpdateGroupActionResponse": { "totalRows": 1, "scheduledUpdateGroupActionList": [ { "autoScalingGroupNo": "456789012", "scheduledActionNo": "678901234", "scheduledActionName": "schedule-01", "minSize": 0, "maxSize": 2, "desiredCapacity": 1, "startTime": "2026-08-01T03:00:00+0900", "recurrence": "", "timeZone": "KST" } ], "requestId": "53207e92-04a6-4133-a106-06775572cda0", "returnCode": "0", "returnMessage": "success" } } ```