ModifySmartAccessGateway - 智能接入网关

调用ModifySmartAccessGateway接口修改智能接入网关的配置。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
SmartAGId	String	是	sag-0ovhf732a9j0******	智能接入网关实例ID。
Name	String	否	SAG	智能接入网关的名称。长度为2~128个字符，必须以字母或中文开头，可包含数字，点号（.），下划线（_）和短横线（-）。
Description	String	否	SAG描述	智能接入网关的描述。长度为2~256个字符，必须以字母或中文开头，但不能以`http://` 或 `https:/`/开头。
CidrBlock	String	否	172.16.0.0/24	线下机构客户端用来通信的私网网段，确保各私网网段不冲突。如果智能接入网关终端设备的LAN口配置为动态方式，则线下已开启DHCP的客户端使用的IP地址会从您指定的第一个私网网段中分配。
RegionId	String	是	cn-hangzhou	智能接入网关的所属区域。
Action	String	是	ModifySmartAccessGateway	系统规定参数。取值：ModifySmartAccessGateway。
SecurityLockThreshold	Integer	否	3	离线锁定功能用户设定的阈值，大于等于0。单位：秒。
RoutingStrategy	String	否	static	线下路由同步方式： static：静态路由。 dynamic：动态路由。
Position	String	否	[ { "adcode":"", "label":"浙江省杭州市xx区xx路xx号", "value":"B0FFGxxxx", "center":"120.190xxxx, 30.182xxxx", "_new":"true" } ]	智能接入网关所部署的位置。
EnableSoftwareConnectionAudit	Boolean	否	true	是否开启SAG App连接日志审计。 true：开启SAG App连接日志审计。 false：关闭SAG App连接日志审计。

返回数据


名称	类型	示例值	描述
RequestId	String	CE6642D4-21EB-4168-9BF9-F217953F9892	请求ID。

示例

请求示例

http(s)://[Endpoint]/?SmartAGId=sag-0ovhf732a9j0******
&Name=SAG
&Description=SAG描述
&CidrBlock=172.16.0.0/24
&RegionId=cn-hangzhou
&Action=ModifySmartAccessGateway
&SecurityLockThreshold=3
&RoutingStrategy=static
&Position=[     {         "adcode":"",         "label":"浙江省杭州市xx区xx路xx号",         "value":"B0FFGxxxx",         "center":"120.190xxxx, 30.182xxxx",         "_new":"true"     } ]
&EnableSoftwareConnectionAudit=true
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码


HttpCode	错误码	错误信息	描述
400	SAG.IpCountTooLittle	The number of available IP addresses of the CIDR block is fewer than the number of SslConnectionSpec.	地址段可用IP数少于连接数。
400	SAG.SslConnectionSpecInvalid	The number of SslConnectionSpec is invalid.	连接数非法。
400	SAG.CcnCidrNoConfig	You must configure the CIDR block of CCN.	绑定的云连接网地址段未配置。
400	SAG.CidrEmpty	You must specify the CIDR blocks of SAG.	智能网关地址段为空。
400	SAG.ConflictCidr.CcnSnatCidr	The SAG CIDR block is in conflict with the CCN CIDR block.	智能网关地址段与云连接网地址段冲突。
400	SAG.ConflictSnatIp	The specified SNAT IP address is invalid.	指定的SNAT IP存在冲突。
400	SAG.InstanceIdEmpty	You must specify the SAG instance ID.	智能接入网关实例ID为空。
400	SAG.InstanceNoFound	The specified SAG instance does not exist.	智能接入网关实例不存在。
400	SAG.InvalidCidr	The specified CIDR block is invalid.	智能网关地址段非法。
400	SAG.InvalidCidr.NoBelongCcnCidr	The specified SAG CIDR block does not belong to the CCN CIDR block.	智能网关地址段不属于云接网地址段。
400	SAG.InvalidSnatCidr	The specified SNAT CIDR block is invalid.	智能网关SNAT CIDR非法。
400	SAG.InvalidSnatIp	The specified SNAT IP address is invalid.	智能网关SNAT IP非法。
400	CCN.CidrEmpty	You must specify the CCN CIDR block.	云连接网的地址段为空。
400	CCN.SnatCidrConflict	The specified SNAT CIDR block is invalid.	指定的SNAT地址段存在冲突。
400	ActionNotSupport	The specified instance does not support this action.	当前实例不支持此功能。
400	CCN.SnatCidrNoConfig	You must configure the SNAT CIDR block of the CCN.	云连接网的SNAT地址段尚未配置。
400	SAG.CidrUsedByRoutableAddress	A routable internal IP address belongs to the specified internal CIDR block. You cannot modify this CIDR block.	当前修改的私网地址段已经被私网可路由地址使用，无法修改。
400	InvalidName	The specified name is invalid.	您输入的名称不合法。
400	SAG.CidrAmountLimit	The maximum number of static routes for the SAG instance is exceeded.	智能接入网关实例设置的静态路由已经到达上限。
400	SAG.InvalidCidrFormat	The specified CIDR format is invalid.	私网地址段格式非法。
400	SAG.CidrOverlap	The specified CIDR overlaps with an existing CIDR.	存在重叠私网地址段。
400	SAG.Arrearage	The specified SAG instance has overdue payments. Renew the instance first.	智能接入网关实例已经欠费，请先续费。
400	SAG.NoActive	The specified SAG instance has not been activated.	智能接入网关实例还未激活，请先激活。
400	SAG.NotAllowConfigCidr	You cannot specify a static CIDR block when the dynamic routing strategy is used.	动态路由模式不允许配置静态地址段。
403	MissingParameter	The input parameter is missing, please check your input.	输入参数缺失，请检查您的输入。
403	InvalidId.SMARTAG	The specified smart access gateway instance id is invalid.	无效的智能接入网关实例ID。
403	InvalidCidr	Cidr is illegal, please check your input.	Cidr不合法，请检查您的输入
403	Forbidden	User not authorized to operate on the specified resource.	用户没有操作此资源的权限。
403	VbrConflict.ChangeSubnet	The subnet of the gateway conflicts with the VBR. Modify the subnet first.	该智能接入网关的子网网段与VBR有冲突，请修改子网网段。
403	VbrConflict.CreateBackup	The subnet of the gateway conflicts with the VBR. Create a backup relationship first.	该智能接入网关的子网网段与VBR有冲突，请先创建专线备份。
403	SmartAccessGatewayNotBind	The instance has not yet been bound.	该实例未被绑定。
403	FeatureNotSupport	The current edition of the smart access gateway does not support this feature.	智能接入网关当前版本不支持该功能特性。
500	SmartAccessGatewayInArrears	The specified Smart Access Gateway has expired.	该智能接入网关已经到期停服，请续费。
500	SmartAccessGatewayNotActivated	The specified Smart Access Gateway has not been activated.	该智能接入网关尚未激活，请先激活该实例。
500	InternalError	An error occurred while processing your request.	请求失败，发生未知错误。

访问错误中心查看更多错误码。