Tüm Ürünler
Search
Belge Merkezi

:DescribeVpnConnection

Son Güncelleme:Oct 04, 2026

Bir IPsec-VPN bağlantısının ayrıntılı bilgilerini sorgular.

Hata Ayıklama

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

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action

String

Evet

DescribeVpnConnection

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

RegionId

String

Evet

cn-hangzhou

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

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

VpnConnectionId

String

Evet

vco-bp1bbi27hojx80nck****

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

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

Status String ike_sa_not_established

IPsec-VPN bağlantısının durumu. Geçerli değerler:

  • ike_sa_not_established: 1. aşama anlaşmaları başarısız oldu.

  • ike_sa_established: 1. aşama anlaşmaları başarılı oldu.

  • ipsec_sa_not_established: 2. aşama anlaşmaları başarısız oldu.

  • ipsec_sa_established: 2. aşama anlaşmaları başarılı oldu.

RemoteCaCertificate String -----BEGIN CERTIFICATE----- MIIB7zCCAZW****

Eşin CA sertifikası.

EnableNatTraversal Boolean true

IPsec-VPN bağlantısı için NAT geçişinin etkin olup olmadığını gösterir.

  • true

  • false

NAT geçişi etkinleştirildikten sonra başlatıcı, IKE anlaşmaları 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.

CreateTime Long 1492753817000

IPsec-VPN bağlantısının kurulduğu zaman damgası. Birim: milisaniye.

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

EffectImmediately Boolean true

IPsec anlaşmalarının hemen başlayıp başlamadığını gösterir.

  • true: Yapılandırma değiştirildikten sonra anlaşmalar yeniden başlatılır.

  • false: Trafik algılandığında anlaşmalar yeniden başlatılır.

VpnGatewayId String vpn-bp1q8bgx4xnkm2ogj****

VPN ağ geçidinin kimliği.

LocalSubnet String 10.0.0.0/8

Alibaba Cloud tarafındaki CIDR bloğu.

CIDR blokları virgül (,) ile ayrılır.

RequestId String F2310D45-BCF6-4E2E-9082-B4503844BA4C

İstek kimliği.

VpnConnectionId String vco-bp1bbi27hojx80nck****

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

RemoteSubnet String 192.168.0.0/16

Veri merkezi tarafındaki CIDR bloğu.

CIDR blokları virgül (,) ile ayrılır.

CustomerGatewayId String cgw-bp1mvj4g9kogwwcxk****

IPsec-VPN bağlantısıyla ilişkili müşteri ağ geçidinin kimliği.

Name String ipsec1

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

EnableDpd Boolean true

IPsec-VPN bağlantısı için ölü eş algılamanın (DPD) etkin olup olmadığını gösterir. Geçerli değerler:

  • false

  • true

DPD'yi etkinleştirdiğinizde IPsec-VPN bağlantısının başlatıcısı, eşin varlığını ve kullanılabilirliğini kontrol etmek için DPD paketleri gönderir. Belirtilen süre içinde eşten yanıt alınmazsa bağlantı başarısız olur. Ardından ISAKMP SA, IPsec SA ve IPsec tüneli silinir.

IkeConfig Object

1. aşama anlaşmalarının yapılandırmaları.

RemoteId String 139.34.XX.XX

Veri merkezi tarafındaki tanımlayıcı.

IkeLifetime Long 86400

IKE aşamasındaki yaşam süresi. Birim: saniye.

IkeEncAlg String aes

IKE aşamasındaki şifreleme algoritması.

LocalId String 116.28.XX.XX

Alibaba Cloud tarafındaki tanımlayıcı.

IkeMode String main

IKE anlaşma modu. Geçerli değerler:

  • main: Bu mod, anlaşmalar sırasında daha yüksek güvenlik sağlar.
  • aggressive: Bu mod daha hızlıdır ve başarı oranı daha yüksektir.
IkeVersion String ikev1

IKE sürümü.

  • ikev1
  • ikev2

