スケーリンググループの変更
説明
(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 |
例
リクエストの例
http://ess.aliyuncs.com/?Action=ModifyScalingGroup&ScalingGroupId=cqS5QbbhmvGLcJbWoDbWLj2V&ScalingGroupName=ScalingGroup&<Public Request Parameters>
戻り値の例
XML 形式
< ModifyScalingGroupResponse><RequestId>6469DCD0-13AC-487E-85A0-CE4922908FDE</RequestId></ ModifyScalingGroupResponse>
JSON 形式
"RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE"