putScheduledUpdateGroupAction
    • PDF

    putScheduledUpdateGroupAction

    • PDF

    Article Summary

    VPC 환경에서 이용 가능합니다.

    개요

    Scaling Action 일정을 생성 또는 수정합니다.
    일회성 스케쥴과 반복 스케쥴을 설정할 수 있습니다.
    일회성 스케쥴을 생성하려면 startTime 을 지정하고 recurrence 를 설정하지 않습니다.
    반복 스케쥴을 생성하려면 recurrence 를 설정합니다. (startTime 과 동시에 설정하면 startTime 이후부터 반복 스케쥴이 수행됩니다.)

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    regionCodeNoString- 리전 코드
    Scheduled Action을 생성 또는 수정할 Auto Scaling Group의 리전(Region) 결정 가능
    regionCode는 getRegionList 액션을 통해 획득 가능
    Default : getRegionList 조회 결과의 첫 번째 리전을 선택
    autoScalingGroupNoYesString- Auto Scaling Group 번호
    autoScalingGroupNo는 getAutoScalingGroupList 액션을 통해 획득 가능
    scheduledActionNoConditionalString- 수정할 Scheduled Action 번호
    Scheduled Action 번호를 이용하여 수정할 스케쥴 지정 가능
    새로운 Scheduled Action을 생성하는 경우에는 입력하지 않음
    수정하는 경우 scheduledActionNo와 scheduledActionName 중 반드시 한개를 필수로 입력
    scheduledActionNo는 getScheduledActionList 액션을 통해 획득 가능
    scheduledActionNameConditionalStringMin : 1, Max : 255
    소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함
    영어 또는 숫자로 끝나야 함
    - Scheduled Action 이름
    새로 생성할 Scheduled Action 이름을 입력하거나 수정할 Scheduled Action 이름을 입력할 수 있음
    지정한 이름의 Scheduled Action이 이미 존재하는경우 해당 Scheduled Action의 내용이 수정됨
    수정하는 경우 scheduledActionNo와 scheduledActionName 중 반드시 한개를 필수로 입력함
    생성하는 경우에는 scheduledActionName을 필수로 입력함
    scheduledActionName는 getScheduledActionList 액션을 통해 획득 가능
    minSizeYesIntegerMin : 0, Max : 30- 최소 용량
    Auto Scaling Group의 최소 서버 수이며 항상 이 값보다 크거나 같은 서버 수가 유지됨
    서버를 한 대도 보유하지 않을 수 있게하려면 0으로 설정함
    해당 Action에 의해서 Auto Scaling Group의 최소 용량 설정이 변경됨
    maxSize 보다 작거나 같은 값이어야 함
    maxSizeYesIntegerMin : 0, Max : 30- 최대 용량
    Auto Scaling Group에서 생성 가능한 최대 서버 수이며 해당 Action에 의해서 Auto Scaling Group의 최대 용량 설정이 변경됨
    minSize 보다 크거나 같은 값이어야 함
    desiredCapacityYesIntegerMin : 0, Max : 30- 기대 용량
    기대 용량값에 따라서 서버의 수가 조정됨
    해당 Action에 의해서 Auto Scaling Group의 기대 용량 설정이 변경됨
    minSize 보다 크거나 같고, maxSize 보다 작거나 같은 값이어야 함
    startTimeConditionalDateyyyy-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
    endTimeNoDateyyyy-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
    recurrenceNoStringcrontab 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 *
    timeZoneNoString- 시간 대역
    반복 설정의 시간 대역 가능
    Options : KST (UTC+9) | UTC (UTC+0)
    Default : KST
    responseFormatTypeNoString- 응답 결과의 포맷 타입
    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>
    

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

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.