Cloud Services API ReferenceIndustrial ScenariosIndustry Basic ServiceIndustry Asset ManagementQuery the Information of Multiple Assets

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 name	Type	IN	Required	Description
asset_ids	String	query	true	The asset ID.

Return parameter

Parameter name	Type	Description
result	List

Description of result

Parameter name	Type	Description
asset_id	String	The asset ID.
parent_asset_id	String	The ID of the parent asset. The top-level ID is set to `-1`.
asset_name	String	The asset name.
asset_full_name	String	The full name of the specified asset.
level	Integer	The 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.

Prev DocAuthorize User with Assets

Next DocQuery the Authorized Assets