updateAutoScalingGroup
- 印刷する
- PDF
updateAutoScalingGroup
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
概要
指定された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に設定されます。
- リクエストする時に、伝達されなかった選択的なパラメータはすべて既存の値のままに残ります。選択的パラメータがなにも伝達されないと、どの属性値も変更されません。(エラーにはなりません。)
リクエスト
リクエストパラメータ
パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
---|---|---|---|---|
autoScalingGroupName | Yes | String | Min : 1, Max : 255 | 照会しようとするオートスケーリンググループ名を入力します。 |
launchConfigurationName | No | String | Min : 1, Max : 255 | ローンチ設定名 該当するオートスケーリンググループ所属のサーバインスタンスが新しく作成される時に使うサーバ関連情報を持っています。 |
desiredCapacity | No | Integer | Min : 0, Max : 30 | サービスで期待されるキャパシティであり、該当するグループ所属で運用されるサーバインスタンスの数を設定します。 この値はオートスケーリングに、すでに設定されている既存属性の minSize より大きく、 maxSize より小さく設定する必要があります。 |
minSize | No | Integer | Min : 0, Max : 30 | 最小サイズ(最小0で、maxSizeの値より小さいか同じ)です。 |
maxSize | No | Integer | Min : 0, Max : 30 | 最大サイズ |
defaultCooldown | No | Integer | Min : 0, Max : 2147483647 | デフォルトcooldown時間です。default : 300 |
healthCheckGracePeriod | Conditional | Integer | Min : 0, Max : 2147483647 | health checkの保留期間であり、サーバインスタンスがサービスに投入された以降、health checkを保留する時間を設定します。 healthCheckTypeCode値が LOADB(ロードバランサー)である場合は必須です。 |
healthCheckTypeCode | No | String | Min : 1, Max : 5 | Health checkのタイプコードです。SVR(サーバ) LOADB(ロードバランサー) |
zoneNoList | No | String | 重複不可 | 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 | リターンコード | リターンメッセージ |
---|---|---|
400 | 50120 | An invalid or out-of-range value was supplied for the input parameter. |
400 | 50130 | The quota for capacity groups or launch configurations for this customer has already been reached. |
400 | 50160 | You cannot delete an Auto Scaling group while there are scaling activities in progress for that group. |
この記事は役に立ちましたか?