調用ModifySmartAccessGateway修改智能接入網關的配置。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| smartag:ModifySmartAccessGateway | Write |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| SmartAGId | string | 是 | 智能接入網關實例 ID。 | sag-0ovhf732a9j0****** |
| Name | string | 否 | 智能接入網關的名稱。 長度為 2~128 個字符，必須以字母或中文開頭，可包含數字，點號（.），下劃線（_）和短橫線（-）。 | SAG |
| Description | string | 否 | 智能接入網關的描述。 長度為 2~256 個字符，必須以字母或中文開頭，但不能以 | SAG描述 |
| CidrBlock | string | 否 | 線下機構客戶端用來通信的私網網段，確保各私網網段不沖突。 如果智能接入網關終端設備的 LAN 口配置為動態方式，則線下已開啟 DHCP 的客戶端使用的 IP 地址會從您指定的第一個私網網段中分配。 | 172.16.0.0/24 |
| RegionId | string | 是 | 智能接入網關的所屬區域。 | cn-hangzhou |
| SecurityLockThreshold | integer | 否 | 離線鎖定功能用戶設定的閾值，大于等于 0。 單位：秒。 | 3 |
| RoutingStrategy | string | 否 | 線下路由同步方式：
| static |
| Position | string | 否 | 智能接入網關所部署的位置。 | [ { "adcode":"", "label":"浙江省杭州市xx區xx路xx號", "value":"B0FFGxxxx", "center":"120.190xxxx, 30.182xxxx", "_new":"true" } ] |
| EnableSoftwareConnectionAudit | boolean | 否 | 是否開啟 SAG App 連接日志審計。
| true |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "CE6642D4-21EB-4168-9BF9-F217953F9892"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 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 | CidrConflict | Cidr is conflict, Please Check your input. | - |
| 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. | 請求失敗，發生未知錯誤。 |
訪問錯誤中心查看更多錯誤碼。