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의 대소 관계를 유지해야 합니다.
그렇지 않으면 스케줄 적용이 실패해서 효과가 발생하지 않습니다.
요청 파라미터
파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
---|---|---|---|---|
autoScalingGroupName | Yes | String | Min : 1, Max : 255 | 조회하고자 하는 오토 스케일링 그룹명 입력 |
scheduledActionName | Yes | String | Min : 1, Max : 255 | 스케일링 액션 스케줄 이름이며 스케줄 식별자 역할을 함 지정된 Auto Scaling Group 내에서는 유일한 이름이어야 함 이 액션(action)을 호출할 때 동일한 이름의 스케줄 이름이 이미 있으면 그 스케줄을 변경하고 아니면 스케줄을 생성함 |
desiredCapacity | Conditional | String | Min : 1, Max : 30 | 기대 서비스 능력으로 해당 그룹 소속으로 운영될 서버 인스턴스들의 수를 설정함 이 값이 오토 스케일링에 이미 세팅되어 있는 기존 속성인 min size보다 작아서는 안되고 max size보다 커서는 안됨 |
minSize | Conditional | String | Min : 1, Max : 30 | - 최소 사이즈 최소 0이고 maxSize 값보다 작거나 같아야 함 Min: 최소 사이즈(minSize), Max: 최대 사이즈(maxSize) Min: 0, Max: 30 |
maxSize | Conditional | String | Min : 1, Max : 30 | - 최대 사이즈 최소 0, 최대 30 |
startTime | Conditional | Date | yyyy-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 |
endTime | No | Date | yyyy-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 |
recurrenceInKST | No | String | 예)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 |
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>
이 문서가 도움이 되었습니까?