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

:ModifyDBClusterServerlessConf

最終更新日:Dec 15, 2025

サーバーレスクラスターの構成を変更します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

polardb:ModifyDBClusterServerlessConf

update

*DBCluster

acs:polardb:*:{#accountId}:dbcluster/{#DbClusterId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

DBClusterId

string

必須

サーバーレスクラスターの ID。

pc-bp10gr51qasnl****

ScaleMin

string

任意

スケーリング用のノードあたりの最小 PCU 数。有効な値:1 PCU~31 PCU。

1

ScaleMax

string

任意

スケーリング用のノードあたりの最大 PCU 数。有効な値:1 PCU~32 PCU。

10

ScaleRoNumMin

string

任意

スケーリング用の読み取り専用ノードの最小数。有効な値:0~15。

1

ScaleRoNumMax

string

任意

スケーリング用の読み取り専用ノードの最大数。有効な値:0~15。

2

AllowShutDown

string

任意

「無操作による中断」を有効にするかどうかを指定します。デフォルト値:false。有効な値:

  • true

  • false

true

SecondsUntilAutoPause

string

任意

「無操作による中断」の検出期間。有効な値:5~1440。単位:分。検出期間は 5 分の倍数である必要があります。

10

ScaleApRoNumMin

string

任意

安定した AP 読み取り専用ノードの最小数。有効な値:0~7。

1

ScaleApRoNumMax

string

任意

安定した AP 読み取り専用ノードの最大数。有効な値:0~7。

1

PlannedStartTime

string

任意

読み取り専用ノードを追加するためのスケジュールされたタスクの最も早い開始時刻。スケジュールされたタスクは、必要な期間に実行されることを指定します。YYYY-MM-DDThh:mm:ssZ 形式で時間を指定します。時間は UTC である必要があります。

説明
  • スケジュールされたタスクの最も早い開始時刻は、今後 24 時間以内の時点にすることができます。たとえば、現在の時刻が 2021-01-14T09:00:00Z の場合、2021-01-14T09:00:00Z から 2021-01-15T09:00:00Z までの間の時点を指定できます。

  • このパラメーターを空のままにした場合、読み取り専用ノードを追加するタスクはデフォルトで直ちに実行されます。

2021-01-14T09:00:00Z

PlannedEndTime

string

任意

スケジュールされた期間内に仕様をアップグレードするための最も遅い開始時刻。YYYY-MM-DDThh:mm:ssZ 形式で時間を指定します。時間は UTC である必要があります。

説明
  • このパラメーターの値は、PlannedStartTime の値より少なくとも 30 分後である必要があります。

  • PlannedStartTime を指定し、PlannedEndTime を指定しない場合、タスクの最も遅い開始時刻は、次の数式を使用して計算された値に設定されます:PlannedEndTime の値 + 30 分。たとえば、PlannedStartTime を 2021-01-14T09:00:00Z に設定し、PlannedEndTime を指定しない場合、タスクの最も遅い開始時刻は 2021-01-14T09:30:00Z に設定されます。

2021-01-14T09:30:00Z

FromTimeService

boolean

任意

パラメーターを変更してクラスターを再起動するタスクを、即時実行するかスケジュール実行するかを指定します。有効な値:

  • false:スケジュールされたタスク

  • true:即時タスク

false

ServerlessRuleCpuShrinkThreshold

string

任意

CPU のスケールダウンしきい値

50

ServerlessRuleCpuEnlargeThreshold

string

任意

CPU のバーストしきい値

80

ServerlessRuleMode

string

任意

エラスティック感度。値: ・normal:標準 ・flexible:高感度

normal

TaskId

string

任意

非同期タスク ID。

143f8e9f-2566-4dff-be47-bed79f28fc78

CrontabJobId

string

任意

周期ポリシー ID。

143f8e9f-2566-4dff-be47-bed79f28fc78

レスポンスフィールド

フィールド

説明

object

DBClusterId

string

サーバーレスクラスターの ID。

pc-bp10gr51qasnl****

RequestId

string

リクエスト ID。

5E71541A-6007-4DCC-A38A-F872C31FEB45

成功レスポンス

JSONJSON

{
  "DBClusterId": "pc-bp10gr51qasnl****",
  "RequestId": "5E71541A-6007-4DCC-A38A-F872C31FEB45"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

404 InvalidDBInstanceClass.NotFound rw class code must be equal with hot replica
404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。