获取数据集版本详情-GetDataSetVersionDetails
功能介绍
获取数据集版本详情
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
octopus:dataset:get
Read
workspace *
-
-
-
URI
GET /v1.0/{project_id}/common/datasets/{dataset_id}/versions/{version_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方法请参见获取项目ID。 约束限制: 不涉及 取值范围: 只能用小写字母 a-z 和数字 0-9组成,且长度为32个字符 默认取值: 不涉及 |
| dataset_id | 是 | String | 参数解释: 数据集id 约束限制: 不涉及 取值范围: 标准36位带横杠、小写UUID 默认取值: 不涉及 |
| version_id | 是 | String | 参数解释: 数据集版本id 约束限制: 不涉及 取值范围: 标准36位带横杠、小写UUID 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| payload | 参数解释: 实际返回信息 | |
| meta_info | MetaInfo object | 参数解释: 元数据 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 数据集版本ID 取值范围: 不涉及 |
| label_dataset_id | String | 参数解释: 数据集ID 取值范围: 不涉及 |
| name | String | 参数解释: 名称 取值范围: 不涉及 |
| batch_task_id | String | 参数解释: 批次任务id,当版本是标注创建的则返回该字段 取值范围: 不涉及 |
| label_meta_names | Array of strings | 参数解释: 标注物名 取值范围: 不涉及 |
| label_format | String | 参数解释: 标注格式 取值范围: |
| status | String | 参数解释: 状态 取值范围: |
| frame_num | String | 参数解释: 帧文件数量 取值范围: 不涉及 |
| frame_size | String | 参数解释: 帧文件大小,包含单位 取值范围: 不涉及 |
| label_count | String | 参数解释: 标志物数量 取值范围: 不涉及 |
| custom_image | String | 参数解释: 自定义镜像,版本中没有则不返回 取值范围: 不涉及 |
| command | String | 参数解释: 脚本路径,版本中没有则不返回 取值范围: 不涉及 |
| cluster_id | String | 参数解释: 集群id 取值范围: 不涉及 |
| spec | String | 参数解释: 资源规格 取值范围: 不涉及 |
| description | String | 参数解释: 描述若版本中没有描述则不返回 取值范围: 不涉及 |
| project_id | String | 参数解释: 项目id 取值范围: 不涉及 |
| workspace_id | String | 参数解释: 工作空间id 取值范围: 不涉及 |
| create_at | String | 参数解释: 创建时间,UTC标准时间毫秒时间戳 取值范围: 不涉及 |
| update_at | String | 参数解释: 修改时间,UTC标准时间毫秒时间戳 取值范围: 不涉及 |
| upload_id | String | 参数解释: 上传id 取值范围: 不涉及 |
| tags | Array of strings | 参数解释: 标签 取值范围: 不涉及 |
| custom_attributes | Array of strings | 参数解释: 自定义属性,格式形式"key:value" |
| label_names | Array of strings | 参数解释: 标注物名 |
| agreement_confirm | Boolean | 参数解释: 隐私声明同意 取值范围: 不涉及 |
| source_version_id | String | 参数解释: 子集的源数据集版本ID 取值范围: 不涉及 |
| label_infos | Array of LabelInfoVO objects | 参数解释: 息标注物信息 |
| tag_infos | Array of TagInfoVO objects | 参数解释: tag信息 |
| custom_attribute_infos | Array of CustomAttributeInfoVO objects | 参数解释: 自定义属性信息 |
| frame_ids | Array of strings | 参数解释: 桢id集合 |
| has_finished | Boolean | 参数解释: 已经结束,该数据集下没有非终止状态下的版本表示结束,成功或失败表示终止状态 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| label_shape_type | String | 参数解释: 标注物形状 取值范围: 不涉及 |
| shape_count | String | 参数解释: 标注物形状个数 取值范围: 不涉及 |
| label_meta_infos | Array of LabelMetaInfoVO objects | 参数解释: 标注物名称信息 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| label_name | String | 参数解释: 标注物名称 取值范围: 不涉及 |
| count | Long | 参数解释: 标注物名称个数 取值范围: 不涉及 |
请求示例
获取数据集版本详情
GET https://{endpoint}/v1.0/{project_id}/common/datasets/61a22ebc-49b3-40b5-b16f-ab9aebd2b231/versions/102575d5-cf89-4aca-b856-0d39ae2a69c5 响应示例
状态码:200
查询成功
获取数据集版本详情
{
"meta_info" : {
"current_time" : "2024-01-08T07:04:13Z"
},
"payload" : {
"item" : {
"id" : "3371d47a-df83-43a6-ae86-0c634bd76238",
"label_dataset_id" : "564e0c00-3883-4f0c-861d-f4b280506ddb",
"name" : "V1",
"batch_task_id" : "1377063caf6a42e1a95a030188500e1f",
"label_meta_names" : [ "road" ],
"label_format" : "OCTOPUS",
"status" : "SUCCESS",
"frame_num" : 1,
"frame_size" : 1,
"label_count" : 1,
"label_names" : [ "Car" ],
"custom_image" : "",
"command" : "",
"description" : "",
"project_id" : "64d37c8f25af4277a1ff4ee9772687bf",
"workspace_id" : 0,
"create_at" : 1704694142135,
"update_at" : 1704694287236,
"label_infos" : [ {
"label_shape_type" : "bndbox",
"shape_count" : 1,
"label_meta_infos" : [ {
"label_name" : "Car",
"count" : 1
} ]
} ],
"tag_infos" : [ ],
"custom_attribute_infos" : [ ],
"frame_ids" : [ "1" ],
"has_finished" : true
}
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
| 400 | 参数校验失败 |
| 500 | 系统内部错误 |
错误码
请参见错误码。