全部產品
Search
文件中心

VPN Gateway:ModifyVpnAttachmentAttribute - 修改IPsec串連的配置

更新時間:Apr 27, 2026

調用ModifyVpnAttachmentAttribute介面修改IPsec串連的配置。

介面說明

  • 修改雙隧道模式的 IPsec-VPN 串連時,除配置必填參數外,支援配置以下請求參數:ClientTokenNameLocalSubnetRemoteSubnetEffectImmediatelyTunnelOptionsSpecification 數組、EnableTunnelsBgp

  • 修改單隧道模式的 IPsec-VPN 串連時,除配置必填參數外,支援配置以下請求參數:ClientTokenNameLocalSubnetRemoteSubnetEffectImmediatelyIkeConfigIpsecConfigHealthCheckConfigEnableDpdEnableNatTraversalBgpConfigCustomerGatewayId

  • ModifyVpnAttachmentAttribute 介面屬於非同步介面,即系統返回一個請求 ID,但該 IPsec 串連的配置尚未修改成功,系統背景修改任務仍在進行。您可以調用 DescribeVpnConnection 查詢 IPsec 串連的配置的修改狀態:

    • 當 IPsec 串連處於 updating 狀態時,表示 IPsec 串連的配置正在修改中。

    • 當 IPsec 串連處於 attached 狀態時,表示 IPsec 串連的配置修改成功。

  • ModifyVpnAttachmentAttribute 介面不支援並發修改 IPsec 串連的配置。

  • 調用 ModifyVpnAttachmentAttribute 介面時,不支援修改 IPsec 串連的網關類型。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

IPsec 串連所屬的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-hangzhou

VpnConnectionId

string

IPsec 串連 ID。

vco-p0w5112fgnl2ihlmf****

Name

string

IPsec 串連的名稱。

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

nametest

LocalSubnet

string

需要和本機資料中心互連的 VPC 側的網段,用於第二階段協商。

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

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

  • 如果 LocalSubnetRemoteSubnet 均輸入為 0.0.0.0/0,則表示您使用目的路由模式。

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

10.1.1.0/24,10.1.2.0/24

RemoteSubnet

string

需要和 VPC 互連的本機資料中心側的網段,用於第二階段協商。

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

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

  • 如果 LocalSubnetRemoteSubnet 均輸入為 0.0.0.0/0,則表示您使用目的路由模式。

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

10.1.3.0/24,10.1.4.0/24

EffectImmediately

boolean

選擇 IPsec 串連的配置是否立即生效。 取值:

  • true:配置完成後系統立即進行 IPsec 協議協商。

  • false:當有流量進入時系統才進行 IPsec 協議協商。

false

IkeConfig

string

修改單隧道模式的 IPsec-VPN 串連時支援配置該參數。

第一階段協商的配置資訊:

  • IkeConfig.Psk:預先共用金鑰,用於阿里雲 IPsec 串連與本機資料中心之間的身份認證。

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

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

    說明

    IPsec 串連側的預先共用金鑰需和本機資料中心側的認證密鑰一致,否則本機資料中心和 VPN 閘道之間無法建立串連。

  • IkeConfig.IkeVersion:IKE 協議的版本。取值:ikev1ikev2

  • IkeConfig.IkeMode:協商模式。取值:mainaggressive

  • IkeConfig.IkeEncAlg:第一階段協商的密碼編譯演算法。取值:aesaes192aes256des3des

  • IkeConfig.IkeAuthAlg:第一階段協商的認證演算法。取值:md5sha1sha256sha384sha512

  • IkeConfig.IkePfs:第一階段協商使用的 Diffie-Hellman 金鑰交換演算法。取值:group1group2group5group14

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

  • IkeConfig.LocalId:IPsec 串連阿里雲側的標識,長度限制為 100 個字元,不能包含空格。

  • IkeConfig.RemoteId:IPsec 串連本機資料中心側的標識,長度限制為 100 個字元,不能包含空格。

