检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
功能总览 功能总览 全部 API SDK 权限管理 同步任务 割接方案 归档数据迁移 错误码 设置迁移限速 迁移任务组 API OMS提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，实现创建、查询、暂停、删除任务等操作
迁移网络模型 对象存储迁移服务（OMS）的网络模型设计考虑了数据的传输效率、安全性和可靠性。OMS支持大文件分片、大量数据的快速迁移。同时，它还支持断点续传功能，即使在迁移过程中遇到网络中断等异常情况，也能从断点处继续传输，确保数据的完整性和迁移的连续性。 图1 网络模型图 场景一
跨区域迁移时，迁移速率慢且失败对象较多，如何处理？ 问题描述 使用OMS服务进行跨区域迁移，例如：从中国-香港区域（非中国大陆区域）迁移至华北-北京四区域（中国大陆区域），网络速率较慢，出现严重的网络丢包问题，从而导致失败对象数较多。 解决方案 方法一：请尝试多次重试迁移任务，如仍然无法解决
创建任务 功能介绍 调用该接口添加迁移任务。创建任务成功后，任务会被自动启动，不需要额外调用启动任务命令。 注意事项： 单个租户在过去24小时内最多可创建200个迁移任务。 单个租户名下处于“等待中”状态的迁移任务达到50个时不可再创建任务。 URI POST /v1/{project_id
恢复指定id的迁移任务组 功能介绍 当迁移任务组处于暂停状态时，调用该接口启动指定id的迁移任务组。 调用方法 请参见如何调用API。 URI PUT /v2/{project_id}/taskgroups/{group_id}/start 表1 路径参数 参数 是否必选 参数类型
自动检查并重启失败的迁移任务 方案概述 通过API调用启动迁移任务/迁移任务组后，由于网络波动或其他原因导致迁移任务失败，需要重新启动迁移任务/迁移任务组，可以通过以下方式重新启动： 手动调用API重新启动迁移任务/迁移任务组。 在业务代码中自动检测并调用API重新启动迁移任务/迁移任务组
历史错误码 调用接口出错后，调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP 请求返回一个 4xx 或 5xx 的 HTTP 状态码。返回的消息体中包含具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题
对已经失败的指定id迁移任务组进行重启 功能介绍 当迁移任务组处于迁移失败状态时，调用该接口重启指定id的迁移任务组。 调用方法 请参见如何调用API。 URI PUT /v2/{project_id}/taskgroups/{group_id}/retry 表1 路径参数 参数
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 200 TRF.0001 System error. Click Restart to restart the migration task.
监控同步任务状态 操作场景 同步任务开始后，您可以随时查看同步的进度以及详情，以确定同步迁移的执行状态是否正常。 操作步骤 登录管理控制台，进入“对象存储迁移服务”页面。 在左侧导航树，选择“同步任务”。 单击任务ID记录左侧的，查看同步任务执行情况。如图1所示。具体的参数说明参见表
创建同步事件 功能介绍 源端有对象需要进行同步时，调用该接口创建一个同步事件，系统将根据同步事件中包含的对象名称进行同步(目前只支持华北-北京四、华东-上海一地区)。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/sync-tasks/{sync_task_id
最佳实践汇总 本文汇总了基于对象存储迁移服务（Object Storage Migration Service，OMS）常见应用场景的操作实践，每个实践我们提供详细的方案描述和操作指导，用于指导您快速实现对象存储数据迁移。 表1 OMS最佳实践一览表 最佳实践 使用场景 优势 使用
删除指定id的迁移任务组 功能介绍 删除指定的迁移任务组. 创建任务中、监控中、暂停中状态的任务不允许删除，如果删除会返回失败；若要删除，请先行暂停任务。 调用方法 请参见如何调用API。 URI DELETE /v2/{project_id}/taskgroups/{group_id
查询指定API版本信息 功能介绍 查询对象存储迁移服务指定API版本信息。 调用方法 请参见如何调用API。 URI GET /{version} 表1 路径参数 参数 是否必选 参数类型 描述 version 是 String 版本信息。 最小长度：1 最大长度：10 请求参数
批量更新任务 功能介绍 批量更新迁移任务，可指定单个迁移任务组下所有的迁移任务或通过迁移任务ID来执行。 调用方法 请参见如何调用API。 URI POST /v2/{project_id}/tasks/batch-update 表1 路径参数 参数 是否必选 参数类型 描述 project_id
删除同步任务 功能介绍 调用该接口删除同步任务。 正在同步的任务不允许删除，如果删除会返回失败；若要删除，请先行暂停任务。 调用方法 请参见如何调用API。 URI DELETE /v2/{project_id}/sync-tasks/{sync_task_id} 表1 路径参数
示例2：启动迁移任务 场景描述 本章节指导用户通过API启动迁移任务。API的调用方法请参见如何调用API。 启动迁移任务前需要获取Token，启动迁移任务后，需要查询任务状态详情，失败或暂停中的任务才能被启动。 涉及接口 获取IAM用户Token（使用密码）：用于鉴权认证。 启动迁移任务
迁移是否会影响目的端桶的已有数据 对象存储迁移对目的端桶已有数据的影响，主要看目的端桶与源端桶是否有同名对象。 不存在同名对象，OMS迁移服务对目的桶已有数据无影响。 迁移过程中，不会修改目的端桶的已有数据。 迁移完成后，不会删除目的端桶的已有数据。 存在同名对象，会根据创建任务/
示例3：暂停并删除迁移任务 场景描述 本章节指导用户通过API暂停并删除迁移任务。API的调用方法请参见如何调用API。 删除迁移任务前，需要获取Token并暂停迁移任务，暂停迁移任务后，需查询任务状态详情，当迁移任务暂停后，才能删除迁移任务。 涉及接口 获取IAM用户Token（
管理迁移任务组 创建迁移任务组后，您可以对迁移任务执行暂停/恢复、重启等操作。 操作步骤 登录管理控制台，进入“对象存储迁移服务”页面。 在左侧导航树，选择“迁移任务组”。 右侧切换到“迁移任务组”页面。 对目标迁移任务组进行操作。 表1 管理迁移任务组 项目 场景 操作 暂停迁移任务组
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
