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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
SmartAGId String sag-0ovhf732a9j0******

智能接入网关ID。

Name String sag

智能接入网关的名称。

名称长度为2~128个字符,必须以字母或中文开头,可包含数字,半角句号(.),下划线(_)和短划线(-),但不能以http://https://开头。

Description String sag描述

智能接入网关的描述。

描述可以为空或描述长度为2~256个字符,必须以字母或中文开头,但不能以http://https://开头。

CidrBlock String 172.16.0.1/24

线下机构客户端用来通信的私网网段,确保各私网网段不冲突。

如果智能接入网关终端设备的LAN口配置为动态方式,则线下已开启DHCP的客户端使用的IP地址会从您指定的第一个私网网段中分配。

RegionId String cn-hangzhou

智能接入网关的所属区域。

Action String ModifySmartAccessGateway

系统规定参数。取值:ModifySmartAccessGateway

SecurityLockThreshold Integer 3

智能接入网关设备离线锁定的时间阈值。设定的阈值需大于等于0。

单位:秒。

RoutingStrategy String static

线下路由同步方式。取值:

  • static:静态路由。
  • dynamic:动态路由。

返回数据

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

请求ID。

示例

请求示例

http(s)://[Endpoint]/?SmartAGId=sag-0ovhf732a9j0******
&Name=sag
&Description=sag描述
&CidrBlock=172.16.0.1/24
&RegionId=cn-hangzhou
&Action=ModifySmartAccessGateway
&SecurityLockThreshold=3
&RoutingStrategy=static
&公共请求参数

正常返回示例

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. 动态路由模式不允许配置静态地址段。
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. 请求失败,发生未知错误。
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. 智能接入网关当前版本不支持该功能特性。

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