すべてのプロダクト
Search

このプロダクト

    PolarDB:TransformDBClusterPayType

    ドキュメントセンター

    PolarDB:TransformDBClusterPayType

    最終更新日:Sep 24, 2026

    PolarDB クラスターの課金方法を変更します。

    操作説明

    説明

    • PolarDB クラスターでは、サブスクリプションおよび従量課金の課金方法がサポートされています。ビジネス要件に応じて、サブスクリプションから従量課金へ、または従量課金からサブスクリプションへ切り替えることができます。詳細については、「サブスクリプションから従量課金への切り替え」および「従量課金からサブスクリプションへの切り替え」をご参照ください。

    • Alibaba Cloud アカウントの残高が不足している場合、従量課金からサブスクリプションへ切り替えることはできません。

    • サブスクリプションから従量課金へ切り替える場合、システムは支払い済み料金の残額を自動的に返金します。

    今すぐお試しください

    この 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:TransformDBClusterPayType

    update

    *DBCluster。

    acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    DBClusterId

    string

    必須

    PolarDB クラスターの ID。

    pc-bp10gr51qasnl****
    PayType

    string

    必須

    インスタンスの課金方法。有効な値:

    • Postpaid: 従量課金

    • Prepaid: サブスクリプション

    Prepaid
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    UsedTime

    string

    任意

    サブスクリプション期間。有効な値:

    • Period が Year に設定されている場合、UsedTime を 1 から 3 の値に設定します。

    • Period が Month に設定されている場合、UsedTime を 1 から 9 の値に設定します。

    説明

    このパラメーターは、PayType が Prepaid に設定されている場合に必須です。

    1
    Period

    string

    任意

    インスタンスのサブスクリプション期間の単位。有効な値:

    • Year: 年単位のサブスクリプション

    • Month: 月単位のサブスクリプション

    説明

    このパラメーターは、PayType が Prepaid に設定されている場合に必須です。

    Month
    ResourceGroupId

    string

    任意

    リソースグループの ID。

    rg-acfm3f4un32****
    ClientToken

    string

    任意

    リクエストのべき等性を確保するために使用されるクライアントトークン。このパラメーターの値はクライアントによって生成され、異なるリクエスト間で一意である必要があります。トークンは大文字と小文字が区別され、長さは 64 ASCII 文字を超えることはできません。

    6000170000591aed949d0f5********************
    AutoUseCoupon

    boolean

    任意

    クーポンを自動的に使用するかどうかを指定します。有効な値:

    • true (デフォルト): クーポンを使用します。

    • false: クーポンを使用しません。

    PromotionCode

    string

    任意

    クーポンコード。このパラメーターを指定しない場合、デフォルトのクーポンが使用されます。

    727xxxxxx934

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンススキーマ。

    RequestId

    string

    リクエストの ID。

    5E71541A-6007-4DCC-A38A-F872C31FEB45
    ChargeType

    string

    インスタンスの課金方法。有効な値:

    • Postpaid: 従量課金

    • Prepaid: サブスクリプション

    Prepaid
    DBClusterId

    string

    PolarDB クラスターの ID。

    pc-bp10gr51qasnl****
    ExpiredTime

    string

    インスタンスの有効期限。

    説明

    このレスポンスパラメーターは、PayType が Prepaid に設定されている場合にのみ返されます。

    時間は ISO 8601 規格に準拠し、YYYY-MM-DDTHH:mm:ssZ のフォーマットで表記されます。時間は協定世界時 (UTC) で表示されます。

    2020-04-20T10:00:00Z
    OrderId

    string

    注文の ID。

    20515760028****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "5E71541A-6007-4DCC-A38A-F872C31FEB45",
  "ChargeType": "Prepaid",
  "DBClusterId": "pc-bp10gr51qasnl****",
  "ExpiredTime": "2020-04-20T10:00:00Z",
  "OrderId": "20515760028****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidOrderCharge.NotSupport The specified order charge does not support in PolarDB.
    400 InvalidOrderTask.NotSupport The Current ClusterId exist Order Task in PolarDB.
    400 InvalidPaymentMethod.Incomplete No payment method is specified for your account. We recommend that you add a payment method. 現在のアカウントには有効な支払方法 (バウチャー) が設定されていません。支払方法を追加してください。
    400 InvalidPayType.Malformed The specified parameter PayType is not valid. 指定された PayType パラメーターは無効です。
    400 InvalidPeriod.Malformed The specified parameter Period is not valid. 指定された Period パラメーターは無効です。
    400 InvalidUsedTime.Malformed The specified parameter UsedTime is not valid. 指定された UsedTime パラメーターは無効です。
    400 InvalidPeriodUnit.Malformed The specified parameter PeriodUnit is not valid. 指定された PeriodUnit パラメーターは無効です。
    403 OperationDenied.LockMode The operation is not permitted when the instance is locked. インスタンスがロック済み状態であり、この操作がサポートされていないため、操作に失敗しました。
    403 OperationDenied.DBClusterDeletionLock The operation is not permitted due to the deletion lock of cluster. クラスターに現在の操作をサポートしないクラスターロックが存在するため、操作に失敗しました。
    404 InvalidDBCluster.NotFound The specified DBClusterId is not found. 操作に失敗しました。指定されたクラスターインスタンス ID が存在しません。
    404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid. 指定された DBClusterId がレコードに存在しません。

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

    変更履歴

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