putScheduledUpdateGroupAction
- 인쇄
- PDF
putScheduledUpdateGroupAction
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
Scaling Action 일정을 생성 또는 수정합니다.
일회성 스케쥴과 반복 스케쥴을 설정할 수 있습니다.
일회성 스케쥴을 생성하려면 startTime 을 지정하고 recurrence 를 설정하지 않습니다.
반복 스케쥴을 생성하려면 recurrence 를 설정합니다. (startTime 과 동시에 설정하면 startTime 이후부터 반복 스케쥴이 수행됩니다.)
요청
요청 파라미터
파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
---|---|---|---|---|
regionCode | No | String | - 리전 코드 Scheduled Action을 생성 또는 수정할 Auto Scaling Group의 리전(Region) 결정 가능 regionCode는 getRegionList 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 | |
autoScalingGroupNo | Yes | String | - Auto Scaling Group 번호 autoScalingGroupNo는 getAutoScalingGroupList 액션을 통해 획득 가능 | |
scheduledActionNo | Conditional | String | - 수정할 Scheduled Action 번호 Scheduled Action 번호를 이용하여 수정할 스케쥴을 지정 가능 새로운 Scheduled Action을 생성하는 경우에는 입력하지 않음 수정하는 경우 scheduledActionNo와 scheduledActionName 중 반드시 한개를 필수로 입력함 scheduledActionNo는 getScheduledActionList 액션을 통해 획득 가능 | |
scheduledActionName | Conditional | String | Min : 1, Max : 255 소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함 영어 또는 숫자로 끝나야 함 | - Scheduled Action 이름 새로 생성할 Scheduled Action 이름을 입력하거나 수정할 Scheduled Action 이름 입력 가능 지정한 이름의 Scheduled Action이 이미 존재하는경우 해당 Scheduled Action의 내용이 수정됨 수정하는 경우 scheduledActionNo와 scheduledActionName 중 반드시 한개를 필수로 입력함 생성하는 경우에는 scheduledActionName을 필수로 입력함 scheduledActionName는 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 |
---|
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 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
응답 예시
<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>
이 문서가 도움이 되었습니까?