更新时间:2025-12-04 GMT+08:00
批量设置任务限速 - BatchCheckJobs
功能介绍
批量设置任务限速,任务创建成功后默认不限速。
- 限速:自定义的最大迁移速度,迁移过程中的迁移速度将不会超过该速度。
- 不限速:对迁移速度不进行限制,通常会最大化使用源数据库的出口带宽。该流速模式同时会对源数据库造成读消耗,消耗取决于源数据库的出口带宽。比如:源数据库的出口带宽为100MB/s,假设高速模式使用了80%带宽,则迁移对源数据库将造成80MB/s的读操作IO消耗。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
接口约束
- 限速可以通过设定时间段来定时控制迁移速度。目前默认设定为全天,您也可以根据业务场景自定义限速时间段。
- 自定义限速时间段支持最多设置10个,每个限速时段之间不能存在交叉的时间段,没有设定在限速时间段内的时间默认为不限速。
- 开始限速时间不能与结束时间相同。
- 开始时间为16:00且结束时间为15:59,为全天限速。
- speed_limit参数设置为[]为不限速。
- 开始时间忽略分钟,结束时间必须以59结尾例如03:59相当于4点(UTC时间),小时数为两位数字。
- 双主灾备时父任务不支持。
- 任务模式为INCR_TRANS时不支持。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
PUT /v3/{project_id}/jobs/batch-limit-speed
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-Type | 是 | String | 指定类型为application/json。 缺省值:application/json |
X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。 |
X-Language | 否 | String | 请求语言类型。 缺省值:en-us 取值:
|
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
speed_limits | 是 | Array of objects | 灾备限速设置信息。 详情请参见表4。 |
请求示例
批量设置灾备任务限速,限速15MB/s,限速时间段为
https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-limit-speed
{
"speed_limits" : [ {
"job_id" : "7d0504f1-aba3-435f-914f-936b861jb502",
"speed_limit" : [ {
"begin" : "16:00",
"end" : "15:59",
"speed" : "15"
} ]
} ]
} 响应示例
状态码:200
OK
{
"results" : [ {
"id" : "efa2bd29-8780-494f-a2ee-188b003ejb11",
"status" : "success"
} ],
"count" : 1
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
错误码
请参见错误码。
父主题:公共接口管理

