GetGatewayBySubDevice
GetGatewayBySubDevice
调用该接口，根据挂载的子设备信息，查询对应的网关设备信息。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | GetGatewayBySubDevice | 系统规定参数。取值：GetGatewayBySubDevice。 |
ProductKey | String | 否 | a1BwAGV**** | 子设备所隶属的产品ProductKey。 |
DeviceName | String | 否 | light | 子设备名称。 |
IotId | String | 否 | Q7uOhVRdZRRlDnTLv****00100 | 子设备ID。物联网平台为该子设备颁发的ID，设备的唯一标识符。 |
‼️ 注意：调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
Code | String | iot.system.SystemException | 调用失败时，返回的错误码。更多信息，请参见错误码。 |
Data | Struct | 调用成功时，返回的网关设备的详细信息。 | |
DeviceName | String | gateway | 网关设备名称。 |
DeviceSecret | String | dCYdTU3gw5Z77bsHjPk6lPHPVnBT**** | 网关设备密钥。 |
FirmwareVersion | String | V1.0.1 | 网关设备的固件版本号。 |
GmtActive | String | 2019-12-18 23:25:30 | 网关设备的激活时间，GMT格式，是用户所在地的当地时间。 |
GmtCreate | String | 2019-12-18 16:58:33 | 网关设备的创建时间，GMT格式，是用户所在地的当地时间。 |
GmtOnline | String | 2020-01-20 17:41:04 | 网关设备最近一次上线的时间，GMT格式，是用户所在地的当地时间。 |
IpAddress | String | 106.**.1**.** | 网关设备的IP地址。 |
NodeType | String | 1 | 节点类型，取值为1，表示该设备为网关设备。 |
ProductKey | String | a1BwAGV**** | 网关设备隶属的产品ProductKey。 |
ProductName | String | LinkIoT | 网关设备隶属的产品名称。 |
Status | String | online | 网关设备状态。取值：
|
UtcActive | String | 2019-12-18T15:25:30.176Z | 网关设备的激活时间，UTC格式，世界标准时间。用户所在地实际时间，可根据当地时差计算。 |
UtcCreate | String | 2019-12-18T08:58:33.000Z | 网关设备的创建时间，UTC格式，世界标准时间。用户所在地实际时间，可根据当地时差计算。 |
UtcOnline | String | 2020-01-20T09:41:04.879Z | 网关设备最近一次上线的时间，UTC格式，世界标准时间。用户所在地实际时间，可根据当地时差计算。 |
iotId | String | WuyjPSDQE1L22z1d****000100 | 物联网平台为该网关设备颁发的ID，作为该设备的唯一标识符。 |
region | String | cn-shanghai | 网关设备所在地域（与控制台上的地域对应）。 |
ErrorMessage | String | 系统异常 | 调用失败时，返回的出错信息。 |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | 该请求生成的唯一标识符。 |
Success | Boolean | true | 表示是否调用成功。
|
示例
请求示例
curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=GetGatewayBySubDevice&SignatureNonce=9e6189124f5a4716ad2de849467be7c0&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A47%3A43Z&ProductKey=k1ymv5ZxdaN&DeviceName=subDevice&Signature=WJN0Ee8%2BX6pogcD3loLHIqQNEN0%3D'正常返回示例
{
"Data": {
"region": "cn-shanghai",
"DeviceName": "gateway_04",
"GmtActive": "2019-12-18 23:25:30",
"ProductKey": "a1vL7cp****",
"IpAddress": "106.**.1**.**",
"GmtCreate": "2019-12-18 16:58:33",
"UtcCreate": "2019-12-18T08:58:33.000Z",
"UtcOnline": "2020-01-20T09:41:04.879Z",
"UtcActive": "2019-12-18T15:25:30.176Z",
"Status": "online",
"NodeType": 1,
"GmtOnline": "2020-01-20 17:41:04",
"ProductName": "LinkIoTEdge_Gateway",
"iotId": "WuyjPSDQE1L22z1****000100"
},
"RequestId": "0377D5A9-BDE1-48C2-96C9-BDC048899186",
"Success": true
}