调整同步或迁移实例的迁移速率。

调试

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

请求参数

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

系统规定参数。取值：ModifyDynamicConfig。
DtsJobId String 是 ta7w132u12h****

同步或迁移任务的ID。

说明 可调用DescribeDtsJobs获取任务ID。
JobCode String 是 07

任务码，取值为：

  • 03 : 全量同步或迁移任务。
  • 04 : 增量迁移任务。
  • 07 : 增量同步任务。
RegionId String 否 cn-hangzhou

DTS实例所在地域的ID，请参见支持的地域列表。
ConfigList String 是 { "dts.datamove.source.rps.max": 5000, "dts.datamove.source.bps.max": 10485760 }

具体限速配置。

  • dts.datamove.blaster.qps.max：每秒查询源库的速率。
  • dts.datamove.source.rps.max：每秒全量同步或迁移的行数RPS。
  • dts.datamove.source.bps.max：每秒全量同步或迁移的数据量，单位为Byte/s。
说明
  • 当JobCode取值为03时，您需将EnableLimit配置为true，三个参数的配置才会生效。
  • 当JobCode取值为04或07时，您只需配置dts.datamove.source.rps.max和dts.datamove.source.bps.max。
  • 取值为-1时表示不限速。
EnableLimit Boolean 否 true

是否限制全量同步或迁移任务的迁移速率，取值为true或false。

说明 仅当JobCode为03时需要配置。

返回数据

名称 类型 示例值 描述
HttpStatusCode Integer 200

状态码。
RequestId String 8D81829D-1BBD-5CE8-BE75-1CAD5750****

请求ID。
ErrCode String InternalError

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

请求是否成功。
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不合法。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=ModifyDynamicConfig
&DtsJobId=ta7w132u12h****
&JobCode=07
&RegionId=cn-hangzhou
&ConfigList={"dts.datamove.source.rps.max":5000,"dts.datamove.source.bps.max":10485760}
&公共请求参数

正常返回示例

JSON格式

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

{
  "code" : "200",
  "data" : {
    "RequestId" : "8D81829D-1BBD-5CE8-BE75-1CAD5750****",
    "HttpStatusCode" : 200,
    "Success" : true
  },
  "httpStatusCode" : "200",
  "requestId" : "8D81829D-1BBD-5CE8-BE75-1CAD5750****",
  "successResponse" : 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. 签名已经过期，请更新签名

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