云服务器内容精选

  • 响应示例 状态码: 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 表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
  • 功能介绍 对单个实景三维建模任务内的精修后处理任务进行分页查询,支持过滤条件: 实景三维精修后处理任务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)。
  • 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'。