调用TransferInstanceClass可以升级或降级DTS实例规格。

调试

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

请求参数

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

系统规定参数,取值:TransferInstanceClass

OrderType String UPGRADE

升级或降级实例规格,可选值:

  • UPGRADE(升级)
  • DOWNGRADE(降级)
说明 如果您降级实例,需要提交工单
InstanceClass String large

升降级后的实例规格,可以调用DescribeDtsJobDetail查询升降级前的实例规格。

  • 迁移实例支持的规格:xxlargexlargelargemediumsmall
  • 同步实例支持的规格:largemediumsmallmicro
说明 关于各链路规格的说明及性能测试情况请参见数据迁移链路规格说明数据同步链路规格说明
RegionId String cn-hangzhou

DTS实例所在地域的ID,请参见支持的地域列表

DtsJobId String r4yr723m199****

迁移或同步任务ID,可调用DescribeDtsJobs查询。

返回数据

名称 类型 示例值 描述
ChargeType String POSTPAY

付费类型,返回值:

  • POSTPAY:按量付费(后付费)。
  • PREPAY:包年包月(预付费)。
Code String 200

错误码。

DtsJobId String r4yr723m199****

迁移或同步任务ID。

DynamicMessage String DtsJobId

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

说明 如果ErrMessage返回The Value of Input Parameter %s is not valid,且DynamicMessage返回DtsJobId,则表示所传入的请求参数DtsJobId不合法。
EndTime String 2021-08-04T16:00:00.000+00:00

实例到期时间。

说明 ChargeType为PREPAY,才会返回此参数。
ErrCode String InternalError

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

ErrMessage String The request processing has failed due to some unknown error.

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

HttpStatusCode Integer 200

状态码。

InstanceId String dtsr4yr723m199****

实例ID。

RequestId String 716DB03E-2D0B-4DC3-BC4C-F7A9EE21****

请求ID。

Success Boolean true

请求是否成功。返回值:

  • true:请求成功。
  • false:请求失败。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=TransferInstanceClass
&OrderType=UPGRADE
&InstanceClass=large
&DtsJobId=r4yr723m199****
&<公共请求参数>

正常返回示例

XML格式

<TransferInstanceClassResponse>
        <DtsJobId>r4yr723m199****</DtsJobId>
        <RequestId>716DB03E-2D0B-4DC3-BC4C-F7A9EE21****</RequestId>
        <InstanceId>dtsr4yr723m199****</InstanceId>
        <ChargeType>POSTPAY</ChargeType>
        <HttpStatusCode>200</HttpStatusCode>
        <Success>true</Success>  
</TransferInstanceClassResponse>

JSON格式

{
        "DtsJobId": "r4yr723m199****",
        "RequestId": "716DB03E-2D0B-4DC3-BC4C-F7A9EE21****",
        "InstanceId": "dtsr4yr723m199****",
        "ChargeType": "POSTPAY",
        "HttpStatusCode": 200,
        "Success": true
}

错误码

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