文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 源数据包/ 获取数据包详情-GetDataPackageDetail
更新时间:2026-04-30 GMT+08:00
分享

获取数据包详情-GetDataPackageDetail

功能介绍

获取数据包详情

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    octopus:dataPackage:get

    Read

    workspace *

    -

    -

    -

URI

GET /v1.0/{project_id}/data/packages/{id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方法请参见获取项目ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

id

是

String

参数解释:

数据包ID

约束限制:

以DPK开头,加7-13位数字

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

是

String

参数解释:

内容类型。填application/json

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

payload

DataPackageInfoPayload object

参数解释:

实际返回信息

meta_info

RespMetaInfo object

参数解释:

元数据

表4 DataPackageInfoPayload

参数

参数类型

描述

item

DataPackageDetail object

参数解释:

数据包详细信息

表5 DataPackageDetail

参数

参数类型

描述

id

String

参数解释:

数据包ID

取值范围:

不涉及

user_id

String

参数解释:

用户ID

取值范围:

不涉及

project_id

String

参数解释:

项目ID

取值范围:

不涉及

dcl_id

String

参数解释:

导入任务ID

取值范围:

不涉及

status

String

参数解释:

数据包状态

取值范围:

  • CREATED:已创建

  • SCANNING:扫描中

  • NORMAL:导入完成

  • ABNORMAL:导入异常

  • PRE_DESENSITIZATION:待脱敏

  • IN_DESENSITIZATION:脱敏中

  • DESENSITIZATION_SUCCESS:脱敏完成

  • DESENSITIZATION_FAILED:脱敏失败

  • NOT_RECYCLED:未回收

  • RECYCLED:待处理

  • DELETING:删除中

  • FAILED:删除失败

name

String

参数解释:

数据包名称

取值范围:

不涉及

data_type

String

参数解释:

数据包类型

取值范围:

不涉及

data_source

String

参数解释:

传输方式

取值范围:

  • OBS:对象存储

  • DES:数据递送

storage_size

Long

参数解释:

数据包大小

取值范围:

不涉及

recycled_time

Long

参数解释:

数据包放入回收站时间,UTC标准时间毫秒时间戳(若数据包没有放入回收站,则没有此字段)

取值范围:

不涉及

vehicle_id

Long

参数解释:

车辆id(数据包导入失败,此字段不会返回)

取值范围:

不涉及

create_at

Long

参数解释:

数据包创建时间,UTC标准时间毫秒时间戳

取值范围:

不涉及

update_at

Long

参数解释:

数据包更新时间,UTC标准时间毫秒时间戳

取值范围:

不涉及

collection_info

OctopusDataCollection object

参数解释:

数据包收集信息(数据转换算子运行失败,此字段不会返回)

msg_code

Integer

参数解释:

数据包错误码(数据包非异常状态,此字段不会返回)

取值范围:

不涉及

error_msg

String

参数解释:

数据包错误信息(数据包非异常状态,此字段不会返回)

取值范围:

不涉及

suggestion_msg

String

参数解释:

数据包错误提示建议(数据包非异常状态,此字段不会返回)

取值范围:

不涉及

tag_ids

Array of integers

参数解释:

数据包标签列表

workspace_id

String

参数解释:

工作空间id

取值范围:

不涉及

表6 OctopusDataCollection

参数

参数类型

描述

cardrive

DataCardrive object

参数解释:

车辆信息

folders

modelsDataCollectingDataFolders object

参数解释:

传感器信息

data_type

Integer

参数解释:

数据包类型

取值范围:

不涉及

map_id

String

参数解释:

高精地图ID

取值范围:

不涉及

preprocessor

preprocessor object

参数解释:

opendata转换算子信息(导入时未配置处理任务,此字段不返回)

desensitization

preprocessor object

参数解释:

脱敏算子信息(导入时未配置处理任务,此字段不返回)

project

String

参数解释:

采集项目信息

取值范围:

不涉及

module

String

参数解释:

采集模块信息

取值范围:

不涉及

videos

Array of modelsDataCollectingVideos objects

参数解释:

视频列表

表7 DataCardrive

参数

参数类型

描述

collect_time

String

参数解释:

数据包采集时间

取值范围:

不涉及

station

String

参数解释:

数据包采集站点(数据包yaml中没有填写此项,此项不会返回)

取值范围:

不涉及

car

DataCar object

参数解释:

采集车信息

route

String

参数解释:

数据包采集路线(数据包yaml中没有填写此项,此项不会返回)

取值范围:

不涉及

mode

String

参数解释:

数据包采集模式(数据包yaml中没有填写此项,此项不会返回)

取值范围:

不涉及

tags

Array of integers

参数解释:

数据包标签列表(数据包yaml中没有填写此项,此项不会返回)

segments

Array of modelsDataCollectingSegmentInfo objects

参数解释:

数据包场景片段列表(数据包yaml中没有填写此项,此项不会返回)

description

String

参数解释:

数据包描述信息(数据包yaml中没有填写此项,此项不会返回)

取值范围:

不涉及

speed

String

参数解释:

数据包采集时车辆速度(数据包yaml中没有填写此项,此项不会返回)

取值范围:

不涉及

表8 DataCar

参数

参数类型

描述

vehicle_name

String

参数解释:

车辆名称

取值范围:

不涉及

calibration_id

Long

参数解释:

标定id(数据包yaml中没有填写此项,此项不会返回)

取值范围:

不涉及

表9 modelsDataCollectingSegmentInfo

参数

参数类型

描述

time

String

参数解释:

场景片段时间

取值范围:

不涉及

tags

Array of strings

参数解释:

场景片段标签列表

表10 modelsDataCollectingDataFolders

参数

参数类型

描述

camera

Array of DataFolderInfo objects

参数解释:

摄像头信息

lidar

Array of DataFolderInfo objects

参数解释:

激光雷达信息

radar

Array of DataFolderInfo objects

参数解释:

毫米波雷达信息

gnss

Array of DataFolderInfo objects

参数解释:

车辆定位

vehicle

Array of DataFolderInfo objects

参数解释:

车辆底盘信息

ego_tf

Array of DataFolderInfo objects

参数解释:

自车坐标和姿态

object_array_vision

Array of DataFolderInfo objects

参数解释:

感知数据

traffic_light_info

Array of DataFolderInfo objects

参数解释:

交通灯信息

tag_record

Array of DataFolderInfo objects

参数解释:

标签数据

planning_trajectory

Array of DataFolderInfo objects

参数解释:

规划路径

predicted_objects

Array of DataFolderInfo objects

参数解释:

感知目标预测路径

control

Array of DataFolderInfo objects

参数解释:

车辆控制信息

routing_path

Array of DataFolderInfo objects

参数解释:

全局规划路径

表11 DataFolderInfo

参数

参数类型

描述

name

String

参数解释:

传感器名称

取值范围:

不涉及

format

String

参数解释:

数据格式

取值范围:

不涉及

calibration_item_id

Long

参数解释:

标定信息(若传感器无标定信息,则此项不会返回)

取值范围:

不涉及

size

Long

参数解释:

数据量大小

取值范围:

不涉及

表12 preprocessor

参数

参数类型

描述

id

Long

算子id

resource_spec

String

作业所需资源规格

envs

Array of JobEnv objects

环境变量(没有配置环境变量,则此项不返回)

表13 JobEnv

参数

参数类型

描述

key

String

参数解释:

环境变量键

约束限制:

不能重复,配置环境变量时此项必填

取值范围:

不涉及

默认取值:

不涉及

value

String

参数解释:

环境变量值

约束限制:

配置环境变量时此项必填

取值范围:

不涉及

默认取值:

不涉及

表14 modelsDataCollectingVideos

参数

参数类型

描述

name

String

参数解释:

视频名称

取值范围:

不涉及

format

String

参数解释:

视频格式

取值范围:

不涉及

表15 RespMetaInfo

参数

参数类型

描述

current_time

String

参数解释:

请求时间,UTC时间格式,时间为UTC标准时间

取值范围:

不涉及

请求示例

获取数据包详情

GET https://{endpoint}/v1.0/{project_id}/data/packages/DPK0000001

响应示例

状态码:200

查询成功

{
  "meta_info" : {
    "current_time" : "2022-01-01T08:08:29Z"
  },
  "payload" : {
    "item" : {
      "id" : "DPK0000001",
      "user_id" : "087679f0aaxxxxxxxxxxxxxx2f5e902b",
      "project_id" : "087679f0aaxxxxxxxxxxxxxx2f5e902b",
      "dcl_id" : "DCL0000000000001",
      "status" : "NORMAL",
      "name" : "package1",
      "data_type" : "ROSBAG",
      "data_source" : "OBS",
      "storage_size" : 2882433681,
      "vehicle_id" : 228,
      "create_at" : 1701312661439,
      "update_at" : 1701313102802,
      "collection_info" : {
        "cardrive" : {
          "station" : "my_station",
          "car" : {
            "vehicle_name" : "test"
          },
          "route" : "my_route",
          "mode" : "auto",
          "description" : "",
          "collect_time" : "2022-11-01T08:00:00+08:00"
        },
        "preprocessor" : {
          "id" : 10276,
          "resource_spec" : "4Core_8GiB"
        },
        "folders" : {
          "camera" : [ {
            "name" : "camera_1",
            "format" : "jpg",
            "size" : 159355710
          } ],
          "lidar" : [ {
            "name" : "lidar",
            "format" : "pcd",
            "size" : 1143818860
          } ],
          "gnss" : [ {
            "name" : "gnss",
            "format" : "proto3",
            "size" : 3570
          } ]
        },
        "data_type" : 3
      },
      "tag_ids" : [ 11, 222 ]
    }
  }
}

状态码

状态码

描述

200

查询成功

400

请求参数错误

403

权限校验失败

404

找不到请求的资源

500

系统内部错误

错误码

请参见错误码。

相关文档