查询数据流动任务列表
更新时间:2025-09-22
描述
查看pfs实例的所有数据流动任务。
请求
请求结构
Shell
1POST /v2?action=ListL2BucketLink
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.gz.baidubce.com
4content-type: application/json
5Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
6version:v2
7{
8 "instanceId": "pfs-xxxyy",
9 "manner": "marker",
10}
请求头域
除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
action | string | 是 | URL Query | 本接口固定为 ListL2BucketLink |
version | string | 是 | Request Header | API版本号,固定为v2 |
instanceId | string | 是 | Request Body | PFS实例ID |
maxKeys | int | 否 | Request Body | 返回buckettlink列表长度最大为1000,默认为20个,取值范围为【1,1000】,超过范围的规整为1或1000 |
manner | string | 是 | Request Body | 请求的分段类型,必须指定marker |
marker | string | 否 | Request Body | 按照bucketlinkId(格式一般为"dflow-xxxxxx")的字典序排列,从marker之后的第一个开始返回(不包括marker) |
响应
返回状态码,成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
requestId | string | 是 | response body | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
isTruncated | string | 是 | response body | 是否被截断,false表示本轮请求已包含全部数据 |
marker | string | 否 | response body | 本轮list的marker |
maxKeys | string | 是 | response body | 本轮返回的数据流动的数量 |
nextMarker | int | 是 | response body | 下一轮数据流动的marker |
result | list<BucketLinkInfo> | 否 | response body | 返回的数据流动具体列表 |
示例
请求:
Shell
1POST /v2?action=ListL2BucketLink
2x-bce-date: 2023-06-09T10:08:22Z
3host: pfs.xx.baidubce.com ## 请将xx替换为对应地域的服务域名,如北京为bj、保定为bd、苏州为su、阳泉为yq
4content-type: application/json
5Authorization: bce-auth-v1/ALTAK-gjz7qrfJ*******iGKkl/2025-09-16T07:27:36Z/1800/content-type;host;x-bce-date/87c7897837261b55c3c28e3bdf006988b************616c7d353ca5283990b
6version:v2
7{
8 "instanceId": "pfs-Lnf5fM",
9}
响应:
Shell
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6{
7 "requestId": "946002ee-cb4f-4aad-b686-5be55df27f09",
8 "isTruncated": false,
9 "marker": "",
10 "maxKeys": 20,
11 "nextMarker": null,
12 "result": [
13 {
14 "bucketLinkId": "dflow-9Tyvcz",
15 "bucketLinkName": "job123",
16 "conflictPolicy": 1,
17 "createTime": "2025-03-12T11:09:48Z",
18 "dst": "bos://pfsbucketlinkgz/test/",
19 "errmsg": "",
20 "finishTime": "-",
21 "instanceId": "pfs-Lnf5fM",
22 "iopsLimit": 0,
23 "progress": 0,
24 "report": null,
25 "src": "/pfs/pfs-be2muH/lsh",
26 "status": 0,
27 "throughputLimit": 1258291200,
28 "transferType": 0
29 }
30 ]
31}