Query the Information of Multiple Assets

Last Updated on : 2023-06-20 15:18:22download

Query the information of multiple assets.

API address

GET: /v1.0/iot-02/assets

Request parameter

Parameter nameTypeINRequiredDescription
asset_idsStringquerytrueThe asset ID.

Return parameter

Parameter nameTypeDescription
resultList

Description of result

Parameter nameTypeDescription
asset_idStringThe asset ID.
parent_asset_idStringThe ID of the parent asset. The top-level ID is set to -1.
asset_nameStringThe asset name.
asset_full_nameStringThe full name of the specified asset.
levelIntegerThe hierarchical level of the specified asset. The root node is set to 0.

Request example

GET: /v1.0/iot-02/assets?asset_ids=137493xxxx62112,13750xxxx74592

Return example

{
    "result": [
        {
            "level": 0,
            "asset_id": "137493xxxx62112",
            "asset_full_name": "Asset xxx",
            "asset_name": "Asset xxx",
            "parent_asset_id": "-1"
        },
        {
            "level": 0,
            "asset_id": "13750xxxx74592",
            "asset_full_name": "Asset yyy",
            "asset_name": "Asset yyy",
            "parent_asset_id": "-1"
        }
    ],
    "t": 1616663281459,
    "success": true
}

Error code

For more information, see error code.