You need to enable JavaScript to run this app.
文档中心
文件存储 vePFS

文件存储 vePFS

复制全文
下载 pdf
数据流动
CreateDataFlowTask - 创建数据流动任务
复制全文
下载 pdf
CreateDataFlowTask - 创建数据流动任务
调用 CreateDataFlowTask 接口,创建数据流动任务。​
使用说明​
数据流动功能的删除型任务目前处于邀测状态,无法通过此 API 创建。更多信息,请参见数据流动概述。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:CreateDataFlowTask​
要执行的操作,取值:CreateDataFlowTask。​
​
Version string 必选 示例值:2022-01-01​
API的版本,取值:2022-01-01。​
​
TaskAction string 必选 示例值:Import​
任务类型,取值说明如下:​
  • Import:预热任务。​
  • Export:沉降任务。​
  • Inventory:对账任务。​
​
DataType string 必选 示例值:MetaAndData​
任务操作的数据类型,取值说明如下:​
MetaAndData:元数据和数据。​
​
FilesetId string 可选 示例值:fset-0a3e****​
Fileset ID。​
​
SubPath string 可选 示例值:/subpath****/​
Fileset 下的子路径(未指定 Fileset ID 时,表示文件系统全路径)。​
​
SameNameFilePolicy string 可选 示例值:KeepLatest​
同名文件策略,取值说明如下:​
  • Skip:跳过同名文件。​
  • KeepLatest:保持最新文件。​
  • OverWrite:覆盖同名文件。​
​
ExportSymlinkPolicy string 可选 示例值:Skip​
导出任务软链接处理策略,取值说明如下:​
  • Skip:跳过软链接文件。​
  • NormalFile:导出为独立文件。​
​
DataStorage string 可选 示例值:bucketname​
源端存储(TOS 存储桶)名称。​
​
DataStoragePath string 可选 示例值:/bigfiletest****/​
Bucket 路径前缀。​
​
EntryListFileInfo object 可选 示例值:{ "FileKey": "path1/file_list.txt", "FileName": "file_list.txt", "FileBucket": "user-bucket-****" }​
任务执行的列表文件信息。​
FileName string 可选 示例值:file_list.txt​
任务执行的列表文件名称,在使用本地列表文件或用户 TOS 桶中的列表文件进行预热、沉降时均需要指定。​
​
FileKey string 可选 示例值:path1/file_list.txt​
任务执行的列表文件标识。​
  • 使用本地列表文件进行预热、沉降时,需要先通过 CreatePreSignedUrl 接口生成临时文件上传链接,CreatePreSignedUrl 接口会返回该值,示例值:210037****/2025-05-21/e88f40fd-5290-409c-9e7d-16e8d36a**** 。​
  • 使用用户 TOS 桶中的列表文件进行预热、沉降时,需要指定为列表文件对应的对象路径,示例值:path1/file_list.txt。​
​
FileBucket string 可选 示例值:user-bucket-****​
任务执行的列表文件所在的桶,在使用用户 TOS 桶中的列表文件预热、沉降时需要指定。​
​
​
FileSystemId string 必选 示例值:vepfs-cnbj4c83fc4a****​
文件系统 ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
DataFlowTaskId string 示例值:task-cnbj025700c1****​
数据流动任务 ID。​
​
​
​
请求示例​
​
POST /?Action=CreateDataFlowTask&Version=2022-01-01 HTTP/1.1​
Host: vepfs.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260114T080118Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260114/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"TaskAction": "Import",​
"DataType": "MetaAndData",​
"FilesetId": "fset-0a3e****",​
"SubPath": "/subpath****/",​
"SameNameFilePolicy": "KeepLatest",​
"ExportSymlinkPolicy": "Skip",​
"DataStorage": "bucketname",​
"DataStoragePath": "/bigfiletest****/",​
"EntryListFileInfo": {​
"FileKey": "path1/file_list.txt",​
"FileName": "file_list.txt",​
"FileBucket": "user-bucket-****"​
},​
"FileSystemId": "vepfs-cnbj4c83fc4a****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260114160127089167237099DE****",​
"Action": "CreateDataFlowTask",​
"Version": "2022-01-01",​
"Service": "vepfs",​
"Region": "cn-beijing"​
},​
"Result": {​
"DataFlowTaskId": "task-cnbj025700c1****"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
500​
InternalError​
Service has some internal Error. Pls Contact With Admin.​
内部错误。​
​
​
最近更新时间:2026.03.06 10:28:57
这个页面对您有帮助吗?
有用
有用
无用
无用