# 获取数据集版本详情-GetDataSetVersionDetails #### 功能介绍 获取数据集版本详情 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-octopus/Permission.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | octopus:dataset:get | Read | workspace \* | - | - | - | #### URI GET /v1.0/{project_id}/common/datasets/{dataset_id}/versions/{version_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-octopus/octopus-10-0020.html)。 **约束限制**： 不涉及 **取值范围**： 只能用小写字母 a-z 和数字 0-9组成，且长度为32个字符 **默认取值**： 不涉及 | | dataset_id | 是 | String | **参数解释**： 数据集id **约束限制**： 不涉及 **取值范围**： 标准36位带横杠、小写UUID **默认取值**： 不涉及 | | version_id | 是 | String | **参数解释**： 数据集版本id **约束限制**： 不涉及 **取值范围**： 标准36位带横杠、小写UUID **默认取值**： 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | payload | [LabelDatasetVersionInfoPayload] object | **参数解释**： 实际返回信息 | | meta_info | [MetaInfo] object | **参数解释**： 元数据 | 表4LabelDatasetVersionInfoPayload | 参数 | 参数类型 | 描述 | |:---|:---|:---| | item | [LabelDatasetVersionDetailVO] object | **参数解释**： 版本信息 | 表5LabelDatasetVersionDetailVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 数据集版本ID **取值范围**： 不涉及 | | label_dataset_id | String | **参数解释**： 数据集ID **取值范围**： 不涉及 | | name | String | **参数解释**： 名称 **取值范围**： 不涉及 | | batch_task_id | String | **参数解释**： 批次任务id，当版本是标注创建的则返回该字段 **取值范围**： 不涉及 | | label_meta_names | Array of strings | **参数解释**： 标注物名 **取值范围**： 不涉及 | | label_format | String | **参数解释**： 标注格式 **取值范围**： - OCTOPUS：OCTOPUS格式 - USER_DEFINE：自定义格式 | | status | String | **参数解释**： 状态 **取值范围**： - CREATING：创建中 - IN_INTEGRATION：整合中 - EXPORTING：导出中 - SUCCESS：成功 - INTEGRATION_FAILED：整合失败 - EXPORT_FAILED：导出失败 - EXPORT_PRE_SUCCESS：导出中 - UPLOAD_SUSPENDED：上传中断 - INITIALIZING：初始化 - RELEASING：发布中 - RELEASED：已发布 - RELEASE_FAILED：发布失败 | | 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 | **参数解释**： 已经结束，该数据集下没有非终止状态下的版本表示结束，成功或失败表示终止状态 **取值范围**： 不涉及 | 表6LabelInfoVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | label_shape_type | String | **参数解释**： 标注物形状 **取值范围**： 不涉及 | | shape_count | String | **参数解释**： 标注物形状个数 **取值范围**： 不涉及 | | label_meta_infos | Array of [LabelMetaInfoVO] objects | **参数解释**： 标注物名称信息 | 表7LabelMetaInfoVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | label_name | String | **参数解释**： 标注物名称 **取值范围**： 不涉及 | | count | Long | **参数解释**： 标注物名称个数 **取值范围**： 不涉及 | 表8TagInfoVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | tag_name | String | **参数解释**： tag名称 **取值范围**： 不涉及 | | count | Long | **参数解释**： tag个数 **取值范围**： 不涉及 | 表9CustomAttributeInfoVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | custom_attribute_name | String | **参数解释**： 自定义属性名称 **取值范围**： 不涉及 | | count | Long | **参数解释**： 自定义属性名称个数 **取值范围**： 不涉及 | 表10MetaInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | current_time | String | **参数解释**： 请求时间，UTC时间格式，时间为UTC标准时间 **取值范围**： 不涉及 | #### 请求示例 获取数据集版本详情 ``` 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 | 系统内部错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-octopus/ErrorCode.html)。