QueryDeviceByTags

更新时间：2024-09-14 07:22:25

调用该接口通过标签查询设备。

使用说明

单次调用，最多可输入10个标签。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	QueryDeviceByTags	系统规定参数。取值：QueryDeviceByTags。
Tag.N.TagKey	String	是	room	设备标签的Key。
Tag.N.TagValue	String	是	101	设备标签的值。
IotInstanceId	String	否	iot_instc_pu***_c-v64*******	实例ID。您可在物联网平台控制台的实例概览页面，查看当前实例的ID。注意 + 若有ID值，必须传入该ID值，否则调用会失败。 + 若无ID值，则无需传入。
CurrentPage	Integer	否	1	指定从返回结果中的第几页开始显示。默认值是1。
PageSize	Integer	否	10	指定返回结果中每页显示的设备记录数量，最大值是50。默认值是10。

返回数据

名称	类型	示例值	描述
Code	String	iot.system.SystemException	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	Array of SimpleDeviceInfo		调用成功时，返回的设备信息列表（SimpleDeviceInfo）。
SimpleDeviceInfo
DeviceName	String	light1	设备名称。
IotId	String	Q7uOhVRdZRRlDnTLv****00100	物联网平台为该设备颁发的ID，作为该设备的唯一标识符。
ProductKey	String	a1BwAGV****	设备所属产品的ProductKey。
ProductName	String	lamp	产品名称。
ErrorMessage	String	系统异常	调用失败时返回的出错信息。
Page	Integer	1	当前页面号。
PageCount	Integer	1	总页数。
PageSize	Integer	10	每页显示的记录数。
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	涂鸦云为该请求生成的唯一标识符。
Success	Boolean	true	表示是否调用成功。 + true：调用成功。 + false：调用失败。
Total	Integer	1	总记录数。

示例

请求示例

https://iot.****.tuya.com/?Action=QueryDeviceByTags
&CurrentPage=1
&PageSize=10
&Tag.1.TagKey=room
&Tag.1.TagValue=101
&Tag.2.TagKey=city
&Tag.2.TagValue=hangzhou
&<公共请求参数>

正常返回示例

JSON格式

{
    "PageCount": 1,
    "Data": {
        "SimpleDeviceInfo": [
            {
                "DeviceName": "1102jichu02",
                "ProductKey": "a1SM5S1****",
                "IotId": "GookTiUcwqRbHosp9Ta10****3a00",
                "ProductName": "TEST"
            }
        ]
    },
    "PageSize": 10,
    "Page": 1,
    "RequestId": "2B5091E4-32D5-4884-A5B2-2E8E713D84AF",
    "Success": true,
    "Total": 1
}

上一篇QueryDeviceProp

下一篇DeleteDeviceProp