V2.5 Search Device Group by Device¶

通过设备查询设备组信息。

操作权限¶

需授权的服务	所需操作权限
设备管理	Read

请求格式¶

POST https://{apigw-address}/connect-service/v2.5/deviceGroups?action=searchDeviceGroupByDevice

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	资产所属的组织 ID。如何获取 orgId 信息>>

请求参数（Body）¶

名称	必需/可选	数据类型	描述
expression	可选	String	参见如何使用查询表达式>>
deviceIdentifier	必需	结构体	参见 DeviceIdentifier 结构体。

DeviceIdentifier 结构体 ¶

名称	数据类型	描述
assetId	String	资产 ID。如何获取Asset ID信息>>
productKey	String	Product Key。如何获取设备的 productKey 信息>>
deviceKey	String	Device Key。如何获取设备的 deviceKey 信息>>

响应参数¶

名称	数据类型	描述
code	number	更新成功或失败的指示码。
msg	String	成功时返回 `OK`；其他值则为失败。
requestId	String	每次请求获取的 ID，用于唯一标识一次 API 请求。
data	结构体	参见 Data 结构体。

Data 结构体 ¶

名称	数据类型	描述
groupId	String	设备组ID。在 EnOS 管理控制台中前往设备管理 > 设备组获取设备组ID。
orgId	String	资产所属组织ID
name	StringI18n	设备组名称，结构参见国际化名称结构体。
desc	String	设备组描述。
type	String	设备组类型：STATIC、DYNAMIC。
condition	String	动态设备组条件。更多信息，参见 [动态规则](/docs/device-connection/zh_CN/preview/howto/device/managing_device_group.html#rule)。
createTime	Number	创建时间。
updateTime	Number	更新时间。

示例¶

请求示例¶

url: https://{apigw-address}/connect-service/v2.5/deviceGroups?action=searchDeviceGroupByDevice&orgId=yourOrgId
method: POST

返回示例¶

{
    "code": 0,
    "msg": "OK",
    "requestId": "626996dd-54cb-4dbe-8ac2-bcb4c2622971",
    "data": [{
        "groupId": "yourGroupId",
        "orgId": "yourOrgId",
        "name": {
            "defaultValue": "GroupName",
            "i18nValue": {
      "en_US": "name",
      "zh_CN": "中文名",
      "es_ES": "nombre",
      "ja_JP": "名前"
            }
        },
        "desc": "GroupDescription",
        "type": "STATIC",
        "condition": null,
        "status": "READY",
        "createTime": 1718950104553,
        "updateTime": 1718950124873
    }]
}