# 评测集导入 - ImportOpsDatasetItems #### 功能介绍 该接口用于从本地文件或历史版本中将海量数据批量导入至指定评测集的草稿版本中，支持多种格式解析及灵活的写入模式。 适用场景： - 评测集同步：将存储在OBS（对象存储服务）中的海量生产数据或标注数据自动化同步至评测系统。 - 评测集更替：利用全量覆盖模式（Overwrite），一键重置当前草稿版本的数据内容。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:dataset:importOpsDatasetItems | Write | dataset \* | g:ResourceTag/\ | - | - | #### URI POST /v1/ops/datasets/{dataset_id}/items/import 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | **参数解释：** 评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 由英文、数字、连字符(-)、下划线(_)组成的1\~64个字符串。 **默认取值：** 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | source_version_id | 否 | String | **参数解释：** 源版本ID。用于指定在数据还原或复制操作中作为参考的基础版本。获取方式请参见查询评测集版本列表。 **约束限制：** 不涉及。 **取值范围：** 由英文字母、数字和连字符(-)组成，长度为0\~36个字符。 **默认取值：** 不涉及。 | | overwrite | 否 | Boolean | **参数解释：** 覆盖模式开关。决定在导入新数据前是否清空草稿版本中的现有数据。 **约束限制：** 不涉及。 **取值范围：** - *true*: 覆盖模式，执行清空操作。 - *false*: 追加模式，保留现有数据。 **默认取值：** false。 | | get_obs_url | 否 | Boolean | **参数解释：** 获取OBS预签名URL标识。用于确定是否需要系统生成并返回用于大文件直传的临时上传链接。 **约束限制：** 仅在不使用 multipart/form-data 模式时启用。 **取值范围：** - true：需要系统生成并返回OBS预签名URL - false：不需要系统生成OBS预签名URL **默认取值：** false。 | | obs_object_name | 否 | String | **参数解释：** OBS对象名称。指定待导入文件在对象存储（OBS）中的完整存储路径或文件名。 **约束限制：** 不涉及。 **取值范围：** 由任意字符组成，长度为0\~10000个字符。 **默认取值：** 不涉及。 | | obs_file_hash | 否 | String | **参数解释：** 文件哈希值（SHA-256）。用于在服务端进行文件完整性校验，确保上传过程中数据未损坏或被篡改。 **约束限制：** 不涉及。 **取值范围：** 只能由十六进制字符（0-9、a-f）组成，长度为0\~256个字符。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 导入任务下发成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。