Modifies the configurations of a Smart Access Gateway instance.

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 area to which the Smart Access Gateway instance belongs.

SmartAGId String Yes sag-0ovhf732a9j0******

The ID of the Smart Access Gateway instance.

Action String No ModifySmartAccessGateway

The name of this action.

Value:ModifySmartAccessGateway.

CidrBlock String No 172.16.0.1/24

The CIDR blocks used by local clients for communication. Make sure all CIDR blocks do not conflict with one another.

If the LAN ports of the Smart Access Gateway device uses dynamic IP addresses and DHCP is enabled on a client, the IP address used by the client is allocated from the first specified CIDR block.

Description String No sag description

The description of the Smart Access Gateway instance.

The description must be 2 to 256 characters in length and must start with an English letter. It cannot start with http:// or https:/.

Name String No sag

The name of the Smart Access Gateway instance.

The instance name must be 2 to 128 characters in length and can contain letters, numbers, periods (.), underscores (_), and hyphens (-). The name must start with a letter. It must not start with http:// or https://.

SecurityLockThreshold Integer No 3

The threshold value set for the offline locking function. It must be larger or equal to 0.

Unit: seconds.

Response parameters

Parameter Type Example value Description
RequestId String CE6642D4-21EB-4168-9BF9-F217953F9892

The ID of the request.

Examples

Request example


http(s)://[Endpoint]/? Action=ModifySmartAccessGateway
&RegionId=cn-hangzhou
&SmartAGId=sag-0ovhf732a9j0******
&<CommonParameters>

Response example

XML format

<ModifySmartAccessGatewayResponse>
  <RequestId>CE6642D4-21EB-4168-9BF9-F217953F9892</RequestId>
</ModifySmartAccessGatewayResponse>

JSON format

{
	"RequestId":"CE6642D4-21EB-4168-9BF9-F217953F9892"
}

Error codes

HTTP status code Error code Error message Description
403 CidrConflict Cidr is conflict, Please Check your input. The specified CIDR blocks are in conflict.
403 MissingParameter The input parameter is missing, please check your input. The required parameters are missing.
403 InvalidId.SMARTAG The specified smart access gateway instance id is invalid. The specified Smart Access Gateway ID is invalid.
403 InvalidCidr Cidr is illegal, please check your input. The specified Cidr is invalid.
403 Forbidden User not authorized to operate on the specified resource. You are not authorized to operate on the specified resource.
500 SmartAccessGatewayInArrears The specified Smart Access Gateway has expired. The specified Smart Access Gateway instance has expired. Please renew it.
500 SmartAccessGatewayNotActivated The specified Smart Access Gateway has not been activated. The specified Smart Access Gateway instance has not been activated.
403 VbrConflict.ChangeSubnet The subnet of the gateway conflicts with the VBR. Modify the subnet first. The specified CIDR block of the Smart Access Gateway instance conflicts with that of the Virtual Border Router (VBR).
403 VbrConflict.CreateBackup The subnet of the gateway conflicts with the VBR. Create a backup relationship first. The specified CIDR block of the Smart Access Gateway instance conflicts with that of the Virtual Border Router (VBR).
400 SAG.IpCountTooLittle The number of available IP addresses of the CIDR block is fewer than the number of SslConnectionSpec. The number of available IP addresses in the CIDR block is less than the number of connections.
400 SAG.SslConnectionSpecInvalid The number of SslConnectionSpec is invalid. The specified number of connections is invalid.
400 SAG.CcnCidrNoConfig You must configure the CIDR block of CCN. The CIDR block of the associated CCN instance is not specified.
400 SAG.CidrEmpty You must specify the CIDR blocks of SAG. The specified CIDR block of the Smart Access Gateway instance is empty.
400 SAG.ConflictCidr.CcnSnatCidr The SAG CIDR block is in conflict with the CCN CIDR block. The specified CIDR block of the Smart Access Gateway instance conflicts with that of the CCN instance.
400 SAG.ConflictSnatIp The specified snat ip address is invalid. The specified SNAT IP is invalid.
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. The ID of the Smart Access Gateway instance is empty.
400 SAG.InstanceNoFound The specified SAG instance does not exist. The specified Smart Access Gateway instance does not exist.
400 SAG.InvalidCidr The specified ClientIp is invalid. The specified CIDR block of the Smart Access Gateway instance is invalid.
400 SAG.InvalidCidr.NoBelongCcnCidr The specified SAG CIDR block does not belong to the CCN CIDR block. The specified CIDR block of the Smart Access Gateway instance does not belong to the CIDR block of the CCN instance.
400 SAG.InvalidSnatCidr The specified SNAT CIDR block is invalid. The specified SNAT CIDR block is invalid.
400 SAG.InvalidSnatIp The specified SNAT IP address is invalid. The specified SNAT IP address is invalid.
400 CCN. CidrEmpty You must specify the CCN CIDR block. The CIDR block of the CCN instance is empty.
403 SmartAccessGatewayNotBind The instance has not yet been bound. The specified Smart Access Gateway instance is not associated.
400 CCN.SnatCidrConflict The specified SNAT CIDR block is invalid. The specified SNAT CIDR block is invalid.
400 ActionNotSupport The specified instance does not support this action. The specified instance does not support this action.
400 CCN.SnatCidrNoConfig You must configure the SNAT CIDR block of the CCN. The SNAT CIDR block of CCN instance is not configured.
403 FeatureNotSupport The current edition of the smart access gateway does not support this feature. The current version of the Smart Access Gateway instance does not support this feature.

See common error codes