- 文档首页
存储迁移服务
API 参考
DMS 2.0 API
openapi
CreateTask - 创建任务
CreateTask - 创建任务
调用 CreateTask 接口创建任务。
调试
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
请求参数
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。 Action string 必选 示例值:CreateTask
要执行的操作,取值:CreateTask。
Version string 必选 示例值:2025-01-01
API的版本,取值:2025-01-01。
TaskName string 必选 示例值:task-name
任务名字。
TaskType string 必选 示例值:HalfManaged
任务类型,取值说明如下:
SourceId string 必选 示例值:1*
源端地址 ID。
DestinationId string 必选 示例值:1*
目标端地址 ID。
TaskConfig object 可选 示例值:-
任务配置。
StorageClassDirective string 可选 示例值:Standard
迁移的对象在目标端的存储类型,取值说明如下:
- IntelligentTiering:智能分层存储。
ListConfig object 可选 示例值:-
任务列举参数配置。
ListIncludePrefixes string[] 可选 示例值:[prefix1,prefix2]
需要迁移的前缀列表,多个前缀用英文逗号(,)隔开。
ListIncludeBeginTime string 可选 示例值:1766974902040
开始时间,任务会迁移修改时间大于该时间的对象,毫秒时间戳。
ListIncludeEndTime string 可选 示例值:1766974902040
结束时间,任务会迁移修改时间早于该时间的对象,毫秒时间戳。
GenerateReport boolean 必选 示例值:true
是否生成报告。
ListIncludeBucketKeys object 可选 示例值:-
清单配置信息。
Bucket string 必选 示例值:test
存储桶名称。
Ak string 必选 示例值:AKLTM2NlN2E5Yzg2ZDhkNDBjMGIzZGU3MDllMzE4NzU****
用于访问对象存储的 AccessKey ID。
Sk string 必选 示例值:T1RkbVpHTmlNakl3TWpobE5EVmlObUkzTURrMU16STNZakF4TW****
用于访问对象存储的 AccessKey Secret。
Keys string[] 必选 示例值:[objectname1,objectname2]
清单文件对象名列表,多个对象名用英文逗号(,)隔开。
SymlinkPolicy string 可选 示例值:follow
软链接文件迁移策略,取值说明如下:
- follow:将软链接文件以独立文件的形式迁移到对象存储 TOS。
OverwritePolicy string 可选 示例值:Force
迁移任务覆盖策略,取值说明如下:
- Force:针对同名文件,不做任何判断,直接用源端覆盖目的端。
- None:针对同名文件,不做任何判断,直接跳过。
- LastModify:当源端和目标端出现同名文件时,根据文件的 lastmodify 字段(最后修改时间)判断是否
AgentGroupId string 可选 示例值:1*
代理组 ID。
返回参数
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。 AccountId string 示例值:210000****
账号 ID。
请求示例
返回示例
错误码
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
最近更新时间:2026.01.27 18:52:33