IKEv2, IKEv1'e kıyasla SA anlaşma sürecini basitleştirir ve birden fazla CIDR bloğunun kullanıldığı senaryolar için daha uygundur.

IkePfs String group2

IKE aşamasındaki DH grubu.

Psk String pgw6dy****

Önceden paylaşılan anahtar.

IkeAuthAlg String sha1

IKE aşamasındaki kimlik doğrulama algoritması.

IpsecConfig Object

2. aşama anlaşmalarının yapılandırmaları.

IpsecAuthAlg String sha1

IPsec aşamasındaki kimlik doğrulama algoritması.

IpsecLifetime Long 86400

IPsec aşamasındaki yaşam süresi. Birim: saniye.

IpsecEncAlg String aes

IPsec aşamasındaki şifreleme algoritması.

IpsecPfs String group2

IPsec aşamasındaki DH grubu.

VcoHealthCheck Object

IPsec-VPN bağlantısının durum denetimi bilgileri.

Status String failed

Durum denetimi durumu. Geçerli değerler:

  • failed

  • success

Dip String 10.0.0.1

Hedef IP adresi.

Interval Integer 3

Durum denetimi yeniden deneme aralığı. Birim: saniye.

Retry Integer 3

Maksimum durum denetimi yeniden deneme sayısı.

Sip String 192.168.1.1

Kaynak IP adresi.

Enable String true

IPsec-VPN bağlantısı için durum denetimi özelliğinin etkin olup olmadığını gösterir. Geçerli değerler:

  • false

  • true

Policy String revoke_route

Durum denetimi başarısız olduğunda duyurulan rotaların geri çekilip çekilmeyeceğini gösterir.

  • revoke_route
  • reserve_route
VpnBgpConfig Object

IPsec-VPN bağlantısının BGP yapılandırması.

Status String success

BGP yönlendirme protokolünün anlaşma durumu.

  • success

  • failed

PeerBgpIp String 169.254.11.1

Eşin BGP IP adresi.

TunnelCidr String 169.254.11.0/30

IPsec-VPN bağlantısının BGP CIDR bloğu. CIDR bloğu 169.254.0.0/16 aralığındadır. CIDR bloğunun maskesi 30 bit uzunluğundadır.

EnableBgp String true

BGP yönlendirme protokolünün durumu. Geçerli değerler:

  • true

  • false

LocalBgpIp String 169.254.11.2

Alibaba Cloud tarafındaki BGP IP adresi.

PeerAsn Long 65530

Eşin otonom sistem numarası (ASN).

LocalAsn Long 65531

Alibaba Cloud tarafındaki ASN.

AuthKey String AuthKey****

BGP yönlendirme protokolünün kimlik doğrulama anahtarı.

AttachType String CEN

IPsec-VPN bağlantısıyla ilişkili kaynağın türü. Geçerli değerler:

  • CEN: IPsec-VPN bağlantısının bir Cloud Enterprise Network (CEN) örneğinin aktarma yönlendiricisiyle ilişkili olduğunu gösterir.
  • NO_ASSOCIATED: IPsec-VPN bağlantısının bir kaynakla ilişkili olmadığını gösterir.
  • VPNGW: IPsec-VPN bağlantısının bir VPN ağ geçidiyle ilişkili olduğunu gösterir.
NetworkType String public

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

  • public
  • private
AttachInstanceId String cen-lxxpbpalc776qz****

Aktarma yönlendiricisinin ait olduğu CEN örneğinin kimliği.

Spec String 1000M

IPsec-VPN bağlantısının bant genişliği teknik özellikleri. Birim: Mbit/s.

State String attached

