检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 主机迁移服务所提供的接口为SMS接口。通过使用SMS接口，您可以完整的使用主机迁移服务的所有功能，包括查询源端服务器列表、创建迁移任务和查看迁移进度等。 表1 主机迁移服务接口列表 类型 说明 源端管理 可以实现上报源端服务器基本信息、查询源端服务器列表以及删除源端服务器的操作。
API v3 查询API版本信息 Agent运行 源端管理 任务管理 命令管理 模板管理 密钥管理 迁移项目管理 网络检测管理 配置设置管理 隐私协议管理
查询API版本信息 查询主机迁移服务的API版本信息 查询主机迁移服务指定API版本信息 父主题： API v3
如何调用API 构造请求 认证鉴权 返回结果
ListApiVersionRequest request = new ListApiVersionRequest(); try { ListApiVersionResponse response = client.listApiVersion(request);
ShowApiVersionRequest request = new ShowApiVersionRequest(); try { ShowApiVersionResponse response = client.showApiVersion(request);
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口，您可以从接口的请求部分看到所需的请求参数及参数
修改模板信息 功能介绍 修改源端模板信息。 调用方法 请参见如何调用API。 URI PUT /v3/vm/templates/{id} 表1 路径参数 参数 是否必选 参数类型 描述 id 是 String 需要修改信息的模板的ID 最小长度：0 最大长度：255 请求参数 表2
计算sha256 功能介绍 计算sha256，加密字段值为uuid。 调用方法 请参见如何调用API。 URI GET /v3/sha256/{key} 表1 路径参数 参数 是否必选 参数类型 描述 key 是 String 关键字，加密字段值为uuid。 最小长度：1 最大长度：16384
查询指定ID的源端服务器 功能介绍 迁移Agent将源端服务器信息上报到主机迁移服务后，主机迁移服务会对迁移的可行性进行检测，该接口返回源端服务器的基本信息和检查结果。 调用方法 请参见如何调用API。 URI GET /v3/sources/{source_id} 表1 路径参数 参数 是否必选 参数类型
修改指定ID的源端服务器名称 功能介绍 该功能用来修改SMS服务端的源端名称，方便用户对源端进行管理。 调用方法 请参见如何调用API。 URI PUT /v3/sources/{source_id} 表1 路径参数 参数 是否必选 参数类型 描述 source_id 是 String
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头。 图1 管理员创建IAM用户响应消息头
更新任务对应源端复制状态 功能介绍 更新任务对应源端复制状态。 调用方法 请参见如何调用API。 URI PUT /v3/sources/{source_id}/changestate 表1 路径参数 参数 是否必选 参数类型 描述 source_id 是 String 源端服务器在主机迁移服务中的ID
调用方法 请参见如何调用API。 URI GET /v3/sources/overview 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
查询指定ID模板信息 功能介绍 查询指定ID的弹性云服务器模板信息。 调用方法 请参见如何调用API。 URI GET /v3/vm/templates/{id} 表1 路径参数 参数 是否必选 参数类型 描述 id 是 String 需要查询的模板信息的ID 最小长度：0 最大长度：255
源端服务器信息被删除，则只能通过重启源端服务器上的迁移Agent来将源端服务器信息重新添加在主机迁移服务界面。 调用方法 请参见如何调用API。 URI DELETE /v3/sources/{source_id} 表1 路径参数 参数 是否必选 参数类型 描述 source_id
获取服务端命令 功能介绍 迁移Agent调用该接口从SMS服务端获取下发给指定源端迁移Agent的命令。 调用方法 请参见如何调用API。 URI GET /v3/sources/{server_id}/command 表1 路径参数 参数 是否必选 参数类型 描述 server_id
删除迁移项目 功能介绍 删除指定ID的迁移项目。 接口约束 迁移项目下没有服务器时可以删除该项目。 调用方法 请参见如何调用API。 URI DELETE /v3/migprojects/{mig_project_id} 表1 路径参数 参数 是否必选 参数类型 描述 mig_project_id
批量删除迁移任务 功能介绍 批量删除迁移任务。 接口约束 只有当Agent与主机迁移服务服务端断开连接，或者源端状态为源端校验失败、就绪中、迁移完成、错误、已暂停可以删除 调用方法 请参见如何调用API。 URI POST /v3/tasks/delete 请求参数 表1 请求Header参数
某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scop
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
