检索数据集列表 | 大装置帮助中心
跳到主要内容

检索数据集列表

POST /aids/aidmp/data/v2/dataSpaces/{data_space_id}/repos:search

请求头(Request Header)

参考认证(authentication)

请求参数(Request Parameters)

名称类型必须位置默认值取值范围描述
data_space_idstringpath--数据空间ID.

请求体(Request Body)

名称类型必须默认值取值范围描述
repoobject--检索数据集参数,支持按照name、display_name完全匹配,或name正则匹配:"/正则表达式/".
pageinteger1-当前页的开始.
page_sizeinteger100-1000本次请求的分页大小.
order_bystring--排序关键字,例:"create_time desc".
tenant_codestring--所属租户的名称.
repo_tagsarray[object]--标签信息数组,支持数据集标签检索.

其中,repo的参数如下

名称类型描述
namestring名称.
display_namestring显示的名称,例如url上.
is_publicboolean是否是公开数据集.
tenant_idstring租户ID.

其中,repo_tags的参数如下

名称类型描述
tag_namestring标签名称.
tag_typestring标签类型.
numinteger该标签在数据集中出现的次数.

请求示例(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)

名称类型描述
reposarray[object]数据集列表.
totalinteger数据集总数.
tenant_codestring所属租户的名称.

其中,repos的参数如下

名称类型描述
repoobject数据集详细.
tagsstring数据集的标签 array(json)的字符串 例如:'[{"数据类型":["图片", "视频"]},{"应用场景":["自动驾驶"]}]'.

其中,repo的参数如下

名称类型描述
idstring数据集ID.
namestring名称.
display_namestring显示的名称,例如url上.
create_user_idstring数据集的创建者ID(用于用户界面).
descstring数据集的描述.
tenant_idstring所属租户ID.
branch_numinteger分支数量(用于用户界面).
commit_numinteger版本数量(用于用户界面).
file_numinteger数据集中不同文件的总数,即有多少个不同的SHA.
is_emptyboolean数据集是否空(用于用户界面).
prefix_uristring固定前缀(用于用户界面).
create_usernamestring创建用户名称(用于用户界面),对应云管/v1/users/{user_id}接口返回结果里面的username.
last_commit_timestring最新一次的提交时间(用于用户界面).
create_timestring创建时间.
update_timestring最后更新时间.
default_branchstring默认分支名.
is_publicboolean是否是公开数据集.
is_allow_publicboolean是否允许公开.
repo_typeinteger($enum)数据集类型.
oss_pathstring对象存储路径.
is_asyncboolean是否是创建中状态,true表示数据集状态为Creating.
acl_listarray[integer($enum)]用户在此数据集所拥有的权限.

其中,repo_type有如下情况

状态数值含义
COMMON0普通数据集,默认值
IMPORT1导入的数据集

其中,acl_list有如下情况

状态数值含义
UNKNOWN0未知
READ1读权限
WRITE2写权限

响应示例(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": ""
}