发起数据集导入任务

开发环境

http://dev-cn.your-api-server.com

POST

https://qianfan.baidubce.com/wenxinworkshop/dataset/import

功能介绍

本接口用于发起数据集导入任务。

接口调用效果，与下图操作实现效果类似，部分同产品页面有区别，具体以接口参数为准。

接口调用成功后，在数据集管理页面，可以查看导入状态变化，如下图所示：

注意事项

鉴权机制，调用本文API，使用“安全认证/Access Key ”中的Access Key ID 和 Secret Access Key等鉴权，无法使用获取Access Token的方式鉴权，具体鉴权认证机制参考“百度云鉴权认证机制”。

示例2：从分享链接导入目录中的所有无标注信息文件

bash

错误码

若请求错误，服务器将返回的JSON文本包含以下参数：

名称	描述
error_code	错误码
error_msg	错误描述信息，帮助理解和解决发生的错误

例如参数错误返回：

{
  "error_code": 500001,
  "error_msg": "param invalid"
}

数据管理相关错误码，请查看错误码说明。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qianfan.baidubce.com/wenxinworkshop/dataset/import?access_token	=' \
--header 'Content-Type;' \
--header 'x-bce-date;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "annotated": false,
    "importFrom": 1,
    "files": ["bos:/aip-web/ f2ffdfcf-e3d2-4368-9ce6-084af9282f93/"],
    "datasetId": 2315
}'

响应示例

{
    "log_id": "string",
    "result": true,
    "status": 0,
    "success": true
}

请求参数

Query 参数

access_token

string

必需

通过API Key和Secret Key获取的access_token，参考Access Token获取

Header 参数

Content-Type

string

必需

HTTP请求内容的类型，固定值：application/json

x-bce-date

string

必需

当前时间，遵循ISO8601规范，格式如2016-04-06T08:23:49Z

Authorization

string

必需

用于验证请求合法性的认证信息。更多参见鉴权认证，签名工具可参考IAM签名工具

Body 参数application/json

annotated

boolean

必需

是否带标注导入，可选值如下： · true：表示带标注信息 · false：表示不带

importFrom

integer

必需

上传方式，可选值如下： · 1：用户Bos目录/文件上传，默认1 · 2：网络分享链接,将全部文件保存至同一压缩包，压缩包仅支持zip/tar.gz格式，压缩前源文件大小限制5G以内；仅支持来自百度BOS、阿里OSS、腾讯COS、华为OBS的共享链接

files

array[string]

可选

导入文件名称列表，数量随importFrom字段变化，说明： · importFrom为1时， files值为bos:/bucketName/some/path/ (可为目录或文件) · importFrom为2时，files值有且仅有1个，值为http[s]://bucketName.bj.bcebos.com/fileName.zip?authorization=bce-auth-v1/c786...

datasetId

integer

必需

要导入的数据集版本ID，示例：1，可以通过以下任一方式获取该字段值： · 方式一，通过调用创建数据集接口，返回的id字段获取 · 方式二，在千帆控制台-数据集管理列表页面查看，如下图所示：

示例

返回响应

🟢200成功

application/json

Body

log_id

string

必需

result

boolean

必需

status

integer

必需

success

boolean

必需

发起数据集发布任务

获取数据集详情

发起数据集导入任务

功能介绍#

注意事项#

示例2：从分享链接导入目录中的所有无标注信息文件#

错误码#

请求参数

返回响应

功能介绍

注意事项

示例2：从分享链接导入目录中的所有无标注信息文件

错误码