You can call this operation to upgrade a Smart Access Gateway (SAG) instance to a later version.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
RegionId | String | Yes | cn-hangzhou |
The ID of the region where the SAG instance is deployed. |
SmartAGId | String | Yes | sag-0ovhf732a9j******* |
The ID of the SAG instance. |
VersionCode | String | Yes | 1.0.1 |
The version to which you want to upgrade the SAG instance. |
Action | String | No | UpdateSmartAccessGatewayVersion |
The operation that you want to perform. Set the value to UpdateSmartAccessGatewayVersion . |
SerialNumber | String | No | sag233a234i55 |
The serial number (SN) of the SAG device. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | CE6642D4-21EB-4168-9BF9-F217953F9892 |
The ID of the request. |
Examples
Sample requests
https://smartag.cn-shanghai.aliyuncs.com/?Action=UpdateSmartAccessGatewayVersion
&SmartAGId=sag-0ovhf732a9j0pt0aeo
&VersionCode=2.0
&CommonParameters
Sample success responses
XML
format
<UpdateSmartAccessGatewayVersionResponse>
<RequestId>CE6642D4-21EB-4168-9BF9-F217953F9892</RequestId>
</UpdateSmartAccessGatewayVersionResponse>
JSON
format
{
"RequestId":"CE6642D4-21EB-4168-9BF9-F217953F9892"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
403 | Forbidden | User not authorized to operate on the specified resource. | The error message returned because you do not have the permission to manage the specified resource. |
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 | InvalidId.SMARTAG | The specified smart access gateway instance id is invalid. | The error message returned because the specified SAG instance ID is invalid. |
500 | PermissionError | No permission to operate the instance. | The error message returned because you do not have the permission to manage the specified instance. |
403 | NotBoundCCN | The specified smart access gateway has not bound CCN; please bind CCN first. | The error message returned because the specified SAG instance is not associated with a Cloud Connect Network (CCN) instance. Associate the SAG instance with a CCN instance first. |
403 | SmartAccessGatewayNotOnline | The specified smart access gateway is not online. | The error message returned because the specified SAG instance is not connected to Alibaba Cloud. |
403 | GetSmartAccessGatewayVersionError | An error occurred while obtaining the smart access gateway version. | The error message returned because an error occurred while querying the version of the specified SAG instance. |
403 | GetSmartAccessGatewayStateError | An error occurred while obtaining the smart access gateway status. | The error message returned because an error occurred while querying the status of the specified SAG instance. |
403 | VersionTooOld | The specified version is outdated; please select a newer version. | The error message returned because the specified version is outdated. Select a later version. |
For a list of error codes, visit the API Error Center.