IPsec-VPN bağlantısının ilişkilendirme durumu. Geçerli değerler:

  • active: IPsec-VPN bağlantısı bir VPN ağ geçidiyle ilişkilendirilmiştir.
  • init: IPsec-VPN bağlantısı bir kaynakla ilişkilendirilmemiştir ve başlatılmaktadır.
  • attaching: IPsec-VPN bağlantısı bir aktarma yönlendiricisiyle ilişkilendirilmektedir.
  • attached: IPsec-VPN bağlantısı bir aktarma yönlendiricisiyle ilişkilendirilmiştir.
  • detaching: IPsec-VPN bağlantısının bir aktarma yönlendiricisiyle olan ilişkilendirmesi kaldırılmaktadır.
  • financialLocked: IPsec-VPN bağlantısı ödemenin gecikmesi nedeniyle kilitlenmiştir.
  • provisioning: IPsec-VPN bağlantısı hazırlanmaktadır.
  • updating: IPsec-VPN bağlantısı güncellenmektedir.
  • upgrading: IPsec-VPN bağlantısı yükseltilmektedir.
  • deleted: IPsec-VPN bağlantısı silinmiştir.
ZoneNo String ap-southeast-2b

IPsec-VPN bağlantısının dağıtıldığı alanın kimliği.

Alan kimliklerini sorgulamak için DescribeZones öğesini çağırabilirsiniz.

InternetIp String 47.XX.XX.162

IPsec-VPN bağlantısının ağ geçidi IP adresi.

TransitRouterId String tr-p0we2edef9qr44a85****

IPsec-VPN bağlantısının ilişkili olduğu aktarma yönlendiricisinin kimliği.

TransitRouterName String nametest

Aktarma yönlendiricisinin adı.

CrossAccountAuthorized Boolean false

IPsec-VPN bağlantısının başka bir Alibaba Cloud hesabına ait bir aktarma yönlendiricisiyle ilişkilendirilip ilişkilendirilmediğini gösterir. Geçerli değerler:

  • true
  • false
Tags Array of Tag

IPsec-VPN bağlantısına eklenen etiketlerin listesi.

Tag
Key String TagKey

N. etiketin anahtarı.

Value String TagValue

N. etiketin değeri.

TunnelOptionsSpecification Array of TunnelOptions

IPsec-VPN bağlantısının tünel yapılandırması.

TunnelOptionsSpecification içindeki parametreler yalnızca çift tünelli moddaki IPsec-VPN bağlantılarını sorguladığınızda döndürülür.

TunnelOptions
TunnelId String tun-opsqc4d97wni27****

Tünel kimliği.

CustomerGatewayId String cgw-p0wy363lucf1uyae8****

Tünel ile ilişkili müşteri ağ geçidinin kimliği.

EnableDpd String true

Tünel için DPD'nin etkin olup olmadığını gösterir. Geçerli değerler:

  • false
  • true
EnableNatTraversal String true

Tünel için NAT geçişinin etkin olup olmadığını gösterir.

  • false
  • true
InternetIp String 47.21.XX.XX

Tünel IP adresi.

RemoteCaCertificate String -----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----

Tünel eşinin CA sertifikası.

Bu parametre yalnızca VPN ağ geçidi ShangMi (SM) türündeyse döndürülür.

Role String master

Tünel rolü. Geçerli değerler:

  • master
  • slave
State String active

Tünel durumu. Geçerli değerler:

  • active
  • updating
  • deleting
Status String ipsec_sa_established

IPsec-VPN bağlantısının durumu. Geçerli değerler:

  • ike_sa_not_established: 1. aşama anlaşmaları başarısız oldu.

  • ike_sa_established: 1. aşama anlaşmaları başarılı oldu.

  • ipsec_sa_not_established: 2. aşama anlaşmaları başarısız oldu.

  • ipsec_sa_established: 2. aşama anlaşmaları başarılı oldu.

TunnelBgpConfig Object

BGP yapılandırmaları.

BgpStatus String success

BGP'nin anlaşma durumu. Geçerli değerler:

  • success
  • false
LocalAsn String 65530

Alibaba Cloud tarafındaki ASN.

LocalBgpIp String 169.254.10.1

Alibaba Cloud tarafındaki BGP IP adresi.

