putScheduledUpdateGroupAction

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

Auto Scaling Group의 Scaling 일정을 생성하거나 수정합니다. 일회성 및 반복성 실행 일정을 설정할 수 있습니다.

구문

putScheduledUpdateGroupAction 구문은 다음과 같습니다.

./ncloud vautoscaling putScheduledUpdateGroupAction \
--autoScalingGroupNo <auto-scaling-group-no> \
--minSize <min-size> \
--maxSize <max-size> \
--desiredCapacity <desired-capacity> \
[--scheduledActionNo <scheduled-action-no>] \
[--scheduledActionName <scheduled-action-name>] \
[--startTime <yyyy-MM-ddTHH:mm:ssZ>] \
[--endTime <yyyy-MM-ddTHH:mm:ssZ>] \
[--recurrence <crontab-expression>] \
[--timeZone <KST|UTC>] \
[--regionCode <KR|KRS>] \
[--output <json|xml>]

옵션

putScheduledUpdateGroupAction 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

putScheduledUpdateGroupAction의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--autoScalingGroupNo`	String	Required	Auto Scaling Group 번호 getAutoScalingGroupList 참조
`--minSize`	Integer	Required	Auto Scaling Group의 최소 서버 수 `0`~`30` `maxSize` 이하로 설정 서버를 보유하지 않으려면 `0` 입력
`--maxSize`	Integer	Required	Auto Scaling Group의 최대 서버 수 `0`~`30` `minSize` 이상으로 설정
`--desiredCapacity`	Integer	Required	Auto Scaling Group의 기대 서버 수 `minSize` 이상, `maxSize` 이하로 설정 입력 값에 따라 서버 수 자동 조정
`--scheduledActionNo`	String	Conditional	일정 번호 일정 생성 시 입력하지 않음 일정 수정 시 `scheduledActionNo`, `scheduledActionName` 중 하나는 필수 입력 getScheduledActionList 참조
`--scheduledActionName`	String	Conditional	일정 이름 새로운 이름 입력 시 일정 생성 영문 소문자, 숫자, 특수문자 `-`를 조합하여 1~255자 이내로 입력 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 기존 이름 입력 시 일정 수정 일정 생성 시 필수 입력 일정 수정 시 `scheduledActionNo`, `scheduledActionName` 중 하나는 필수 입력 getScheduledActionList 참조
`--startTime`	Date	Conditional	일정 시작 일시 `yyyy-MM-ddTHH:mm:ssZ` 형식 현재 시각 이후이며 `endTime` 이전으로 설정 `recurrence` 미설정 시 필수 입력 `recurrence` 설정 시 `startTime` 이후 가장 빠른 반복 일정 실행 `recurrence`만 설정 시 가장 빠른 반복 일정을 `startTime`으로 실행 다른 일정의 시작 시각과 중복 불가

선택 옵션

putScheduledUpdateGroupAction의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--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 (VPC) 옵션을 참조해 주십시오.

예시

Scaling 일정 생성 또는 수정 요청이 성공하면 Scaling 일정의 구성 정보가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vautoscaling putScheduledUpdateGroupAction \
    --autoScalingGroupNo 20461037 \
    --scheduledActionName schedule-01 \
    --minSize 0 \
    --maxSize 2 \
    --desiredCapacity 1 \
    --startTime 2026-12-01T03:00:00+0900 \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "putScheduledUpdateGroupActionResponse": {
    "totalRows": 1,
    "scheduledUpdateGroupActionList": [
      {
        "autoScalingGroupNo": "456789012",
        "scheduledActionNo": "678901234",
        "scheduledActionName": "schedule-01",
        "minSize": 0,
        "maxSize": 2,
        "desiredCapacity": 1,
        "startTime": "2026-12-01T03:00:00+0900",
        "recurrence": "",
        "timeZone": "KST"
      }
    ],
    "requestId": "53207e92-04a6-4133-a106-06775572cda0",
    "returnCode": "0",
    "returnMessage": "success"
  }
}