数据迁移--veImageX-火山引擎

文档中心

veImageX

数据迁移

veImageX 支持创建云端数据迁移任务以及拥有公网访问 URL 本地数据迁移任务，实现将数据从国内外其他云服务商的对象存储中在线，自动化拉取到 veImageX 的服务中。源对象存储可能会产生流量费用，具体费用需要参考源对象存储云厂商的定价。
已支持数据源
阿里云OSS、腾讯云COS、七牛云KODO、百度云BOS、华为云OBS、优刻得（Ucloud File)、AWS国际站、URL 列表、其他支持 S3 协议的存储服务

说明

对于您的本地数据，您可以选择以下几个迁移方式进行迁移：

对于可公网访问的大批量 URL 列表文件，您可以使用 URL列表进行批量离线迁移至 veImageX。
对于可公网访问的单资源 URL 文件，您可以通过调用 FetchImageUrl实时迁移至 veImageX。
如果您的数据在本地 IDC 或者在本地磁盘中，同时通过本地服务器挂载云存储的资源迁移 veImageX 存储，建议使用本地迁移与上传工具进行数据迁移。

前提条件

已开通 veImgaeX 服务，如未开通请参考服务管理。

迁移准备

具体各迁移源的迁移准备操作请见下表。

迁移源	文档地址
阿里云OSS	迁移准备
腾讯云COS	迁移准备
七牛云Kodo	迁移准备
百度云BOS	迁移准备
华为云OBS	迁移准备
优刻得（Ucloud File）	迁移准备
AWS国际站	迁移准备
URL 列表迁移	URL列表迁移说明

说明

对于迁移源为其他 S3 协议存储类型时，请您按源站使用说明准备好新建数据迁移任务所需要的 AK/SK 等迁移源信息。

操作步骤

登录 veImgaeX 控制台，进入左侧导航栏的工具箱页面。
在数据迁移卡片下单击去查看，进入数据迁移页面。
选择迁移目标服务所在地区，目前支持国内、亚太东南（柔佛）。
说明
新加坡区域已停止服务，您目前只能查询该区域的任务详情。如果您在选择新加坡区域后新建或复制迁移任务，系统将自动为您切换到亚太东南（柔佛）区域。
单击新建迁移任务按钮，并在新建任务页面，根据以下内容完成迁移参数配置。

Step 1：设置迁移任务名称

设置迁移任务名称，字符长度可为 1 至 60 个字符，允许的字符为中文、英文、0-9、_、-。此处设置的名称，可用于在任务列表中查看迁移状态和迁移进度。

Step 2：设置迁移源信息

支持以下迁移数据来源，您可根据实际业务进行迁移源信息配置。

阿里云OSS

腾讯云COS

七牛云KODO

百度云BOS

华为云OBS

Ucloud File

AWS国际站

其他S3协议存储

URL 列表

请您根据提示信息，配置源站为阿里云 OSS 的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择阿里云OSS。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置源站为腾讯云 OSS 的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择腾讯云OSS。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	必填。请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置源站为七牛云 KODO 的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择七牛云KODO。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置源站为百度云 BOS 的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择百度云BOS。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	必填。请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置源站为华为云 OBS 的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择华为云OBS。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	必填。请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置源站为优刻得（Ucloud File）的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择 Ucloud File。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	必填。请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置源站为 AWS 国际站的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择AWS国际站。
AccessKey	必填。访问密钥，AccessKey 的获取方法请参考迁移准备。
SecretKey	必填。私钥，SecretKey 的获取方法请参考迁移准备。
Bucket 所在区域 ID	请参照各云厂商的获取文档。
源端 Bucket	必填。数据源 Bucket，源端 Bucket 的获取方法请参考迁移准备。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置其他S3协议存储类型的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择其他S3协议存储。
AccessKey	必填。访问密钥，请根据源站信息填写。
SecretKey	必填。私钥，请根据源站信息填写。
Endpoint	必填，请根据源站信息填写。
Bucket 所在区域 ID	必填，请根据源站信息填写。
源端 Bucket	必填。数据源 Bucket，请根据源站信息填写。
Header 迁移方式	支持配置：丢弃全部源 Header、保留全部源 Header 注意：调用 veImageX 图片服务时，源 Header 暂时不会生效。
文件迁移方式	支持配置：全量迁移、只迁移匹配前缀文件、只迁移匹配正则表达式的文件
时间范围	开启后表示只迁移指定时间范围内新增或变更的文件。

