VPN Gateway：CreateVpnAttachment

IPsec 連線所屬的地區 ID。

您可以透過呼叫 DescribeRegions 介面取得地區 ID。

IPsec 連線的名稱。

名稱長度為 1～100 個字元，不能以 http:// 或 https:// 開頭。

使用者閘道器 ID。

IPsec 連線的網路類型。取值：

• public（預設值）：公網，表示 IPsec 連線透過公網建立加密通訊通道。

• private：私網，表示 IPsec 連線透過私網建立加密通訊通道。

需要與本機資料中心互通的 VPC 側網段，用於第二階段協商。

多個網段之間使用半形逗號 (,) 分隔，例如：192.168.1.0/24,192.168.2.0/24。

關於 IPsec 連線路由模式的說明：

• 如果 LocalSubnet 和 RemoteSubnet 均輸入為 0.0.0.0/0，則表示您使用目的路由模式。

• 如果 LocalSubnet 和 RemoteSubnet 均輸入具體的網段，則表示您使用感興趣流模式。

需要與 VPC 互通的本機資料中心側網段，用於第二階段協商。

多個網段之間使用半形逗號 (,) 分隔，例如：192.168.3.0/24,192.168.4.0/24。

關於 IPsec 連線路由模式的說明：

• 如果 LocalSubnet 和 RemoteSubnet 均輸入為 0.0.0.0/0，則表示您使用目的路由模式。

• 如果 LocalSubnet 和 RemoteSubnet 均輸入具體的網段，則表示您使用感興趣流模式。

選擇 IPsec 連線的設定是否立即生效。取值：

• true：是，設定完成後系統立即進行 IPsec 協定協商。

• false（預設值）：否，當有流量進入時系統才進行 IPsec 協定協商。

建立單隧道模式的 IPsec-VPN 連線時支援設定此參數。

第一階段協商的設定資訊：

