华为云用户手册

AR地图运行服务错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 NAVI.0002 Navi failed, please check parameters. 导航失败。 检查参数是否正确或联系技术支持。 400 NAVI.0003 Invalid parameters. 导航算法服务参数不正确。 检查参数是否正确。 400 NAVI.0004 Access denied, out of your service zone. 导航参数不正确，位置不在你的服务区。 到有服务的地方请求或联系技术支持。 400 VPS.0002 VPS failed. 空间定位算法服务定位错误。 检查参数是否正确或请联系技术支持。 400 VPS.0003 Invalid parameters. 空间定位算法服务请求参数不正确。 检查参数是否正确。 400 VPS.0004 Access denied, out of your service zone. 空间定位算法服务参数不正确，位置不在你的服务区。 到有服务的地方请求或联系技术支持。 403 GATEWAY.0002 Auth failed, please check your auth token. 鉴权header未携带。 在请求头中携带鉴权信息，参考“如何调用API”。 403 GATEWAY.0003 Service unavailable. 服务未开通/冻结。 开通/购买服务，检查服务是否被冻结或联系技术支持。 403 GATEWAY.0005 IAM auth deny, you don't have the permission of this action. IAM鉴权失败，没有action的访问权限。 为IAM用户添加此服务对应的操作权限。 429 GATEWAY.0006 Too many requests. 触发网关限流。 降低访问频率或开通更高QPS规格的服务。 500 GATEWAY.0001 Open gateway system inner error. 网关内部错误。 请联系技术支持。 500 NAVI.0001 Navi internal server error. 导航算法服务错误。 请联系技术支持。 500 VPS.0001 Internal server error. 空间定位算法服务错误。 请联系技术支持。 502 GATEWAY.0007 Service timeout. 服务超时。 请联系技术支持。

请求示例 校验原始影像文件。 POST https://{Endpoint}/v1/kmp-control/tasks/image { "data_ids" : [ "142ffd14e65048f39cdcccf5005d649a", "853499857b47411da21c628ba2ece325" ], "production_level" : "L2", "task_name" : "test", "coordination" : "WGS84" }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 data_ids 是 Array of strings 影像文件ID集合。 production_level 是 String 处理等级，当前支持以下等级： L2、L3、L4、L5。 task_name 是 String 任务名称。 coordination 是 String 坐标系。

响应示例 状态码： 200 请求成功。 [ { "name" : "GF1_20160908_E117.3_N38.9_L2", "data_id" : null, "error_message" : null } ] 状态码： 400 非法请求。 [ { "name" : null, "data_id" : "3f7eb40cf46d45fd96a927361c5718f1", "error_message" : "卫星型号不一致" } ]

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of CheckImageResultDto objects 请求成功。 表4 CheckImageResultDto 参数 参数类型 描述 name String 影像文件名。 最小长度：32 最大长度：36 data_id String 影像文件ID。 error_message String 错误提示。 状态码： 400 表5 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID，用于运维人员定位请求日志。 表6 响应Body参数 参数 参数类型 描述 [数组元素] Array of CheckImageResultDto objects 非法请求。 表7 CheckImageResultDto 参数 参数类型 描述 name String 影像文件名。 最小长度：32 最大长度：36 data_id String 影像文件ID。 error_message String 错误提示。 状态码： 500 表8 响应Header参数 参数 参数类型 描述 X-request-id String 请求ID，用于运维人员定位请求日志。 表9 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

创建组织 登录CraftArts IPDCenter控制台。 在左侧菜单栏选择“服务管理”，进入“服务管理”页面。 单击“创建组织”，输入组织名称，单击“下一步”。 组织名称由1-60个中文、英文、数字及合法字符组成。 图1 创建组织 在“设置组织的域名”页面，设置组织的域名。 没有域名，输入域名，单击“下一步”。 已有域名，单击“使用自有域名”，输入自有域名，如example.com，单击“下一步”。 图2 设置域名 阅读“管理式华为账号”相关声明，单击“同意”创建组织。

操作步骤 进入购买CraftArts IPDCenter页面。 单击“立即购买”，选择商品及商品配置项。 表1 商品及商品配置项 商品 配置项 说明 产品主数据协同服务-基础版 基础服务 区域 资源所在区域。 计费模式 商品的计费模式。 用户环境 根据您的使用场景，对用户环境进行标志，比如：xx研发生产环境，xx研发测试环境等。只能包含中文、英文字母、数字、“_”、“-”，最大长度64字符。 企业项目 此处调取您所在组织设置的企业项目信息，用于订单的费用管理。 用户数 最小配额为100，最大配额为8000。 购买时长 提供包月、包年多种规格，您可按需选择。支持自动续费。 首次购买产品数字化协同平台云服务，默认配套购买基础服务。 单击“立即购买”，查看订单信息，确认无误后，按照界面提示选择支付方式完成付款。

响应参数 状态码： 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（运行中） SUC CES S（运行成功） 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 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 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 }

请求示例 该请求示例用于创建一个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" }

