云服务器内容精选

  • 响应示例 状态码: 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" }
  • 响应参数 状态码: 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 错误码。格式为: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