Upgrades an SAG instance to a later version.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | No | UpdateSmartAccessGatewayVersion |
The operation that you want to perform. Set the value to UpdateSmartAccessGatewayVersion. |
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. |
SerialNumber | String | No | sag233**** |
The serial number of the SAG device. |
VersionType | String | No | Device |
The type of software that you want to upgrade. Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | CE6642D4-21EB-4168-9BF9-F217953F9892 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=UpdateSmartAccessGatewayVersion
&RegionId=cn-hangzhou
&SmartAGId=sag-0ovhf732a9j*******
&VersionCode=1.0.1
&<Common request parameters>
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 permissions 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 device is not connected to Alibaba Cloud and the system failed to process the request. |
403 | GetSmartAccessGatewayVersionError | An error occurred while obtaining the smart access gateway version. | The error message returned because the system failed to query the version of the specified SAG instance. |
403 | GetSmartAccessGatewayStateError | An error occurred while obtaining the smart access gateway status. | The error message returned because the system failed to query 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.