putScheduledUpdateGroupAction
- 인쇄
- PDF
putScheduledUpdateGroupAction
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
지정된 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의 대소 관계를 유지해야 합니다.
그렇지 않으면 스케줄 적용이 실패해서 효과가 발생하지 않습니다.
요청
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| autoScalingGroupName | Yes | String | Min : 1 Max : 255 | 조회하고자 하는 Auto Scaling 그룹명 입력 |
| scheduledActionName | Yes | String | Min : 1 Max : 255 | - 스케일링 액션 스케줄 이름 스케줄 식별자 역할 지정된 Auto Scaling Group 내에서는 유일한 이름이어야 함 이 액션(Action)을 호출할 때, 동일한 이름의 스케줄 이름이 이미 있으면 그 스케줄을 변경하고, 아니면 스케줄을 생성함 |
| desiredCapacity | Conditional | String | Min : 1, Max : 30 | - 기대 서비스 능력 해당 그룹 소속으로 운영될 서버 인스턴스들의 수를 설정함 이 값이 Auto Scaling에 이미 세팅되어 있는 기존 속성인 min size보다 작아서는 안되고, max size보다 커서는 안됨 |
| minSize | Conditional | String | Min : 1, Max : 30 | 최소 사이즈 최소 0이고 maxSize 값보다 작거나 같아야 함 |
| maxSize | Conditional | String | Min : 1, Max : 30 | 최대사이즈 |
| startTime | Conditional | Date | yyyy-MM-dd’T’HH:mm:ssZ | recurrenceInKST(반복스케쥴설정) 이 없는 경우 필수format : yyyy-MM-dd'T'HH:mm:ssZex) 2018-07-25T17:50:00+0900 |
| endTime | No | Date | yyyy-MM-dd’T’HH:mm:ssZ | recurrenceInKST(반복스케쥴설정) 이 없는 경우 필수format : yyyy-MM-dd'T'HH:mm:ssZex) 2018-07-25T17:50:00+0900 |
| recurrenceInKST | No | String | - | - 반복 스케줄 설정 설정 형식은 crontab 설정 방식 분(minute)과 시(hour)와 날짜(day of month), 달(month) 및 요일(day of week) 필드를 공백문자를 분리자를 이용해 기재하면 됨 분(minute)과 시(hour)와 날짜(day of month), 달(month) 및 요일(day of week) 필드로 입력될 수 있는 유효한 값은 각각 0-590-231-311-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 | 리턴 코드 | 리턴 메시지 |
|---|---|---|
| 400 | 50100 | The named Auto Scaling group or launch configuration already exists. |
| 400 | 50130 | The quota for capacity groups or launch configurations for this customer has already been reached. |
이 문서가 도움이 되었습니까?