评测集导入 - ImportOpsDatasetItems
功能介绍
该接口用于从本地文件或历史版本中将海量数据批量导入至指定评测集的草稿版本中,支持多种格式解析及灵活的写入模式。
适用场景:
URI
POST /v1/ops/datasets/{dataset_id}/items/import
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dataset_id |
是 |
String |
参数解释: 评测集的ID。 约束限制: 由英文、数字、“-”、“_”组成,长度为1到64个字符。 取值范围: 1-64位字符。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
source_version_id |
否 |
String |
参数解释: 源版本ID。用于指定在数据还原或复制操作中作为参考的基础版本。 约束限制: 长度为0到100个字符。 取值范围: 0到100字符。 默认取值: 不涉及。 |
|
overwrite |
否 |
Boolean |
参数解释: 覆盖模式开关。决定在导入新数据前是否清空草稿版本中的现有数据。 约束限制: 不涉及。 取值范围: 默认取值: false。 |
|
get_obs_url |
否 |
Boolean |
参数解释: 获取OBS预签名URL标识。用于确定是否需要系统生成并返回用于大文件直传的临时上传链接。 约束限制: 仅在不使用 multipart/form-data 模式时启用。 取值范围: true, false。 默认取值: false。 |
|
obs_object_name |
否 |
String |
参数解释: OBS对象名称。指定待导入文件在对象存储(OBS)中的完整存储路径或文件名。 约束限制: 字符串长度限制为0到10000个字符。 取值范围: 0到10000 字符。 默认取值: 不涉及。 |
|
obs_file_hash |
否 |
String |
参数解释: 文件哈希值(SHA-256)。用于在服务端进行文件完整性校验,确保上传过程中数据未损坏或被篡改。 约束限制: 十六进制字符串,最大长度 256 个字符。 取值范围: 0到256字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
import_task_id |
String |
参数解释: 系统为本次导入操作生成的异步任务唯一标识符。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 |
|
obs_url |
String |
参数解释: 用于将本地数据文件直接上传至对象存储(OBS)的预签名 URL 地址。 取值范围: 合法的 HTTP/HTTPS 协议 URL 字符串。 |
请求示例
数据批量导入至指定评测集的草稿版本
POST https://*.com/agentarts/v1/ops/datasets/7452bf21f819-6f91-4568-9f2f-57ef9562ab7/items/import
响应示例
状态码:200
导入任务下发成功
{
"import_task_id" : "550e8400-e29b-41d4-a716-446655440001",
"obs_url" : "http://obs.cn-north-7.ulanqab.huawei.com/doc"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
导入任务下发成功 |
错误码
请参见错误码。