华为云用户手册

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 folders Array of FolderVo objects 文件夹列表。 page Page object 分页信息。 表5 FolderVo 参数 参数类型 描述 folder_code String 倾斜影像的唯一标识。 folder_name String 倾斜影像名称。 folder_alias String 倾斜影像别名。 folder_desc String 倾斜影像描述。 obs_endpoint String 倾斜影像所在OBS的Endpoint。 obs_path String 倾斜影像所在OBS的目录地址。 create_time String 倾斜影像上传时间。 status Integer 倾斜影像状态。 0：处理中 1：已完成 2：导入失败 表6 Page 参数 参数类型 描述 offset Integer 偏移量，表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "folders" : [ { "folder_code" : "16565875049557xxxx", "folder_name" : "xxxx", "folder_alias" : "xxxx", "folder_desc" : "xxxx", "obs_endpoint" : "obs.xxxx.myhuaweicloud.com", "obs_path" : "real3d/xxxxx/real-test", "create_time" : "2023-05-11 17:10:13.000", "status" : 1 }, { "folder_code" : "16558314669791xxxx", "folder_name" : "xxxx", "folder_alias" : "xxxx", "folder_desc" : "xxxx", "obs_endpoint" : "obs.xxxx.myhuaweicloud.com", "obs_path" : "real3d/xxxxxx/test-image-source", "create_time" : "2023-05-09 15:06:00.000", "status" : 1 } ], "page" : { "offset" : 0, "limit" : 10, "total" : 2 } }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 offset 是 Integer 偏移量，表示从第几条记录开始查询。 limit 是 Integer 每页显示条数。 condition 否 FolderQueryCondition object 查询条件。 表3 FolderQueryCondition 参数 是否必选 参数类型 描述 folder_name 否 String 倾斜影像名称。支持中文、英文、数字以及“_”、“-”、“.”字符，长度限制为[1, 100]。 folder_alias 否 String 倾斜影像别名。支持中文、英文、数字以及“_”、“-”、“.”字符，长度限制为[1, 100]。 folder_desc 否 String 倾斜影像描述。支持中文、英文、数字以及“_”、“-”、“.”字符，长度限制为[0, 255]。 from 否 String 倾斜影像上传起始时间。格式为UTC标准时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 to 否 String 倾斜影像上传结束时间。格式为UTC标准时间：yyyy-MM-dd'T'HH:mm:ss'Z'。 status 否 String 倾斜影像状态。当前仅支持处理中（0）、已完成（1）、导入失败（2）。 order 否 String 倾斜影像排序规则。 当前仅支持影像名称正序（1）、影像名称倒序（-1）、影像别名正序（2）、影像别名倒序（-2）、影像上传日期正序（3）、影像上传日期倒序（-3）。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 data Array of WorkspaceDto objects 工作共享空间列表。 page Page object 分页信息。 表4 WorkspaceDto 参数 参数类型 描述 workspace_id String 工作共享空间ID。 workspace_name String 工作共享空间名称。 workspace_description String 工作共享空间描述。 tenant_domain_id String 华为云IAM租户账号ID。 creator String 创建人。 latest_operator String 最近修改人。 create_time String 创建时间。返回UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 update_time String 更新时间。返回UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 star Integer 工作共享空间是否置顶显示（最多可置顶4个）。 can_delete Boolean 工作共享空间是否允许删除标志位。当工作共享空间置顶显示或者该空间下存在任务时，取值为“true”，表示不可以删除。 表5 Page 参数 参数类型 描述 offset Integer 偏移量，表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

URI GET /v1/workspaces 表1 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量。查询时忽略的记录数量。 最小值：0 最大值：2147483647 缺省值：0 limit 否 Integer 分页大小。 最小值：1 最大值：100 缺省值：10 workspace_ids 否 Array 根据工作共享空间ID查询。 workspace_name 否 String 工作共享空间名称。支持模糊查询。 star 否 Boolean 工作共享空间是否置顶显示（最多可置顶4个）。 0：否 1：是 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'。 order_by 否 String 排序字段。置顶空间默认排列在列表最前面，并且根据该排序字段组合排序。 create_time_asc：按照创建时间升序排列。 create_time_desc：按照创建时间降序排列。

