putScheduledUpdateGroupAction

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

구문

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

./ncloud vautoscaling putScheduledUpdateGroupAction \
    --autoScalingGroupNo <auto-scaling-group-no> \
    --minSize <min-size> \
    --maxSize <max-size> \
    [--scheduledActionNo <scheduled-action-no>] \
    [--scheduledActionName <scheduled-action-name>] \
    [--desiredCapacity <desired-capacity>] \
    [--startTime <yyyy-MM-ddTHH:mm:ssZ>] \
    [--endTime <yyyy-MM-ddTHH:mm:ssZ>] \
    [--recurrence <crontab-expression>] \
    [--timeZone <KST|UTC>] \
    [--regionCode <FKR>] \
    [--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` 이상으로 설정
`--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의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

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

예시

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"
  }
}