You need to enable JavaScript to run this app.
导航
URL 列表迁移说明
最近更新时间:2024.06.13 11:52:44首次发布时间:2024.05.17 15:46:31

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

注意事项

  • 单个.txt 迁移文件大小不超过 500MB。

  • 在迁移过程对图片配置转码(仅 API 支持)处理:

    • 若源文件解码失败:不执行转码,继续迁移源文件。

    • 若源文件解码成功,编码为目标格式时失败:该文件迁移失败。

  • 若同一个 URL 指定 dstKeytranscodeKey 为不同值,此时建议配置迁移回调(仅 API 支持),获取迁移后的文件 URI 确认实际的文件 Key。

填写规则

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

Migrate_URL .txt
24.00Bytes

示例:

  • 同时指定 urlsize 时:http://test.com/demo.png;;89219

  • 同时指定 urldstKeysize 时:http://test.com/demo.png;Migrate/test.png;89219

  • 同时指定 urldstKeysizetranscodeKey 时:http://test.com/demo.png;Migrate/test.png;89219;;Migrate/test.heic

参数说明

字段是否必填示例值说明
urlhttp://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

迁移文件大小,单位为字节。

说明

强烈建议您填写迁移文件大小,以提升整体迁移效率。

etagtest迁移文件 ETag,用于打点记录。

transcodeKey

Migrate/test.heic

迁移后已转码的文件 key,默认为 dstKey 的值。填写规则请参考dstKey

说明

如果指定了transcodeKey,则转码完成的迁移文件 key 为指定 transcodeKey 值;对于不需要转码的文件,迁移后文件 key 仍为 dstKey 值。

callbackArgsresource自定义回调参数,最多可输入 1024 个任意类型字符。当 URL 列表文件迁移任务执行完成后,将在回调的 SuccessEntries.CallbackArgs 中返回。