Tüm Ürünler
Search
Belge Merkezi

:CreateVpnAttachment

Son Güncelleme:Oct 04, 2026

Bir IPsec-VPN bağlantısı oluşturur. IPsec-VPN bağlantısını oluşturduktan sonra bu bağlantıyı bir geçiş yönlendiricisiyle ilişkilendirebilirsiniz.

Kullanım notları

CreateVpnAttachment işlemi çağrılarak oluşturulan bir IPsec-VPN bağlantısı varsayılan olarak herhangi bir kaynakla ilişkili değildir. CreateTransitRouterVpnAttachment işlemini çağırarak bir IPsec-VPN bağlantısını bir geçiş yönlendiricisiyle ilişkilendirebilirsiniz.

Ön koşullar

IPsec-VPN bağlantısı oluşturmadan önce, bu bağlantıyı oluşturmak istediğiniz bölgede bir müşteri ağ geçidi oluşturduğunuzdan emin olun. Daha fazla bilgi için CreateCustomerGateway konusuna bakın.

Bir IPsec-VPN bağlantısına BGP yapılandırmaları eklemek istiyorsanız, müşteri ağ geçidine bir özerk sistem numarası (ASN) atanmış olduğundan emin olun.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet CreateVpnAttachment

Gerçekleştirmek istediğiniz işlem. Değeri CreateVpnAttachment olarak ayarlayın.

RegionId String Evet ap-southeast-2

IPsec-VPN bağlantısının kurulduğu bölgenin kimliği.

En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

Name String Hayır nametest

IPsec-VPN bağlantısının adı.

Ad 1 ila 100 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

CustomerGatewayId String Evet cgw-p0w2jemrcj5u61un8****

Müşteri ağ geçidinin kimliği.

NetworkType String Hayır public

IPsec-VPN bağlantısının ağ türü. Geçerli değerler:

  • public (varsayılan)
  • private
LocalSubnet String Evet 10.1.1.0/24,10.1.2.0/24

VPC tarafındaki CIDR bloğu. Bu CIDR bloğu Aşama 2 müzakerelerinde kullanılır.

Birden çok CIDR bloğunu virgülle (,) ayırın. Örnek: 192.168.1.0/24,192.168.2.0/24.

Aşağıdaki yönlendirme modları desteklenir:

  • LocalSubnet ve RemoteSubnet değerlerini 0.0.0.0/0 olarak ayarlarsanız, IPsec-VPN bağlantısının yönlendirme modu Hedef Yönlendirme Modu olarak ayarlanır.
  • LocalSubnet ve RemoteSubnet değerlerini belirli CIDR bloklarına ayarlarsanız, IPsec-VPN bağlantısının yönlendirme modu Korunan Veri Akışları olarak ayarlanır.
RemoteSubnet String Evet 10.1.3.0/24,10.1.4.0/24

Veri merkezi tarafındaki CIDR bloğu. Bu CIDR bloğu Aşama 2 müzakerelerinde kullanılır.

Birden çok CIDR bloğunu virgülle (,) ayırın. Örnek: 192.168.3.0/24,192.168.4.0/24.

Aşağıdaki yönlendirme modları desteklenir:

  • LocalSubnet ve RemoteSubnet değerlerini 0.0.0.0/0 olarak ayarlarsanız, IPsec-VPN bağlantısının yönlendirme modu Hedef Yönlendirme Modu olarak ayarlanır.
  • LocalSubnet ve RemoteSubnet değerlerini belirli CIDR bloklarına ayarlarsanız, IPsec-VPN bağlantısının yönlendirme modu Korunan Veri Akışları olarak ayarlanır.
EffectImmediately Boolean Hayır false

IPsec müzakerelerinin hemen başlatılıp başlatılmayacağını belirtir. Geçerli değerler:

  • true: yapılandırma tamamlandıktan sonra IPsec müzakerelerini hemen başlatır.
  • false (varsayılan): gelen trafik alındığında IPsec müzakerelerini başlatır.
