分页查询资产子节点(支持排序)

更新时间:2023-06-20 15:22:51下载pdf

本文介绍分页查询资产子节点(支持排序)的 API。

接口描述

获取某个资产下的子节点资产,支持以资产名称或资产创建时间进行排序。

接口地址

GET: /v1.1/iot-02/assets/{asset_id}/sub-assets

请求参数

参数名类型参数位置是否必填说明
asset_idStringuritrue资产 ID
page_noIntegerquerytrue页码
page_sizeIntegerquerytrue分页页面大小
sort_ruleStringquerytrue支持排序规则如下:
  • assetsNameAsc:按照资产名称升序。
  • assetsNameDesc:按照资产名称降序。
  • createTimeAsc:按照创建时间升序。
  • createTimeDesc:按照创建时间降序。

返回参数

参数名类型说明
resultAssetsPageListResponse资产返回信息

result 说明

参数名类型说明
listList资产结果列表
has_nextBoolean是否有下一页

list 说明

参数名类型说明
asset_idString资产 ID
parent_asset_idString父级资产 ID,最顶级为 -1
asset_nameString资产名称
asset_full_nameString资产完整名称
levelInteger资产层级,根节点为 0

请求示例

GET: /v1.1/iot-02/assets/abcd/sub-assets?page_no=1&page_size=20&sort_rule=assetNameAsc

返回示例

{
    "list": [
        {
            "level": 0,
            "asset_id": "123",
            "asset_full_name": "123",
            "asset_name": "123",
            "parent_asset_id": "-1"
        }
    ],
    "has_next": false
}

错误码

参考 错误码