查询数据流动任务详情
更新时间:2025-09-22
描述
查看单个数据流动详情,只支持精确查询。
请求
请求结构
Shell
1POST /?action=DescribeL2BucketLink
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 "bucketLinkId": "dflow-xxxyyy",
10}
请求头域
除公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
action | string | 是 | URL Query | 本接口中为固定DescribeL2BucketLink |
version | string | 是 | Request Header | API版本号,固定为v2 |
instanceId | string | 是 | Request Body | 数据流动所属PFS实例Id |
bucketLinkId | string | 是 | Request Body | 数据流动ID |
响应
返回状态码,成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
参数名字 | 类型 | 是否必须 | 参数位置 | 描述 |
---|---|---|---|---|
requestId | response body | string | 是 | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
bucketlinkId | string | 否 | response body | 数据流动任务ID |
bucketlinkName | string | 是 | response body | 数据流动任务名字 |
instanceId | string | 是 | response body | PFS实例短ID |
transferType | int | 是 | response body | |
createTime | string | 是 | response body | 数据流动任务创建时间 |
finishTime | string | 否 | response body | 数据流动任务结束时间 |
conflictPolicy | int | 是 | response body | 冲突策略 |
throughputLimit | int | 是 | response body | 任务吞吐上限,单位byte |
status | int | 是 | response body | 任务状态 |
src | string | 是 | response body | 数据源路径 |
dst | string | 是 | response body | 数据目的路径 |
progress | int | 否 | response body | 进度情况(0 ~ 100),在运行中时生效 |
report | string | 否 | response body | 任务报告,在任务结束(已成功、任务失败、已取消)时生效 |
示例
请求:
Shell
1POST /?action=DescribeL2BucketLink
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 "bucketLinkId": "dflow-xxxyyy",
10}
响应:
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 "bucketLinkId": "dflow-xxxxyyy",
9 "bucketLinkName": "data flow test",
10 "instanceId": "pfs-xxxxyyy",
11 "transferType": 0,
12 "createTime": "2024-08-14T05:04:30Z",
13 "finishTime": "-",
14 "conflictPolicy": 0,
15 "throughputLimit": 1342177280,
16 "status": 2,
17 "errmsg": "don't have permission to access bos bucket",
18 "src": "bos://bucket-name/prefix",
19 "dst": "/pfs/path",
20 "progress": 60,
21 "report": "bos://bucket-name/preifx/report_object_name",
22}