putScheduledUpdateGroupAction

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 scheduledUpdateGroupActionList = new ArrayList<>();

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>