文档首页/ 云地图服务 KooMap/ API参考/ API/ 实景三维精修后处理任务管理/ 分页查询实景三维精修后处理任务列表
更新时间：2024-05-17 GMT+08:00
查看PDF
分享

分页查询实景三维精修后处理任务列表

功能介绍

对单个实景三维建模任务内的精修后处理任务进行分页查询，支持过滤条件：

  • 实景三维精修后处理任务ID（subtask_id）：支持根据ID查询特定精修后处理任务。

  • 实景三维精修后处理任务别名（subtask_name）：支持根据精修后处理任务别名进行模糊查询。

  • 实景三维精修后处理任务状态（subtask_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/{task_id}/subtasks

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

是

String

工作共享空间ID。

task_id

是

String

原始实景三维建模任务ID。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

偏移量。

最小值：0

最大值：2147483647

缺省值：0

limit

否

Integer

分页大小。

最小值：1

最大值：100

缺省值：10

subtask_id

否

String

精修后处理任务ID。

subtask_name

否

String

精修后处理任务别名，支持模糊查询。

subtask_status

否

Array

根据精修后处理任务状态查询，支持输入多个状态。

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'。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

subtasks

Array of Real3DSubTaskDto objects

精修后处理任务列表。

page

Page object

分页信息。
表5 Real3DSubTaskDto

参数

参数类型

描述

subtask_id

String

实景三维精修后处理任务ID。

task_id

String

原始实景三维建模任务ID。

subtask_name

String

精修后处理任务别名。

task_name

String

原始实景三维建模任务名称。

workspace_id

String

原始实景三维建模任务所属工作共享空间ID。

modeling_params

ModelingParams object

原始实景三维建模任务建模参数列表。

subtask_status

String

实景三维精修后处理任务当前状态。

  • INIT（初始化）

  • UPLOADING（上传中）

  • UPLOAD_SUCCESS（上传成功）

  • UPLOAD_FAILED（上传失败）

  • PENDING（等待中）

  • STARTING（启动中）

  • START_FAILED（启动失败）

  • RUNNING（运行中）

  • SUCCESS（运行成功）

  • FAILED（运行失败）

  • STOPPING（停止中）

  • STOP_SUCCESS（已停止）

model_path

String

模型数据上传路径。

refine_product_id

String

精修后处理任务成果数据ID。

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

精修后处理任务最近操作人。

subtask_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

失败消息。当精修后处理任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。
表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

请求示例

该请求分页查询任务ID为914305233ef7428e8073a95d8042fxxx的精修后处理任务列表，从第0个任务开始，查询2个任务。

https://{endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks/914305233ef7428e8073a95d8042fxxx/subtasks?limit=2&offset=0

响应示例

状态码： 200

请求成功。

{
  "subtasks" : [ {
    "subtask_id" : "914305233ef7428e8073a95d8042fxxx",
    "task_id" : "aaaaa30b6c5f42cfaf49e01eb690xyyy",
    "subtask_name" : "精修后处理任务别名",
    "task_name" : "测试任务1685087027834",
    "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx",
    "modeling_params" : {
      "accuracy" : "High",
      "key_point_limit" : "40000",
      "tie_point_limit" : "4000",
      "mesh_accuracy" : "0"
    },
    "subtask_status" : "INIT",
    "model_path" : "obs://real3d/real3d/xxx",
    "refine_product_id" : "914305233ef7428e8073a95d8042fxxx",
    "create_time" : "2023-05-26T07:43:47Z",
    "update_time" : "2023-05-26T07:52:58Z",
    "tenant_domain_id" : "xxxx",
    "creator" : "xxxx",
    "latest_operator" : "xxxx",
    "subtask_progress" : null,
    "exec_start_time" : null,
    "exec_stop_time" : null,
    "fail_message" : null
  } ],
  "page" : {
    "offset" : 0,
    "limit" : 2,
    "total" : 1
  }
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

500

服务内部错误。

错误码

请参见错误码。

相关文档