You can call this operation to query information about the 4G subscriber identity module (SIM) card of a Smart Access Gateway (SAG) device.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | No | DescribeSagWan4G |
The operation that you want to perform. Set the value to DescribeSagWan4G. |
RegionId | String | Yes | cn-shanghai |
The ID of the region where the SAG instance is deployed. |
SmartAGId | String | Yes | sag-whfn**** |
The ID of the SAG instance. |
SmartAGSn | String | Yes | sag32a30**** |
The serial number of the SAG device. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Ip | String | 192.XX.XX.1 |
The IP address of the 4G SIM card. |
Mac | String | c4:00:ad:a2:f5:**** |
The MAC address of the 4G SIM card. |
RequestId | String | CE6642D4-21EB-4168-9BF9-F217953F9892 |
The ID of the request. |
Status | String | Normal |
The status of the 4G SIM card. Valid values:
|
Strength | String | High |
The signal strength of the 4G SIM card. Valid values:
|
Examples
Sample requests
http(s)://smartag.cn-shanghai.aliyuncs.com/? Action=DescribeSagWan4G
&RegionId=cn-shanghai
&SmartAGId=sag-whfn****
&SmartAGSn=sag32a30****
&<Common request parameters>
Sample success responses
XML
format
<DescribeSagWan4GResponse>
<RequestId>CE6642D4-21EB-4168-9BF9-F217953F9892</RequestId>
<Ip>192.XX.XX.1</Ip>
<Mac>c4:00:ad:a2:f5:****</Mac>
<Status>Normal</Status>
<Strength>High</Strength>
</DescribeSagWan4GResponse>
JSON
format
{
"RequestId": "CE6642D4-21EB-4168-9BF9-F217953F9892",
"Ip": "192.XX.XX.1",
"Mac": "c4:00:ad:a2:f5:****",
"Status": "Normal",
"Strength": "High"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | SAG.InstanceNoFound | The specified SAG instance does not exist. | The error message returned because the specified SAG instance does not exist. |
400 | SAG.SoftwareNotSupport | The specified SAG software edition instance does not support ACL. | The error message returned because the specified SAG instance does not support access control lists (ACLs). |
500 | SmartAccessGatewayInArrears | The specified Smart Access Gateway has expired. | The error message returned because the specified SAG instance has expired. Renew the SAG instance first. |
500 | SmartAccessGatewayNotActivated | The specified Smart Access Gateway has not been activated. | The error message returned because the specified SAG instance has not been activated. Activate the SAG instance first. |
403 | SmartAccessGatewayNotOnline | The specified smart access gateway is not online. | The error message returned because the specified SAG device is not connected. |
500 | SmartAccessGatewayOffline | The request cannot be completed. The Smart Access Gateway is offline. | The error message returned because the specified SAG device is disconnected. |
400 | InstanceNotExit | The specified instance does not exist. | The error message returned because the specified instance does not exist. |
400 | ConfigUnsynchronized | The network configuration is not synchronized. | The error message returned because the network settings are not synchronized between the SAG device and instance. |
403 | FeatureNotSupport | The current edition of the smart access gateway does not support this feature. | The error message returned because the current version of the SAG instance does not support this feature. |
403 | FeatureNotSupportForActiveSmartAG | The current edition of the active smart access gateway does not support this feature. | The error message returned because the current version of the active SAG device does not support this feature. |
403 | FeatureNotSupportForStandBySmartAG | The current edition of the standby smart access gateway does not support this feature. | The error message returned because the current version of the standby SAG device does not support this feature. |
For a list of error codes, visit the API Error Center.