putScheduledUpdateGroupAction
    • PDF

    putScheduledUpdateGroupAction

    • PDF

    Article Summary

    概要

    指定された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の関係を維持する必要があります。
    そうでない場合、スケジュールの適用が失敗して効果が発生しません。

    リクエスト

    リクエストパラメータ

    パラメータ名必須タイプ制約事項説明
    autoScalingGroupNameYesStringMin : 1
    Max : 255
    照会するオートスケーリンググループ名を入力します。
    scheduledActionNameYesStringMin : 1
    Max : 255
    スケーリングアクションスケジュール名であり、スケジュール識別子の役割をします。
    指定されたAuto Scaling Group内では唯一の名称である必要があります。
    このアクション(Action)を呼び出す時、同じ名称のスケジュール名が既にある場合はそのスケジュールを変更し、ない場合は作成します。
    desiredCapacityConditionalStringMin : 1, Max : 30サービスで期待されるキャパシティであり、該当するグループ所属で運用されるサーバインスタンスの数を設定します。
    この値はオートスケーリングに、すでに設定されている既存属性のminSize より大きく、 maxSizeより小さく設定する必要があります。
    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 : 毎月最初の日夜の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リターンコードリターンメッセージ
    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.