获取数据集版本导入详情
更新时间：2026-04-16
POST
https://qianfan.baidubce.com/v2/dataset?Action=DescribeImportTask
本接口用于获取数据集版本的导入任务详情。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。需具有以下任一权限：
- 完全控制千帆大模型平台的权限：QianfanFullControlAccessPolicy
- 完全控制千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataFullControlAccessPolicy
- 运维操作千帆大模型平台数据管理（除数据标注外）的权限：QianfanDataOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权，具体鉴权认证机制参考HTTP调用鉴权说明。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值DescribeImportTask
必选
Body 参数
taskId
string
导入任务ID
必选
请求结构
POST /v2/dataset?Action=DescribeImportTask HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"taskId": "task-xxx"
}示例代码
请求示例
curl -i --location 'https://qianfan.baidubce.com/v2/dataset?Action=DescribeImportTask'\
--header 'Authorization: bce-auth-v1/f0ee7axxxx/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8f44a21a5xxxx74525543'\
--header 'x-bce-date: 2023-09-19T13:37:10Z'\
--header 'Content-Type: application/json'\
--data '{
"taskId": "task-xxx"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
result
object {9}
数据集版本导入相关信息，请求成功时返回
可选
显示子属性
隐藏子属性
versionId
string
数据集版本ID
可选
importStatus
string
导入状态
可选
progress
string
导入进度
可选
sizeMB
float
数据集大小，单位为MB
可选
sampleCount
integer
样本数
可选
creator
string
导入任务操作人
可选
startTime
string
导入开始时间，格式：YYYY-MM-DD hh:mm:ss
可选
finishTime
string
导入完成时间，格式：YYYY-MM-DD hh:mm:ss，如果导入未完成，该字段为空
可选
errDownloadUrl
string
导入错误详情下载地址，仅在导入出现错误时非空
可选
code
string
错误码，错误时返回
可选
message
string
错误信息，请求失败时返回
可选
成功示例
{
"requestId": "febaf751-7725-4a8b-5699-a966b82dd676",
"result": {
"versionId": "ds-sshcwxmh5uk9t17w",
"importStatus": "ImportFinished",
"progress": "100%",
"sizeMB": 0.01,
"sampleCount": 10,
"creator": "accountName",
"startTime": "2024-08-06 11:17:50",
"finishTime": "2024-08-06 11:18:01",
"errDownloadUrl": ""
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
requestId |
请求ID |
code |
错误码 |
message |
错误描述信息，帮助理解和解决发生的错误 |
例如错误返回：
text
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}
更多其他错误码，也可以查看错误码说明。
评价此篇文章