创建设备组

POST
{host}/create_group
此功能用于创建新设备组,上限为50组。

请求

Body Parameters
name
(required)
string
自定义组名称

响应

字段名称 说明
group_name 设备组名称
group_uuid 设备组唯一标识

请求示例

curl --request POST \
     --url '{host}/create_group' \
     --user '<username>:<password>' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --data '{"name":"device group name"}' \
     --include

{
    "code": "0",
    "data": {
        "group_name": "test group",
        "group_uuid": "478ED9E2A290F401"
    }
}

接口历史版本

历史版本 说明
Sensecap V1 已停止维护,不推荐使用

更新设备组信息

POST
{host}/update_group
更新设备组名称

请求

Body Parameters
group_uuid
(required)
string
设备组唯一标识
name
(required)
string
分组名称

请求示例

curl --request POST \
     --url '{host}/update_group' \
     --user '<username>:<password>' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --data '{"group_uuid":"259B1906C3B38481", "name":"new name of the device group"}' \
     --include

{
    "code": "0",
    "data": {}
}

删除设备组

POST
{host}/delete_group
删除一个设备组,删除后该组内的设备将自动移到默认组中

请求

Query Parameters
group_uuid
(required)
string
设备组唯一标识

请求示例

curl --request POST \
     --url '{host}/delete_group?group_uuid=0C32119F38C89C31' \
     --user '<username>:<password>' \
     --header 'content-type: application/json' \
     --include
     
{
    "code": "0",
    "data": {}
}

获取设备组列表

GET
{host}/list_groups
获取所有设备组

响应

字段名称 说明
group_name 设备组名称
group_uuid 设备组唯一标识

请求示例

curl --request GET \
     --url '{host}/list_groups' \
     --user '<username>:<password>' \
     --include
     
{
    "code": "0",
    "data": [
        {
            "group_name": "Default",
            "group_uuid": ""
        },
        {
            "group_name": "test group",
            "group_uuid": "80523B280630E611"
        },
        {
            "group_name": "demo",
            "group_uuid": "EBAD5387C4FC8711"
        }
    ]
}

接口历史版本

历史版本 说明
Sensecap V1 已停止维护,不推荐使用

移动设备到其它组

POST
{host}/move_devices_to_group
将设备移动到某个分组中

请求

Body Parameters
group_uuid
(required)
string
设备组唯一标识
devices
(required)
array
设备唯一标识

请求示例

curl --request POST \
     --url '{host}/move_devices_to_group' \
     --user '<username>:<password>' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --data '{"devices":["2CF7F12004100001","2CF7F12004100002"], "group_uuid": "0BC724D9F32AD934"}' \
     --include

{
    "code": "0",
    "data": {}
}