putScheduledUpdateGroupAction
- 印刷する
- PDF
putScheduledUpdateGroupAction
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
概要
指定されたAuto Scaling Groupのためのscaling actionスケジュールを作成または更新します。
このアクション(Action)を呼び出す時、同じ名称のスケジュール名が既にある場合、そのスケジュールを変更し、ない場合はスケジュールを作成します。
スケジュールの種類は、一回性スケジュールと繰り返しのスケジュールに区分されます。
一回性スケジュールを作成したい場合はstart timeを指定して、繰り返し(recurrence)設定はセットしなければ作成できます。繰り返しスケジュールを設定したい場合は繰り返し設定をセットすれば設定できます。
呼び出す時のパラメータであるMin size、Desired Capacityとmax sizeの中で、少なくとも一つは指定しなければなりません。
スケジュールが実行される時、前に記述した3つのパラメータの中で指定されたパラメータの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 | 照会するオートスケーリンググループ名を入力します。 |
scheduledActionName | Yes | String | Min : 1 Max : 255 | スケーリングアクションスケジュール名であり、スケジュール識別子の役割をします。 指定されたAuto Scaling Group内では唯一の名称である必要があります。 このアクション(Action)を呼び出す時、同じ名称のスケジュール名が既にある場合はそのスケジュールを変更し、ない場合は作成します。 |
desiredCapacity | Conditional | String | Min : 1, Max : 30 | サービスで期待されるキャパシティであり、該当するグループ所属で運用されるサーバインスタンスの数を設定します。 この値はオートスケーリングに、すでに設定されている既存属性の minSize より大きく、 maxSize より小さく設定する必要があります。 |
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:ssZ ex) 2018-07-25T17:50:00+0900 |
endTime | No | Date | yyyy-MM-dd’T’HH:mm:ssZ | recurrenceInKST(繰り返しスケジュール設定) がない場合は必須format : yyyy-MM-dd'T'HH:mm:ssZ ex) 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-59 0-23 1-31 1-12(または月の英語名) 0-7(0または7が日曜日、または曜日の英語名) です。 フィールド値としてasterisk('*')が入力できますが、最初の値から最後の値までのすべてを意味します。以下はその例示です。 例示 1 :毎時定刻: 0 * * * * 例示 2 : 毎週土曜日 16時30分: 30 16 * * 6 例示 3 : 毎月最初の日夜の12時: 0 0 1 * * 例示 4 : 毎年1月1日夜の12時: 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. |
この記事は役に立ちましたか?