putScheduledUpdateGroupAction
- 인쇄
- PDF
putScheduledUpdateGroupAction
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
개요
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 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>
이 문서가 도움이 되었습니까?