URL 列表迁移说明--veImageX-火山引擎

文档中心

导航

URL 列表迁移说明

最近更新时间：2024.06.13 11:52:44首次发布时间：2024.05.17 15:46:31

本文为您介绍使用 URL 列表迁移文件的注意事项、填写规则和参数说明。

注意事项

单个.txt 迁移文件大小不超过 500MB。
在迁移过程对图片配置转码（仅 API 支持）处理：
- 若源文件解码失败：不执行转码，继续迁移源文件。
- 若源文件解码成功，编码为目标格式时失败：该文件迁移失败。
若同一个 URL 指定 dstKey 和 transcodeKey 为不同值，此时建议配置迁移回调（仅 API 支持），获取迁移后的文件 URI 确认实际的文件 Key。

填写规则

请在 .txt 迁移文本文件中填写url;dstKey;size;etag;transcodeKey;callbackArgs，每行一个。您可下载 Migrate_URL .txt 参考示例，填写迁移内容。

Migrate_URL .txt

24.00Bytes

示例：

同时指定 url 和 size 时：http://test.com/demo.png;;89219
同时指定 url 、dstKey 和 size 时：http://test.com/demo.png;Migrate/test.png;89219
同时指定 url 、dstKey、size 和 transcodeKey 时：http://test.com/demo.png;Migrate/test.png;89219;;Migrate/test.heic

参数说明

字段	是否必填	示例值	说明
url	是	`http://test.com/demo.png`	待迁移文件的公网访问 URL。
dstKey	否	`Migrate/test.png`	迁移后的文件 key，默认为`url`的 path 值。填写规则如下：使用 UTF-8 编码。长度必须在 1～1024 个字符之间。不能以反斜线（\）开头。不支持 `\a`、`\b`、`\t`、`\n`、`\v`、`\f`、`\r` 字符。
size	否	`89219`	迁移文件大小，单位为字节。说明强烈建议您填写迁移文件大小，以提升整体迁移效率。
etag	否	`test`	迁移文件 ETag，用于打点记录。
transcodeKey	否	`Migrate/test.heic`	迁移后已转码的文件 key，默认为 `dstKey` 的值。填写规则请参考`dstKey`。说明如果指定了`transcodeKey`，则转码完成的迁移文件 key 为指定 `transcodeKey` 值；对于不需要转码的文件，迁移后文件 key 仍为 `dstKey` 值。
callbackArgs	否	`resource`	自定义回调参数，最多可输入 1024 个任意类型字符。当 URL 列表文件迁移任务执行完成后，将在回调的 `SuccessEntries.CallbackArgs` 中返回。