すべてのプロダクト
Search
ドキュメントセンター

Modify a scaling group

最終更新日: Mar 18, 2020

説明

(1) スケーリンググループの属性を変更します。ただし、次の属性は変更できません。

  • RegionId
  • LoadBalancerId
  • DBInstanceId

(2) インターフェイスを呼び出すことができるのは、スケーリンググループがアクティブまたは非アクティブのときに限られます。

(3) スケーリンググループに指定されたスケーリング設定を変更する必要がある場合は、変更するスケーリング設定とアクティブなスケーリング設定の instancetype 属性が一致している必要があります。

  • 新しいスケーリング設定がスケーリンググループに追加されても、以前のスケーリング設定に基づいて作成された実行中の ECS インスタンスは変更されません。

(4) スケーリンググループに含まれている ECS インスタンスの数 (合計容量) が、変更後の MaxSize と MinSize の範囲に収まらない場合は、収まるように ECS インスタンスが自動的にグループにアタッチ、またはグループから削除されます。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい 操作インターフェイス名、必須パラメーター。値: ModifyScalingGroup。
ScalingGroupId String はい スケーリンググループ ID。
ScalingGroupName String いいえ 表示されるスケーリンググループの名前。2 ~ 40 文字で指定する必要があります (英語または中国語)。この名前は、数字、大文字/小文字の英字、または漢字で始まる必要があり、”_”、”-“、”.” を使用できます。アカウント名は、同じリージョン内で一意です。
ActiveScalingConfigurationId String いいえ スケーリンググループのアクティブなスケーリング設定の ID。
MinSize Integer いいえ スケーリンググループの ECS インスタンスの最小数。値範囲: [0, 100]。
MaxSize Integer いいえ スケーリンググループの ECS インスタンスの最大数。値範囲: [0, 100]。
DefaultCooldown Integer いいえ スケーリンググループのデフォルトのクールダウン時間 (秒)。値範囲: [0, 86400]。
RemovalPolicy.N String いいえ スケーリンググループから ECS インスタンスを削除する場合のポリシー。オプション: OldestInstance (スケーリンググループにアタッチされた最初の ECS インスタンスを削除します)
NewestInstance (スケーリンググループにアタッチされた最後の ECS インスタンスを削除します)
OldestScalingConfiguration (スケーリング設定が最も古い ECS インスタンスを削除します)
最大 2 個の削除ポリシーを入力できます。

リターンパラメーター

リターンパラメーター

エラーコード

すべてのインターフェイスに共通のエラーについては、「エラーコード表」のクライアントエラー または サーバエラーを参照してください。

エラー エラーコード 説明 HTTP ステータスコード
指定したスケーリンググループがこのアカウントに存在しません。 InvalidScalingGroupId.NotFound 指定したスケーリンググループが存在しません。 404
このスケーリンググループ名は既に存在します。 InvalidScalingGroupName.Duplicate 指定したパラメーター <parameter name> の値が重複しています。 400
指定したスケーリング設定がスケーリンググループに存在しません。 InvalidScalingConfigurationId.NotFound 指定したスケーリング設定が存在しません。 404
指定したスケーリング設定とアクティブなスケーリング設定のインスタンスタイプが一致しません。 InvalidScalingConfigurationId.InstanceTypeMismatch 指定したスケーリング設定と既存のアクティブなスケーリング設定のインスタンスタイプが異なります。 400
指定した MinSize が MaxSize を超えています。 InvalidParameter.Conflict パラメーター <parameter name> とパラメーター <parameter name> の値が競合しています。 400

リクエストの例

  1. http://ess.aliyuncs.com/?Action=ModifyScalingGroup
  2. &ScalingGroupId=cqS5QbbhmvGLcJbWoDbWLj2V
  3. &ScalingGroupName=ScalingGroup
  4. &<Public Request Parameters>

戻り値の例

XML 形式

  1. < ModifyScalingGroupResponse>
  2. <RequestId>6469DCD0-13AC-487E-85A0-CE4922908FDE</RequestId>
  3. </ ModifyScalingGroupResponse>

JSON 形式

  1. "RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE"