调用ListNodesByNodeGroupId根据过滤条件,查询指定节点分组中的节点列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListNodesByNodeGroupId |
系统规定参数。取值:ListNodesByNodeGroupId。 |
Limit | Long | 是 | 2 |
本次查询的节点数量上限,大于等于1。 |
NodeGroupId | String | 是 | 123 |
节点分组ID。 |
Offset | Long | 是 | 0 |
本次查询的起始位置,从0开始。 |
Ascending | Boolean | 否 | true |
配合SortingField参数一起使用,true表示升序,false表示降序。 |
FuzzyDevEui | String | 否 | d896e0 |
模糊匹配节点的DevEUI。 |
SortingField | String | 否 | CREATED_MILLIS |
指定排序字段,可取值为CREATED_MILLIS,表示根据创建时间排序。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data |
返回的结果。 |
||
List |
满足过滤条件的节点列表。 |
||
AuthTypes | STANDARD |
网关合约类型。
|
|
BoundMillis | Long | 1514736000000 |
节点加入当前节点分组的时间,UNIX时间戳,以毫秒为单位。 |
ClassMode | String | A |
节点所采用的LoRaWAN Class模式,可取值:A、B、C。 |
DevAddr | String | 12345678 |
节点的网络地址。 |
DevEui | String | 0000000000000000 |
节点的DevEUI。 |
LastJoinMillis | Long | 1514736000000 |
最近一次入网的时间,UNIX时间戳,以毫秒为单位。 |
MulticastGroupId | String | xxxx |
组播ID值。 |
TotalCount | Long | 10 |
满足过滤条件的节点总数。 |
RequestId | String | 89EF6CAA-958F-F32C-BE45-FE003C6DE097 |
请求ID。 |
Success | Boolean | true |
是否成功。 |
示例
请求示例
http(s)://linkwan.cn-shanghai.aliyuncs.com/?Action=ListNodesByNodeGroupId
&Limit=2
&NodeGroupId=123
&Offset=0
&<公共请求参数>
正常返回示例
XML
格式
<ListNodesByNodeGroupIdResponse>
<Data>
<TotalCount>10</TotalCount>
<List>
<Node>
<ClassMode>A</ClassMode>
<BoundMillis>1514736000000</BoundMillis>
<LastJoinMillis>1514736000000</LastJoinMillis>
<DevEui>0000000000000000</DevEui>
<DevAddr>12345678</DevAddr>
</Node>
<Node>
<ClassMode>A</ClassMode>
<BoundMillis>1514736000001</BoundMillis>
<LastJoinMillis>1514736000000</LastJoinMillis>
<DevEui>0000000000000001</DevEui>
<DevAddr>12345678</DevAddr>
</Node>
</List>
</Data>
<RequestId>89EF6CAA-958F-F32C-BE45-FE003C6DE097</RequestId>
<Success>true</Success>
</ListNodesByNodeGroupIdResponse>
JSON
格式
{
"Data":{
"TotalCount":10,
"List":[
{
"DevEui":"0000000000000000",
"ClassMode":"A",
"BoundMillis":1514736000000,
"DevAddr":"12345678",
"LastJoinMillis":1514736000000
},
{
"DevEui":"0000000000000001",
"ClassMode":"A",
"BoundMillis":1514736000001,
"DevAddr":"12345678",
"LastJoinMillis":1514736000000
}
]
},
"RequestId":"89EF6CAA-958F-F32C-BE45-FE003C6DE097",
"Success":true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | ForbiddenByRam | User not authorized to operate on the specified resource, or this API does not support RAM. | 用户没有执行该操作所需要的RAM权限。 |
400 | ForbiddenByRiskControl | This operation cannot be performed because of security risks. | 存在安全风险,无法执行该操作 |
400 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
400 | FeatureNotActivated | The feature has not been activated. | 功能未开通 |
400 | CloudProductNotActivated | The Link WAN service has not been activated. | 未开通 Link WAN 云产品 |
访问错误中心查看更多错误码。