putScheduledUpdateGroupAction
    • PDF

    putScheduledUpdateGroupAction

    • PDF

    기사 요약

    개요

    스케줄 액션 생성/수정

    설명

    지정된 오토스케일링 그룹을 위한 스케일링 액션 스케줄을 생성 또는 갱신합니다. 이 액션(action)을 호출할 때 동일한 이름의 스케줄 이름이 이미 있으면 그 스케줄을 변경하고 아니면 스케줄을 생성합니다.
    스케줄의 종류는 일회성 스케줄과 반복 스케줄로 나뉩니다. 일회성 스케줄을 생성하고 싶으면 start time은 지정하고 반복(recurrence) 설정은 하지 않으면 됩니다. 반복 스케줄을 설정하고 싶으면 반복 설정을 하면 됩니다.

    호출할 때 파라미터 중 Min size, Desired Capacity와 max size 이 셋은 적어도 하나는 지정되어 있어야 합니다.
    스케줄이 실행될 때 전술한 세 파라미터 중 지정된 파라미터의 오토스케일링 그룹의 해당 속성을 변경합니다.
    스케줄에 의해 변경된 오토스케일링 그룹의 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 값보다 작거나 같아야 함
    Min: 최소 사이즈(minSize), Max: 최대 사이즈(maxSize)
    Min: 0, Max: 30
    maxSizeConditionalStringMin : 1, Max : 30- 최대 사이즈
    최소 0, 최대 30
    startTimeConditionalDateyyyy-MM-dd'T'HH:mm:ssZ반복 스케줄 설정(recurrenceInKST)이 없는 경우 필수
    반복 스케줄 설정(recurrenceInKST)이 있는 경우: 반복 스케쥴 시작 시간
    format: yyyy-MM-dd'T'HH:mm:ssZ
    예)2013-07-25T17:50:00+0900, 2013-07-25T17:50:00+09:00
    endTimeNoDateyyyy-MM-dd'T'HH:mm:ssZ반복 스케줄 설정(recurrenceInKST)이 있는 경우만 지정이 가능
    반복 스케줄 설정(recurrenceInKST)이 있는 경우: 반복 스케줄 설정 종료 시간
    format : yyyy-MM-dd'T'HH:mm:ssZ
    예)2013-07-25T17:50:00+0900, 2013-07-25T17:50:00+09:00
    recurrenceInKSTNoString예)50 23 * * Sun- 반복 스케줄 설정
    설정 형식은 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 *]

    ※ CLI input parameter type : --recurrenceInKST "0 0 1 * *"

    응답 데이터 타입

    • ScheduledUpdateGroupActionList 타입
    ScheduledUpdateGroupActionList extends CommonResponse
    private Integer totalRows;
    private List scheduledUpdateGroupActionList = new ArrayList();
    ScheduledUpdateGroupAction extends BaseObject
    private String autoScalingGroupName;
    private String scheduledActionName;
    private Integer desiredCapacity;
    private Integer minSize;
    private Integer maxSize;
    private Date startTime;
    private Date endTime;
    private String recurrenceInKST;

    예시

    호출

    ncloud autoscaling putScheduledUpdateGroupAction --autoScalingGroupName testabc --scheduledActionName test3 --desiredCapacity 1 --minSize 1 --maxSize 1 --recurrenceInKST "0 0 1 * *"
    

    응답

    {
      "putScheduledUpdateGroupActionResponse": {
        "requestId": "a3f3052e-2e0b-4ad9-8069-07853834493a",
        "returnCode": "0",
        "returnMessage": "success",
        "totalRows": 1,
        "scheduledUpdateGroupActionList": [
          {
            "autoScalingGroupName": "testabc",
            "scheduledActionName": "test3",
            "desiredCapacity": 1,
            "minSize": 1,
            "maxSize": 1,
            "startTime": "2018-05-01T00:00:00+0900",
            "recurrenceInKST": "0 0 1 * *"
          }
        ]
      }
    }
    
    <?xml version="1.0" encoding="UTF-8" ?>
    <putScheduledUpdateGroupActionResponse>
      <requestId>a3f3052e-2e0b-4ad9-8069-07853834493a</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <scheduledUpdateGroupActionList>
        <autoScalingGroupName>testabc</autoScalingGroupName>
        <scheduledActionName>test3</scheduledActionName>
        <desiredCapacity>1</desiredCapacity>
        <minSize>1</minSize>
        <maxSize>1</maxSize>
        <startTime>2018-05-01T00:00:00+0900</startTime>
        <recurrenceInKST>0 0 1 * *</recurrenceInKST>
      </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.