使用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.	无权访问此资源

访问错误中心查看更多错误码。