Upgrades the software version of a Smart Access Gateway (SAG) device.
Debug
Use OpenAPI Explorer to perform debug operations and generate SDK code examples.
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| RegionId | String | Yes | cn-hangzhou |
The region to which the Smart Access Gateway instance belongs. |
| SmartAGId | String | Yes | sag-0ovhf732a9j******* |
The ID of the SAG instance. |
| VersionCode | String | Yes | 1.0.1 |
The version of the SAG instance to be upgraded. |
| Action | String | No | UpdateSmartAccessGatewayVersion |
The name of this action. Value: UpdateSmartAccessGatewayVersion |
| SerialNumber | String | No | sag233a234i55 |
The serial number of the SAG device. |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| RequestId | String | CE6642D4-21EB-4168-9BF9-F217953F9892 |
The ID of the request. |
Examples
Request example
https://smartag.cn-shanghai.aliyuncs.com/?Action=UpdateSmartAccessGatewayVersion
&SmartAGId=sag-0ovhf732a9j0pt0aeo
&VersionCode=2.0
&CommonParameters
Response examples
XML format
<UpdateSmartAccessGatewayVersionResponse>
<RequestId>CE6642D4-21EB-4168-9BF9-F217953F9892</RequestId>
</UpdateSmartAccessGatewayVersionResponse>
JSON format
{
"RequestId":"CE6642D4-21EB-4168-9BF9-F217953F9892"
}Errors
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 403 | Forbidden | User not authorized to operate on the specified resource. | You are not authorized to use this resource. |
| 500 | SmartAccessGatewayInArrears | The specified Smart Access Gateway has expired. | The specified SAG instance has expired. |
| 500 | SmartAccessGatewayNotActivated | The specified Smart Access Gateway has not been activated. | The specified SAG instance has not been activated. |
| 403 | InvalidId.SMARTAG | The specified smart access gateway instance id is invalid. | The specified SAG ID is invalid. |
| 500 | PermissionError | No permission to operate the instance. | You are not authorized to use this resource. |
| 403 | NotBoundCCN | The specified smart access gateway has not bound CCN; please bind CCN first. | The specified SAG instance is not attached to a CCN instance. |
| 403 | SmartAccessGatewayNotOnline | The specified smart access gateway is not online. | The specified SAG instance is offline. |
| 403 | GetSmartAccessGatewayVersionError | An error occurred while obtaining the smart access gateway version. | An error occurred when the SAG version is being obtained. |
| 403 | GetSmartAccessGatewayStateError | An error occurred while obtaining the smart access gateway status. | An error occurred when the SAG status is being obtained. |
| 403 | VersionTooOld | The specified version is outdated; please select a newer version. | The specified version is too low. |