{"Psk":"1234****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"47.XX.XX.1","RemoteId":"47.XX.XX.2"}

IpsecConfig

string

修改單隧道模式的 IPsec-VPN 串連時支援配置該參數。

第二階段協商的配置資訊:

  • IpsecConfig.IpsecEncAlg:第二階段協商的密碼編譯演算法。取值:aesaes192aes256des3des

  • IpsecConfig. IpsecAuthAlg:第二階段協商的認證演算法。取值:md5sha1sha256sha384sha512

  • IpsecConfig. IpsecPfs:第二階段協商使用的 Diffie-Hellman 金鑰交換演算法。取值:disabledgroup1group2group5group14

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

{"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400}

BgpConfig

string

修改單隧道模式的 IPsec-VPN 串連時支援配置該參數。

BGP 的配置資訊:

  • BgpConfig.EnableBgp:是否開啟 BGP 功能。取值:

    • true:開啟 BGP 功能。

    • false:關閉 BGP 功能。

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

    支援按照兩段位的格式進行輸入,即:前 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 位址。

說明
  • 在添加 BGP 配置前,建議您先瞭解 BGP 動態路由功能的工作機制和使用限制。更多資訊,請參見配置 BGP 動態路由

  • 建議您使用自治系統號的私人號碼與阿里雲建立 BGP 串連。自治系統號的私人號碼範圍請自行查閱文檔。

{"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"}

HealthCheckConfig

string

修改單隧道模式的 IPsec-VPN 串連時支援配置該參數。

健全狀態檢查配置資訊:

  • HealthCheckConfig.enable:是否開啟健全狀態檢查,取值:

    • true:開啟健全狀態檢查功能。

    • false:關閉健全狀態檢查功能。

  • HealthCheckConfig.dip:健全狀態檢查的目的 IP 位址。輸入 VPC 側通過 IPsec 串連可以訪問的本機資料中心的 IP 位址。

  • HealthCheckConfig.sip:健全狀態檢查的源 IP 位址。輸入本機資料中心通過 IPsec 串連可以訪問的 VPC 側的 IP 位址。

  • HealthCheckConfig.interval:健全狀態檢查的稍候再試時間,單位:秒。

  • HealthCheckConfig.retry:健全狀態檢查的重試發包次數。

  • HealthCheckConfig.Policy:健全狀態檢查失敗時是否撤銷發行的路由。取值:

    • revoke_route:撤銷發行的路由。

    • reserve_route:不撤銷發行的路由。

{"enable":"true","dip":"192.168.1.1","sip":"10.1.1.1","interval":"3","retry":"3","Policy": "revoke_route"}

AutoConfigRoute

boolean

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

  • true:自動設定路由。

  • false:不自動設定路由。

true

EnableDpd

boolean

修改單隧道模式的 IPsec-VPN 串連時支援配置該參數。

是否開啟 DPD(對等體存活檢測)功能。取值:

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

  • false:不開啟 DPD 功能,IPsec 發起端不會發送 DPD 探測報文。

true

EnableNatTraversal

boolean

修改單隧道模式的 IPsec-VPN 串連時支援配置該參數。

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

  • true:開啟 NAT 穿越功能。開啟後,IKE 協商過程會刪除對 UDP 連接埠號碼的驗證過程,同時實現對 VPN 隧道中 NAT Gateway裝置的發現功能。

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

true

RemoteCaCert

string

對端的 CA 憑證。

說明

當前參數暫不生效。

-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----

ClientToken

string

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

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

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

123e4567-e89b-12d3-a456-4266****

NetworkType

string

IPsec 串連的網路類型。取值:

  • public:公網,表示 IPsec 串連通過公網建立加密通訊通道。

  • private:私網,表示 IPsec 串連通過私網建立加密通訊通道。

public

CustomerGatewayId

string

IPsec 串連關聯的使用者網關執行個體。

說明

僅單隧道模式 IPsec-VPN 串連支援配置本參數。

cgw-p0w2jemrcj5u61un8****

TunnelOptionsSpecification

array<object>

配置隧道。

僅修改雙隧道模式的 IPsec-VPN 串連時支援配置 TunnelOptionsSpecification 數組下的參數。您可以同時修改 IPsec-VPN 串連兩條隧道的配置。

array<object>

配置隧道資訊。

TunnelId

string

隧道 ID。

tun-0jod7plwf2a0o9lvu****

CustomerGatewayId

string

隧道關聯的使用者網關 ID。

說明

僅雙隧道模式 IPsec-VPN 串連支援配置本參數。

cgw-p0w2jemrcj5u61un8****

TunnelIndex

integer

隧道的建立順序。

  • 1:第一條隧道。

  • 2:第二條隧道。

1

EnableDpd

boolean

是否為隧道開啟 DPD(對等體存活檢測)功能。取值:

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

  • false:不開啟 DPD 功能,IPsec 發起端不會發送 DPD 探測報文。

true

EnableNatTraversal

boolean

是否為隧道開啟 NAT 穿越功能。取值:

  • true:開啟 NAT 穿越功能。開啟後,IKE 協商過程會刪除對 UDP 連接埠號碼的驗證過程,同時實現對隧道中 NAT Gateway裝置的發現功能。

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

true

TunnelBgpConfig

object

為隧道添加 BGP 配置。

說明

當您為 IPsec 串連開啟 BGP 功能後(即指定 EnableTunnelsBgp 參數的值為 true)需要配置該參數。

LocalAsn

integer

隧道本端(阿里雲側)的自治系統號。自治系統號取值範圍:1~4294967295。預設值:45104

說明

建議您使用自治系統號的私人號碼與阿里雲建立 BGP 串連。自治系統號的私人號碼範圍請自行查閱文檔。

65530

LocalBgpIp

string

隧道本端(阿里雲側)的 BGP 地址。該地址為 BGP 網段內的一個 IP 位址。

169.254.10.1

TunnelCidr

string

隧道的 BGP 網段。該網段需是一個在 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。

說明

一個 IPsec 串連下兩個隧道的隧道網段不能相同。

169.254.10.0/30

TunnelIkeConfig

object

第一階段協商的配置資訊。

IkeAuthAlg

string

第一階段協商的認證演算法。取值:md5sha1sha256sha384sha512

sha1

IkeEncAlg

string

第一階段協商的密碼編譯演算法。取值:aesaes192aes256des3des

aes

IkeLifetime

integer

第一階段協商出的 SA 的生存周期。單位:秒。

取值範圍:0~86400

86400

IkeMode

string

IKE 版本的協商模式。取值:mainaggressive

  • main:主模式,協商過程安全性高。

  • aggressive:野蠻模式,協商快速且協商成功率高。

main

IkePfs

string

第一階段協商使用的 Diffie-Hellman 金鑰交換演算法。 取值:group1group2group5group14

group2

IkeVersion

string

IKE 協議的版本。取值:ikev1ikev2

相對於 IKEv1 版本,IKEv2 版本簡化了 SA 的協商過程並且對於多網段的情境提供了更好的支援。

ikev2

LocalId

string

隧道本端(阿里雲側)的標識,用於第一階段的協商。長度限制為 100 個字元,不能包含空格。

LocalId 支援 FQDN 格式,如果您使用 FQDN 格式,協商模式建議選擇為 aggressive(野蠻模式)。

47.XX.XX.1

Psk

string

預先共用金鑰,用於隧道與隧道對端之間的身份認證。

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

  • 若您未指定預先共用金鑰,系統會隨機產生一個 16 位的字串作為預先共用金鑰。您可以調用 DescribeVpnAttachments 介面查詢系統自動產生的預先共用金鑰。

說明

隧道及隧道對端的預先共用金鑰需一致,否則系統無法正常建立隧道。

123456****

RemoteId

string

隧道對端的標識,用於第一階段的協商。長度限制為 100 個字元,不能包含空格。

RemoteId 支援 FQDN 格式,如果您使用 FQDN 格式,協商模式建議選擇為 aggressive(野蠻模式)。

47.XX.XX.2

TunnelIpsecConfig

object

第二階段協商的配置資訊。

IpsecAuthAlg

string

第二階段協商的認證演算法。

取值:md5sha1sha256sha384sha512

sha1

IpsecEncAlg

string

第二階段協商的密碼編譯演算法。取值:aesaes192aes256des3des

aes

IpsecLifetime

integer

第二階段協商出的 SA 的生存周期。單位:秒。

取值範圍:0~86400

86400

IpsecPfs

string

第二階段協商使用的 Diffie-Hellman 金鑰交換演算法。

取值:disabledgroup1group2group5group14

group2

EnableTunnelsBgp

boolean

修改雙隧道模式的 IPsec-VPN 串連時支援配置該參數。

是否為隧道開啟 BGP 功能。取值:truefalse

說明

在添加 BGP 配置前,建議您先瞭解 BGP 動態路由功能的工作機制和使用限制。更多資訊,請參見配置 BGP 動態路由

false

返回參數

名稱

類型

描述

樣本值

object

返回結果。

VpnConnectionId

string

IPsec 串連 ID。

vco-p0w5112fgnl2ihlmf****

CustomerGatewayId

string

IPsec 串連綁定的使用者網關 ID。

僅單隧道模式的 IPsec-VPN 串連會返回該參數。

cgw-p0w2jemrcj5u61un8****

VpnGatewayId

string

IPsec 串連綁定的 VPN 閘道執行個體 ID。

vpn-not-exist:IPsec 串連未綁定 VPN 閘道執行個體。

vpn-not-exist

Name

string

IPsec 串連的名稱。

nametest

Description

string

IPsec 串連的描述資訊。

desctest

LocalSubnet

string

需要和本機資料中心互連的阿里雲側的網段,例如 VPC 的網段。

10.1.1.0/24,10.1.2.0/24

RemoteSubnet

string

需要和阿里雲互連的本機資料中心側的網段。

10.1.3.0/24,10.1.4.0/24

IkeConfig

object

第一階段協商的配置資訊。

僅單隧道模式的 IPsec-VPN 串連會返回 IkeConfig 數組下的參數。

Psk

string

預先共用金鑰,用於阿里雲 IPsec 串連與本機資料中心之間的身份認證。

說明

IPsec 串連側的預先共用金鑰需和本機資料中心側的認證密鑰一致,否則本機資料中心和 VPN 閘道之間無法建立串連。

1234***

IkeVersion

string

IKE 協議版本。

  • ikev1

  • ikev2

相對於 IKEv1 版本,IKEv2 版本簡化了 SA 的協商過程並且對於多網段的情境提供了更好的支援。

ikev1

IkeMode

string

IKE 協商模式。

  • main:主模式,協商過程安全性高。

  • aggressive:野蠻模式,協商快速且協商成功率高。

main

IkeEncAlg

string

第一階段協商的密碼編譯演算法。

aes

IkeAuthAlg

string

第一階段協商的認證演算法。

sha1

IkePfs

string

第一階段協商使用的 Diffie-Hellman 金鑰交換演算法。

group2

IkeLifetime

integer

第一階段協商出的 SA 的生存周期。單位:秒。

86400

LocalId

string

IPsec 串連阿里雲側的標識。

47.XX.XX.1

RemoteId

string

IPsec 串連對端本機資料中心側的標識。

47.XX.XX.2

IpsecConfig

object

第二階段協商的配置資訊。

僅單隧道模式的 IPsec-VPN 串連會返回 IpsecConfig 數組下的參數。

IpsecEncAlg

string

第二階段協商的密碼編譯演算法。

aes

IpsecAuthAlg

string

第二階段協商的認證演算法。

md5

IpsecPfs

string

第二階段協商使用的 Diffie-Hellman 金鑰交換演算法。

group2

IpsecLifetime

integer

第二階段協商出的 SA 的生存周期。單位:秒。

86400

CreateTime

integer

建立 IPsec 串連的時間戳記。單位:毫秒。

時間戳記的格式採用 Unix 時間戳記,表示從格林威治時間 1970 年 01 月 01 日 00 時 00 分 00 秒至建立 IPsec 串連時的總時間長度。

1658201810000

EffectImmediately

boolean

IPsec 串連的配置是否立即生效。

  • true:是。

  • false:否。

false

Status

string

IPsec 串連的狀態。

  • ike_sa_not_established:第一階段協商失敗。

  • ike_sa_established:第一階段協商成功。

  • ipsec_sa_not_established:第二階段協商失敗。

  • ipsec_sa_established:第二階段協商成功。

ike_sa_not_established

VcoHealthCheck

object

IPsec 串連的健全狀態檢查配置資訊。

僅單隧道模式的 IPsec-VPN 串連會返回 VcoHealthCheck 數組下的參數。

Enable

string

IPsec 串連是否已開啟健全狀態檢查功能。

  • true:已開啟。

  • false:未開啟。

true

Sip

string

健全狀態檢查的源 IP 位址。

10.1.1.1

Dip

string

健全狀態檢查的目的 IP 位址。

192.168.1.1

Interval

integer

健全狀態檢查的稍候再試時間。單位:秒。

3

Retry

integer

健全狀態檢查的重試發包次數。

3

Policy

string

健全狀態檢查失敗時是否撤銷發行的路由。

  • revoke_route:撤銷發行的路由。

  • reserve_route:不撤銷發行的路由。

revoke_route

EnableDpd

boolean

IPsec 串連是否已開啟 DPD 功能。

  • true:已開啟。

  • false:未開啟。

僅單隧道模式的 IPsec-VPN 串連會返回該參數。

true

EnableNatTraversal

boolean

IPsec 串連是否已開啟 NAT 穿越功能。

  • true:已開啟。

  • false:未開啟。

僅單隧道模式的 IPsec-VPN 串連會返回該參數。

true

VpnBgpConfig

object

IPsec 串連的 BGP 配置資訊。

僅單隧道模式的 IPsec-VPN 串連會返回 VpnBgpConfig 數組下的參數。

EnableBgp

string

IPsec 串連是否已開啟 BGP 功能。

  • true:已開啟。

  • false:未開啟。

true

TunnelCidr

string

IPsec 隧道網段。

169.254.11.0/30

LocalBgpIp

string

阿里雲側的 BGP IP 位址。

169.254.11.1

PeerBgpIp

string

本機資料中心側的 BGP IP 位址。

169.254.11.2

LocalAsn

integer

阿里雲側的自治系統號。

45104

PeerAsn

integer

本機資料中心側的自治系統號。

65535

Status

string

BGP 的協商狀態。

  • success:正常。

  • false:異常。

false

AttachType

string

IPsec 串連綁定的資源類型。

  • CEN:表示 IPsec 串連綁定了轉寄路由器執行個體。

  • VPNGW:表示 IPsec 串連綁定了 VPN 閘道執行個體。

  • NO_ASSOCIATED:表示 IPsec 串連未綁定任何資源。

CEN

NetworkType

string

IPsec 串連的網路類型。

  • public:公網。

  • private:私網。

public

AttachInstanceId

string

IPsec 串連綁定的轉寄路由器執行個體所屬的雲企業網執行個體 ID。

cen-c2r3m3zxkumoqz****

Spec

string

IPsec 串連的頻寬規格。

傳回值中 M 表示單位 Mbps

1000M

ResourceGroupId

string

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

您可以調用 ListResourceGroups 介面查詢資源群組資訊。

rg-acfmzs372yg****

TunnelOptionsSpecification

array<object>

IPsec 串連的隧道配置資訊。

僅雙隧道模式的 IPsec 串連會返回 TunnelOptionsSpecification 數組下的參數。

array<object>

隧道的配置資訊。

CustomerGatewayId

string

隧道關聯的使用者網關 ID。

cgw-p0w2jemrcj5u61un8****

EnableDpd

boolean

隧道是否已開啟 DPD 功能。

  • true:已開啟。

  • false:未開啟。

true

EnableNatTraversal

boolean

隧道是否已開啟 NAT 穿越功能。

  • true:已開啟。

  • false:未開啟。

true

InternetIp

string

隧道阿里雲側網關 IP 位址。

47.XX.XX.66

Role

string

隧道的角色。

  • master:表示當前隧道為主隧道。

  • slave:表示當前隧道為備隧道。

master

TunnelId

string

隧道 ID。

tun-0jod7plwf2a0o9lvu****

TunnelIndex

integer

隧道的建立順序。

  • 1:第一條隧道。

  • 2:第二條隧道。

1

State

string

隧道的狀態。

  • active:狀態正常。

  • updating:更新中。

  • deleting:刪除中。

active

TunnelBgpConfig

object

隧道的 BGP 配置資訊。

LocalAsn

integer

隧道本端(阿里雲側)的自治系統號。

65530

LocalBgpIp

string

隧道本端(阿里雲側)的 BGP 地址。

169.254.10.1

PeerAsn

integer

隧道對端的自治系統號。

65531

PeerBgpIp

string

隧道對端的 BGP 地址。

169.254.10.2

TunnelCidr

string

隧道的 BGP 網段。

169.254.10.0/30

TunnelIkeConfig

object

第一階段協商的配置。

IkeAuthAlg

string

IKE 階段認證演算法。

sha1

IkeEncAlg

string

IKE 階段密碼編譯演算法。

aes

IkeLifetime

integer

IKE 階段存留時間。單位:秒。

86400

IkeMode

string

IKE 版本的協商模式。取值:

  • main:主模式,協商過程安全性高。

  • aggressive:野蠻模式,協商快速且協商成功率高。

main

IkePfs

string

IKE 階段 DH 分組。

group2

IkeVersion

string

IKE 協議版本。

ikev2

LocalId

string

隧道本端(阿里雲側)的標識。

47.XX.XX.1

Psk

string

預先共用金鑰。

123456****

RemoteId

string

隧道對端的標識。

47.XX.XX.2

TunnelIpsecConfig

object

第二階段協商的配置。

IpsecAuthAlg

string

IPsec 階段認證演算法。

sha1

IpsecEncAlg

string

IPsec 階段密碼編譯演算法。

aes

IpsecLifetime

integer

IPsec 階段存留時間。單位:秒。

86400

IpsecPfs

string

IPsec 階段 DH 分組。

group2

EnableTunnelsBgp

boolean

隧道 BGP 的開啟狀態。

  • true:已開啟。

  • false:未開啟。

僅雙隧道模式的 IPsec-VPN 串連會返回該參數。

false

RequestId

string

請求 ID。

35822A84-867F-3936-A2E6-A4C4E3ED11C0

樣本

正常返回樣本

JSON格式

{
  "VpnConnectionId": "vco-p0w5112fgnl2ihlmf****",
  "CustomerGatewayId": "cgw-p0w2jemrcj5u61un8****",
  "VpnGatewayId": "vpn-not-exist",
  "Name": "nametest",
  "Description": "desctest",
  "LocalSubnet": "10.1.1.0/24,10.1.2.0/24",
  "RemoteSubnet": "10.1.3.0/24,10.1.4.0/24",
  "IkeConfig": {
    "Psk": "1234***",
    "IkeVersion": "ikev1",
    "IkeMode": "main",
    "IkeEncAlg": "aes",
    "IkeAuthAlg": "sha1",
    "IkePfs": "group2",
    "IkeLifetime": 86400,
    "LocalId": "47.XX.XX.1",
    "RemoteId": "47.XX.XX.2"
  },
  "IpsecConfig": {
    "IpsecEncAlg": "aes",
    "IpsecAuthAlg": "md5",
    "IpsecPfs": "group2",
    "IpsecLifetime": 86400
  },
  "CreateTime": 1658201810000,
  "EffectImmediately": false,
  "Status": "ike_sa_not_established",
  "VcoHealthCheck": {
    "Enable": "true",
    "Sip": "10.1.1.1",
    "Dip": "192.168.1.1",
    "Interval": 3,
    "Retry": 3,
    "Policy": "revoke_route"
  },
  "EnableDpd": true,
  "EnableNatTraversal": true,
  "VpnBgpConfig": {
    "EnableBgp": "true",
    "TunnelCidr": "169.254.11.0/30",
    "LocalBgpIp": "169.254.11.1",
    "PeerBgpIp": "169.254.11.2",
    "LocalAsn": 45104,
    "PeerAsn": 65535,
    "Status": "false"
  },
  "AttachType": "CEN",
  "NetworkType": "public",
  "AttachInstanceId": "cen-c2r3m3zxkumoqz****",
  "Spec": "1000M",
  "ResourceGroupId": "rg-acfmzs372yg****",
  "TunnelOptionsSpecification": [
    {
      "CustomerGatewayId": "cgw-p0w2jemrcj5u61un8****",
      "EnableDpd": true,
      "EnableNatTraversal": true,
      "InternetIp": "47.XX.XX.66",
      "Role": "master",
      "TunnelId": "tun-0jod7plwf2a0o9lvu****",
      "TunnelIndex": 1,
      "State": "active",
      "TunnelBgpConfig": {
        "LocalAsn": 65530,
        "LocalBgpIp": "169.254.10.1",
        "PeerAsn": 65531,
        "PeerBgpIp": "169.254.10.2",
        "TunnelCidr": "169.254.10.0/30"
      },
      "TunnelIkeConfig": {
        "IkeAuthAlg": "sha1",
        "IkeEncAlg": "aes",
        "IkeLifetime": 86400,
        "IkeMode": "main",
        "IkePfs": "group2",
        "IkeVersion": "ikev2",
        "LocalId": "47.XX.XX.1",
        "Psk": "123456****",
        "RemoteId": "47.XX.XX.2"
      },
      "TunnelIpsecConfig": {
        "IpsecAuthAlg": "sha1",
        "IpsecEncAlg": "aes",
        "IpsecLifetime": 86400,
        "IpsecPfs": "group2"
      }
    }
  ],
  "EnableTunnelsBgp": false,
  "RequestId": "35822A84-867F-3936-A2E6-A4C4E3ED11C0"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 VpnConnection.Configuring The specified service is configuring. 服務正在配置中,請您稍後再試。
400 VpnConnection.FinancialLocked The specified service is financial locked. 指定的服務欠費鎖定。
400 InvalidName The name is not valid
400 VpnRouteEntry.AlreadyExists The specified route entry is already exist. 該路由已存在。
400 VpnRouteEntry.Conflict The specified route entry has conflict. 路由條目存在衝突。
400 NotSupportVpnConnectionParameter.IpsecPfs The specified vpn connection ipsec Ipsec Pfs is not support. IPsec串連中指定的Pfs參數不支援
400 NotSupportVpnConnectionParameter.IpsecAuthAlg The specified vpn connection ipsec Auth Alg is not support. IPsec串連中指定的認證演算法不支援
400 VpnRouteEntry.BackupRoute Validate backup route entry failed. 主備路由條目校正失敗。
400 VpnRouteEntry.InvalidWeight Invalid route entry weight value. 路由權重值不合法
400 MissingParameter.TunnelCidr The parameter TunnelCidr is mandatory when BGP is enabled. 開啟BGP時,隧道CIDR參數是必填項
400 OperationUnsupported.EnableBgp Current region does not support enable BGP. 當前地區不支援開啟BGP。
400 MissingParam.CustomerGatewayAsn Asn of customer gateway is mandatory when BGP is enabled. 開啟BGP時,客戶網關的自治系統號不可以為空白。
400 IllegalParam.LocalAsn The specified LocalAsn is invalid. 本端自治系統號不合法。
400 IllegalParam.BgpConfig The specified BgpConfig is invalid. 指定的BGP配置不合法
400 IllegalParam.EnableBgp VPN connection must enable BGP when VPN gateway has enabled BGP. 當 VPN 閘道啟用 BGP 時,VPN 串連必須啟用 BGP。
400 IllegalParam.TunnelCidr The specified TunnelCidr is invalid. 參數TunnelCidr不合法。
400 InvalidLocalBgpIp.Malformed The specified LocalBgpIp is malformed. 指定的本端BGP的IP異常
400 IllegalParam.LocalBgpIp The specified LocalBgpIp is invalid. 本端BGP地址不合法。
400 IllegalParam.LocalSubnet The specified "LocalSubnet" (%s) is invalid. 本端網段(%s)不合法。
400 IllegalParam.RemoteSubnet The specified "RemoteSubnet" (%s) is invalid. 對端網段(%s)不合法。
400 CustomerGateway.ConflictRouteEntry The specified customer gateway has conflict with route entry. 目前使用者網關和路由存在衝突。
400 IllegalParam.NetworkType The specified NetworkType (%s) is invalid. 網路類型不合法。
400 InvalidTunnelCidr.Malformed The specified TunnelCidr is malformed. 指定的隧道CIDR異常
400 VpnGateway.Configuring The specified service is configuring.
400 VpnTask.CONFLICT Vpn task has conflict. Vpn操作存在衝突,請稍後重試。
400 ModifyIkeV1WithMultiRoutes.Invalid Failed to modify VPN connection parameters. Multi-network is configured while using IkeV1 protocol. 修改VPN串連參數失敗,在使用IkeV1協議的同時配置了多網端。
400 InvalidVpnGatewayInstanceId.NotFound The specified vpn gateway instance id does not exist. 指定的 VPN 閘道不存在,請您檢查 VPN 閘道是否正確。
400 Resource.QuotaFull The resources you are operating have reached the upper limit of the quota. Please increase the quota or use other solutions to avoid it according to the VPN operation document. 您現在所操作的資源目前已經達到了配額的上限,請參考VPN操作文檔,進行配額提升或者使用其他方案進行規避。
400 CreateDbrRoutesQuotaFull.QuotaFull The number of created destination routes exceeds the quota limit. 建立目的路由數量超過配額限制。
400 CreatePbrRoutesQuotaFull.QuotaFull The number of policy routes exceeds the quota limit. 策略路由數量超過配額限制。
400 EncAlgInvalid.DesIncompatible Des/3des in IkeEncAlg and IpsecEncAlg does not support multi algorithm. Ike密碼編譯演算法以及IPsec密碼編譯演算法中,des/3des不支援多演算法相容。
400 IkeVersionInvalid.GcmIncompatible Ikev1 does not support IkeEncAlg of gcm16. Ikev1不支援IKE密碼編譯演算法僅配置gcm16演算法。
400 CustomerGateway.ConflictVpnIp The specified customer gateway has conflict with vpn gateway ip. 使用者網關的ip與VPN網關ip衝突。
403 Forbbiden.SubUser User not authorized to operate on the specified resource as your account is created by another user.
403 Forbidden User not authorized to operate on the specified resource. 您沒有許可權操作指定資源,請申請許可權後再操作。
404 InvalidVpnConnectionInstanceId.NotFound The specified vpn connection instance id does not exist. 指定的VPN串連不存在,請您檢查該VPN串連ID是否正確。

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

變更歷史

更多資訊,參考變更詳情