文档首页/ 自动驾驶云服务 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

系统内部错误

错误码

请参见错误码

相关文档