全部產品
Search

搜尋本產品

    Smart Access Gateway：ModifySagWan - 修改裝置的WAN連接埠配置

    文件中心

    Smart Access Gateway：ModifySagWan - 修改裝置的WAN連接埠配置

    更新時間：Dec 21, 2025

    修改Smart Access Gateway裝置的WAN口配置。

    介面說明

    在您修改 WAN 口配置前，建議您先瞭解 WAN 口的功能資訊。更多資訊，請參見配置 WAN 口。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    smartag:ModifySagWan

    update

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    Smart Access Gateway執行個體地區 ID。 您可以調用 DescribeRegions 介面查詢Smart Access Gateway支援的地區以及對應的地區 ID。

    cn-shanghai
    SmartAGId

    string

    是

    Smart Access Gateway執行個體 ID。

    sag-whfn****
    SmartAGSn

    string

    是

    Smart Access Gateway裝置序號。

    sag32a30****
    PortName

    string

    是

    WAN 口所屬的連接埠號碼。

    0
    IPType

    string

    是

    WAN 口連線類型。取值：

    • DHCP：通過 DHCP 協議動態擷取 IP 位址，進而訪問互連網。

    • STATIC：通過靜態指定 IP 位址，進而訪問互連網。此種方式需要為 WAN 口配置靜態 IP 位址、位址遮罩及網關 IP 位址。

    • PPPOE：通過撥號方式接入互連網。此種方式需要輸入電訊廠商提供的 PPPOE 帳號和密碼。

    DHCP
    IP

    string

    否

    WAN 口 IP 位址。

    說明

    IPType 為 STATIC 時需要輸入。

    192.XX.XX.1
    Mask

    string

    否

    WAN 口 IP 位址遮罩。

    說明

    IPType 為 STATIC 時需要輸入。

    255.255.255.0
    Gateway

    string

    否

    網關 IP 位址。

    說明

    • IPType 為 STATIC 時需要輸入。

    • 配置網關後，Smart Access Gateway裝置會自動產生一條預設路由。

    192.XX.XX.254
    Username

    string

    否

    PPPOE 帳號。

    長度為 6~30 位字元，可包含數字、大小寫字母。

    說明

    IPType 為 PPPOE 時需要輸入。

    P12ppp***
    Password

    string

    否

    PPPOE 密碼。

    長度為 6~30 位字元，可包含數字、大小寫字母。

    說明

    IPType 為 PPPOE 時需要輸入。密碼不修改時可以不指定該項。

    P12ppq***
    Priority

    integer

    否

    WAN 口優先順序。

    取值範圍：-1或1~50。

    數值越小優先順序越高。-1表示該 WAN 口不啟用流量轉寄。

    1
    Weight

    integer

    否

    WAN 口權重。

    取值範圍：1~100。預設值：100。

    100
    ISP

    string

    否

    WAN 口串連的電訊廠商鏈路。取值：

    • CT：電信

    • CM：移動

    • CU：聯通

    • Other：其他

    CT
    Bandwidth

    integer

    否

    WAN 口的限速頻寬。單位：Mbps。

    50

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Sag.PortNotExist The specified port does not exist. 當前連接埠不存在。
    400 Sag.PortRoleInvalid The port role is invalid. 裝置連接埠角色不正確。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。