インスタンスの自動スケーリング設定を変更します。
操作説明
この操作を呼び出して、インスタンスの次の自動スケーリング設定を変更できます:仕様の自動スケーリング、ストレージの自動拡張、帯域幅の自動調整、リソースの自動スケーリング。
-
以下のタイプのデータベースインスタンスに対して、仕様の自動スケーリング機能の設定を変更できます:
PolarDB for MySQL Cluster Edition インスタンス。 機能と課金ルールの詳細については、「自動パフォーマンススケーリング」をご参照ください。
標準 SSD または ESSD (エンタープライズ SSD) を使用する ApsaraDB RDS for MySQL High-availability Edition インスタンス。 機能と課金ルールの詳細については、「自動パフォーマンススケーリング」をご参照ください。
-
以下のタイプのデータベースインスタンスに対して、ストレージの自動拡張機能の設定を変更できます:
標準 SSD または ESSD を使用する ApsaraDB RDS for MySQL High-availability Edition インスタンス。 機能と課金ルールの詳細については、「自動容量拡張」をご参照ください。
-
以下のタイプのデータベースインスタンスに対して、帯域幅の自動調整機能の設定を変更できます:
ApsaraDB for Redis クラシック (ローカルディスクベース) 版インスタンス。 機能と課金ルールの詳細については、「帯域幅の自動調整」をご参照ください。
-
以下のタイプのデータベースインスタンスに対して、リソースの自動スケーリング機能の設定を変更できます:
汎用 ApsaraDB RDS for MySQL Enterprise Edition インスタンス。 機能と課金ルールの詳細については、「自動パフォーマンススケーリング」をご参照ください。
-
Alibaba Cloud SDK または Database Autonomy Service (DAS) SDK を使用してこの操作を呼び出す場合は、最新バージョンの SDK を使用することを推奨します。
-
SDK を使用して DAS の操作を呼び出す場合は、リージョン ID を cn-shanghai に設定する必要があります。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
hdm:ModifyAutoScalingConfig |
update |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceId |
string |
必須 |
インスタンス ID。 |
rm-2ze8g2am97624**** |
| Spec |
object |
任意 |
仕様の自動スケーリング機能の設定項目。 |
|
| Apply |
boolean |
任意 |
仕様の自動スケーリング機能の Spec 設定を適用するかどうかを指定します。 有効な値:
|
true |
| Upgrade |
boolean |
任意 |
仕様の自動スケールアップを有効にするかどうかを指定します。 有効な値:
|
true |
| CpuUsageUpperThreshold |
integer |
任意 |
仕様の自動スケールアップをトリガーする平均 CPU 使用率のしきい値。 単位:%。 有効な値:
説明
このパラメーターは、データベースインスタンスが PolarDB for MySQL Cluster Edition インスタンス、または標準 SSD もしくは ESSD を使用する ApsaraDB RDS for MySQL High-availability Edition インスタンスである場合に指定する必要があります。 |
70 |
| MemUsageUpperThreshold |
integer |
任意 |
仕様の自動スケールアップをトリガーする平均メモリ使用率のしきい値。 単位:%。 有効な値:
説明
このパラメーターは、データベースインスタンスが中国サイト (aliyun.com) の Tair (Redis OSS-compatible) Community Edition クラウドネイティブインスタンスである場合に指定する必要があります。 |
70 |
| MaxSpec |
string |
任意 |
データベースインスタンスがスケールアップできる最大仕様。 データベースインスタンスは、同じエディションのより高い仕様のデータベースインスタンスにのみアップグレードできます。 さまざまなデータベースインスタンスの仕様については、次のトピックをご参照ください:
|
polar.mysql.x8.12xlarge |
| MaxReadOnlyNodes |
integer |
任意 |
インスタンスの読み取り専用ノードの最大数。 説明
このパラメーターは、データベースインスタンスが PolarDB for MySQL Cluster Edition インスタンスである場合に指定する必要があります。 |
10 |
| ObservationWindowSize |
string |
任意 |
観測ウィンドウ。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 m は分、h は時間を指定します。
|
5m |
| CoolDownTime |
string |
任意 |
静止期間。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 m は分、h は時間、d は日を指定します。
|
5m |
| Downgrade |
boolean |
任意 |
仕様の自動スケールダウンを有効にするかどうかを指定します。 有効な値:
説明
このパラメーターは、データベースインスタンスが PolarDB for MySQL Cluster Edition インスタンス、または標準 SSD もしくは ESSD を使用する ApsaraDB RDS for MySQL High-availability Edition インスタンスである場合に指定する必要があります。 |
true |
| Storage |
object |
任意 |
ストレージの自動拡張機能の設定項目。 |
|
| Apply |
boolean |
任意 |
ストレージの自動拡張機能の Storage 設定を適用するかどうかを指定します。 有効な値:
|
true |
| Upgrade |
boolean |
任意 |
ストレージの自動拡張を有効にするかどうかを指定します。 有効な値:
|
true |
| DiskUsageUpperThreshold |
integer |
任意 |
ストレージの自動拡張をトリガーする平均ストレージ使用率のしきい値。 単位:%。 有効な値:
|
70 |
| MaxStorage |
integer |
任意 |
データベースインスタンスの最大ストレージサイズ。 単位:GB。 値は、インスタンスの合計ストレージサイズ以上である必要があります。
説明
標準 SSD ストレージタイプは段階的に廃止されます。 ご利用のインスタンスのストレージタイプを標準 SSD から ESSD にアップグレードすることを推奨します。 |
32000 |
| Bandwidth |
object |
任意 |
帯域幅自動スケーリング機能の設定項目。 |
|
| Apply |
boolean |
任意 |
帯域幅自動スケーリング機能の Bandwidth 設定を適用するかどうかを指定します。 有効な値:
|
true |
| Upgrade |
boolean |
任意 |
帯域幅の自動拡張を有効にするかどうかを指定します。 有効な値:
|
true |
| BandwidthUsageUpperThreshold |
integer |
任意 |
帯域幅の自動拡張をトリガーする平均帯域幅使用率のしきい値。 単位:%。 有効な値:
|
70 |
| ObservationWindowSize |
string |
任意 |
帯域幅自動スケーリング機能の観測ウィンドウ。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 m は分を指定します。 有効な値:
|
5m |
| Downgrade |
boolean |
任意 |
帯域幅の自動ダウングレードを有効にするかどうかを指定します。 有効な値:
|
true |
| BandwidthUsageLowerThreshold |
integer |
任意 |
帯域幅の自動ダウングレードをトリガーする平均帯域幅使用率のしきい値。 単位:%。 有効な値:
|
30 |
| Shard |
object |
任意 |
シャード自動スケーリング機能の設定項目。 |
|
| Apply |
boolean |
任意 |
シャード自動スケーリング機能の Shard 設定を適用するかどうかを指定します。 有効な値:
説明
シャード自動スケーリング機能は、中国サイト (aliyun.com) の Tair (Redis OSS-compatible) クラウドネイティブクラスターインスタンスでのみ利用できます。 |
true |
| Upgrade |
boolean |
任意 |
シャードの自動追加を有効にするかどうかを指定します。 有効な値:
|
true |
| MemUsageUpperThreshold |
integer |
任意 |
シャードの自動追加をトリガーする平均メモリ使用率のしきい値。 単位:%。 有効な値:
|
70 |
| MaxShards |
integer |
任意 |
インスタンス内のシャードの最大数。 正の整数である必要があります。 有効な値:4~32。 |
16 |
| UpgradeObservationWindowSize |
string |
任意 |
シャードの自動追加機能の観測ウィンドウ。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 m は分を指定します。 有効な値:
|
5m |
| Downgrade |
boolean |
任意 |
シャードの自動削除を有効にするかどうかを指定します。 有効な値:
説明
シャードの自動削除機能はカナリアリリースです。 |
true |
| MemUsageLowerThreshold |
integer |
任意 |
シャードの自動削除をトリガーする平均メモリ使用率のしきい値。 単位:%。 有効な値:
|
30 |
| MinShards |
integer |
任意 |
インスタンス内のシャードの最小数。 正の整数である必要があります。 有効な値:4~32。 |
4 |
| DowngradeObservationWindowSize |
string |
任意 |
シャードの自動削除機能の観測ウィンドウ。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 h は時間、d は日を指定します。 有効な値:
|
1h |
| Resource |
object |
任意 |
リソース自動スケーリング機能の設定項目。 |
|
| Apply |
boolean |
任意 |
リソース自動スケーリング機能の Resource 設定を適用するかどうかを指定します。 有効な値:
|
true |
| Enable |
boolean |
任意 |
リソースの自動スケーリングを有効にするかどうかを指定します。 有効な値:
|
true |
| CpuUsageUpperThreshold |
integer |
任意 |
リソースの自動スケールアウトをトリガーする平均 CPU 使用率のしきい値。 単位:%。 有効な値:
|
70 |
| UpgradeObservationWindowSize |
string |
任意 |
リソースの自動スケールアウト機能の観測ウィンドウ。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 m は分を指定します。 有効な値:
列挙値:
|
5m |
| DowngradeObservationWindowSize |
string |
任意 |
リソースの自動スケールイン機能の観測ウィンドウ。 このパラメーターの値は、数値と時間単位のサフィックスで構成されます。 m は分を指定します。 有効な値:
|
5m |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Code |
string |
返される HTTP ステータスコード。 |
200 |
| Message |
string |
返されるメッセージ。 説明
リクエストが成功した場合、Successful が返されます。 リクエストが失敗した場合、エラーコードなどのエラーメッセージが返されます。 |
Successful |
| RequestId |
string |
リクエスト ID。 |
B6D17591-B48B-4D31-9CD6-9B9796B2**** |
| Success |
string |
リクエストが成功したかどうかを示します。 有効な値:
|
true |
例
成功レスポンス
JSONJSON
{
"Code": "200",
"Message": "Successful",
"RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Success": "true"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | |
| 403 | NoPermission | You are not authorized to do this action. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。