PeerAsn String 65531

Eş ASN.

PeerBgpIp String 169.254.10.2

Eş BGP IP adresi.

TunnelCidr String 169.254.10.0/30

Tünelin BGP CIDR bloğu.

TunnelIkeConfig Object

1. aşama anlaşmalarının yapılandırmaları.

IkeAuthAlg String sha1

IKE aşamasındaki kimlik doğrulama algoritması.

IkeEncAlg String aes

IKE aşamasındaki şifreleme algoritması.

IkeLifetime String 86400

IKE aşamasındaki yaşam süresi. Birim: saniye.

IkeMode String main

IKE anlaşma modu. Geçerli değerler:

  • main: Bu mod, anlaşmalar sırasında daha yüksek güvenlik sağlar.
  • aggressive: Bu mod daha hızlıdır ve başarı oranı daha yüksektir.
IkePfs String group2

IKE aşamasındaki DH grubu.

IkeVersion String ikev1

IKE sürümü.

LocalId String 47.21.XX.XX

Alibaba Cloud tarafındaki tanımlayıcı.

Psk String 123456****

Önceden paylaşılan anahtar.

RemoteId String 47.42.XX.XX

Eş tanımlayıcısı.

TunnelIpsecConfig Object

2. aşama anlaşmalarının yapılandırmaları.

IpsecAuthAlg String sha1

IPsec aşamasındaki kimlik doğrulama algoritması.

IpsecEncAlg String aes

IPsec aşamasındaki şifreleme algoritması.

IpsecLifetime String 86400

IPsec aşamasındaki yaşam süresi. Birim: saniye.

IpsecPfs String group2

IPsec aşamasındaki DH grubu.

ZoneNo String ap-southeast-5a

Tünelin dağıtıldığı alan.

Alan kimliklerini sorgulamak için DescribeZones öğesini çağırabilirsiniz.

EnableTunnelsBgp Boolean true

Tünelin BGP durumu. Geçerli değerler:

  • true
  • false

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeVpnConnection
&RegionId=cn-hangzhou
&VpnConnectionId=vco-bp1bbi27hojx80nck****
&Common request parameters

Örnek başarılı yanıtlar

XML biçimi

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

<DescribeVpnConnectionResponse>
    <Status>ike_sa_not_established</Status>
    <RemoteCaCertificate>-----BEGIN CERTIFICATE----- MIIB7zCCAZW****</RemoteCaCertificate>
    <EnableNatTraversal>true</EnableNatTraversal>
    <CreateTime>1492753817000</CreateTime>
    <EffectImmediately>true</EffectImmediately>
    <VpnGatewayId>vpn-bp1q8bgx4xnkm2ogj****</VpnGatewayId>
    <State>active</State>
    <LocalSubnet>10.0.0.0/8</LocalSubnet>
    <RequestId>F2310D45-BCF6-4E2E-9082-B4503844BA4C</RequestId>
    <VpnConnectionId>vco-bp1bbi27hojx80nck****</VpnConnectionId>
    <RemoteSubnet>192.168.0.0/16</RemoteSubnet>
    <CustomerGatewayId>cgw-bp1mvj4g9kogwwcxk****</CustomerGatewayId>
    <Name>ipsec1</Name>
    <EnableDpd>true</EnableDpd>
    <IkeConfig>
        <RemoteId>139.34.XX.XX</RemoteId>
        <IkeLifetime>86400</IkeLifetime>
        <IkeEncAlg>aes</IkeEncAlg>
        <LocalId>116.28.XX.XX</LocalId>
        <IkeMode>main</IkeMode>
        <IkeVersion>ikev1</IkeVersion>
        <IkePfs>group2</IkePfs>
        <Psk>pgw6dy****</Psk>
        <IkeAuthAlg>sha1</IkeAuthAlg>
    </IkeConfig>
    <IpsecConfig>
        <IpsecAuthAlg>sha1</IpsecAuthAlg>
        <IpsecLifetime>86400</IpsecLifetime>
        <IpsecEncAlg>aes</IpsecEncAlg>
        <IpsecPfs>group2</IpsecPfs>
    </IpsecConfig>
    <VcoHealthCheck>
        <Status>failed</Status>
        <Dip>10.0.0.1</Dip>
        <Interval>3</Interval>
        <Retry>3</Retry>
        <Sip>192.168.1.1</Sip>
        <Enable>true</Enable>
    </VcoHealthCheck>
    <VpnBgpConfig>
        <Status>success</Status>
        <PeerBgpIp>169.254.11.1</PeerBgpIp>
        <TunnelCidr>169.254.11.0/30</TunnelCidr>
        <EnableBgp>true</EnableBgp>
        <LocalBgpIp>169.254.11.2</LocalBgpIp>
        <PeerAsn>65530</PeerAsn>
        <LocalAsn>65531</LocalAsn>
        <AuthKey>AuthKey****</AuthKey>
    </VpnBgpConfig>
