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

上报数据迁移进度和速率

功能介绍

此接口由安装在源端服务器上的迁移Agent在数据迁移阶段调用,用来将迁移的具体进度上报给SMS服务端。

迁移Agent自动调用此接口用于上报数据迁移进度,您无需调用此接口。

URI

PUT /v3/tasks/{task_id}/progress

表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参数

参数

是否必选

参数类型

描述

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

枚举值:

  • CREATE_CLOUD_SERVER
  • SSL_CONFIG
  • ATTACH_AGENT_IMAGE
  • DETTACH_AGENT_IMAGE
  • FORMAT_DISK_LINUX
  • FORMAT_DISK_LINUX_FILE
  • FORMAT_DISK_LINUX_BLOCK
  • FORMAT_DISK_WINDOWS
  • MIGRATE_LINUX_FILE
  • MIGRATE_LINUX_BLOCK
  • MIGRATE_WINDOWS_BLOCK
  • CLONE_VM
  • SYNC_LINUX_FILE
  • SYNC_LINUX_BLOCK
  • SYNC_WINDOWS_BLOCK
  • CONFIGURE_LINUX
  • CONFIGURE_LINUX_BLOCK
  • CONFIGURE_LINUX_FILE
  • CONFIGURE_WINDOWS

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

错误码

请参见错误码