putScheduledUpdateGroupAction
    • PDF

    putScheduledUpdateGroupAction

    • PDF

    기사 요약

    개요

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

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

    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.