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

启动实景三维精修后处理任务

功能介绍

该接口用于启动精修后处理任务。该接口运行成功后，任务状态更新为等待中（PENDING），此时任务添加到启动队列中等待运行资源就绪，资源就绪后状态更新为启动中（STARTING），启动成功后状态更新为运行中（RUNNING），若启动失败则状态更新为启动失败（START_FAILED）。

精修后处理任务允许启动的状态为：上传成功（UPLOAD_SUCCESS）、已停止（STOP_SUCCESS）、运行失败（FAILED）。

调试

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

URI

POST /v1/real3d/{workspace_id}/tasks/{task_id}/subtasks/{subtask_id}/start

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

是

String

工作共享空间ID。

task_id

是

String

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

subtask_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

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

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

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

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

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：2

最大长度：512

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

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

最小长度：12

最大长度：12

error_msg

String

错误描述。

最小长度：2

最大长度：512

请求示例

该请求用于启动精修后处理任务。

https://{endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks/914305233ef7428e8073a95d8042fxxx/subtasks/abc305233ef7428e8073a95d8042fxxx/start

{ }

响应示例

状态码： 200

请求成功。

{
  "subtask_id" : "914305233ef7428e8073a95d8042fxxx",
  "task_id" : "914305233ef7428e8073a95d8042fxxx",
  "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
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

500

服务内部错误。

错误码

请参见错误码。

分享：

    相关文档

    相关产品