全部产品
Search
文档中心

数据传输服务 DTS:升级DTS实例规格

更新时间:Apr 22, 2024

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

说明
  • DTS实例规格已不支持降级。
  • 若DTS实例的源端为Redis 6.0版本且有增量数据更新,请勿执行升级操作,否则可能会导致DTS实例失败且无法恢复(失败后需要重新配置实例)。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String TransferInstanceClass

系统规定参数。取值:TransferInstanceClass

OrderType String UPGRADE

请填入UPGRADE

InstanceClass String large

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

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

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

DtsJobId String r4yr723m199****

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

ResourceGroupId String rg-acfmzawhxxc****

资源组ID。

返回数据

名称

类型

示例值

描述

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. 签名已经过期,请更新签名

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