云服务器内容精选

  • 响应示例 状态码: 200 请求成功。 { "products" : [ { "id" : "b6fbb5c6b7ba4b89aaeadfaba3df7xxx", "name" : "AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445", "status" : "preparing", "folder_code" : "fa693df75e0e47c88c8eefb2c639axxx", "folder_info" : "{\"folder_name\":\"AUTO_api_1981c24729f611ee947ef86365693xxx\",\"folder_alias\":\"19ae9fbb29f611ee98dff863656935b3\",\"create_time\":\"2023-07-24T07:46:18Z\",\"folder_desc\":\"api\"}", "task_info" : "{\"task_exec_end_time\":\"2023-07-28T02:34:21Z\",\"task_exec_start_time\":\"2023-07-28T01:53:00Z\",\"task_id\":\"db9743d353c741478fd4cfc725081a6f\",\"task_name\":\"546454\",\"task_params\":\"{\\\"accuracy\\\":\\\"High\\\",\\\"mesh_accuracy\\\":\\\"1\\\",\\\"key_point_limit\\\":\\\"40000\\\",\\\"tie_point_limit\\\":\\\"4000\\\"}\",\"task_status\":\"SUC CES S\",\"task_type\":\"REAL3D-UNCTRL\"}", "product_details" : [ { "type" : "mesh_osgb", "storage_size_byte" : 0, "files" : [ "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+000~+000.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+001~+001.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+002~+002.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+003~+003.zip", "MESH_OSGB_AUTO_api_1981c24729f611ee947ef863656935b3_546454_20230728103445-Tile_+004~+004.zip" ] }, { "type" : "mesh_obj", "storage_size_byte" : 0, "files" : [ ] } ], "storage_size_byte" : null, "create_time" : "2023-07-28T02:34:45Z", "update_time" : "2023-07-28T02:34:45Z", "tenant_domain_id" : "234602bf93714dcba145eaa45686exxx" } ], "page" : { "offset" : 0, "limit" : 1, "total" : 47 } }
  • 响应参数 状态码: 200 表2 响应Body参数 参数 参数类型 描述 products Array of Real3DProductVO objects 实景三维成果影像列表。 page Page object 分页信息。 表3 Real3DProductVO 参数 参数类型 描述 id String 成果影像ID。 name String 成果影像名称。 status String 成果影像状态。 preparing:准备中。处于该状态表示成果模型数据正在准备,需要在该状态后才能下载、删除。 available:可用。处于该状态时成果模型可以下载、删除。 deleting:删除中。成果模型正在删除。 folder_code String 倾斜影像编码。 task_info Real3DProductRelateTaskVO object 相关任务信息。 product_details Array of Real3DProductDetailVO objects 成果影像详情。 storage_size_byte Double 成果影像占用存储空间大小(字节)。 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。 表4 Real3DProductRelateTaskVO 参数 参数类型 描述 task_id String 任务ID。 task_name String 任务名称。 task_params String 任务建模参数。 task_exec_start_time String 任务执行开始时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 task_exec_end_time String 任务执行结束时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 表5 Real3DProductDetailVO 参数 参数类型 描述 type String 文件类型。 mesh_osgb:纹理模型格实景三维模型输出.osgb三维预览文件。 mesh_obj:纹理模型格实景三维模型输出.obj三维模型文件。 nerf_osgb:显式辐射场实景三维模型输出.osgb三维预览文件。 nerf_obj:显式辐射场实景三维模型输出.obj三维模型文件。 metadata: metadata.xml文件,用于模型坐标校准。 storage_size_byte Double 文件占用存储空间大小(字节)。 files Array of strings 文件名称列表。 表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
  • URI GET /v1/real3d/products 表1 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量。查询时忽略的记录数量。 最小值:0 最大值:2147483647 缺省值:0 limit 否 Integer 分页大小。 最小值:1 最大值:100 缺省值:10 product_name 否 String 成果影像名称。支持模糊搜索。 product_id 否 String 成果影像ID。
  • 响应参数 状态码: 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)。