You need to enable JavaScript to run this app.
文档中心
存储迁移服务

存储迁移服务

复制全文
下载 pdf
openapi
CreateTask - 创建任务
复制全文
下载 pdf
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​
任务类型,取值说明如下:​
  • HalfManaged:半托管类型。​
  • Source:源端地址。​
  • Destination:目标端地址。​
​
SourceId string 必选 示例值:1*​
源端地址 ID。​
​
DestinationId string 必选 示例值:1*​
目标端地址 ID。​
​
TaskConfig object 可选 示例值:-​
任务配置。​
StorageClassDirective string 可选 示例值:Standard​
迁移的对象在目标端的存储类型,取值说明如下:​
  • Standard:标准存储。​
  • InheritSource:继承源端存储类型。​
  • Ia:低频存储。​
  • ArchiveFr:归档闪回存储。​
  • IntelligentTiering:智能分层存储。​
  • ColdArchive:冷归档存储。​
  • Archive:归档存储。​
  • DeepColdArchive:深度冷归档。​
​
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​
软链接文件迁移策略,取值说明如下:​
  • skip:不迁移软链接文件。​
  • follow:将软链接文件以独立文件的形式迁移到对象存储 TOS。​
​
OverwritePolicy string 可选 示例值:Force​
迁移任务覆盖策略,取值说明如下:​
  • Force:针对同名文件,不做任何判断,直接用源端覆盖目的端。​
  • None:针对同名文件,不做任何判断,直接跳过。​
  • LastModify:当源端和目标端出现同名文件时,根据文件的 lastmodify 字段(最后修改时间)判断是否​
​
​
AgentGroupId string 可选 示例值:1*​
代理组 ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
Id string 示例值:1*​
任务 ID。​
​
AccountId string 示例值:210000****​
账号 ID。​
​
​
​
请求示例​
​
POST /?Action=CreateTask&Version=2025-01-01 HTTP/1.1​
Host: dms.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20251009T074859Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251009/cn-beijing/dms/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"TaskName": "task-name",​
"TaskType": "HalfManaged",​
"SourceId": "1*",​
"DestinationId": "1*"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202510091549310210911791743E9B84",​
"Action": "CreateTask",​
"Version": "2025-01-01",​
"Service": "dms",​
"Region": "cn-beijing"​
},​
"Result": {​
"Id": "1*",​
"AccountId": "210000****"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
2002-00000012​
InvalidRequestBody​
参数错误。​
500​
2001-00000001​
ServiceInternalErr​
服务端异常,请稍后重试。​
​
​
最近更新时间:2026.01.27 18:52:33
这个页面对您有帮助吗?
有用
有用
无用
无用