• IkeConfig.Psk：預共用金鑰，用於 VPN 閘道器與本機資料中心之間的身份驗證。

  • 金鑰長度為 1~100 個字元，支援數字、大小寫英文字母以及右側字元，不能包含空格。~!`@#$%^&*()_-+={}[]|;:',.<>/?

  • 若您未指定預共用金鑰，系統會隨機產生一個字串作為預共用金鑰。您可以呼叫 DescribeVpnConnection 介面查詢系統自動產生的預共用金鑰。

  說明

  IPsec 連線側的預共用金鑰需與本機資料中心側的驗證金鑰一致，否則本機資料中心和 VPN 閘道器之間無法建立連線。

• IkeConfig.IkeVersion：IKE 協定的版本。取值：ikev1 或 ikev2。預設值：ikev1。

• IkeConfig.IkeMode：協商模式。取值：main 或 aggressive。預設值：main。

• IkeConfig.IkeEncAlg：第一階段協商的加密演算法。取值：aes、aes192、aes256、des 或 3des。預設值：aes。

• IkeConfig.IkeAuthAlg：第一階段協商的驗證演算法。取值：md5、sha1、sha256、sha384、sha512。預設值：md5。

• IkeConfig.IkePfs：第一階段協商使用的 Diffie-Hellman 金鑰交換演算法。取值：group1、group2、group5 或 group14。預設值：group2。

• IkeConfig.IkeLifetime：第一階段協商出的 SA 生存週期。單位：秒。取值範圍：0~86400。預設值：86400。

• IkeConfig.LocalId：IPsec 連線阿里雲側的識別碼，長度限制為 100 個字元，不能包含空格。預設值為空。

• IkeConfig.RemoteId：IPsec 連線本機資料中心側的識別碼，長度限制為 100 個字元，不能包含空格。預設值為使用者閘道器的 IP 地址。

建立單隧道模式的 IPsec-VPN 連線時支援設定此參數。

第二階段協商的設定資訊：

• IpsecConfig.IpsecEncAlg：第二階段協商的加密演算法。取值：aes、aes192、aes256、des 或 3des。預設值：aes。

• IpsecConfig. IpsecAuthAlg：第二階段協商的驗證演算法。取值：md5、sha1、sha256、sha384、sha512。預設值：md5。

• IpsecConfig. IpsecPfs：第二階段協商使用的 Diffie-Hellman 金鑰交換演算法。取值：disabled、group1、group2、group5 或 group14。預設值：group2。

• IpsecConfig. IpsecLifetime：第二階段協商出的 SA 生存週期。單位：秒。取值範圍：0~86400。預設值：86400。

建立單隧道模式的 IPsec-VPN 連線時支援設定此參數。

BGP 的設定資訊：

• BgpConfig.EnableBgp：是否開啟 BGP 功能。取值：true 或 false（預設值）。

• BgpConfig.LocalAsn：阿里雲側的自治系統號。自治系統號取值範圍：1~4294967295。預設值：45104。

  支援按照兩段位的格式進行輸入，即：前 16 位元.後 16 位元。每個段位使用十進位輸入。

  例如輸入 123.456，則表示自治系統號：123*65536+456=8061384。

• BgpConfig.TunnelCidr：IPsec 隧道網段。該網段需是一個在 169.254.0.0/16 內的遮罩長度為 30 的網段，且不能是 169.254.0.0/30、169.254.1.0/30、169.254.2.0/30、169.254.3.0/30、169.254.4.0/30、169.254.5.0/30、169.254.6.0/30 和 169.254.169.252/30。

• LocalBgpIp：阿里雲側的 BGP 地址。該地址為 IPsec 隧道網段內的一個 IP 地址。

建立單隧道模式的 IPsec-VPN 連線時支援設定此參數。

健康檢查設定資訊：

• HealthCheckConfig.enable：是否開啟健康檢查，取值：true 或 false（預設值）。

• HealthCheckConfig.dip：健康檢查的目的 IP 地址。輸入 VPC 側透過 IPsec 連線可以存取的本機資料中心 IP 地址。

• HealthCheckConfig.sip：健康檢查的來源 IP 地址。輸入本機資料中心透過 IPsec 連線可以存取的 VPC 側 IP 地址。

• HealthCheckConfig.interval：健康檢查的重試間隔時間，單位：秒。預設值：3。

• HealthCheckConfig.retry：健康檢查的重試封包傳送次數。預設值：3。

• HealthCheckConfig.Policy：健康檢查失敗時是否撤銷已發佈的路由。取值：

  • revoke_route（預設值）：撤銷已發佈的路由。

  • reserve_route：不撤銷已發佈的路由。

是否自動設定路由。取值：

• true（預設值）：自動設定路由。

• false：不自動設定路由。

建立單隧道模式的 IPsec-VPN 連線時支援設定此參數。

是否開啟 DPD（對等體存活偵測）功能。取值：

• true（預設值）：開啟 DPD 功能。IPsec 發起端會傳送 DPD 封包用來偵測對端裝置是否存活，如果在設定時間內未收到正確回應則認為對端已經斷線，IPsec 將刪除 ISAKMP SA 和相應的 IPsec SA，安全隧道同樣也會被刪除。

• false：不開啟 DPD 功能，IPsec 發起端不會傳送 DPD 偵測封包。

建立單隧道模式的 IPsec-VPN 連線時支援設定此參數。

是否開啟 NAT 穿越功能。取值：

• true（預設值）：開啟 NAT 穿越功能。開啟後，IKE 協商過程會移除對 UDP 連接埠號的驗證過程，同時實現對 VPN 隧道中 NAT 閘道器裝置的發現功能。

• false：不開啟 NAT 穿越功能。

對端的 CA 憑證。

用戶端 Token，用於保證請求的冪等性。

從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

IPsec 連線所屬的資源群組 ID。

• 您可以呼叫 ListResourceGroups 介面查詢資源群組 ID。

• 如果您未指定資源群組 ID，IPsec 連線建立後將歸屬於預設資源群組。

建立雙隧道模式的 IPsec-VPN 連線時支援設定此參數。

是否為隧道開啟 BGP 功能。取值：true 或 false（預設值）。

是否只預檢此次請求。取值：

• true：傳送檢查請求，不會建立 IPsec 連線。檢查項目包括是否填寫了必需參數、請求格式、業務限制等。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼 DryRunOperation。

• false（預設值）：傳送正常請求，通過檢查後直接建立 IPsec 連線。

用於說明 VPN 單條隧道的頻寬規格，取值： Standard（預設值）：標準型，預設頻寬 1Gbps Large（大型）：大型，預設頻寬 3Gbps。