查询实景三维成果数据列表
功能介绍
查询实景三维成果数据列表。返回成果数据查询结果以更新时间倒序排列,支持根据以下条件查询:
-
product_name:成果数据名称,模糊匹配。
-
product_id:成果数据ID,精确匹配。
-
offset:查询记录偏移量,设置忽略前面多少个记录,缺省值为0。
-
limit:查询返回的记录条数,缺省值为10。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/real3d/products
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
否 |
Integer |
偏移量。查询时忽略的记录数量。 最小值:0 最大值:2147483647 缺省值:0 |
limit |
否 |
Integer |
分页大小。 最小值:1 最大值:100 缺省值:10 |
product_name |
否 |
String |
成果数据名称。支持模糊搜索。 |
product_id |
否 |
String |
成果数据ID。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
products |
Array of Real3DProductVO objects |
实景三维成果数据列表。 |
page |
Page object |
分页信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
成果数据ID。 |
name |
String |
成果数据名称。 |
status |
String |
成果数据状态。
|
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。 |
参数 |
参数类型 |
描述 |
---|---|---|
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'。 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
文件类型。
|
storage_size_byte |
Double |
文件占用存储空间大小(字节)。 |
files |
Array of strings |
文件名称列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
offset |
Integer |
偏移量,表示从第几条数据开始查询。 |
limit |
Integer |
每页包含的查询记录数量。 |
total |
Integer |
符合查询条件的记录总数。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
请求示例
从第0个开始查询10个成果数据列表。
GET https://{Endpoint}/v1/real3d/products?offset=0&limit=10
响应示例
状态码: 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\":\"SUCCESS\",\"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 |
请求成功。 |
400 |
非法请求。 |
500 |
服务内部错误。 |
错误码
请参见错误码。