查询实景三维成果数据列表
功能介绍
查询实景三维成果数据列表。返回成果数据查询结果以更新时间倒序排列，支持根据以下条件查询：
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 |
服务内部错误。 |
错误码
请参见错误码。
