调用TransformDBClusterPayType变更PolarDB集群的计费方式。

说明
  • PolarDB集群支持包年包月和按量付费两种计费方式,您可以根据业务需求,将包年包月计费方式转换为按量付费,也可以将按量付费计费方式转换为包年包月。具体请参见包年包月转按量付费按量付费转包年包月
  • 当您的阿里云账号余额不足时,按量付费计费方式无法转换为包年包月。
  • 包年包月计费方式变更为按量付费时,系统会自动退还您已支付费用的余额。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String TransformDBClusterPayType

系统规定参数。取值:TransformDBClusterPayType

DBClusterId String pc-bp10gr51qasnl****

PolarDB集群ID。

PayType String Prepaid

实例的付费类型。取值:

  • Postpaid:后付费(按量付费)
  • Prepaid:预付费(包年包月)
RegionId String cn-hangzhou

地域ID。

UsedTime String 1

购买时长,取值:

  • PeriodYear时,UsedTime取值为1~3。
  • PeriodMonth时,UsedTime取值为1~9。
说明PayType取值Prepaid时,需要传入该参数。
Period String Month

指定预付费实例为包年或者包月类型。取值:

  • Year:包年
  • Month:包月
说明PayType取值为Prepaid时,需要传入该参数。
ResourceGroupId String rg-acfm3f4un32****

资源组ID。

ClientToken String 6000170000591aed949d0f5********************

该参数用于保证请求的幂等性。由客户端生成该参数值,保证在不同请求间该参数值的唯一性。该参数区分大小写、长度不超过64个ASCII字符。

返回数据

名称 类型 示例值 描述
RequestId String 5E71541A-6007-4DCC-A38A-F872C31FEB45

请求ID。

ChargeType String Prepaid

实例的付费类型。取值:

  • Postpaid:后付费(按量付费)
  • Prepaid:预付费(包年包月)
DBClusterId String pc-bp10gr51qasnl****

PolarDB集群ID。

ExpiredTime String 2020-04-20T10:00:00Z

实例的到期时间。

说明PayType取值为Prepaid时,才支持该返回参数。
OrderId String 205157600280623

订单ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=TransformDBClusterPayType
&DBClusterId=pc-bp10gr51qasnl****
&PayType=Prepaid
&RegionId=cn-hangzhou
&UsedTime=1
&Period=Month
&ResourceGroupId=rg-acfm3f4un32****
&ClientToken=6000170000591aed949d0f5********************
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TransformDBClusterPayTypeResponse>
    <RequestId>5E71541A-6007-4DCC-A38A-F872C31FEB45</RequestId>
    <ChargeType>Prepaid</ChargeType>
    <DBClusterId>pc-bp10gr51qasnl****</DBClusterId>
    <ExpiredTime>2020-04-20T10:00:00Z</ExpiredTime>
    <OrderId>205157600280623</OrderId>
</TransformDBClusterPayTypeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidOrderCharge.NotSupport The specified order charge does not support in PolarDB. 该订单收费不支持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. 您的账户暂无有效支付方式,请添加支付方式
403 OperationDenied.LockMode The operation is not permitted when the instance is locked. 实例存于锁定状态
404 InvalidDBCluster.NotFound The specified DBClusterId is not found. 指定的集群实例ID不存在

访问错误中心查看更多错误码。