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

调试

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

请求参数

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

系统规定参数。取值：TransferInstanceClass。

OrderType String 是 UPGRADE

升级或降级实例规格，可选值：

  • UPGRADE（升级）
  • DOWNGRADE（降级）
InstanceClass String 是 large

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

  • 迁移实例支持的规格：xxlarge、xlarge、large、medium、small。
  • 同步实例支持的规格：large、medium、small、micro。
说明 关于各链路规格的说明及性能测试情况请参见数据迁移链路规格说明和数据同步链路规格说明。
RegionId String 否 cn-hangzhou

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

DtsJobId String 是 r4yr723m199****

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

返回数据

名称 类型 示例值 描述
EndTime String 2021-08-04T16:00:00.000+00:00

实例到期时间。

说明 ChargeType为PREPAY，才会返回此参数。
HttpStatusCode Integer 200

状态码。
RequestId String 716DB03E-2D0B-4DC3-BC4C-F7A9EE21****

请求ID。
DtsJobId String r4yr723m199****

迁移或同步任务ID。
ErrCode String InternalError

调用出错时返回的错误码。
Success Boolean true

请求是否成功。返回值：

  • true：请求成功。
  • false：请求失败。
ChargeType String POSTPAY

付费类型，返回值：

  • POSTPAY：按量付费（后付费）。
  • PREPAY：包年包月（预付费）。
ErrMessage String The request processing has failed due to some unknown error.

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

错误码。
DynamicMessage String DtsJobId

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

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

实例ID。

示例

请求示例

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

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/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格式 

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

{
  "DtsJobId" : "r4yr723m199****",
  "RequestId" : "716DB03E-2D0B-4DC3-BC4C-F7A9EE21****",
  "InstanceId" : "dtsr4yr723m199****",
  "ChargeType" : "POSTPAY",
  "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. 签名已经过期，请更新签名

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