Tüm Ürünler
Search
Belge Merkezi

:DescribeVpnConnection

Son Güncelleme:Oct 02, 2026

Belirtilen bir IPsec-VPN bağlantısı hakkındaki bilgileri sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

vpc:DescribeVpnConnection

get

*VpnConnection

acs:vpc:{#regionId}:{#accountId}:vpnconnection/{#VpnConnectionId}

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

IPsec-VPN bağlantısının bölge kimliği.\n\nBölge kimliklerini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

cn-hangzhou

VpnConnectionId

string

Yes

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

vco-bp1bbi27hojx80nck****

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

Status

string

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

  • ike_sa_not_established: Aşama 1 görüşmesi başarısız oldu.

  • ike_sa_established: Aşama 1 görüşmesi başarılı oldu.

  • ipsec_sa_not_established: Aşama 2 görüşmesi başarısız oldu.

  • ipsec_sa_established: Aşama 2 görüşmesi başarılı oldu.

ike_sa_not_established

RemoteCaCertificate

string

Karşı ucun CA sertifikası.

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

EnableNatTraversal

boolean

IPsec-VPN bağlantısı için NAT geçişinin etkinleştirilip etkinleştirilmediğini gösterir.

true

CreateTime

integer

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

Zaman damgası, 1 Ocak 1970 00:00:00 (UTC) tarihinden IPsec-VPN bağlantısının oluşturulduğu zamana kadar geçen toplam milisaniye sayısını temsil eden UNIX zaman damgası formatındadır.

1492753817000

EffectImmediately

boolean

IPsec-VPN bağlantısı yapılandırmalarının hemen yürürlüğe girip girmediğini gösterir.

  • true: Yapılandırmalar hemen yürürlüğe girer. Yapılandırma değişikliği tamamlandıktan sonra yeniden bağlantı tetiklenir.

  • false: Yapılandırmalar hemen yürürlüğe girmez. Trafik algılandığında yeniden bağlantı tetiklenir.

true

VpnGatewayId

string

VPN ağ geçidinin örnek kimliği.

vpn-bp1q8bgx4xnkm2ogj****

LocalSubnet

string

IPsec-VPN bağlantısının Alibaba Cloud tarafındaki CIDR bloğu.

10.0.0.0/8

RequestId

string

İstek kimliği.

F2310D45-BCF6-4E2E-9082-B4503844BA4C

VpnConnectionId

string

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

vco-bp1bbi27hojx80nck****

RemoteSubnet

string

Şirket içi veri merkezi tarafındaki CIDR bloğu.

192.168.0.0/16

CustomerGatewayId

string

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

cgw-bp1mvj4g9kogwwcxk****

Name

string

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

ipsec1

EnableDpd

boolean

IPsec-VPN bağlantısı için Dead Peer Detection (DPD) özelliğinin etkinleştirilip etkinleştirilmediğini gösterir.

true

IkeConfig

object

Aşama 1 görüşmesinin yapılandırması.

RemoteId

string

IPsec-VPN bağlantısının şirket içi veri merkezi tarafındaki tanımlayıcısı.

139.34.XX.XX

IkeLifetime

integer

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

86400

IkeEncAlg

string

IKE aşamasındaki şifreleme algoritması.

aes

LocalId

string

IPsec-VPN bağlantısının Alibaba Cloud tarafındaki tanımlayıcısı.

116.28.XX.XX

IkeMode

string

IKE görüşme modu.

main

IkeVersion

string

IKE protokolü sürümü.

  • ikev1

  • ikev2

IKEv2, IKEv1'e kıyasla SA görüşme sürecini basitleştirir ve çoklu CIDR bloğu senaryoları için daha iyi destek sağlar.

ikev1

IkePfs

string

IKE aşamasındaki DH grubu.

group2

Psk

string

Önceden paylaşılan anahtar.

pgw6dy****

IkeAuthAlg

string

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

sha1

IpsecConfig

object

Aşama 2 görüşmesinin yapılandırması.

IpsecAuthAlg

string

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

sha1

IpsecLifetime

integer

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

86400

IpsecEncAlg

string

IPsec aşamasındaki şifreleme algoritması.

aes

IpsecPfs

string

IPsec aşamasındaki DH grubu.

group2

VcoHealthCheck

object

IPsec-VPN bağlantısının sağlık kontrolü bilgileri.

Status

string

Sağlık kontrolü durumu.

failed

Dip

string

Hedef IP adresi.

10.0.0.1

Interval

integer

Sağlık kontrolünün yeniden deneme aralığı. Birim: saniye.

3

Retry

integer

Sağlık kontrolü yeniden deneme sayısı.

3

Sip

string

Kaynak IP adresi.

192.168.1.1

Enable

string

IPsec-VPN bağlantısı için sağlık kontrolünün etkinleştirilip etkinleştirilmediğini gösterir.

  • false: Etkinleştirilmedi.

  • true: Etkinleştirildi.

true

Policy

string

Sağlık kontrolü başarısız olduğunda yayımlanan rotaların geri çekilip çekilmediğini gösterir.

revoke_route

VpnBgpConfig

object

IPsec-VPN bağlantısının BGP yönlendirme protokolü yapılandırması.

Status

string

BGP yönlendirme protokolünün görüşme durumu.

success

PeerBgpIp

string

Karşı ucun BGP IP adresi.

169.254.11.1

TunnelCidr

string

IPsec-VPN bağlantısının BGP CIDR bloğu. CIDR bloğu, 169.254.0.0/16 içinde 30 bitlik alt ağ maskesi uzunluğuna sahip bir alt ağdır.

169.254.11.0/30

EnableBgp

string

BGP yönlendirme protokolünün etkinleştirilme durumu.

true

LocalBgpIp

string

Alibaba Cloud tarafındaki BGP IP adresi.

169.254.11.2

PeerAsn

integer

Karşı ucun otonom sistem numarası.

65530

LocalAsn

integer

Alibaba Cloud tarafındaki otonom sistem numarası.

65531

AuthKey

string

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

AuthKey****

AttachType

string

IPsec-VPN bağlantısına eklenen kaynağın türü.

  • CEN: IPsec-VPN bağlantısı, Cloud Enterprise Network (CEN) örneğinin bir geçiş yönlendiricisine eklenmiştir.

  • NO_ASSOCIATED: IPsec-VPN bağlantısı herhangi bir kaynağa eklenmemiştir.

  • VPNGW: IPsec-VPN bağlantısı bir VPN ağ geçidi örneğine eklenmiştir.

CEN

NetworkType

string

IPsec-VPN bağlantısının ağ türü.

  • public: Genel ağ. IPsec-VPN bağlantısı, İnternet üzerinden şifreli bir iletişim kanalı kurar.

  • private: Özel ağ. IPsec-VPN bağlantısı, özel bir ağ üzerinden şifreli bir iletişim kanalı kurar.

public

AttachInstanceId

string

Geçiş yönlendiricisi örneğinin ait olduğu Cloud Enterprise Network (CEN) örneğinin örnek kimliği.

cen-lxxpbpalc776qz****

Spec

string

IPsec-VPN bağlantısının bant genişliği teknik özelliği. Birim: Mbps.

1000M

State

string

IPsec-VPN bağlantısı ile geçiş yönlendiricisi örneği arasındaki bağlama durumu.

attached

ZoneNo

string

IPsec-VPN bağlantısının dağıtıldığı bölge kimliği.

Bölge kimlikleri ve bölgeler arasındaki eşlemeyi sorgulamak için DescribeZones işlemini çağırabilirsiniz.

cn-hangzhou-h

InternetIp

string

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

47.XX.XX.162

TransitRouterId

string

IPsec-VPN bağlantısına eklenen geçiş yönlendiricisi örneğinin örnek kimliği.

tr-p0we2edef9qr44a85****

TransitRouterName

string

Geçiş yönlendiricisi örneğinin adı.

nametest

CrossAccountAuthorized

boolean

IPsec-VPN bağlantısının farklı bir hesap altındaki bir geçiş yönlendiricisi örneğine bağlanıp bağlanmadığını gösterir.

false

Tags

object

Tag

array<object>

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

object

Etiket bilgileri.

Key

string

Etiket anahtarı.

TagKey

Value

string

Etiket değeri.

TagValue

TunnelOptionsSpecification

object

TunnelOptions

array<object>

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

array<object>

Tünel yapılandırması.

TunnelId

string

Tünel kimliği.

tun-opsqc4d97wni27****

CustomerGatewayId

string

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

cgw-p0wy363lucf1uyae8****

EnableDpd

string

Tünel için Dead Peer Detection (DPD) özelliğinin etkinleştirilip etkinleştirilmediğini gösterir.

true

EnableNatTraversal

string

Tünel için NAT geçişinin etkinleştirilip etkinleştirilmediğini gösterir.

true

InternetIp

string

Tünelin IP adresi.

47.21.XX.XX

RemoteCaCertificate

string

Tünel karşı ucunun CA sertifikası.

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

Role

string

Tünelin rolü.

master

TunnelIndex

integer

Tünelin oluşturma sırası.

1

State

string

Tünelin durumu.

active

Status

string

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

ipsec_sa_established

TunnelBgpConfig

object

Tünelin BGP yapılandırması.

BgpStatus

string

BGP görüşme durumu.

success

LocalAsn

string

Tünelin yerel ucundaki (Alibaba Cloud tarafı) otonom sistem numarası.

65530

LocalBgpIp

string

Tünelin yerel ucundaki (Alibaba Cloud tarafı) BGP IP adresi.

169.254.10.1

PeerAsn

string

Tünel karşı ucunun otonom sistem numarası.

65531

PeerBgpIp

string

Tünel karşı ucunun BGP IP adresi.

169.254.10.2

TunnelCidr

string

Tünelin BGP CIDR bloğu.

169.254.10.0/30

TunnelIkeConfig

object

Aşama 1 görüşmesinin yapılandırması.

IkeAuthAlg

string

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

sha1

IkeEncAlg

string

IKE aşamasındaki şifreleme algoritması.

aes

IkeLifetime

string

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

86400

IkeMode

string

IKE görüşme modu.

main

IkePfs

string

IKE aşamasındaki DH grubu.

group2

IkeVersion

string

IKE protokolü sürümü.

ikev1

LocalId

string

Tünelin yerel ucunun (Alibaba Cloud tarafı) tanımlayıcısı.

47.21.XX.XX

Psk

string

Önceden paylaşılan anahtar.

123456****

RemoteId

string

Tünelin karşı ucunun tanımlayıcısı.

47.42.XX.XX

TunnelIpsecConfig

object

Aşama 2 görüşmesinin yapılandırması.

IpsecAuthAlg

string

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

sha1

IpsecEncAlg

string

IPsec aşamasındaki şifreleme algoritması.

aes

IpsecLifetime

string

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

86400

IpsecPfs

string

IPsec aşamasındaki DH grubu.

group2

ZoneNo

string

Tünelin dağıtıldığı bölge.

Bölge kimlikleri ve bölgeler arasındaki eşlemeyi sorgulamak için DescribeZones işlemini çağırabilirsiniz.

cn-hangzhou-i

EnableTunnelsBgp

boolean

Tünel BGP'sinin etkinleştirilme durumu.

true

ResourceGroupId

string

IPsec-VPN bağlantısının ait olduğu kaynak grubunun kimliği.

Kaynak grubu bilgilerini sorgulamak için ListResourceGroups işlemini çağırabilirsiniz.

rg-acfmzs372yg****

TunnelBandwidth

string

Tek bir VPN tünelinin bant genişliği belirtimi. Geçerli değerler:

Standard

Examples

Success response

JSON format

{
  "Status": "ike_sa_not_established",
  "RemoteCaCertificate": "-----BEGIN CERTIFICATE----- MIIB7zCCAZW****",
  "EnableNatTraversal": true,
  "CreateTime": 1492753817000,
  "EffectImmediately": true,
  "VpnGatewayId": "vpn-bp1q8bgx4xnkm2ogj****",
  "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",
    "Policy": "revoke_route"
  },
  "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****"
  },
  "AttachType": "CEN",
  "NetworkType": "public",
  "AttachInstanceId": "cen-lxxpbpalc776qz****",
  "Spec": "1000M",
  "State": "attached",
  "ZoneNo": "cn-hangzhou-h",
  "InternetIp": "47.XX.XX.162",
  "TransitRouterId": "tr-p0we2edef9qr44a85****",
  "TransitRouterName": "nametest",
  "CrossAccountAuthorized": false,
  "Tags": {
    "Tag": [
      {
        "Key": "TagKey",
        "Value": "TagValue"
      }
    ]
  },
  "TunnelOptionsSpecification": {
    "TunnelOptions": [
      {
        "TunnelId": "tun-opsqc4d97wni27****",
        "CustomerGatewayId": "cgw-p0wy363lucf1uyae8****",
        "EnableDpd": "true",
        "EnableNatTraversal": "true",
        "InternetIp": "47.21.XX.XX",
        "RemoteCaCertificate": "-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----",
        "Role": "master",
        "TunnelIndex": 1,
        "State": "active",
        "Status": "ipsec_sa_established",
        "TunnelBgpConfig": {
          "BgpStatus": "success",
          "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": "ikev1",
          "LocalId": "47.21.XX.XX",
          "Psk": "123456****",
          "RemoteId": "47.42.XX.XX"
        },
        "TunnelIpsecConfig": {
          "IpsecAuthAlg": "sha1",
          "IpsecEncAlg": "aes",
          "IpsecLifetime": "86400",
          "IpsecPfs": "group2"
        },
        "ZoneNo": "cn-hangzhou-i"
      }
    ]
  },
  "EnableTunnelsBgp": true,
  "ResourceGroupId": "rg-acfmzs372yg****",
  "TunnelBandwidth": "Standard"
}

Error codes

HTTP status code

Error code

Error message

Description

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. You do not have the permissions to manage the specified resource. Apply for the permissions and try again.
404 InvalidVpnConnectionInstanceId.NotFound The specified vpn connection instance id does not exist. The specified vpn connection instance id does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.