调用DescribeSAGDeviceInfo接口查询智能接入网关设备信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
smartag:DescribeSAGDeviceInfo |
get |
*SmartAccessGateway
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
智能接入网关实例所属地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-shanghai |
| SmartAGId |
string |
是 |
智能接入网关实例 ID。 |
sag-7f3d9b6jwnuqn6**** |
| SmartAGSn |
string |
是 |
绑定的智能接入网关设备序列号。 |
sag32a30**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| ServiceIP |
string |
智能接入网关设备的业务 IP 地址。 |
42.XX.XX.151 |
| ControllerState |
string |
智能接入网关设备的管控状态:
|
Normal |
| RequestId |
string |
请求 ID。 |
B6A991F4-F533-1627-8144-B64E01C5EE85 |
| SynStatus |
string |
智能接入网关设备本地和云上的同步状态:
|
Unsynchronized |
| SmartAGType |
string |
智能接入网关设备类型:
|
sag-100wm |
| Version |
string |
智能接入网关设备运行的软件版本号。 |
2.3.1.1 |
| VpnState |
string |
智能接入网关设备的 VPN 连接状态:
|
Abnormal |
| StartupTime |
string |
智能接入网关设备的启动时间。 |
2021-06-15 17:33:43 |
| LastConnectedControllerTime |
string |
智能接入网关设备最近一次连接管控的时间。 |
2021-07-14 00:27:48 |
| ResettableStatus |
string |
智能接入网关设备的重置键是否启用。
|
Enabled |
示例
正常返回示例
JSON格式
{
"ServiceIP": "42.XX.XX.151",
"ControllerState": "Normal",
"RequestId": "B6A991F4-F533-1627-8144-B64E01C5EE85",
"SynStatus": "Unsynchronized",
"SmartAGType": "sag-100wm",
"Version": "2.3.1.1",
"VpnState": "Abnormal",
"StartupTime": "2021-06-15 17:33:43",
"LastConnectedControllerTime": "2021-07-14 00:27:48",
"ResettableStatus": "Enabled"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | SAG.InstanceNoFound | The specified SAG instance does not exist. | 智能接入网关实例不存在。 |
| 400 | SAG.SoftwareNotSupport | The specified SAG software edition instance does not support ACL. | 智能接入网关软件版实例不支持ACL。 |
| 400 | InstanceNotExit | The specified instance does not exist. | 指定的实例不存在。 |
| 400 | ConfigUnsynchronized | The network configuration is not synchronized. | 网络配置未同步。 |
| 400 | SmartAccessGatewayNotActivated | The specified Smart Access Gateway has not been activated. | 该智能接入网关尚未激活,请先激活该实例。 |
| 400 | SmartAccessGatewayInArrears | The specified Smart Access Gateway has expired. | 该智能接入网关已经到期停服,请续费。 |
| 400 | SmartAccessGatewayOffline | The request cannot be completed. The Smart Access Gateway is offline. | 智能接入网关离线,请求无法完成。 |
| 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. | 该智能接入网关当前不是在线状态,无法完成操作。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。