全部產品
Search

搜尋本產品

    ENS：CreateSnatEntry - 添加SNAT條目

    文件中心

    ENS：CreateSnatEntry - 添加SNAT條目

    更新時間：Mar 20, 2026

    調用CreateSnatEntry添加SNAT條目。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:CreateSnatEntry

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    NatGatewayId

    string

    是

    NAT Gateway的 ID。

    nat-5tawjw5j7sgd2deujxuk0****
    SnatIp

    string

    是

    SNAT 條目中的 EIP，多個 EIP 之間用半形逗號（,）隔開。

    120.XXX.XXX.71
    SourceVSwitchId

    string

    否

    需要公網訪問的交換器的 ID。該參數表示該交換器內的 ENS 執行個體均可以通過 SNAT 規則訪問公網。

    說明

    SourceVSwitchId 和 SourceCIDR 同時配置時，SourceVSwitchId 參數會被忽略，SourceCIDR 優先順序更高。

    vsw-bp1hwx7gi495q260p****
    SourceCIDR

    string

    否

    網路、交換器或執行個體的網段，還可以輸入任意網段。該網段下的所有執行個體均可以通過 SNAT 服務訪問互連網或者外部網路。

    說明

    SourceVSwitchId 和 SourceCIDR 同時配置時，SourceVSwitchId 參數會被忽略，SourceCIDR 優先順序更高。

    10.0.0.0/24
    SnatEntryName

    string

    否

    SNAT 條目的名稱。長度為 1~128 個字元，但不能以http://或https://開頭。

    test0
    SourceNetworkId

    string

    否

    網路識別碼。該參數表示該網路內的 ENS 執行個體均可以通過 SNAT 規則訪問公網。

    說明

    SourceNetworkId 和 SourceVSwitchId 或 SourceCIDR 同時配置時，SourceNetworkId 參數會被忽略，SourceCIDR 優先順序更高。優先順序：SourceCIDR＞SourceVSwitchId＞ SourceNetworkId。

    n-2zeuphj08tt7q3brd****
    StandbySnatIp

    string

    否

    SNAT 條目中的備用 EIP，多個備用 EIP 之間用半形逗號（,）隔開。

    101.XXX.XXX.7
    IdleTimeout

    integer

    否

    串連空閑逾時時間，取值：1~86400，單位：秒。

    15
    IspAffinity

    boolean

    否

    是否開啟電訊廠商親和性。取值：

    • false：不開啟。

    • true：開啟。

    true
    EipAffinity

    boolean

    否

    是否開啟 IP 親和性，不傳預設為開啟 IP 親和性。取值：

    • false：關閉 IP 親和性。

    • true：開啟 IP 親和性。

    說明

    說明 開啟 IP 親和性開關後，如果 SNAT 條目綁定多個 EIP，同一個用戶端將使用相同的 EIP 進行訪問，否則用戶端將從綁定的 EIP 中隨機選取進行訪問。

    false

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    018EED6A-69CA-58C8-A345-498927D5D34E
    SnatEntryId

    string

    SNAT 條目 ID。

    snat-5tc08qfj5ecblfdn2rqr9****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "018EED6A-69CA-58C8-A345-498927D5D34E",
  "SnatEntryId": "snat-5tc08qfj5ecblfdn2rqr9****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Invalid%s The specified parameter %s is invalid.
    400 Missing%s You must specify the parameter %s.
    400 Forbidden.SourceCIDR.NotSupport SourceCIDR support intranet cidr only.
    400 InvalidParameter.NatNotFound The specified Nat is not found. 指定的參數Nat不存在。
    400 InvalidParameter.SnatIp The specified SnatIp is not found.
    400 SnatEntryLimitExceed The limit of snat entry in the network reaches.
    400 SnatIpLimitExceed The Snat pool ip too many.
    400 InvalidParameter.SourceNetworkId The specified parameter SourceNetworkId is invalid.
    400 ens.interface.error Failed to call API. 介面調用發生異常。
    400 Forbidden.SourceCIDR.Duplicated The specified sourceCIDR is duplicated. 該源網段已配置了 SNAT 規則，請您不要重複設定。
    400 Forbidden.SnatIpUsedInDnat The snatIp is already in use in the DNAT rule. 公網IP已經在DNAT規則中使用，請檢查。
    400 InvalidParameter.SourceCIDR The specified parameter SourceCIDR is invalid. 指定的源網段不合法。
    400 InvalidVSwitchId.NotFound Specified virtual switch does not exist. 指定的虛擬交換器 ID 不存在。
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    變更歷史

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