putScheduledUpdateGroupAction

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

개요

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

이 문서가 도움이 되었습니까?

What's Next

deleteScheduledUpdateGroupAction

개요
요청
응답
예시

태그