评测集导入 -j9九游会登录
功能介绍
该接口用于从本地文件或历史版本中将海量数据批量导入至指定评测集的草稿版本中,支持多种格式解析及灵活的写入模式。
适用场景:
-
评测集同步:将存储在obs(对象存储服务)中的海量生产数据或标注数据自动化同步至评测系统。
-
评测集更替:利用全量覆盖模式(overwrite),一键重置当前草稿版本的数据内容。
调用方法
请参见如何调用api。
授权信息
账号根用户具备所有api的调用权限,如果使用账号下的iam用户调用当前api,该iam用户需具备如下身份策略权限,更多的权限说明请参见。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:dataset:importopsdatasetitems | write | dataset * | g:resourcetag/ | - | - |
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字符。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| import_task_id | string | 参数解释: 系统为本次导入操作生成的异步任务唯一标识符。 取值范围: 符合通用唯一识别码(uuid)标准的字符串。 |
| obs_url | string | 参数解释: 用于将本地数据文件直接上传至对象存储(obs)的预签名 url 地址。 取值范围: 合法的 http/https 协议 url 字符串。 |
请求示例
数据批量导入至指定评测集的草稿版本
post https://api.example.com/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 | 导入任务下发成功 |
错误码
请参见错误码。
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