标注平台帮助手册（V2.0）

# 数据集上传

通过接口对指定数据集下创建新的批次，然后根据已经创建好的数据集上传形式，选择原始文件或者索引文件上传。

通过接口发起数据集上传会创建一个“数据集上传”job。“数据集上传”的操作为异步，创建了“数据集上传”后，还需要根据“数据集上传进度查询接口”来查询数据集上传的完成情况。

提示：

  1. 当您使用私有云存储数据并通过索引文件上传时，标注平台仅把数据文件的地址和名称存储到数据库，而非存储数据文件本身到标注平台。因此当您取消云存储的访问授权或删除云文件后，将无法进行标注；

  2. 多个数据建议使用zip包进行打包压缩后上传，并保证zip包内的文件类型符合标注平台上传数据集要求；

# 请求地址和请求方式

HTTP请求地址 请求方式
{service}/api/v1/datasets/{dataset-id}/batchs POST

# 请求参数Path

序号 参数 是否必须 描述
1 dataset-id 是 数据集id

# 请求参数Header

序号 参数 内容 说明
1 Content-Type multipart/form-data; charset=UTF-8

# 请求参数Body

序号 参数 类型 是否必填 长度限制 描述 示例值
1 batchName string 是 50 批次名称 人脸检测数据集
2 files file 是 - 当前请求下的文件内容。
原始文件：
每次上传文件大小限制10000M。
索引文件：
每次上传限制5万条数据。		 @[object Object]
3 fileSize int 是 - 源文件的大小，单位为字节，不能为0。
如果和源文件大小有差异，则返回文件缺失，请重新上传。		 2346789

# 请求示例

{
  "batchName": "人脸检测数据集",
  "batchId":"2345",
  "files":[object Object],
  "fileSize": 2346789
}

# 返回结果（返回正确）

{
  "code":1,
  "message":"调用成功",
  "uploadbId":1
}

# 返回结果说明

序号 返回项目 返回类型 项目说明
1 uploadbId int 数据上传进度id

# 返回结果（返回错误）

{
  "code":203,
  "message":"上传数据的格式和数据集类型不匹配"
}

# 错误码说明

序号 错误码 错误提示信息
1 217 数据集id不存在
2 219 上传数据的格式和数据集类型不匹配
3 220 数据集id不能为空
4 221 批次名称不能重复
5 222 批次名称不能为空
6 223 批次名称长度不能超过50字符
7 224 文件缺失，请重新上传
8 225 文件不能为空
9 226 文件内容不能空
10 227 原始文件每次上传限制10000M以内
11 228 索引文件每次上传限制5万条数据
12 229 flieSize参数错误
13 230 fileSize必须为大于0的整数
14 231 flieSize不能为空
15 234 当前数据集已经存在同名批次，请更改csv文件名称后，再上传

← 数据集上传进度查询 →