文档首页> 主机迁移服务 SMS> API参考（阿布扎比区域）> API v3> 任务管理> 设置迁移限速规则
更新时间：2022-08-05 GMT+08:00
查看PDF

设置迁移限速规则

功能介绍

设置迁移任务的迁移速率。

URI

POST /v3/tasks/{task_id}/speed-limit

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

主机迁移任务的id

最小长度：0

最大长度：255

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

X-Auth-Token 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度：1

最大长度：16384
表3 请求Body参数

参数

是否必选

参数类型

描述

speed_limit

是

Array of SpeedLimitlJson objects

按时间段限速信息
表4 SpeedLimitlJson

参数

是否必选

参数类型

描述

start

是

String

时间段开始时间，格式：XX:XX。

最小长度：0

最大长度：255

end

是

String

时间段结束时间，格式：XX:XX。

最小长度：0

最大长度：255

speed

是

Integer

时间段的速率，0-1000的整数，单位：Mbit/s。

最小值：0

最大值：10000

响应参数

无

请求示例

  • 设置迁移速率
    POST https://{endpoint}/v3/tasks/7a9a9540-ff28-4869-b9e4-855fbe12e83b/speed-limit

{
  "speed_limit" : [ {
    "start" : "00:00",
    "end" : "23:59",
    "speed" : 0
  } ]
}
  • 更新id为a45a300b-86b5-4b13-8802-52274fa43016的迁移速率
    POST https://{endpoint}/v3/tasks/a45a300b-86b5-4b13-8802-52274fa43016/speed-limit

{
  "speed_limit" : [ {
    "start" : "0:00",
    "end" : "8:00",
    "speed" : 20
  }, {
    "start" : "8:00",
    "end" : "15:00",
    "speed" : 50
  }, {
    "start" : "15:00",
    "end" : "23:59",
    "speed" : 25
  } ]
}

响应示例

无

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 任务管理