请求参数 表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

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "spurInfos" : [ { "imageCode" : "1674019035390013440", "id" : "1676151290921086976", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" }, { "imageCode" : "1674019035390013440", "id" : "1674395911112953856", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "9274.5957", "pointHeight" : "2941.47803", "longitude" : "113.8800482786927", "latitude" : "22.8771672263087", "height" : "37.976999999999997", "accuracy" : "0.05" }, { "imageCode" : "1674019035390013440", "id" : "1674394962671767552", "taskId" : "db554dbd410f4c53a2118c6e34a31eb0", "pointWidth" : "7864.08984", "pointHeight" : "5433.04541", "longitude" : "113.87890565212626", "latitude" : "22.876653471049696", "height" : "37.884999999999998", "accuracy" : "0.05" } ], "page" : { "offset" : -1, "limit" : 10, "total" : 3 } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 spurInfos Array of SpurInfoDetail objects 刺点信息列表。 page Page object 分页信息。 表4 SpurInfoDetail 参数 参数类型 描述 imageCode String 图像ID。 id String 刺点ID。 taskId String 刺点所属任务ID。 pointWidth String 刺点在图片中的横向像素值。 pointHeight String 刺点在图片中的纵向像素值。 longitude String 像控点经度。 latitude String 像控点纬度。 height String 像控点高度。 accuracy String 像控点精度。 表5 Page 参数 参数类型 描述 offset Integer 偏移量，表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 imageCode 是 String 图片ID。 taskId 是 String 刺点所属的任务ID。 offset 否 Integer 偏移量。 最小值：0 最大值：2147483647 缺省值：0 limit 否 Integer 分页大小。 最小值：1 最大值：100 缺省值：10

响应参数 状态码： 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 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

请求示例 该请求更新建模的任务类型、输入的影像ID。 PUT https://{Endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks/914305233ef7428e8073a95d8042fxxx { "task_type" : "REAL3D-CTRL", "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgpxxx" }

响应示例 状态码： 200 请求成功。 { "task_id" : "914305233ef7428e8073a95d8042fxxx", "task_name" : "测试任务1685087027834", "task_type" : "REAL3D-CTRL", "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-YqeZDWfgpxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T07:52:58Z", "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 }

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

请求示例 该请求查询单个像控点已经刺点的数量。 POST https://{Endpoint}/v1/real3d/spur/count { "taskId" : "41f72c882cc747a88f90151b1af18292", "longitude" : 9.24242349, "latitude" : 12.718883191, "height" : 3.247742033, "accuracy" : 0.05 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token信息，用于租户鉴权，该字段由租户请求IAM的Token接口获得。 表2 请求Body参数 参数 是否必选 参数类型 描述 taskId 是 String 任务ID longitude 是 String 像控点经度。要求为WGS84地理坐标系。 latitude 是 String 像控点纬度。要求为WGS84地理坐标系。 height 是 String 像控点高度。要求为WGS84地理坐标系。 accuracy 是 String 像控点精度。范围：(0, 100)。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 像控点在图片上已刺点的数量。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功。 { "tasks" : [ { "task_id" : "914305233ef7428e8073a95d8042fxxx", "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, "center_x_offset" : 0, "center_y_offset" : 0, "center_z_offset" : 0, "mesh_accuracy" : 0, "is_calibration" : true, "blend_intensity" : 0, "compress_accuracy" : 0, "intp_accuracy" : 0 }, "coordinate_sys" : "WGS84-UTM", "has_marker" : false, "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgpxxx", "create_time" : "2023-05-26T07:43:47Z", "update_time" : "2023-05-26T08:00:00Z", "tenant_domain_id" : "xxxx", "creator" : "xxxx", "latest_operator" : "xxxx", "task_status" : "SUCCESS", "complete_stage" : 10, "total_stage" : 10, "exec_start_time" : "2023-05-26T07:57:00Z", "task_progress" : "1.00", "exec_stop_time" : "2023-05-26T08:00:00Z", "fail_message" : null, "AT_progress" : null } ], "page" : { "offset" : 0, "limit" : 2, "total" : 1 } }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 tasks Array of Real3DTaskDto objects 任务列表。 page Page object 分页信息。 表5 Real3DTaskDto 参数 参数类型 描述 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 表7 Page 参数 参数类型 描述 offset Integer 偏移量，表示从第几条数据开始查询。 limit Integer 每页包含的查询记录数量。 total Integer 符合查询条件的记录总数。 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

功能介绍 对单个工作共享空间内的任务进行分页查询，支持过滤条件： 任务名称（task_name）：支持模糊查询。 任务类型（task_type）：支持REAL3D-UNCTRL和REAL3D-CTRL。 建模类型（modeling_type）：支持Mesh和Nerf。 任务ID（task_ids）：支持同时过滤多个任务ID。 任务状态（task_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 表1 路径参数 参数 是否必选 参数类型 描述 workspace_id 是 String 工作共享空间ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量。查询时忽略的记录数量。 最小值：0 最大值：2147483647 缺省值：0 limit 否 Integer 分页大小。 最小值：1 最大值：100 缺省值：10 task_name 否 String 任务名称。支持中文、英文、数字以及“_”字符，长度限制1~50个字符。支持模糊查询。 task_type 否 Array 任务类型。支持过滤多种任务类型。 modeling_type 否 String 建模类型。支持Mesh和Nerf。 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'。 task_ids 否 Array 根据任务ID查询。支持过滤多个任务ID。 task_status 否 Array 根据任务状态查询。支持过滤多个任务状态。

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表4 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

响应参数 状态码： 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 请求状态码。 最小长度：3 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 请求状态码。 最小长度：3 最大长度：36 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）。