updateAutoScalingGroup
    • PDF

    updateAutoScalingGroup

    • PDF

    Article Summary

    概要

    指定されたAuto Scaling Groupを更新します。
    指定されたパラメータに該当する属性のみ、その値が変更され、伝達されてないパラメータに該当する属性は既存の値のままに残ります。
    このアクション(Action)の呼び出しのよってminSize、desiredCapacityまたはmaxSizeが変更されても、その大小関係は続けてmaxSize >= desiredCapacity >= minSizeが維持される必要があります。
    zoneNoListが変わるとzone rebalancingが発生します。
    このアクション(Action)の呼び出しによって新しいLaunch Configurationが指定されると、その後からサーバインスタンスが作成される時に効果が表れます。
    Auto Scaling Groupで、現在scaling actionが行われている状態で呼び出すとエラーになります。

    • minSizeは指定されたが、desiredCapacityが指定されてない時、新しいminSize値がAuto Scaling Groupの現在サイズより大きいと、暗示的にsetDesiredCapacityが呼び出されて、グループサイズが新しいminSizeに設定されます。
    • maxSizeは指定されたが、desiredCapacityが指定されてない時、新しいmaxSize値がAuto Scaling Groupの現在サイズより小さいと、暗示的にsetDesiredCapacityが呼び出されて、グループサイズが新しいmaxSizeに設定されます。
    • リクエストする時に、伝達されなかった選択的なパラメータはすべて既存の値のままに残ります。選択的パラメータがなにも伝達されないと、どの属性値も変更されません。(エラーにはなりません。)

    リクエスト

    リクエストパラメータ

    パラメータ名必須タイプ制約事項説明
    autoScalingGroupNameYesStringMin : 1, Max : 255照会しようとするオートスケーリンググループ名を入力します。
    launchConfigurationNameNoStringMin : 1, Max : 255ローンチ設定名
    該当するオートスケーリンググループ所属のサーバインスタンスが新しく作成される時に使うサーバ関連情報を持っています。
    desiredCapacityNoIntegerMin : 0, Max : 30サービスで期待されるキャパシティであり、該当するグループ所属で運用されるサーバインスタンスの数を設定します。
    この値はオートスケーリングに、すでに設定されている既存属性のminSize より大きく、 maxSizeより小さく設定する必要があります。
    minSizeNoIntegerMin : 0, Max : 30最小サイズ(最小0で、maxSizeの値より小さいか同じ)です。
    maxSizeNoIntegerMin : 0, Max : 30最大サイズ
    defaultCooldownNoIntegerMin : 0, Max : 2147483647デフォルトcooldown時間です。
    default : 300
    healthCheckGracePeriodConditionalIntegerMin : 0, Max : 2147483647health checkの保留期間であり、サーバインスタンスがサービスに投入された以降、health checkを保留する時間を設定します。
    healthCheckTypeCode値が LOADB(ロードバランサー)である場合は必須です。
    healthCheckTypeCodeNoStringMin : 1, Max : 5Health checkのタイプコードです。
    SVR(サーバ) LOADB(ロードバランサー)
    zoneNoListNoString重複不可Zone番号のリストです。
    このグループ所属のサーバインスタンスが存在するzone番号リストを入れます。

    レスポンス

    レスポンスボディ

    例示

    リクエスト例示

    {AUTOSCALILNG_API_URL}/updateAutoScalingGroup
    ?autoScalingGroupName=asg-1
    &desiredCapacity=0
    &maxSize=0
    &minSize=0
    

    レスポンス例示

    <updateAutoScalingGroupResponse>
       <requestId>5e40dcb6-56cc-46cd-ae08-98ec6e611cd9</requestId>
       <returnCode>0</returnCode>
       <returnMessage>success</returnMessage>
       <totalRows>1</totalRows>
       <autoScalingGroupList>
          <autoScalingGroup>
             <autoScalingGroupName>asg-1</autoScalingGroupName>
             <autoScalingGroupNo>***517</autoScalingGroupNo>
             <launchConfigurationName>lc-1</launchConfigurationName>
             <launchConfigurationNo>***013</launchConfigurationNo>
             <desiredCapacity>0</desiredCapacity>
             <minSize>0</minSize>
             <maxSize>0</maxSize>
             <loadBalancerInstanceSummeryList>
                <loadBalancerInstanceSummery>
                   <loadBalancerName>slb-1</loadBalancerName>
                </loadBalancerInstanceSummery>
                <loadBalancerInstanceSummery>
                   <loadBalancerName>slb-2</loadBalancerName>
                </loadBalancerInstanceSummery>
             </loadBalancerInstanceSummeryList>
             <healthCheckGracePeriod>600</healthCheckGracePeriod>
             <healthCheckType>
                <code>SVR</code>
                <codeName>Server</codeName>
             </healthCheckType>
             <createDate>2014-02-13T17:24:19+0900</createDate>
             <inAutoScalingGroupServerInstanceList>
                <InAutoScalingGroupServerInstance>
                   <healthStatus>
                      <code>HLTHY</code>
                      <codeName>Healthy (normal)</codeName>
                   </healthStatus>
                   <lifecycleState>
                      <code>INSVC</code>
                      <codeName>In service</codeName>
                   </lifecycleState>
                   <launchConfiguration>
                      <launchConfigurationName>lc-1</launchConfigurationName>
                      <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
                      <serverProductCode>SPSVRSTAND000043</serverProductCode>
                      <memberServerImageNo />
                      <loginKeyName>yh-nang-test</loginKeyName>
                      <createDate>2014-02-13T13:45:57+0900</createDate>
                      <userData />
                   </launchConfiguration>
                   <serverInstanceNo>68084</serverInstanceNo>
                   <serverInstanceName>svr-7f8879ae0826836</serverInstanceName>
                </InAutoScalingGroupServerInstance>
             </inAutoScalingGroupServerInstanceList>
             <suspendedProcessList />
             <zoneList>
                <zone>
                   <zoneNo>2</zoneNo>
                   <zoneName>KR-1</zoneName>
                   <zoneCode>KR-1</zoneCode>
                   <zoneDescription>カサンzone</zoneDescription>
                </zone>
             </zoneList>
          </autoScalingGroup>
       </autoScalingGroupList>
    </updateAutoScalingGroupResponse>
    

    エラーコード

    以下のエラーコードは、このアクション(Action)で特徴的に発生するエラーです。共通的に発生するエラーに対する詳細な説明はNAVER Cloud Platform APIをご参考ください。

    HTTP Response Codeリターンコードリターンメッセージ
    40050120An invalid or out-of-range value was supplied for the input parameter.
    40050130The quota for capacity groups or launch configurations for this customer has already been reached.
    40050160You cannot delete an Auto Scaling group while there are scaling activities in progress for that group.

    この記事は役に立ちましたか?

    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.