响应示例 状态码： 200 请求成功。 { "data" : [ { "workspace_id" : "8c008cabac124f74ad7deba48e1bdf7a", "workspace_name" : "测试空间1", "workspace_description" : "空间描述", "creator" : "xxxx", "latest_operator" : "xxxx", "create_time" : "2023-05-23T07:57:14Z", "update_time" : "2023-05-23T07:57:14Z", "star" : 0, "can_delete" : false }, { "workspace_id" : "cd8a29375dc0452889e3cce805bace1d", "workspace_name" : "测试空间2", "workspace_description" : "空间描述", "creator" : "xxxx", "latest_operator" : "xxxx", "create_time" : "2023-05-23T07:36:30Z", "update_time" : "2023-05-23T07:36:30Z", "star" : 0, "can_delete" : true } ], "page" : { "offset" : 0, "limit" : 2, "total" : 12 } }

功能介绍 该接口用于分页查询工作共享空间列表，支持过滤条件： 工作共享空间名称（workspace_name）：支持模糊查询。 工作共享空间是否置顶显示：最多可置顶4个工作共享空间。 创建时间范围（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）。

响应参数 状态码： 400 表3 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID，用于运维人员定位请求日志。 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID，用于运维人员定位请求日志。 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求示例 新建处理任务，目前只支持卫星影像处理任务（ORSIP）。 POST https://{Endpoint}/v1/kmp-control/tasks { "task_name": "这是任务描述", "task_type": "ORSIP", "data_ids": [ "ed9313d537dd4cf7a6a7758f9xxxxd84", "8dc0d6187b8e4f429c2d20d34xxxxx5a" ], "production_level": "L2", "task_description": "这是任务描述", "workspace_id": "dfa3527b45a24de6a2d0ddbcb8xxxxxx", "shape_id": null, "data_alias": { "JL1_20160112_203_0018_L2": "JL1_20160112_203_0018_L2" }, "coordination": "WGS84", "data_description": { "JL1_20160112_203_0018_L2": null }, "csv_ids": [3cd09e0xbf7949a59c9ec14012a4xxxx], "is_clip": "0", "is_tile": "0" }