请您根据提示信息，配置 URL 列表类型的迁移源信息。具体配置项说明请见下表：

配置	说明
文件来源	必选。选择 URL 列表。如何配置请参考 URL 列表迁移说明。
上传 URL 文件列表	包含待迁移的文件访问链接 URL 的文本文件，每一行是一个要迁移的文件 URL。若您配置了上传 Content-Type 限制，则该文件的格式需在服务的 Content-Type 白名单内，否则，无法成功上传。
提供 URL 列表文件下载地址	对于较大 URL 列表文件支持保存至可公网访问的服务器，并提供该文件的 URL 访问地址。

Step 3：设置迁移目标信息

请参考下表进行迁移目标信息配置，配置完成后请勾选提交前须知并单击确认提交，完成迁移任务的创建。

配置	说明
选择服务	当前账号下的服务
保存路径	支持以下配置：保存到根目录：即为您保留源端文件目录结构，整体保存到 veImageX 提供的存储路径的根目录下。保存到指定目录：如果是多重目录请使用斜线分割，例如`aaa/bbb/ccc`。
同名文件覆盖规则说明同名文件指在对象存储中访问 Key 相同的文件。	支持以下配置：直接覆盖加后缀区分（同名文件自动加文件名后缀，后缀为任务 ID）跳过（不迁移源 Bucket 中与所选服务中的文件同名的文件）
源 Bucket 名保留规则	支持以下配置：保留：即迁移后资源访问 URI 中，会保留迁移源的 Bucket 名称。不保留：即迁移后资源访问 URI 中，不会保留迁移源的 Bucket 名称。说明使用 URL 列表的迁移任务无需进行该配置。

其他操作

管理迁移任务

登录 veImgaeX 控制台，在常用工具下点击数据迁移。
在数据迁移页面，您可查看迁移任务的任务名称、文件来源和迁移进度。

单击详情，您可以查看迁移源信息和迁移目标信息。
- 迁移源信息：文件来源、源端 Bucket、Header 迁移方式、文件迁移方式和时间范围。
- 迁移目标信息：目标服务、保存路径、同名文件覆盖规则。
单击复制任务，您可以按照当前任务配置创建新的迁移任务。
单击结束，您可以终止当前迁移进度。
单击重启失败任务，您可以对失败文件重新开始迁移操作。
单击导出失败任务，您可以在 txt 文件内查看迁移失败文件的信息以及失败原因。

预估文件迁移时间

您可以参考预估文件迁移时间从而获取您创建的迁移任务在顺利情况下完成迁移的大概时间。

OpenAPI

您可调用 CreateImageMigrateTask 来创建新的数据迁移任务；
您可调用 GetImageMigrateTasks 来获取迁移任务详情；
您可调用 ExportFailedMigrateTask 来导出迁移失败任务列表；
您可调用 UpdateImageTaskStrategy 来更新迁移任务策略；
您可调用 GetVendorBuckets 来获取服务商 Bucket；
您可调用 TerminateImageMigrateTask 来结束迁移任务；
您可调用 DeleteImageMigrateTask 来删除迁移任务；
您可调用 RerunImageMigrateTask 来重启迁移失败任务。

最近更新时间：2025.12.17 10:51:45

这个页面对您有帮助吗？

有用

无用

veImageX

前提条件 #

迁移准备 #

操作步骤 #

Step 1：设置迁移任务名称 #

Step 2：设置迁移源信息 #

Step 3：设置迁移目标信息 #

其他操作 #

管理迁移任务 #

预估文件迁移时间 #

OpenAPI #