文档首页> 云地图服务 KooMap> API参考> API> 实景三维任务管理> 分页查询工作共享空间内实景三维任务列表
更新时间：2024-05-17 GMT+08:00
查看PDF
分享

分页查询工作共享空间内实景三维任务列表

功能介绍

对单个工作共享空间内的任务进行分页查询，支持过滤条件：

  • 任务名称（task_name）：支持模糊查询。

  • 任务类型（task_type）：支持REAL3D-UNCTRL和REAL3D-CTRL。

  • 建模类型（modeling_type）：支持Mesh和Nerf。

  • 任务ID（task_ids）：支持同时过滤多个任务ID。

  • 任务状态（task_status）：支持同时过滤多个任务状态。

  • 创建时间范围（create_time_from和create_time_to）：为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。

  • 更新时间范围（update_time_from和update_time_to）：为UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。

  • 分页参数：偏移量offset（缺省值为0）、每页数量limit（缺省值为10）。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/real3d/{workspace_id}/tasks

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

是

String

工作共享空间ID。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

偏移量。查询时忽略的记录数量。

最小值：0

最大值：2147483647

缺省值：0

limit

否

Integer

分页大小。

最小值：1

最大值：100

缺省值：10

task_name

否

String

任务名称。支持中文、英文、数字以及“_”字符，长度限制1~50个字符。支持模糊查询。

task_type

否

Array

任务类型。支持过滤多种任务类型。

modeling_type

否

String

建模类型。支持Mesh和Nerf。

create_time_from

否

String

任务创建起始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

create_time_to

否

String

任务创建截止时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

update_time_from

否

String

任务更新起始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

update_time_to

否

String

任务更新截止时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

task_ids

否

Array

根据任务ID查询。支持过滤多个任务ID。

task_status

否

Array

根据任务状态查询。支持过滤多个任务状态。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

tasks

Array of Real3DTaskDto objects

任务列表。

page

Page object

分页信息。
表5 Real3DTaskDto

参数

参数类型

描述

task_id

String

任务ID。

task_name

String

任务名称。

task_type

String

任务类型。

  • REAL3D-UNCTRL（无控建模）

  • REAL3D-CTRL（有控建模）

modeling_type

String

建模类型。

  • Mesh：纹理模型实景三维建模。

  • Nerf：显式辐射场实景三维建模。

task_description

String

任务描述。

workspace_id

String

任务所属工作共享空间ID。

modeling_params

ModelingParams object

任务建模参数列表。

coordinate_sys

String

建模坐标系。

has_marker

Boolean

是否添加了刺点。

folder_code

String

任务绑定的倾斜影像的影像code。

create_time

String

任务创建时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

update_time

String

任务更新时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

tenant_domain_id

String

华为云IAM租户账号ID。

creator

String

任务创建人。

latest_operator

String

任务最近操作人。

task_status

String

任务当前状态。

  • INIT（初始化）

  • PENDING（等待中）

  • STARTING（启动中）

  • START_FAILED（启动失败）

  • RUNNING（运行中）

  • SUCCESS（运行成功）

  • FAILED（运行失败）

  • STOPPING（停止中）

  • STOP_SUCCESS（已停止）

  • ARCHIVED（已归档）

  • BUNDLE_SUCCESS（空三建模成功）

complete_stage

Integer

建模已完成作业步骤数。

total_stage

Integer

建模总作业步骤数。

task_progress

String

任务进度。该字段为字符串表示的保留两位小数的浮点型数值，取值范围：0.00~1.00。

exec_start_time

String

任务执行开始时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

exec_stop_time

String

任务执行结束时间。格式为UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z'。

fail_message

String

失败消息。当任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。

AT_progress

String

空三建模进度，取值范围：0.00~1.00。展示有控建模任务空三建模阶段的执行进度。因为空三建模仅在有控建模任务中执行，无控建模任务中该字段取值始终为null。
表6 ModelingParams

参数

参数类型

描述

accuracy

String

空三精度。取值包括：Highest、High、Medium、Low、Lowest。

缺省值：High

key_point_limit

Integer

空三关键点数量。取值范围：1000~1000000。

缺省值：40000

tie_point_limit

Integer

空三连接点数量。取值范围：100~100000。

缺省值：4000

mesh_accuracy

Integer

Mesh重建质量。枚举值：

  • 0：高

  • 1：中

  • 2：低

缺省值：0
表7 Page

参数

参数类型

描述

offset

Integer

偏移量，表示从第几条数据开始查询。

limit

Integer

每页包含的查询记录数量。

total

Integer

符合查询条件的记录总数。

状态码： 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为：KMP.XXXXXXXX，其中X表示数字。

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：2

最大长度：512

状态码： 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为：KMP.XXXXXXXX，其中X表示数字。

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：2

最大长度：512

请求示例

该请求分页查询工作共享空间内的任务，从第0个任务开始，查询2个任务。

GET https://{Endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks?limit=2&offset=0

响应示例

状态码： 200

请求成功。

{
  "tasks" : [ {
    "task_id" : "914305233ef7428e8073a95d8042fxxx",
    "task_name" : "测试任务1685087027834",
    "task_type" : "REAL3D-UNCTRL",
    "modeling_type" : "Nerf",
    "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx",
    "modeling_params" : {
      "accuracy" : "High",
      "key_point_limit" : 40000,
      "tie_point_limit" : 4000,
      "center_x_offset" : 0,
      "center_y_offset" : 0,
      "center_z_offset" : 0,
      "mesh_accuracy" : 0,
      "is_calibration" : true,
      "blend_intensity" : 0,
      "compress_accuracy" : 0,
      "intp_accuracy" : 0
    },
    "coordinate_sys" : "WGS84-UTM",
    "has_marker" : false,
    "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgpxxx",
    "create_time" : "2023-05-26T07:43:47Z",
    "update_time" : "2023-05-26T08:00:00Z",
    "tenant_domain_id" : "xxxx",
    "creator" : "xxxx",
    "latest_operator" : "xxxx",
    "task_status" : "SUCCESS",
    "complete_stage" : 10,
    "total_stage" : 10,
    "exec_start_time" : "2023-05-26T07:57:00Z",
    "task_progress" : "1.00",
    "exec_stop_time" : "2023-05-26T08:00:00Z",
    "fail_message" : null,
    "AT_progress" : null
  } ],
  "page" : {
    "offset" : 0,
    "limit" : 2,
    "total" : 1
  }
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

500

服务内部错误。

错误码

请参见错误码。

分享：

    相关文档

    相关产品