检索数据集列表
POST /aids/aidmp/data/v2/dataSpaces/{data_space_id}/repos:search
请求头(Request Header)
请求参数(Request Parameters)
名称 | 类型 | 必须 | 位置 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|---|
data_space_id | string | 是 | path | - | - | 数据空间ID. |
请求体(Request Body)
名称 | 类型 | 必须 | 默认值 | 取值范围 | 描述 |
---|---|---|---|---|---|
repo | object | 是 | - | - | 检索数据集参数,支持按照name、display_name完全匹配,或name正则匹配:"/正则表达式/". |
page | integer | 否 | 1 | - | 当前页的开始. |
page_size | integer | 否 | 10 | 0-1000 | 本次请求的分页大小. |
order_by | string | 否 | - | - | 排序关键字,例:"create_time desc". |
tenant_code | string | 否 | - | - | 所属租户的名称. |
repo_tags | array[object] | 否 | - | - | 标签信息数组,支持数据集标签检索. |
其中,repo
的参数如下
名称 | 类型 | 描述 |
---|---|---|
name | string | 名称. |
display_name | string | 显示的名称,例如url上. |
is_public | boolean | 是否是公开数据集. |
tenant_id | string | 租户ID. |
其中,repo_tags
的参数如下
名称 | 类型 | 描述 |
---|---|---|
tag_name | string | 标签名称. |
tag_type | string | 标签类型. |
num | integer | 该标签在数据集中出现的次数. |
请求示例(Request Example)
curl --location 'https://aidmp.cn-sh-01.sensecoreapi.dev/aids/aidmp/data/v2/dataSpaces/ecfcd941-575c-11ee-9d6f-46f164dda338/repos:search' \
--header 'Content-Type: application/json' \
--data '{
"page": 1,
"page_size": 10,
"order_by": "update_time desc",
"repo": {
"name": "/(?i)demo/"
}
}'
# 支持标签检索
curl --location 'https://aidmp.cn-sh-01.sensecoreapi.dev/aids/aidmp/data/v2/dataSpaces/ecfcd941-575c-11ee-9d6f-46f164dda338/repos:search' \
--header 'Content-Type: application/json' \
--data '{
"page": 1,
"page_size": 10,
"order_by": "update_time desc",
"repos_tags": [
{
"tag_name": "自动驾驶",
"tag_type": "应用场景"
}
],
"repo": {}
}
响应(Response)
名称 | 类型 | 描述 |
---|---|---|
repos | array[object] | 数据集列表. |
total | integer | 数据集总数. |
tenant_code | string | 所属租户的名称. |
其中,repos
的参数如下
名称 | 类型 | 描述 |
---|---|---|
repo | object | 数据集详细. |
tags | string | 数据集的标签 array(json)的字符串 例如:'[{"数据类型":["图片", "视频"]},{"应用场景":["自动驾驶"]}]'. |
其中,repo
的参数如下
名称 | 类型 | 描述 |
---|---|---|
id | string | 数据集ID. |
name | string | 名称. |
display_name | string | 显示的名称,例如url上. |
create_user_id | string | 数据集的创建者ID(用于用户界面). |
desc | string | 数据集的描述. |
tenant_id | string | 所属租户ID. |
branch_num | integer | 分支数量(用于用户界面). |
commit_num | integer | 版本数量(用于用户界面). |
file_num | integer | 数据集中不同文件的总数,即有多少个不同的SHA. |
is_empty | boolean | 数据集是否空(用于用户界面). |
prefix_uri | string | 固定前缀(用于用户界面). |
create_username | string | 创建用户名称(用于用户界面),对应云管/v1/users/{user_id}接口返回结果里面的username. |
last_commit_time | string | 最新一次的提交时间(用于用户界面). |
create_time | string | 创建时间. |
update_time | string | 最后更新时间. |
default_branch | string | 默认分支名. |
is_public | boolean | 是否是公开数据集. |
is_allow_public | boolean | 是否允许公开. |
repo_type | integer($enum) | 数据集类型. |
oss_path | string | 对象存储路径. |
is_async | boolean | 是否是创建中状态,true表示数据集状态为Creating. |
acl_list | array[integer($enum)] | 用户在此数据集所拥有的权限. |
其中,repo_type
有如下情况
状态 | 数值 | 含义 |
---|---|---|
COMMON | 0 | 普通数据集,默认值 |
IMPORT | 1 | 导入的数据集 |
其中,acl_list
有如下情况
状态 | 数值 | 含义 |
---|---|---|
UNKNOWN | 0 | 未知 |
READ | 1 | 读权限 |
WRITE | 2 | 写权限 |
响应示例(Response Example)
{
"repos": [
{
"repo": {
"id": "b3bb7993-0ede-43bc-88cb-4fc88e55e9e0",
"name": "demo01",
"display_name": "demo01",
"create_user_id": "644f2cb8-49e9-42b0-8cd9-c62eb46cb5d8",
"desc": "",
"tenant_id": "f06a01f0-15f3-4c4e-9e4c-28428137a06d",
"branch_num": 1,
"default_branch": "",
"commit_num": 2,
"file_num": "0",
"is_empty": false,
"prefix_uri": "",
"create_username": "adimp0224",
"last_commit_time": "2023-10-07T08:18:53.017Z",
"create_time": "2023-09-25T08:24:35.826Z",
"update_time": "2023-10-07T08:18:53.017Z",
"is_public": null,
"is_allow_public": false,
"repo_type": 2,
"oss_path": "",
"is_async": false,
"acl_list": [
1,
2
]
},
"tags": "[{\"name\":\"标注来源\",\"value\":[\"自标注\"]},{\"name\":\"数据类型\",\"value\":[\"图片\",\"视频\"]},{\"name\":\"任务类型\",\"value\":[\"目标检测\"]},{\"name\":\"数据来源\",\"value\":[\"采集\"]},{\"name\":\"数据大小\",\"value\":[\"1M\\u003c=n\\u003c10M\"]},{\"name\":\"自定义标签\",\"value\":[\"锥形桶\",\"斑马线\",\"红绿灯\"]},{\"name\":\"应用场景\",\"value\":[\"自动驾驶\",\"智能车舱\"]},{\"name\":\"标注类型\",\"value\":[\"2D 矩形框\"]},{\"name\":\"语言\",\"value\":[\"中文\"]}]"
},
{
"repo": {
"id": "ec21087e-1c68-4a86-9199-8130e346d183",
"name": "test_new_demo_1",
"display_name": "test_new_demo_1",
"create_user_id": "644f2cb8-49e9-42b0-8cd9-c62eb46cb5d8",
"desc": "",
"tenant_id": "f06a01f0-15f3-4c4e-9e4c-28428137a06d",
"branch_num": 1,
"default_branch": "",
"commit_num": 3,
"file_num": "0",
"is_empty": false,
"prefix_uri": "",
"create_username": "adimp0224",
"last_commit_time": "2023-09-26T08:07:13.668Z",
"create_time": "2023-09-26T08:04:59.032Z",
"update_time": "2023-09-26T08:07:13.668Z",
"is_public": null,
"is_allow_public": false,
"repo_type": 2,
"oss_path": "",
"is_async": false,
"acl_list": [
1,
2
]
},
"tags": ""
}
],
"total": 2,
"tenant_code": ""
}