</DescribeVpnConnectionResponse>

JSON biçimi

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

{
  "Status" : "ike_sa_not_established",
  "RemoteCaCertificate" : "-----BEGIN CERTIFICATE----- MIIB7zCCAZW****",
  "EnableNatTraversal" : true,
  "CreateTime" : 1492753817000,
  "EffectImmediately" : true,
  "VpnGatewayId" : "vpn-bp1q8bgx4xnkm2ogj****",
  "State" : "active",
  "LocalSubnet" : "10.0.0.0/8",
  "RequestId" : "F2310D45-BCF6-4E2E-9082-B4503844BA4C",
  "VpnConnectionId" : "vco-bp1bbi27hojx80nck****",
  "RemoteSubnet" : "192.168.0.0/16",
  "CustomerGatewayId" : "cgw-bp1mvj4g9kogwwcxk****",
  "Name" : "ipsec1",
  "EnableDpd" : true,
  "IkeConfig" : {
    "RemoteId" : "139.34.XX.XX",
    "IkeLifetime" : 86400,
    "IkeEncAlg" : "aes",
    "LocalId" : "116.28.XX.XX",
    "IkeMode" : "main",
    "IkeVersion" : "ikev1",
    "IkePfs" : "group2",
    "Psk" : "pgw6dy****",
    "IkeAuthAlg" : "sha1"
  },
  "IpsecConfig" : {
    "IpsecAuthAlg" : "sha1",
    "IpsecLifetime" : 86400,
    "IpsecEncAlg" : "aes",
    "IpsecPfs" : "group2"
  },
  "VcoHealthCheck" : {
    "Status" : "failed",
    "Dip" : "10.0.0.1",
    "Interval" : 3,
    "Retry" : 3,
    "Sip" : "192.168.1.1",
    "Enable" : "true"
  },
  "VpnBgpConfig" : {
    "Status" : "success",
    "PeerBgpIp" : "169.254.11.1",
    "TunnelCidr" : "169.254.11.0/30",
    "EnableBgp" : "true",
    "LocalBgpIp" : "169.254.11.2",
    "PeerAsn" : 65530,
    "LocalAsn" : 65531,
    "AuthKey" : "AuthKey****"
  }
}

Hata kodları

HttpCode

Hata kodu

Hata mesajı

Açıklama

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ştirmek için yetkiniz yok. Gerekli izinleri talep edip tekrar deneyebilirsiniz.

403

Forbidden

User not authorized to operate on the specified resource.

Belirtilen kaynakta bu işlemi gerçekleştirmek için yetkiniz yok. Gerekli izinleri talep edip tekrar deneyebilirsiniz.

404

InvalidVpnConnectionInstanceId.NotFound

The specified vpn connection instance id does not exist.

Belirtilen IPsec bağlantısı mevcut değil. IPsec bağlantısının kimliğinin geçerli olup olmadığını kontrol edin.

Hata kodlarının listesi için bkz. Hizmet hata kodları.