文档

修改付费方式

更新时间:

调用TransferPayType接口修改DTS产品的付费方式。

请确保在使用该接口前,已充分了解云数据库DTS产品的收费方式和价格

  • 为避免您的资源浪费,在实例转换付费方式操作前确认要进行转换操作。
  • 数据迁移实例只支持按量付费,无需转换。

  • Serverless实例不支持转换付费方式。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String TransferPayType

系统规定参数。取值:TransferPayType

DtsJobId String o4nh3g7jg56****

同步或订阅任务ID,可调用DescribeDtsJobs查询。

ChargeType String PostPaid

修改后的付费方式,取值:

  • PrePaid:预付费,即包年包月。
  • PostPaid:后付费,即按量付费。

  • sync_serverless:后付费Serverless。
Period String Year

预付费实例的计费方式,取值:

  • Year:包年。
  • Month:包月。
说明 ChargeTypePrePaid(预付费)时,该参数才有效且必须传入。
BuyCount String 5

预付费实例购买时长。

  • PeriodYear(包年)时,取值范围为1~5
  • PeriodMonth(包月)时,取值范围为1~60
说明 ChargeTypePrepaid(预付费)时,该参数才有效且必须传入。
RegionId String cn-hangzhou

实例所属的地域,请参见支持的地域列表

MinDu Integer 1

Serverless实例的DU下限,取值为:1、2、4、8、16。

说明 ChargeTypesync_serverless时,该参数才有效且必须传入。
MaxDu Integer 16

Serverless实例的DU上限,取值为:2、4、8、16。

说明 ChargeTypesync_serverless时,该参数才有效且必须传入。
ResourceGroupId String rg-acfmzawhxxc****

资源组ID。

返回数据

名称

类型

示例值

描述

EndTime String 1614916318

预付费实例到期时间,格式为Unix时间戳。

说明
  • 如修改后的实例为后付费实例,则该值为空值。
  • Unix时间戳转换工具可用搜索引擎获取。
HttpStatusCode Integer 200

状态码。

RequestId String 601B6F25-21E7-4484-99D5-3EF2625C****

请求ID。

DtsJobId String o4nh3g7jg56****

任务ID。

ErrCode String InternalError

调用错误时返回的错误码。

Success Boolean true

请求是否成功,返回值:

  • true:请求成功。
  • false:请求失败。
ChargeType String PostPaid

修改后的付费方式,返回值:

  • PrePaid:预付费。
  • PostPaid:后付费。
ErrMessage String The Value of Input Parameter %s is not valid.

调用错误时返回的错误信息。

Code String 200

错误码,本参数即将下线。

DynamicMessage String DtsJobId

动态错误信息,用于替换返回参数ErrMessage错误信息中的%s

说明 如果ErrMessage返回The Value of Input Parameter %s is not valid,且DynamicMessage返回DtsJobId,则代表所传入的请求参数DtsJobId不合法。
InstanceId String dtso4nh3g7jg56****

实例ID。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=TransferPayType
&ChargeType=PostPaid
&DtsJobId=o4nh3g7jg56****
&<公共请求参数>

正常返回示例

XML格式

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

<TransferPayTypeResponse>
    <DtsJobId>o4nh3g7jg56****</DtsJobId>
    <RequestId>601B6F25-21E7-4484-99D5-3EF2625C****</RequestId>
    <InstanceId>dtso4nh3g7jg56****</InstanceId>
    <ChargeType>PostPaid</ChargeType>
    <HttpStatusCode>200</HttpStatusCode>
    <Success>true</Success>
</TransferPayTypeResponse>

JSON格式

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

{
  "DtsJobId" : "o4nh3g7jg56****",
  "RequestId" : "601B6F25-21E7-4484-99D5-3EF2625C****",
  "InstanceId" : "dtso4nh3g7jg56****",
  "ChargeType" : "PostPaid",
  "HttpStatusCode" : 200,
  "Success" : true
}

错误码

HttpCode

错误码

错误信息

描述

400 Throttling.User Request was denied due to user flow control. 由于请求频次达到阈值,请求被拒绝,请稍后重试。
500 ServiceUnavailable The request has failed due to a temporary failure of the server. 由于服务端响应超时或者不可用导致请求失败,请重试,重试后仍失败请联系技术支持。
403 InvalidSecurityToken.Expired Specified SecurityToken is expired. 签名已经过期,请更新签名

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