putScheduledUpdateGroupAction
    • PDF

    putScheduledUpdateGroupAction

    • PDF

    Article Summary

    개요

    지정된 Auto Scaling Group을 위한 scaling action 스케줄을 생성 또는 갱신합니다.
    이 액션(Action)을 호출할 때, 동일한 이름의 스케줄 이름이 이미 있으면 그 스케줄을 변경하고, 아니면 스케줄을 생성합니다.
    스케줄의 종류는 일회성 스케줄과 반복 스케줄로 나뉩니다.
    일회성 스케줄을 생성하고 싶으면 start time은 지정하고 반복(recurrence) 설정은 하지 않으면 됩니다. 반복 스케줄을 설정하고 싶으면 반복 설정을 하면 됩니다.
    호출할 때 파라미터 중 Min size, Desired Capacity와 max size 이 셋은 적어도 하나는 지정되어 있어야 합니다.
    스케줄이 실행될 때 전술한 세 파라미터 중 지정 된 파라미터의 Auto Scaling Group의 해당 속성을 변경합니다.
    스케줄에 의해 변경된 Auto Scaling Group의 Min size, Desired Capacity와 max size는 변경 이후에도 Min size <= Desired Capacity <= max size의 대소 관계를 유지해야 합니다.
    그렇지 않으면 스케줄 적용이 실패해서 효과가 발생하지 않습니다.

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    autoScalingGroupNameYesStringMin : 1
    Max : 255
    조회하고자 하는 오토스케일링 그룹명 입력
    scheduledActionNameYesStringMin : 1
    Max : 255
    - 스케일링 액션 스케줄 이름
    스케줄 식별자 역할으로 지정된 Auto Scaling Group 내에서는 유일한 이름
    이 액션(Action)을 호출할 때, 동일한 이름의 스케줄 이름이 이미 있으면 그 스케줄을 변경하고, 아니면 스케줄을 생성함
    desiredCapacityConditionalStringMin : 1, Max : 30- 기대 서비스 능력
    해당 그룹 소속으로 운영될 서버 인스턴스들의 수 설정
    이 값이 오토스케일링에 이미 세팅되어 있는 기존 속성인 min size보다 작아서는 안되고, max size보다 커서는 안됨
    minSizeConditionalStringMin : 1, Max : 30최소 사이즈
    최소 0이고 maxSize 값보다 작거나 같아야 함
    maxSizeConditionalStringMin : 1, Max : 30최대사이즈
    startTimeConditionalDateyyyy-MM-dd’T’HH:mm:ssZrecurrenceInKST(반복스케쥴설정) 이 없는 경우 필수
    format : yyyy-MM-dd'T'HH:mm:ssZ
    ex) 2018-07-25T17:50:00+0900
    endTimeNoDateyyyy-MM-dd’T’HH:mm:ssZrecurrenceInKST(반복스케쥴설정) 이 없는 경우 필수
    format : yyyy-MM-dd'T'HH:mm:ssZ
    ex) 2018-07-25T17:50:00+0900
    recurrenceInKSTNoString-- 반복 스케줄 설정
    설정 형식은 crontab 설정 방식
    분(minute)과 시(hour)와 날짜(day of month), 달(month) 및 요일(day of week) 필드를 공백문자를 분리자를 이용해 기재
    분(minute)과 시(hour)와 날짜(day of month), 달(month) 및 요일(day of week) 필드로 입력될 수 있는 유효한 값은 각각
    0-59
    0-23
    1-31
    1-12(또는 달 영어 이름)
    0-7(0 또는 7이 일요일, 또는 요일 영어 이름)
    필드 값으로 asterisk('*')를 넣을 수 있는데 있는 처음 값부터 마지막 값 모두를 의미
    예시 1 : 매시 정각: 0 * * * *
    예시 2 : 매주 토요일 16시 30분: 30 16 * * 6
    예시 3 : 매월 첫날 자정: 0 0 1 * *
    예시 4 : 매해 1월 1일 자정: 0 0 1 Jan *

    응답

    응답 바디

    예시

    요청 예시

    {AUTOSCALILNG_API_URL}/putScheduledUpdateGroupAction
    ?autoScalingGroupName=asg-0212
    &desiredCapacity=3
    &scheduledActionName=sa-0303
    &startTime=2014-03-05T10%3A00%3A00%2B0900
    

    응답 예시

    <putScheduledUpdateGroupActionResponse>
       <requestId>948b7bc1-47e6-4d5c-a71d-e85622ab16ef</requestId>
       <returnCode>0</returnCode>
       <returnMessage>success</returnMessage>
       <totalRows>1</totalRows>
       <scheduledUpdateGroupActionList>
          <scheduledUpdateGroupAction>
             <autoScalingGroupName>asg-0212</autoScalingGroupName>
             <scheduledActionName>sa-0303</scheduledActionName>
             <desiredCapacity>3</desiredCapacity>
             <startTime>2014-03-05T10:00:00+0900</startTime>
             <recurrenceInKST />
          </scheduledUpdateGroupAction>
       </scheduledUpdateGroupActionList>
    </putScheduledUpdateGroupActionResponse>
    

    오류 코드

    아래 오류 코드는 이 액션(Action)에서 특징적으로 발생하는 오류입니다. 공통적으로 발생하는 오류에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요

    HTTP Response Code리턴 코드리턴 메시지
    40050100The named Auto Scaling group or launch configuration already exists.
    40050130The quota for capacity groups or launch configurations for this customer has already been reached.

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

    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.