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
İ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 |
| 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:
|
| 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:
|
| 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:
|
| EffectImmediately | Boolean | Hayır | false | IPsec müzakerelerinin hemen başlatılıp başlatılmayacağını belirtir. Geçerli değerler:
|
| 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ı:
|
| IpsecConfig | String | Hayır | {"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400} | Aşama 2 müzakerelerinin yapılandırmaları:
|
| 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ı:
Not
|
| 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ı:
|
| AutoConfigRoute | Boolean | Hayır | true | Rotaların otomatik olarak yapılandırılıp yapılandırılmayacağını belirtir. Geçerli değerler:
|
| EnableDpd | Boolean | Hayır | true | Eş canlılık algılama (DPD) özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
|
| EnableNatTraversal | Boolean | Hayır | true | NAT geçişinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
|
| 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 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. 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.
|
| 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.