创建数据流动任务

更新时间：2025-09-22

描述

创建一个数据流动，返回数据流动的ID

请求

请求结构

                Shell
                
            

                POST /?action=CreateL2BucketLink
x-bce-date: 2023-06-09T10:08:22Z
host: pfs.xx.baidubce.com  ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
content-type: application/json
Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
version:v2
{
    "instanceId": "pfs-Lnf5fM",
    "conflictPolicy": 1,
    "bucketName": "wyl-test-pfs",
    "bucketPrefix": "",
    "throughputLimitBytes": 629145600,
    "reportObjectName": ".baidu_l2_bucketlink_dflow/",
    "bucketLinkName": "test",
    "transferType": 1,
    "pfsPath": "/pfs/test1"
}
            

请求头域

除公共头域外，无其他特殊头域

请求参数

参数名称	类型	是否必需	参数位置	描述
action	string	是	URL Query	本接口中固定为 CreateL2BucketLink
version	string	是	request header	API版本号，固定为v2
instanceId	string	是	request body	PFS实例ID
conflictPolicy	string	是	request body	冲突策略 1 覆盖策略 2 跳过策略 3 保留两者
bucketName	int	是	request body	任务流动的BOS bucket name，最长长度64
bucketPrefix	string	是	request body	任务流动的BOS bucket prefix，要求：非"/"开始以"/"结尾最长长度1000 路径不支持"." ".."
throughputLimitBytes	string	是	request body	任务流动限流，单位byte，当前只支持3个档位，分别是600MB, 1200MB, 1500MB，即： 629145600 1258291200 1572864000
reportObjectName	List	否	request body	任务流动报告保存的object名字最长长度978 路径不支持"." ".."
bucketLinkName	string	是	request body	任务流动名称，最长长度128，(中文64)
transferType	int	是	request body	任务流动类型 0 导出任务(PFS -> BOS) 1 导入任务(BOS -> PFS)
pfsPath	string	是	request body	任务流动的PFS路径，要求：以"/"开始非"/"结尾最长长度1000 路径不支持"." ".."

响应

返回状态码，成功返回200，失败返回见错误码

返回头域

除公共头域外，无其他特殊头域

返回参数

参数名称	类型	是否必需	参数位置	描述
requestId	string	是	Response Body	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
bucketLinkId	string	是	Response Body	数据流动ID

示例

请求：

                Shell
                
            

                POST /v2?action=CreateL2BucketLink
x-bce-date: 2023-06-09T10:08:22Z
host: pfs.xx.baidubce.com  ## 请将xx替换为对应地域的服务域名，如北京为bj、保定为bd、苏州为su、阳泉为yq
content-type: application/json
Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
version:v2
{
    "instanceId": "pfs-Lnf5fM",
    "conflictPolicy": 1,
    "bucketName": "wyl-test-pfs",
    "bucketPrefix": "",
    "throughputLimitBytes": 629145600,
    "reportObjectName": ".baidu_l2_bucketlink_dflow/",
    "bucketLinkName": "test",
    "transferType": 1,
    "pfsPath": "/pfs/test1"
}
            

响应：

                Shell
                
            

                HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Wed, 10 Apr 2016 08:26:52 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
{
    "requestId": "946002ee-cb4f-4aad-b686-5be55df27f09",
    "bucketLinkId": "dflow-xxx",
}
            

Fileset管理相关接口

删除数据流动任务

百度智能云

并行文件存储 PFS

并行文件存储 PFS

创建数据流动任务