响应示例 状态码： 200 请求成功。 { "task_id" : "4d40e927514a40898d23a20155xxxxxx", "workspace_id" : "dfa3527b45a24de6a2d0ddbcb8xxxxxx", "data_id" : "[\"ed9313d537dd4cf7a6a7758f942xxxxx\",\"8dc0d6187b8e4f429c2d20d340xxxxxa\"]", "task_name" : "测试", "domain_id" : "234602bf93714dcba145eaa45xxxxxxx", "creator" : "xxxxx", "create_time" : "2023-02-17T09:27:07Z", "task_status" : "INIT", "task_type" : "ORSIP", "task_description" : "测试", "exec_start_time" : null, "exec_stop_time" : null, "origin_data_alias" : null, "production_level" : "L2", "task_progress" : "0.0", "shape_id" : null, "is_deleted" : 0, "image_url" : null, "frozen_tag" : null, "is_clip" : "0", "is_tile" : "0" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 task_id String 任务唯一标识ID。 最小长度：32 最大长度：36 workspace_id String 工作共享空间ID。 data_id String 数据ID。 task_name String 任务名称。 最小长度：2 最大长度：64 creator String 创建者ID。 最小长度：2 最大长度：512 create_time String 创建时间。 task_status String 任务状态。包括INIT（初始化）、RUNNING（运行中）、SUC CES S（执行成功）、ARCHIVED（已归档）、FAILED（执行失败）、STOPPING（停止中）、STOP_SUCCESS（已停止）、STOP_FAILED（停止失败）、START_RUNNING（等待中）。 task_type String 任务类型。 当前仅支持ORSIP（卫星影像生产）。 task_description String 任务描述。 exec_start_time String 开始操作时间。 缺省值：null exec_stop_time String 停止操作时间。 缺省值：null origin_data_alias String 原始数据别名。 production_level String 任务输出结果影像级别，当前支持以下级别： L2、L3、L4、L5。 task_progress String 任务执行进度。 shape_id String 矢量数据文件ID，“isClip”为“1”时必填。 is_deleted Integer 是否删除。 0：未删除 1：已删除 image_url String 影像链接。 domain_id String 华为云IAM租户账号ID。 fail_message String 任务失败原因。 frozen_tag String 任务冻结状态。当前仅支持frozen（冻结中）。 isClip String 是否为矢量切割。 0：否 1：是 isTile String 是否为金字塔切割。 0：否 1：是 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求示例 该请求示例用于创建一个REAL3D-UNCTRL（无控建模）任务。 POST https://{Endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks { "task_name" : "测试任务", "task_description" : "测试任务", "task_type" : "REAL3D-UNCTRL", "modeling_type" : "Nerf", "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgxxxx", "coordinate_sys" : "WGS84-UTM" }

响应示例 状态码： 200 请求成功。 { "task_id" : "914305233ef7428e8073a95d8042xxxx", "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", "mesh_accuracy" : "0" }, "coordinate_sys" : "WGS84-UTM", "has_marker" : false, "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgxxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T07:43:47Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "task_status" : "INIT", "complete_stage" : null, "total_stage" : null, "exec_start_time" : null, "task_progress" : null, "exec_stop_time" : null, "fail_message" : null, "AT_progress" : null }

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 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 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表3 请求Body参数 参数 是否必选 参数类型 描述 task_name 是 String 任务名称。支持中文、英文、数字以及“_”字符，长度限制1~50个字符。 task_description 否 String 任务描述。支持中文、英文、数字以及“_”字符，长度限制255个字符以内。 task_type 否 String 任务类型。 REAL3D-CTRL：实景三维有控建模 REAL3D-UNCTRL：实景三维无控建模 modeling_type 否 String 建模类型。 Mesh：纹理模型实景三维建模。 Nerf：显式辐射场实景三维建模。 modeling_params 否 ModelingParams object 实景三维建模参数。 当请求体中modeling_params为null或者未配置时，其属性均使用缺省值。 当请求体中modeling_params不为null时，则其属性均为必填项，不能省略。 folder_code 否 String 需要进行三维重建的倾斜影像的影像code。 coordinate_sys 否 String 建模坐标系。坐标系当前仅支持WGS84-UTM。输入为null或者不填时，均使用缺省值WGS84-UTM。 表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

响应参数 状态码： 200 表4 响应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 失败消息。当精修后处理任务执行失败时，该字段显示任务的失败原因，用于辅助定位问题。 表5 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 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "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 }

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 workspace_name 是 String 工作共享空间名称。支持中文、英文、数字以及“_”字符，长度限制2~50个字符。 workspace_description 否 String 工作共享空间描述。支持中文、英文、数字以及“_”字符，长度限制200个字符以内。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 workspace_id String 工作共享空间ID。 workspace_name String 工作共享空间名称。 workspace_description String 工作共享空间描述。 tenant_domain_id String 华为云IAM租户账号ID。 creator String 创建人。 latest_operator String 最近修改人。 create_time String 创建时间。返回UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 update_time String 更新时间。返回UTC时间格式字符串，格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 star Integer 工作共享空间是否置顶显示（最多可置顶4个）。 can_delete Boolean 工作共享空间是否允许删除标志位。当工作共享空间置顶显示或者该空间下存在任务时，取值为“true”，表示不可以删除。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "workspace_id" : "3eceb0cb8b834f5bb0a66d4108c2067f", "workspace_name" : "测试空间", "workspace_description" : "空间描述", "creator" : "xxxx", "latest_operator" : "xxxx", "create_time" : "2023-05-23T07:26:28Z", "update_time" : "2023-05-23T07:26:28Z", "star" : 0, "can_delete" : false }

响应示例 状态码： 200 请求成功。 { "imageCode" : "1674019035390013440", "id" : "1676151290921086976", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 imageCode String 图像ID。 id String 刺点ID。 taskId String 刺点所属任务ID。 pointWidth String 刺点在图片中的横向像素值。 pointHeight String 刺点在图片中的纵向像素值。 longitude String 像控点经度。 latitude String 像控点纬度。 height String 像控点高度。 accuracy String 像控点精度。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。格式为：KMP.XXXXXXXX，其中X表示数字。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：2 最大长度：512

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 imageCode 是 String 图片ID。 taskId 是 String 刺点所属任务ID。 pointWidth 是 String 刺点在图片中的横向像素值，以分块左上角为原点，不能超过图片范围。 pointHeight 是 String 刺点在图片中的纵向像素值，以分块左上角为原点，不能超过图片范围。 longitude 是 String 像控点经度。范围：[-10000000, 10000000]。 latitude 是 String 像控点纬度。范围：[-10000000, 10000000]。 height 是 String 像控点高度。范围：[-10000000, 10000000]。 accuracy 是 String 像控点精度。范围：(0, 100)。