更新时间:2024-05-17 GMT+08:00
分享

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

功能介绍

该接口用于启动精修后处理任务。该接口运行成功后,任务状态更新为等待中(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

服务内部错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品