调用ListGatewayOnlineRecords查询网关在线离线记录。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListGatewayOnlineRecords |
系统规定参数。取值:ListGatewayOnlineRecords。 |
GwEui | String | 是 | 0000000000000000 |
网关的GwEUI。 |
Limit | Long | 是 | 5 |
查询的记录数量上限,大于等于1。 |
OffSet | Long | 是 | 0 |
查询的起始位置,从0开始的偏移值。 |
Ascending | Boolean | 否 | true |
配合SortingField参数一起使用,true表示升序,false表示降序。 |
SortingField | String | 否 | STATE_CHANGED_MILLIS |
排序字段,可选值为:STATE_CHANGED_MILLIS,表示按照状态改变时间排序。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data |
返回结果。 |
||
List |
记录列表。 |
||
GwEui | String | 000000000000 |
网关的GwEUI。 |
OnlineState | String | ONLINE |
在线状态,可取值:ONLINE:在线,OFFLINE:离线。 |
StateChangedMillis | Long | 1514737000000 |
切换到此状态的时间点,以毫秒为单位的UNIX时间戳。 |
TotalCount | Long | 25 |
记录总条数。 |
RequestId | String | 89EF6CAA-958F-F32C-BE45-FE003C6DE097 |
请求ID。 |
Success | Boolean | true |
是否成功。 |
示例
请求示例
http(s)://linkwan.cn-shanghai.aliyuncs.com/?Action=ListGatewayOnlineRecords
&GwEui=0000000000000000
&Limit=5
&OffSet=0
&<公共请求参数>
正常返回示例
XML
格式
<ListGatewayOnlineRecordsResponse>
<Data>
<TotalCount>25</TotalCount>
<List>
<GatewayOnlineRecord>
<StateChangedMillis>1514737000000</StateChangedMillis>
<OnlineState>ONLINE</OnlineState>
</GatewayOnlineRecord>
<GatewayOnlineRecord>
<StateChangedMillis>1514737000000</StateChangedMillis>
<OnlineState>ONLINE</OnlineState>
</GatewayOnlineRecord>
</List>
</Data>
<RequestId>89EF6CAA-958F-F32C-BE45-FE003C6DE097</RequestId>
<Success>true</Success>
</ListGatewayOnlineRecordsResponse>
JSON
格式
{
"Data":{
"TotalCount":25,
"List":[
{
"StateChangedMillis":1514737000000,
"OnlineState":"ONLINE"
},
{
"StateChangedMillis":1514737000000,
"OnlineState":"ONLINE"
}
]
},
"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 | NonExistent | The specified resource does not exist. | 要操作的资源不存在。 |
400 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 内部错误。 |
400 | NotResourceOwner | You are not authorized to use this resource. | 无权访问此资源 |
访问错误中心查看更多错误码。