更新时间:2022-08-02 GMT+08:00

设置迁移限速规则

功能介绍

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

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

错误码

请参见错误码