调用DescribeSAGDeviceInfo获取设备概况。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeSAGDeviceInfo |
要执行的操作。 取值:DescribeSAGDeviceInfo。 |
RegionId | String | 是 | cn-shanghai |
智能接入网关实例地域ID。 |
SmartAGId | String | 是 | sag-whfn**** |
智能接入网关实例ID。 |
SmartAGSn | String | 是 | sag32a30**** |
绑定的智能接入网关设备序列号。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ControllerState | String | Abnormal |
当前设备管控状态:
|
RequestId | String | 419268E8-1D8A-43EC-B9B4-C0906F4C444D |
请求ID。 |
SmartAGType | String | sag-1000 |
设备类型:
|
StartupTime | String | 2020-04-13 15:21:43 |
设备启动时间。 |
SynStatus | String | Synchronized |
同步状态:
|
Version | String | 2.0.8 |
设备当前版本号。 |
VpnState | String | Abnormal |
VPN当前连接状态:
|
示例
请求示例
http(s)://smartag.cn-shanghai.aliyuncs.com/?Action=DescribeSAGDeviceInfo
&RegionId=cn-shanghai
&SmartAGId=sag-whfn****
&SmartAGSn=sag32a30****
&<公共请求参数>
正常返回示例
XML
格式
<DescribeSAGDeviceInfoResponse>
<ControllerState>Normal</ControllerState>
<RequestId>9B6DE689-8E20-4739-9A9F-D46A570F3EB7</RequestId>
<SynStatus>Synchronized</SynStatus>
<SmartAGType>sag-1000</SmartAGType>
<Version>2.0.2</Version>
<VpnState>Normal</VpnState>
<StartupTime>2020-04-13 15:21:43</StartupTime>
</DescribeSAGDeviceInfoResponse>
JSON
格式
{
"ControllerState": "Normal",
"RequestId": "9B6DE689-8E20-4739-9A9F-D46A570F3EB7",
"SynStatus": "Synchronized",
"SmartAGType": "sag-1000",
"Version": "2.0.2",
"VpnState": "Normal",
"StartupTime": "2020-04-13 15:21:43"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | SAG.InstanceNoFound | The specified SAG instance does not exist. | 智能网关实例不存在。 |
400 | SAG.SoftwareNotSupport | The specified SAG software edition instance does not support ACL. | 智能接入网关软件版实例不支持ACL。 |
500 | SmartAccessGatewayNotActivated | The specified Smart Access Gateway has not been activated. | 该智能接入网关尚未激活,请先激活该实例。 |
500 | SmartAccessGatewayInArrears | The specified Smart Access Gateway has expired. | 该智能接入网关已经到期停服,请续费。 |
400 | InstanceNotExit | The specified instance does not exist. | 指定的实例不存在 |
400 | ConfigUnsynchronized | The network configuration is not synchronized. | 网络配置未同步 |
403 | FeatureNotSupport | The current edition of the smart access gateway does not support this feature. | 智能接入网关当前版本不支持该功能特性 |
403 | FeatureNotSupportForActiveSmartAG | The current edition of the active smart access gateway does not support this feature. | 主智能接入网关的当前版本不支持该功能特性 |
403 | FeatureNotSupportForStandBySmartAG | The current edition of the standby smart access gateway does not support this feature. | 备智能接入网关的当前版本不支持该功能特性 |
403 | SmartAccessGatewayNotOnline | The specified smart access gateway is not online. | 该智能接入网关当前不是在线状态,无法完成操作。 |
500 | SmartAccessGatewayOffline | The request cannot be completed. The Smart Access Gateway is offline. | 智能接入网关离线,请求无法完成。 |
访问错误中心查看更多错误码。