上报数据迁移进度和速率
功能介绍
此接口由安装在源端服务器上的迁移Agent在数据迁移阶段调用,用来将迁移的具体进度上报给SMS服务端。
迁移Agent自动调用此接口用于上报数据迁移进度,您无需调用此接口。
URI
PUT /v3/tasks/{task_id}/progress
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
task_id |
是 |
String |
主机迁移任务的id 最小长度:0 最大长度:255 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
X-Auth-Token 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:16384 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
subtask_name |
是 |
String |
当前上报进度的子任务名称,子任务名称包括: 创建虚拟机 CREATE_CLOUD_SERVER 配置安全通道 SSL_CONFIG 挂载代理镜像 ATTACH_AGENT_IMAGE 卸载载代理镜像 DETTACH_AGENT_IMAGE Linux分区格式化 FORMAT_DISK_LINUX Linux分区格式化(文件级级) FORMAT_DISK_LINUX_FILE Linux分区格式化(块级) FORMAT_DISK_LINUX_BLOCK Windows分区格式化 FORMAT_DISK_WINDOWS Linux文件级数据迁移 MIGRATE_LINUX_FILE, Linux块级数据迁移 MIGRATE_LINUX_BLOCK Windows块级数据迁移 MIGRATE_WINDOWS_BLOCK 克隆一个虚拟机 CLONE_VM Linux文件级数据同步 SYNC_LINUX_FILE Linux块级数据同步 SYNC_LINUX_BLOCK Windows块级数据同步 SYNC_WINDOWS_BLOCK Linux配置修改 CONFIGURE_LINUX Linux配置修改(块级)CONFIGURE_LINUX_BLOCK Linux配置修改(文件级) CONFIGURE_LINUX_FILE Windows配置修改 CONFIGURE_WINDOWS 最小长度:0 最大长度:255 枚举值:
|
progress |
是 |
Integer |
当前上报的子任务的最新百分比进度 最小值:0 最大值:100 |
replicatesize |
是 |
Long |
当前任务已经复制的数据量大小(B) 最小值:0 最大值:9223372036854775807 |
totalsize |
是 |
Long |
当前任务的总迁移数据大小 最小值:0 最大值:9223372036854775807 |
process_trace |
是 |
String |
迁移或同步时,具体的迁移详情 最小长度:0 最大长度:2048 |
migrate_speed |
否 |
Double |
实施迁移速率,单位Mb/s 最小值:0 最大值:10000 |
compress_rate |
否 |
Double |
实施文件压缩率 |
响应参数
无
请求示例
上报迁移进度
PUT https://{endpoint}/v3/tasks/7a9a9540-ff28-4869-b9e4-855fbe12xxxx/progress { "subtask_name" : "ATTACH_AGENT_IMAGE", "progress" : 100, "replicatesize" : 1000, "totalsize" : 100000, "process_trace" : "" }
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。