IkeConfig String Hayır {"Psk":"1234****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"47.XX.XX.1","RemoteId":"47.XX.XX.2"}

Aşama 1 müzakerelerinin yapılandırması:

  • IkeConfig.Psk: VPN ağ geçidi ile veri merkezi arasında kimlik doğrulama için kullanılan önceden paylaşılan anahtar.
    • Anahtar 1 ila 100 karakter uzunluğunda olmalı ve rakamlar, harfler ile aşağıdaki karakterleri içerebilir:
      ~!`@#$%^&*()_-+={}[]|;:',.<>/?
    • Önceden paylaşılan bir anahtar belirtmezseniz sistem rastgele 16 bitlik bir dizeyi önceden paylaşılan anahtar olarak oluşturur. Sistem tarafından oluşturulan önceden paylaşılan anahtarı sorgulamak için DescribeVpnConnection işlemini çağırabilirsiniz.
      Not IPsec-VPN bağlantısının önceden paylaşılan anahtarı, veri merkezinin kimlik doğrulama anahtarıyla aynı olmalıdır. Aksi takdirde veri merkezi ile VPN ağ geçidi arasında bağlantı kuramazsınız.
  • IkeConfig.IkeVersion: IKE protokolünün sürümü. Geçerli değerler: ikev1 ve ikev2. Varsayılan değer: ikev1.
  • IkeConfig.IkeMode: müzakere modu. Geçerli değerler: main ve aggressive. Varsayılan değer: main.
  • IkeConfig.IkeEncAlg: Aşama 1 müzakerelerinde kullanılan şifreleme algoritması. Geçerli değerler: aes, aes192, aes256, des ve 3des. Varsayılan değer: aes.
  • IkeConfig.IkeAuthAlg: Aşama 1 müzakerelerinde kullanılan kimlik doğrulama algoritması. Geçerli değerler: md5, sha1, sha256, sha384 ve sha512. Varsayılan değer: md5.
  • IkeConfig.IkePfs: Aşama 1 müzakerelerinde kullanılan Diffie-Hellman anahtar değişim algoritması. Geçerli değerler: group1, group2, group5 ve group14. Varsayılan değer: group2.
  • IkeConfig.IkeLifetime: Aşama 1 müzakereleriyle belirlenen SA yaşam süresi. Birim: saniye. Geçerli değerler: 0 ila 86400. Varsayılan değer: 86400.
  • IkeConfig.LocalId: Alibaba Cloud tarafındaki tanımlayıcı. Tanımlayıcı 100 karakteri aşamaz. Bu parametre varsayılan olarak boştur.
  • IkeConfig.RemoteId: veri merkezi tarafındaki tanımlayıcı. Tanımlayıcı 100 karakteri aşamaz. Varsayılan değer, müşteri ağ geçidinin IP adresidir.
IpsecConfig String Hayır {"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400}

Aşama 2 müzakerelerinin yapılandırmaları:

  • IpsecConfig.IpsecEncAlg: Aşama 2 müzakerelerinde kullanılan şifreleme algoritması. Geçerli değerler: aes, aes192, aes256, des ve 3des. Varsayılan değer: aes.
  • IpsecConfig. IpsecAuthAlg: Aşama 2 müzakerelerinde kullanılan kimlik doğrulama algoritması. Geçerli değerler: md5, sha1, sha256, sha384 ve sha512. Varsayılan değer: md5.
  • IpsecConfig. IpsecPfs: Aşama 2 müzakerelerinde kullanılan Diffie-Hellman anahtar değişim algoritması. Geçerli değerler: disabled, group1, group2, group5 ve group14. Varsayılan değer: group2.
  • IpsecConfig. IpsecLifetime: Aşama 2 müzakereleriyle belirlenen SA yaşam süresi. Birim: saniye. Geçerli değerler: 0 ila 86400. Varsayılan değer: 86400.
BgpConfig String Hayır {"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"}

Sınır Ağ Geçidi Protokolü (BGP) yapılandırması:

  • BgpConfig.EnableBgp: BGP'nin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true ve false. Varsayılan değer: false.
  • BgpConfig.LocalAsn: Alibaba Cloud tarafındaki ASN. Geçerli değerler: 1 ila 4294967295. Varsayılan değer: 45104.
  • BgpConfig.TunnelCidr: IPsec tünelinin CIDR bloğu. CIDR bloğu 169.254.0.0/16 aralığına ait olmalıdır. CIDR bloğunun alt ağ maskesi 30 bit uzunluğunda olmalıdır.
  • LocalBgpIp: Alibaba Cloud tarafındaki BGP IP adresi. Bu IP adresi IPsec tünelinin CIDR bloğu içinde yer almalıdır.
Not
  • BGP'yi yapılandırmadan önce BGP'nin çalışma şeklini ve sınırlamalarını öğrenmenizi öneririz. Daha fazla bilgi için BGP dinamik yönlendirme konusuna bakın.
  • BGP üzerinden Alibaba Cloud ile bağlantı kurarken özel bir ASN kullanmanızı öneririz. Özel ASN aralığı için ilgili belgelere bakın.
HealthCheckConfig String Hayır {"enable":"true","dip":"192.168.1.1","sip":"10.1.1.1","interval":"3","retry":"3","Policy": "revoke_route"}

Sağlık denetimi yapılandırması:

  • HealthCheckConfig.enable: sağlık denetimlerinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true ve false. Varsayılan değer: false.
  • HealthCheckConfig.dip: sağlık denetimleri için kullanılan hedef IP adresi. VPC'nin IPsec-VPN bağlantısı üzerinden iletişim kurabileceği veri merkezi tarafındaki IP adresini girin.
  • HealthCheckConfig.sip: sağlık denetimleri için kullanılan kaynak IP adresi. Veri merkezinin IPsec-VPN bağlantısı üzerinden iletişim kurabileceği VPC tarafındaki IP adresini girin.
  • HealthCheckConfig.interval: ardışık iki sağlık denetimi arasındaki süre. Birim: saniye. Varsayılan değer: 3.
  • HealthCheckConfig.retry: maksimum sağlık denetimi yeniden deneme sayısı. Varsayılan değer: 3.
  • HealthCheckConfig.Policy: sağlık denetimleri başarısız olduğunda yayımlanan rotaların geri çekilip çekilmeyeceğini belirtir. Geçerli değerler:
    • revoke_route (varsayılan): yayımlanan rotaları geri çeker.
    • reserve_route: yayımlanan rotaları geri çekmez.
AutoConfigRoute Boolean Hayır true

Rotaların otomatik olarak yapılandırılıp yapılandırılmayacağını belirtir. Geçerli değerler:

  • true (varsayılan)
  • false
EnableDpd Boolean Hayır true

Eş canlılık algılama (DPD) özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true (varsayılan) IPsec-VPN bağlantısının başlatıcısı, eşin varlığını ve kullanılabilirliğini doğrulamak için DPD paketleri gönderir. Belirtilen süre içinde eşten yanıt alınamazsa bağlantı başarısız olur. ISAKMP SA'ları ve IPsec SA'ları silinir. IPsec tüneli de silinir.
  • false
EnableNatTraversal Boolean Hayır true

NAT geçişinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true (varsayılan) NAT geçişi etkinleştirildikten sonra başlatıcı, IKE müzakereleri sırasında UDP bağlantı noktalarını kontrol etmez ve VPN tüneli boyunca NAT ağ geçidi cihazlarını otomatik olarak keşfedebilir.
  • false
RemoteCaCert String Hayır -----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----

IPsec-VPN bağlantısını oluşturmak için ShangMi (SM) VPN ağ geçidi kullanıldığında eş CA sertifikası.

ClientToken String Hayır 123e4567-e89b-12d3-a456-4266****

İsteğin yinelenmezliğini sağlamak için kullanılan istemci belirteci.

Belirteci istemci aracılığıyla oluşturabilirsiniz ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir.

Not Bu parametreyi belirtmezseniz sistem otomatik olarak istek kimliğini istemci belirteci olarak kullanır. İstek kimliği her istek için farklı olabilir.
Tags.N.Key String Hayır TagKey

Etiket anahtarı. Etiket anahtarı boş bir dize olamaz.

En fazla 64 karakter uzunluğunda olabilir ve http:// veya https:// içeremez. aliyun veya acs: ile başlayamaz.

Her çağrıda en fazla 20 etiket anahtarı belirtebilirsiniz.

Tags.N.Value String Hayır TagValue

Etiket değeri.

Etiket değeri boş bir dize olabilir ve 128 karakteri aşamaz. aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.

Her etiket anahtarı bir etiket değerine karşılık gelir. Her çağrıda en fazla 20 etiket değeri belirtebilirsiniz.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String 88187252-0E26-3C4D-9D1D-32A04454EBBA

İstek kimliği.

VpnConnectionId String vco-p0wb09rama8qwwgfn****

IPsec-VPN bağlantısının kimliği.

Name String nametest

IPsec-VPN bağlantısının adı.

CreateTime Long 1658201810000

IPsec-VPN bağlantısı kurulduğunda oluşturulan zaman damgası. Birim: milisaniye.

Bu değer, 1 Ocak 1970 00:00:00 UTC epoch zamanından itibaren geçen milisaniye sayısını temsil eden bir UNIX zaman damgasıdır.

Code String 200

Geçerli işlem tarafından döndürülen durum kodu. 200 işlemin başarılı olduğunu gösterir.

Success Boolean true

Geçerli işlemin başarılı olup olmadığını gösterir.

  • true
  • false
Message String successful

Geçerli işlem tarafından döndürülen bilgiler.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateVpnAttachment
&RegionId=ap-southeast-2
&Name=nametest
&CustomerGatewayId=cgw-p0w2jemrcj5u61un8****
&NetworkType=public
&LocalSubnet=10.1.1.0/24,10.1.2.0/24
&RemoteSubnet=10.1.3.0/24,10.1.4.0/24
&EffectImmediately=false
&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":"sha1","IpsecPfs":"group2","IpsecLifetime":86400}
&BgpConfig={"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"}
&HealthCheckConfig={"enable":"true","dip":"192.168.1.1","sip":"10.1.1.1","interval":"3","retry":"3","Policy": "revoke_route"}
&AutoConfigRoute=true
&EnableDpd=true
&EnableNatTraversal=true
&ClientToken=123e4567-e89b-12d3-a456-4266****
&Tags=[{"Key":"TagKey","Value":"TagValue"}]
&Common request parameters

Başarılı örnek yanıtlar

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateVpnAttachmentResponse>
    <RequestId>88187252-0E26-3C4D-9D1D-32A04454EBBA</RequestId>
    <VpnConnectionId>vco-p0wb09rama8qwwgfn****</VpnConnectionId>
    <Name>nametest</Name>
    <CreateTime>1658201810000</CreateTime>
    <Code>200</Code>
    <Success>true</Success>
    <Message>successful</Message>
</CreateVpnAttachmentResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "88187252-0E26-3C4D-9D1D-32A04454EBBA",
  "VpnConnectionId" : "vco-p0wb09rama8qwwgfn****",
  "Name" : "nametest",
  "CreateTime" : 1658201810000,
  "Code" : "200",
  "Success" : true,
  "Message" : "successful"
}

Hata kodları

HttpCode

Hata kodu

Hata mesajı

Açıklama

400

VpnRouteEntry.AlreadyExists

The specified route entry is already exist.

Rota zaten mevcut olduğu için döndürülen hata mesajı.

400

VpnRouteEntry.Conflict

The specified route entry has conflict.

Belirtilen rota mevcut bir rotayla çakıştığı için döndürülen hata mesajı.

400

NotSupportVpnConnectionParameter.IpsecPfs

The specified vpn connection ipsec Ipsec Pfs is not support.

IPsec bağlantısı için belirtilen Perfect Forward Secrecy (PFS) parametre kümesi desteklenmediği için döndürülen hata mesajı.

400

NotSupportVpnConnectionParameter.IpsecAuthAlg

The specified vpn connection ipsec Auth Alg is not support.

IPsec-VPN bağlantısı için belirtilen kimlik doğrulama algoritması desteklenmediği için döndürülen hata mesajı.

400

VpnRouteEntry.BackupRoute

Validate backup route entry failed.

Aktif/yedek rotalar kimlik doğrulamayı geçemediği için döndürülen hata mesajı.

400

VpnRouteEntry.InvalidWeight

Invalid route entry weight value.

Rota için belirtilen ağırlık geçersiz olduğu için döndürülen hata mesajı.

400

InvalidParameter.VpnConnectionName

The specified vpn connection name is invalid.

VPN bağlantısı adı gereksinimleri karşılamadığı için döndürülen hata mesajı.

400

QuotaExceeded.PolicyBasedRoute

The maximum number of policy-based routes is exceeded. Existing routes: %s. Routes to be created: %s. Maximum routes: %s.

İlke tabanlı rota sayısı üst sınıra ulaştığı için döndürülen hata mesajı. Oluşturabileceğiniz maksimum rota sayısı %s'dir. Mevcut rota sayısı %s'dir. %s rota oluşturuyorsunuz.

400

MissingParameter.TunnelCidr

The parameter TunnelCidr is mandatory when BGP is enabled.

BGP'yi etkinleştirdiğinizde tünel CIDR bloğunu ayarlamanız gerektiği için döndürülen hata mesajı.

400

MissingParam.CustomerGatewayAsn

Asn of customer gateway is mandatory when BGP is enabled.

BGP'yi etkinleştirdiğinizde müşteri ağ geçidinin ASN'si boş bırakılamayacağı için döndürülen hata mesajı.

400

IllegalParam.LocalAsn

The specified LocalAsn is invalid.

Yerel ASN geçersiz olduğu için döndürülen hata mesajı.

400

InvalidParameter.BgpConfig

The specified BgpConfig is invalid.

BGP yapılandırması geçersiz olduğu için döndürülen hata mesajı.

400

IllegalParam.TunnelCidr

The specified TunnelCidr is invalid.

TunnelCidr parametresi geçersiz bir değere ayarlandığı için döndürülen hata mesajı.

400

InvalidLocalBgpIp.Malformed

The specified LocalBgpIp is malformed.

Yerel BGP IP adresi anormal durumda olduğu için döndürülen hata mesajı.

400

IllegalParam.LocalSubnet

The specified "LocalSubnet" (%s) is invalid.

LocalSubnet (%s) geçersiz bir değere ayarlandığı için döndürülen hata mesajı.

400

IllegalParam.RemoteSubnet

The specified "RemoteSubnet" (%s) is invalid.

RemoteSubnet (%s) geçersiz bir değere ayarlandığı için döndürülen hata mesajı.

400

IllegalParam.LocalBgpIp

The specified LocalBgpIp is invalid.

Yerel BGP IP adresi geçersiz olduğu için döndürülen hata mesajı.

400

OperationFailed.MissCertificate

The VPN connecton has not associated any certificates.

VPN ağ geçidi bir sertifikayla ilişkilendirilmediği için döndürülen hata mesajı.

400

MissingParam.RemoteId

The remote ID is mandatory when creating national standard VPN connection.

Eş kimliği belirtilmediği için döndürülen hata mesajı. SM ile şifrelenen bir VPN bağlantısı oluştururken eş kimliğini belirtmeniz gerekir.

400

IllegalParam.EnableBgp

VPN connection must enable BGP when VPN gateway has enabled BGP.

VPN ağ geçidi için BGP etkinleştirilmişse VPN bağlantısının BGP kullanması gerektiği için döndürülen hata mesajı.

400

Forbidden.TagKey.Duplicated

The specified tag key already exists.

Etiket anahtarı zaten mevcut olduğu için döndürülen hata mesajı.

400

SizeLimitExceeded.TagNum

The maximum number of tags is exceeded.

Etiket sayısı üst sınırı aştığı için döndürülen hata mesajı.

400

InvalidParameter.TagValue

The specified parameter TagValue is invalid.

Belirtilen etiket değeri geçersiz olduğu için döndürülen hata mesajı.

400

InvalidParameter.TagKey

The specified parameter TagKey is invalid.

Belirtilen etiket anahtarı geçersiz olduğu için döndürülen hata mesajı.

400

Duplicated.TagKey

The specified parameter TagKey is duplicated.

Belirtilen etiket anahtarı zaten mevcut olduğu için döndürülen hata mesajı.

400

InternalError

The request processing has failed due to some unknown error, exception or failure.

Dahili bir hata oluştuğu için döndürülen hata mesajı.

400

InvalidTunnelCidr.Malformed

The specified TunnelCidr is malformed.

Belirtilen tünel CIDR bloğu anormal olduğu için döndürülen hata mesajı.

403

Forbbiden.SubUser

User not authorized to operate on the specified resource as your account is created by another user.

Belirtilen kaynakta bu işlemi gerçekleştirme yetkiniz olmadığı için döndürülen hata mesajı. Gerekli izinleri alın ve tekrar deneyin.

403

Forbidden

User not authorized to operate on the specified resource.

Belirtilen kaynakta bu işlemi gerçekleştirme yetkiniz olmadığı için döndürülen hata mesajı. Gerekli izinler için başvurun ve tekrar deneyin.

404

InvalidCustomerGatewayInstanceId.NotFound

The specified customer gateway instance id does not exist.

Belirtilen müşteri ağ geçidi mevcut olmadığı için döndürülen hata mesajı. Müşteri ağ geçidinin kimliğinin doğru olup olmadığını kontrol edin.

Hata kodlarının listesi için Servis hata kodları konusuna bakın.