存储迁移服务
存储迁移服务
存储迁移服务
文档指南
请输入
产品计费
用户指南
API 参考
DMS 1.0 API
DMS 2.0 API
openapi
SDK 参考
DMS 1.0 SDK
错误码
1002-执行错误
1004-目标端错误
1005-专线错误
相关协议
- 文档首页
存储迁移服务用户指南DMS 1.0 迁移指南创建迁移任务-使用公共网络
复制全文
下载 pdf创建迁移任务-使用公共网络
文档反馈
问问助手本文介绍如何在存储迁移服务控制台使用公共网络创建迁移任务。
背景信息
存储迁移服务支持以下源端云服务商或数据源类型：
- 阿里云
- 腾讯云
- 华为云
- 七牛云
- 金山云
- 谷歌云
- 其他 S3 协议对象存储
- 对象存储-火山引擎
注意
存储迁移服务只支持在相同地域的火山引擎存储桶之间迁移数据。
迁移文件时，默认支持迁移文件的 HTTP 标准属性，具体包括 Content-Type、Content-Disposition、Content-Encoding、Content-Language、Cache-Control 和 Expires。
前提条件
- 已获取数据源端相关信息，例如访问 AccessKey ID 及Secret AccessKey、Endpoint、桶名称等。
- 已在对象存储创建存储桶，具体步骤，请参见创建存储桶。
注意事项
如果源端桶开启了多版本功能，使用 DMS 迁移对象时，只会迁移源端桶中最新版本对象到目标桶，不会迁移历史版本对象。
操作步骤
- 登录存储迁移服务控制台。
- 在迁移任务列表页面，单击创建迁移任务。
- 在选择网络页面，配置以下参数。
- 参数说明任务名称指定该迁移任务的名称，命名规则如下：
- 3~32 个字符之间。
- 只能包含小写字母、数字、中划线（-）。
- 名称不能以中划线（-）开头或结尾。
网络类型选择公共网络。
- 单击下一步：设置源端及目的端，配置如下源端及目的端参数。
- 源端类型为对象存储
-
- 参数说明源端类型数据源端的类型，本场景下选择对象存储。数据源选择具体的数据源：
- 阿里云：将阿里云上的数据迁移至火山引擎对象存储 TOS。
- 腾讯云：将腾讯云上的数据迁移至火山引擎对象存储 TOS。
- 华为云：将华为云上的数据迁移至火山引擎对象存储 TOS。
- 七牛云：将七牛云上的数据迁移至火山引擎对象存储 TOS。
- 金山云：将金山云上的数据迁移至火山引擎对象存储 TOS。
- 谷歌云：将谷歌云上的数据迁移至火山引擎对象存储 TOS。
- 其他 S3 协议存储：兼容 S3 协议，并支持 AWS Signature V4 鉴权的对象存储均可使用。
- 对象存储-火山引擎：将火山引擎对象存储的数据迁移至相同地域的火山引擎对象存储 TOS。
*注意Access Key ID用于访问源端对象存储的 AccessKey ID。Access Key Secret用于访问源端对象存储的 AccessKey Secret。源端桶选择方式设置选择源端桶的方式，说明如下：- 获取可选源端桶并选择：经过您的授权，DMS 直接读取源端存储桶列表。您无需填写信息，单击刷新加载源端桶列表后，即可在源端桶名的列表中选择存储桶。
- 输入源端桶名称：手动输入源端桶名、源端 Region、Endpoint信息。
源端桶名指定要迁移的源端对象存储桶名称。说明您需要确保当前账号拥有源端存储桶的 HeadBucket、ListObjects 、HeadObject 和 GetObject 权限，否则会导致迁移结果不符合预期。源端 Region指定源端对象存储所在的 Region。Endpoint指定源端对象存储的访问域名，地址前需要输入 http:// 或 https://。注意- 仅支持源端对象存储默认分配的访问域名，不支持自定义域名、AP 域名等其他域名。
- 请勿携带存储桶名称，否则会导致源端连接失败。
指定迁移范围包含说明包含和排除功能互斥。开启指定迁移范围后，可以指定对象迁移的范围，支持通过指定对象或对象前缀来指定迁移范围。说明使用上传文件或下载地址的方式指定对象或对象前缀时，列表文件中的换行符必须是 \n。- 前缀
- 支持以下三种方式指定对象前缀，说明如下：
- 指定前缀：输入对象的前缀，单击添加字段，可以设置多个前缀，最多支持设置 10 个对象前缀。例如迁移源端桶中 user/data 目录下的所有对象，则需要设置对象前缀为 user/data/，迁移源端桶中前缀为 event 的所有文件，则需要设置对象前缀为 event。
- 上传文件：如果您需要迁移的对象较多，您可以将对象前缀记录在文件中，然后将该列表文件上传至控制台，列表文件约束限制如下：
- 上传的列表文件必须为 txt 格式。
- 列表文件中每一行是一个对象前缀，多个对象前缀请换行输入。
- 上传的列表文件大小不能超过 100MB。
- 列表文件中前缀数量不能超过 10 万条。
- 列表文件中的对象前缀需要符合 UTF-8 编码规则。
- 下载地址：将对象前缀记录在列表文件中，然后填写带签名的且签名处于有效期内的对象前缀列表文件的公网访问地址。如果您的对象前缀列表文件较大，不适合使用浏览器上传，您可以将列表文件保存到对象存储，填写列表文件在对象存储的公网访问地址。列表文件约束限制如下：
- 列表文件必须为 txt 格式。
- 列表文件中每一行是一个对象前缀，多个对象前缀请换行输入。
- 列表文件大小不能超过 100MB。
- 列表文件中前缀数量不能超过 10 万条。
- 列表文件中的对象前缀需要符合 UTF-8 编码规则。
注意指定对象前缀时，对象前缀不支持包含空格。- 对象
- 支持以下三种方式指定对象，说明如下：
- 手动输入：输入完整路径的对象名称，不包含桶名，每一行只能包含一个对象名称，多个对象请换行输入，最多支持输入 1000 个对象。例如A桶下的 user/data/flower.png，则需要填写为 user/data/flower.png。
- 上传文件：如果您需要迁移的对象较多，您可以将对象的名称记录在文件中，然后将该列表文件上传至控制台，列表文件约束限制如下：
- 上传的列表文件必须为 txt 格式。
- 列表文件中每一行是一个对象名称，多个对象请换行输入。
- 上传的列表文件大小不能超过 1GB。
- 列表文件中的对象名称需要符合 UTF-8 编码规则。
- 下载地址：将对象的名称记录在列表文件中，然后填写带签名的且签名处于有效期内的对象列表文件的公网访问地址。如果您的对象列表文件较大，不适合使用浏览器上传，您可以将列表文件保存到对象存储，填写列表文件在对象存储的公网访问地址。列表文件约束限制如下：
- 列表文件必须为 txt 格式。
- 列表文件中每一行是一个对象名称，多个对象请换行输入。
- 列表文件大小不能超过 1GB。
- 列表文件中的对象名称需要符合 UTF-8 编码规则。
说明- 指定对象名时，对象名不支持包含空格。
- 如果您想重命名文件，可通过对象名称 + 空格 + 对象新名称的方式。例如您可以通过 a.jpg b.jpg，将 a.jpg文件重命名为 b.jpg。
排除开启指定迁移范围后，可以排除指定的对象，只迁移排除后剩余的对象。当前仅支持通过对象前缀来指定排除的对象，支持以下三种方式指定对象前缀，说明如下：- 指定前缀：输入对象的前缀，单击添加字段，可以设置多个前缀，最多支持设置 10 个对象前缀。例如排除源端桶中 user/data 目录下的所有对象，则需要设置对象前缀为 user/data/，排除源端桶中前缀为 event 的所有对象，则需要设置对象前缀为 event。
- 上传文件：如果您需要排除的对象较多，您可以将排除的对象前缀记录在文件中，然后将该列表文件上传至控制台，列表文件约束限制如下：
- 上传的列表文件必须为 txt 格式。
- 列表文件中每一行是一个对象前缀，多个对象前缀请换行输入。
- 上传的列表文件大小不能超过 5MB。
- 列表文件中前缀数量不能超过 5000 条。
- 列表文件中的对象前缀需要符合 UTF-8 编码规则。
- 下载地址：将排除的对象前缀记录在列表文件中，然后填写带签名的且签名处于有效期内的对象前缀列表文件的公网访问地址。如果您的对象前缀列表文件较大，不适合使用浏览器上传，您可以将列表文件保存到对象存储，填写列表文件在对象存储的公网访问地址。列表文件约束限制如下：
- 列表文件必须为 txt 格式。
- 列表文件中每一行是一个对象前缀，多个对象前缀请换行输入。
- 列表文件大小不能超过 5MB。
- 列表文件中前缀数量不能超过 5000 条。
- 列表文件中的对象前缀需要符合 UTF-8 编码规则。
注意- 指定对象前缀时，对象前缀不支持包含空格。
- 使用上传文件或下载地址的方式指定对象前缀时，列表文件中的换行符必须是 \n。
- 源端类型为 URL列表
注意
- 当源端类型为 URL列表时，URL 列表文件中每个 URL 对应的文件大小不能超过 300G。
- 当源端类型为 URL列表时，URL 列表单行长度不能超过 65536 字符（64 KB）。
- 当前仅支持处理 UTF-8 编码的 URL 列表文件。
- 参数说明源端类型数据源端的类型，本场景下选择 URL列表。上传URL列表文件选择 URL 列表文件的上传方式：
- 手动输入：直接输入文件 URL，约束限制如下：
- 以 http:// 或 https:// 开头，且需要包含一个 URL。
- 每一行只能包含一个 URL，多个 URL 请换行输入，最多支持输入 1000 个 URL。
- 上传文件：如果您需要迁移的文件较多，您可以将 URL 记录在文件中，然后将该列表文件上传至控制台，列表文件约束限制如下：
- 上传的列表文件必须为 txt 格式。
- 列表文件中每一行是一个需要迁移的 URL，多个 URL 请换行输入。
- 上传的列表文件大小不能超过 1GB。
- 下载地址：如果您的 URL 列表文件较大，不适合使用浏览器上传，您可以将 URL 列表文件保存到对象存储，然后选择下载地址，填写列表文件在对象存储的 URL 访问地址。下载地址支持以下两种文件地址获取方式：
- 选择文件列表：设置源端数据授权模式，选择源端桶名和源端文件名，DMS 会读取对应存储桶列表和文件。
注意仅源端数据源为当前火山引擎账号下的对象存储存储桶，且源端存储桶所在地域和目的端存储桶所在地域保持一致时，才可以使用文件列表的方式迁移数据。- 填写访问地址：填写带签名的且签名处于有效期内的 URL 列表文件的公网访问地址。
*说明- 使用上传文件或下载地址的方式选择 URL 列表文件时， URL 列表文件中的换行符必须是 \n。
- 使用手动输入或上传文件迁移时，默认将 URL 路径（域名 / 后的部分）作为对象的名称。如果您想重命名文件，可通过 URL + 空格 + 对象文件名的方式。例如您可以通过 http://xxx.xxx.xxx/xxx/a.jpg b.jpg，将 a.jpg 文件重命名为 b.jpg。
- 目的端参数
-
- 参数说明目的端类型目的端类型，暂时只支持对象存储（火山引擎 TOS）。目的端写入模式选择目的端写入模式，参数说明如下：
- 经典模式：使用 AccessKey ID、AccessKey Secret 等信息迁移数据。
- 跨服务授权模式：使用跨服务授权模式迁移当前账号下的对象存储存储桶，可以不填写 AccessKey ID、AccessKey Secret 等详细信息。经过您的授权，数据迁移服务可直接读取存储桶列表、文件。
注意Access Key ID用于访问目的端对象存储的 AccessKey ID。Access Key Secret用于访问目的端对象存储的 AccessKey Secret。目的端桶名指定目的端对象存储的桶名称。注意- 如果源端数据源为对象存储-火山引擎，则目的端桶必须与源端桶处于相同地域。
- 您需要确保当前账号拥有目的桶的 HeadBucket、HeadObject、PutObject、ListObjects、CreateMultipartUpload、AbortMultipartUpload、CompleteMultipartUpload 和 UploadPart 权限，否则会导致迁移结果不符合预期。
- 单击下一步：设置任务参数，配置如下任务参数。
注意
- 单击下一步：设置任务参数，系统会自动校验源端连接信息，如果你设置的信息有误，会弹出权限预检提示对话框，提示您源端或目的端权限不足，继续创建任务有可能导致迁移结果不满足预期。
- 当源端类型为 URL列表时，仅支持在设置任务参数页面配置跳过归档对象、跳过失败对象、range-get迁移、覆盖策略、文件存储方式、流量控制和抽样校验参数。
-
- 参数说明迁移增量文件默认为关闭，开启后可自定义增量迁移参数，参数说明如下：
- 增量迁移间隔：在存量迁移（即首次迁移）完成之后，每隔多长时间启动一次增量迁移任务，单位为小时，仅支持 1~24 的整数。
- 增量迁移次数：在存量迁移（即首次迁移）完成之后，执行增量迁移的次数，仅支持 1~100 的整数。
跳过归档对象设置是否跳过归档对象，默认开启，说明如下：- 开启跳过归档对象：迁移数据时，不迁移延迟访问存储类型的文件。
- 关闭跳过归档对象：迁移数据时，迁移已解冻的延迟访问存储类型文件，不迁移未解冻的延迟访问存储类型文件。
说明各个数据源的延迟访问存储类型如下：- 阿里云：归档存储（Archive）、冷归档存储（ColdArchive）
- 腾讯云：归档存储（ARCHIVE）、深度归档存储（DEEP_ARCHIVE）
- 华为云：归档存储（COLD）、深度归档存储（DEEP_ARCHIVE）
- 七牛云：归档存储、深度归档存储
- 金山云：归档存储类型
- 其他 S3 协议存储：GLACIER、DEEP ARCHIVE。
- 对象存储-火山引擎：归档存储（ARCHIVE）、冷归档存储（COLD_ARCHIVE）
谷歌云的 Cloud Storage 没有延迟访问存储类型，如果您的数据源是谷歌云，无需设置跳过归档对象参数。跳过失败对象迁移源端对象时，如果没有源端对象的权限，则该对象会迁移失败。您可以设置是否跳过失败对象，默认开启，说明如下：- 开启跳过失败对象：迁移过程中无论迁移失败多少个对象，都不会暂停迁移任务。
- 关闭跳过失败对象：如果迁移过程中，出现连续迁移失败 20 个对象的情况，则会暂停任务并标记失败。
range-get迁移 设置是否开启 range-get迁移，默认关闭。开启 range-get迁移后，DMS将支持断点续传的方式迁移文件，即在网络波动等情况下导致文件传输中断后，重新传输文件，DMS 会在文件断点处开始传输，避免从头传输文件产生额外流量，从而节省成本。 注意- 仅源端类型为 URL列表时，才支持设置 rang-get迁移参数。
- 开启 rang-get迁移前，请确保源端支持 rang-get 迁移，否则 rang-get迁移功能不会生效。
文件重命名默认为关闭，开启后可设置文件重命名规则，文件重命名支持正则替换，您可以输入需要重命名的正则表达式规则以及需要替换的字符串。例如：- 添加前缀 prefix-path/：需要设置正则表达式为 ^，替换文本为 prefix-path/。
- 修改前缀 prefix-old/ 为 prefix-new/：需要设置正则表达式为 ^prefix-old/，替换文本为 prefix-new/。
- 删除前缀 prefix-old/：需要设置正则表达式为 ^prefix-old/，替换文本为空。
- 修改后缀 .txt 为 .csv：需要设置正则表达式为 .txt$，替换文本为 .csv。
- 修改文件名 abc.jpg 为 aaa.jpg：需要设置正则表达式为 abc，替换文本为 aaa。
带分隔符列举由于部分源端存储桶的配置（例如开启桶加速的场景），TOS 只能获取到源端存储桶一级目录的文件。带分隔符列举可以获取到多级目录下的文件，说明如下：- 开启带分隔符列举：TOS 可以获取到源端存储桶多级目录下的文件，保证了迁移到 TOS 的文件完整性。
- 关闭带分隔符列举：迁移文件的速度更快，但是在源端对象存储开启桶加速等场景下，有可能存在迁移到 TOS 的文件不全的问题。
*注意- 如果开启带分隔符列举功能，设置指定迁移范围为包含，并且通过前缀（包括指定前缀、上传文件和下载地址）的方式指定迁移范围，那么前缀必须要以斜线（/）结尾。
- 列举源端桶文件时，若源端桶未按照字典序返回文件，则可能导致列举结果不完整，或陷入无限循环，进而导致迁移任务无法正常完成。此时，建议您将源端桶挂载到本地，然后使用 DMS 2.0 半托管模式迁移文件，详细介绍，请参见DMS 2.0 快速入门。
覆盖策略可指定当源端和目的端出现同名文件时的覆盖策略，策略说明如下：- 全量覆盖：针对同名文件，不做任何判断，直接用源端覆盖目的端。
- 不覆盖：针对同名文件，不做任何判断，直接跳过。
- 根据最后修改时间覆盖：当源端和目标端出现同名文件时，根据文件的 lastmodify 字段（最后修改时间）判断是否进行覆盖，仅当源端文件的最后修改时间晚于目的端文件最后修改时间时执行覆盖。
忽略目标端回源当迁移任务的覆盖策略为不覆盖时，DMS 会在目标端检测待迁移的文件是否存在。若目标端存储桶开启了 HeadObject 请求回源，且源站存在待迁移文件，DMS 会判定该文件在目标桶中已存在，从而跳过迁移，导致最终迁移的文件数量缺失。开启忽略目标端回源后，DMS 会忽略目标端存储桶的回源规则，直接迁移文件。在迁移数据时采用不覆盖同名文件策略，且目标存储桶开启回源规则的场景下，建议开启忽略目标端回源功能。文件存储方式设置文件迁移至 TOS 的存储类型，支持选择全部使用标准存储、保持原存储属性、全部使用低频存储、全部使用归档闪回存储、全部使用智能分层存储、全部使用归档存储、全部使用冷归档存储、全部使用深度冷归档存储。关于 TOS 存储类型的详细介绍，请参见存储类型。以下为保持原存储属性和全部使用智能分层的参数说明：- 保持原存储属性：迁移至 TOS 时，按照 S3 与 TOS 对应关系设置文件的存储类型，更多信息，请参见 迁移数据时 S3 与 TOS 的对应关系 。
- 全部使用智能分层：迁移至 TOS 时，文件将保存至智能分层高频访问层。
说明- 深度冷归档目前在 TOS 处于邀测状态，如果您想将迁移至 TOS 的文件存储类型设置为深度冷归档，请联系客户经理开白。
- 如果迁移源属于延迟访问存储类型，请在迁移前将该类型的状态转换为即时访问，否则该迁移源会迁移失败。
- 如果目的端与源端文件的可用区属性不同，默认以目的端为准。
- 当源端类型为 URL 列表时，不支持保持原存储属性。
迁移文件起始时间按照文件最后一次修改时间来筛选需要迁移的文件，默认为迁移全部，参数说明如下：- 迁移全部：迁移源桶中所有的文件。
- 指定时间范围：筛选需要迁移的文件，支持三种指定方式，说明如下：
- 指定起始时间：仅指定开始日期，结束日期置空，表示仅迁移最后一次修改时间晚于该日期的文件。
- 指定结束时间：仅指定结束日期，开始日期置空，表示仅迁移最后一次修改时间早于该日期的文件。
- 指定时间范围：指定开始日期和结束日期，表示仅迁移最后一次修改时间处于该时间范围内的文件。
流量控制默认关闭，关闭时默认速率为 1000MB/s。打开速率开关，单击添加字段，可设置迁移任务的流控时段和最大速率，速率限制说明如下：- 最大速率默认为 100MB/s。
- 最大速率设置范围为 0MB/s~1000MB/s。
抽样校验默认关闭，开启抽样校验后，DMS 会从源端获取每个对象的 100 个字节，从目标端获取对应每个对象的 100 个字节，然后进行校验，确保源端和目标端的数据一致性。关于抽样校验的详细介绍，请参见数据一致性校验。注意使用抽样校验功能会在源端产生额外的公网流出流量，由源端对象存储收取对应费用。回调配置是否启用回调通知，默认关闭。开启时需配置以下信息：- 回调地址：接收回调的业务方地址，必须以 http:// 或 https:// 开头，生产环境建议使用 HTTPS。
- 订阅回调状态：订阅的任务终态，默认选择完成和失败。
- 自定义回调参数：业务自定义透传参数，以 key/value 形式随回调请求发送，用于携带业务标识、租户信息等便于接收端路由与幂等。
- 可单击添加字段/删除新增/移除参数条目。
- 单击下一步：确定任务信息，在该页面检查迁移任务的各项参数。
- 参数检查无误后，阅读并勾选存储产品和服务条款 ，单击提交。
注意
提交后，会弹出费用提醒对话框。存储迁移服务本身不收取任何费用，但是从公网迁移数据到火山引擎会产生公网流量费用，费用由源站的存储服务提供商收取。
- 在费用提醒对话框，单击已知晓，下一步。
- （可选）如果您选择了跨服务授权，您还需要在弹出的跨服务授权对话框，单击确定。
说明
任务创建完成后会自动启动，您可以在迁移任务列表中查看该任务的创建时间、任务状态，此外，还可以在迁移任务列表页面右上角单击自定义列表字段图标，选中存储量迁移进度和文件数量迁移进度，查看迁移进度。
最近更新时间：2026.08.17 15:49:12
这个页面对您有帮助吗？
有用
有用
无用
无用