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.

For a list of error codes, visit the API Error Center.