Vpn Connections - Get

vpn 연결의 세부 정보를 검색합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/vpnConnections/{connectionName}?api-version=2023-09-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
connectionName
path True

string

vpn 연결의 이름입니다.

gatewayName
path True

string

게이트웨이의 이름입니다.

resourceGroupName
path True

string

VpnGateway의 리소스 그룹 이름입니다.

subscriptionId
path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

api-version
query True

string

클라이언트 API 버전입니다.

응답

Name 형식 Description
200 OK

VpnConnection

요청이 성공했습니다. vpn 연결의 세부 정보를 반환합니다.

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

VpnConnectionGet

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1?api-version=2023-09-01

Sample Response

{
  "name": "vpnConnection1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "properties": {
    "provisioningState": "Succeeded",
    "remoteVpnSite": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1"
    },
    "enableInternetSecurity": false,
    "ingressBytesTransferred": 0,
    "egressBytesTransferred": 0,
    "trafficSelectorPolicies": [],
    "vpnLinkConnections": [
      {
        "name": "Connection-Link1",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1/VpnSiteLinkConnections/Connection-Link1",
        "type": "Microsoft.Network/vpnGateways/vpnConnections/VpnSiteLinkConnections",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "properties": {
          "provisioningState": "Succeeded",
          "vpnSiteLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/siteLink1"
          },
          "connectionBandwidth": 200,
          "ipsecPolicies": [],
          "vpnConnectionProtocolType": "IKEv2",
          "sharedKey": "key",
          "ingressBytesTransferred": 0,
          "egressBytesTransferred": 0,
          "enableBgp": false,
          "enableRateLimiting": false,
          "useLocalAzureIpAddress": false,
          "usePolicyBasedTrafficSelectors": false,
          "routingWeight": 0,
          "vpnLinkConnectionMode": "ResponderOnly"
        }
      },
      {
        "name": "Connection-Link2",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/gateway1/vpnConnections/vpnConnection1/VpnSiteLinkConnections/Connection-Link2",
        "type": "Microsoft.Network/vpnGateways/vpnConnections/VpnSiteLinkConnections",
        "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
        "properties": {
          "provisioningState": "Succeeded",
          "vpnSiteLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/siteLink2"
          },
          "connectionBandwidth": 200,
          "ipsecPolicies": [],
          "vpnConnectionProtocolType": "IKEv2",
          "sharedKey": "key",
          "ingressBytesTransferred": 0,
          "egressBytesTransferred": 0,
          "enableBgp": false,
          "enableRateLimiting": false,
          "useLocalAzureIpAddress": false,
          "usePolicyBasedTrafficSelectors": false,
          "routingWeight": 0,
          "vpnLinkConnectionMode": "InitiatorOnly"
        }
      }
    ],
    "routingConfiguration": {
      "associatedRouteTable": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable1"
      },
      "propagatedRouteTables": {
        "labels": [
          "label1",
          "label2"
        ],
        "ids": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable1"
          },
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable2"
          },
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1/hubRouteTables/hubRouteTable3"
          }
        ]
      },
      "inboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap1"
      },
      "outboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap2"
      }
    }
  }
}

정의

Name Description
CloudError

서비스의 오류 응답입니다.

CloudErrorBody

서비스의 오류 응답입니다.

DhGroup

초기 SA에 대해 IKE 1단계에서 사용되는 DH 그룹입니다.

GatewayCustomBgpIpAddressIpConfiguration

가상 네트워크 게이트웨이 연결에 대한 GatewayCustomBgpIpAddressIpConfiguration입니다.

IkeEncryption

IKE 암호화 알고리즘(IKE 2단계).

IkeIntegrity

IKE 무결성 알고리즘(IKE 2단계).

IpsecEncryption

IPSec 암호화 알고리즘(IKE 1단계).

IpsecIntegrity

IPSec 무결성 알고리즘(IKE 1단계).

IpsecPolicy

가상 네트워크 게이트웨이 연결에 대한 IPSec 정책 구성입니다.

PfsGroup

새 자식 SA에 대해 IKE 2단계에서 사용되는 Pfs 그룹입니다.

PropagatedRouteTable

경로를 보급할 RouteTable 목록입니다.

ProvisioningState

현재 프로비저닝 상태입니다.

RoutingConfiguration

라우팅 구성은 이 연결에 대해 연결되고 전파된 경로 테이블을 나타냅니다.

StaticRoute

모든 정적 경로 목록입니다.

StaticRoutesConfig

이 HubVnetConnection의 정적 경로에 대한 구성이 HubVnetConnection의 정적 경로에 대한 구성입니다.

SubResource

다른 하위 리소스에 대한 참조입니다.

TrafficSelectorPolicy

가상 네트워크 게이트웨이 연결에 대한 트래픽 선택기 정책입니다.

VirtualNetworkGatewayConnectionProtocol

이 연결에 사용되는 연결 프로토콜입니다.

VnetLocalRouteOverrideCriteria

스포크 vnet의 NVA가 스포크 vnet의 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.

VnetRoute

VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.

VpnConnection

VpnConnection 리소스.

VpnConnectionStatus

vpn 연결의 현재 상태입니다.

VpnLinkConnectionMode

Vpn 링크 연결 모드입니다.

VpnSiteLinkConnection

VpnSiteLinkConnection 리소스.

CloudError

서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

클라우드 오류 본문.

CloudErrorBody

서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

target

string

특정 오류의 대상입니다. 예를 들어 오류에 있는 속성의 이름입니다.

DhGroup

초기 SA에 대해 IKE 1단계에서 사용되는 DH 그룹입니다.

Name 형식 Description
DHGroup1

string

DHGroup14

string

DHGroup2

string

DHGroup2048

string

DHGroup24

string

ECP256

string

ECP384

string

None

string

GatewayCustomBgpIpAddressIpConfiguration

가상 네트워크 게이트웨이 연결에 대한 GatewayCustomBgpIpAddressIpConfiguration입니다.

Name 형식 Description
customBgpIpAddress

string

IpconfigurationId에 속하는 사용자 지정 BgpPeeringAddress입니다.

ipConfigurationId

string

게이트웨이에 속하는 ipconfiguration의 IpconfigurationId입니다.

IkeEncryption

IKE 암호화 알고리즘(IKE 2단계).

Name 형식 Description
AES128

string

AES192

string

AES256

string

DES

string

DES3

string

GCMAES128

string

GCMAES256

string

IkeIntegrity

IKE 무결성 알고리즘(IKE 2단계).

Name 형식 Description
GCMAES128

string

GCMAES256

string

MD5

string

SHA1

string

SHA256

string

SHA384

string

IpsecEncryption

IPSec 암호화 알고리즘(IKE 1단계).

Name 형식 Description
AES128

string

AES192

string

AES256

string

DES

string

DES3

string

GCMAES128

string

GCMAES192

string

GCMAES256

string

None

string

IpsecIntegrity

IPSec 무결성 알고리즘(IKE 1단계).

Name 형식 Description
GCMAES128

string

GCMAES192

string

GCMAES256

string

MD5

string

SHA1

string

SHA256

string

IpsecPolicy

가상 네트워크 게이트웨이 연결에 대한 IPSec 정책 구성입니다.

Name 형식 Description
dhGroup

DhGroup

IKE 1단계에서 초기 SA에 사용되는 DH 그룹입니다.

ikeEncryption

IkeEncryption

IKE 암호화 알고리즘(IKE 2단계).

ikeIntegrity

IkeIntegrity

IKE 무결성 알고리즘(IKE 2단계).

ipsecEncryption

IpsecEncryption

IPSec 암호화 알고리즘(IKE 1단계).

ipsecIntegrity

IpsecIntegrity

IPSec 무결성 알고리즘(IKE 1단계).

pfsGroup

PfsGroup

IKE 2단계에서 새 자식 SA에 사용되는 Pfs 그룹입니다.

saDataSizeKilobytes

integer

사이트 및 사이트 간의 VPN 터널에 대한 IPSec 보안 연결(빠른 모드 또는 2단계 SA라고도 함) 페이로드 크기(KB)입니다.

saLifeTimeSeconds

integer

사이트간 VPN 터널에 대한 IPSec 보안 연결(빠른 모드 또는 2단계 SA라고도 함) 수명(초)입니다.

PfsGroup

새 자식 SA에 대해 IKE 2단계에서 사용되는 Pfs 그룹입니다.

Name 형식 Description
ECP256

string

ECP384

string

None

string

PFS1

string

PFS14

string

PFS2

string

PFS2048

string

PFS24

string

PFSMM

string

PropagatedRouteTable

경로를 보급할 RouteTable 목록입니다.

Name 형식 Description
ids

SubResource[]

모든 RouteTable의 리소스 ID 목록입니다.

labels

string[]

레이블 목록입니다.

ProvisioningState

현재 프로비저닝 상태입니다.

Name 형식 Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

라우팅 구성은 이 연결에 대해 연결되고 전파된 경로 테이블을 나타냅니다.

Name 형식 Description
associatedRouteTable

SubResource

이 RoutingConfiguration과 연결된 리소스 ID RouteTable입니다.

inboundRouteMap

SubResource

인바운드 학습 경로에 대해 이 RoutingConfiguration과 연결된 RouteMap의 리소스 ID입니다.

outboundRouteMap

SubResource

아웃바운드 보급 경로에 대한 이 RoutingConfiguration과 연결된RouteMap의 리소스 ID입니다.

propagatedRouteTables

PropagatedRouteTable

경로를 보급할 RouteTable 목록입니다.

vnetRoutes

VnetRoute

VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.

StaticRoute

모든 정적 경로 목록입니다.

Name 형식 Description
addressPrefixes

string[]

모든 주소 접두사 목록입니다.

name

string

VnetRoute 내에서 고유한 StaticRoute의 이름입니다.

nextHopIpAddress

string

다음 홉의 IP 주소입니다.

StaticRoutesConfig

이 HubVnetConnection의 정적 경로에 대한 구성이 HubVnetConnection의 정적 경로에 대한 구성입니다.

Name 형식 Description
propagateStaticRoutes

boolean

이 연결의 정적 경로가 이 연결이 전파하는 경로 테이블에 자동으로 전파되는지 여부를 나타내는 부울입니다.

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

스포크 vnet의 NVA가 스포크에서 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.

SubResource

다른 하위 리소스에 대한 참조입니다.

Name 형식 Description
id

string

리소스 ID입니다.

TrafficSelectorPolicy

가상 네트워크 게이트웨이 연결에 대한 트래픽 선택기 정책입니다.

Name 형식 Description
localAddressRanges

string[]

CIDR 형식의 로컬 주소 공간 컬렉션입니다.

remoteAddressRanges

string[]

CIDR 형식의 원격 주소 공간 컬렉션입니다.

VirtualNetworkGatewayConnectionProtocol

이 연결에 사용되는 연결 프로토콜입니다.

Name 형식 Description
IKEv1

string

IKEv2

string

VnetLocalRouteOverrideCriteria

스포크 vnet의 NVA가 스포크 vnet의 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.

Name 형식 Description
Contains

string

Equal

string

VnetRoute

VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.

Name 형식 Description
bgpConnections

SubResource[]

HubBgpConnection 개체에 대한 참조 목록입니다.

staticRoutes

StaticRoute[]

모든 정적 경로 목록입니다.

staticRoutesConfig

StaticRoutesConfig

이 HubVnetConnection의 정적 경로에 대한 구성입니다.

VpnConnection

VpnConnection 리소스.

Name 형식 Description
etag

string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id

string

리소스 ID입니다.

name

string

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.

properties.connectionBandwidth

integer

예상 대역폭(MBPS)입니다.

properties.connectionStatus

VpnConnectionStatus

연결 상태.

properties.dpdTimeoutSeconds

integer

vpn 연결에 대한 DPD 시간 제한(초)입니다.

properties.egressBytesTransferred

integer

전송된 송신 바이트입니다.

properties.enableBgp

boolean

EnableBgp 플래그.

properties.enableInternetSecurity

boolean

인터넷 보안을 사용하도록 설정합니다.

properties.enableRateLimiting

boolean

EnableBgp 플래그.

properties.ingressBytesTransferred

integer

전송된 수신 바이트입니다.

properties.ipsecPolicies

IpsecPolicy[]

이 연결에서 고려할 IPSec 정책입니다.

properties.provisioningState

ProvisioningState

VPN 연결 리소스의 프로비전 상태입니다.

properties.remoteVpnSite

SubResource

연결된 vpn 사이트의 ID입니다.

properties.routingConfiguration

RoutingConfiguration

이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다.

properties.routingWeight

integer

vpn 연결에 대한 라우팅 가중치입니다.

properties.sharedKey

string

vpn 연결에 대한 SharedKey입니다.

properties.trafficSelectorPolicies

TrafficSelectorPolicy[]

이 연결에서 고려할 트래픽 선택기 정책입니다.

properties.useLocalAzureIpAddress

boolean

로컬 Azure IP를 사용하여 연결을 시작합니다.

properties.usePolicyBasedTrafficSelectors

boolean

정책 기반 트래픽 선택기를 사용하도록 설정합니다.

properties.vpnConnectionProtocolType

VirtualNetworkGatewayConnectionProtocol

이 연결에 사용되는 연결 프로토콜입니다.

properties.vpnLinkConnections

VpnSiteLinkConnection[]

게이트웨이에 대한 모든 vpn 사이트 링크 연결 목록입니다.

VpnConnectionStatus

vpn 연결의 현재 상태입니다.

Name 형식 Description
Connected

string

Connecting

string

NotConnected

string

Unknown

string

VpnLinkConnectionMode

Vpn 링크 연결 모드입니다.

Name 형식 Description
Default

string

InitiatorOnly

string

ResponderOnly

string

VpnSiteLinkConnection

VpnSiteLinkConnection 리소스.

Name 형식 Description
etag

string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id

string

리소스 ID입니다.

name

string

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.

properties.connectionBandwidth

integer

예상 대역폭(MBPS)입니다.

properties.connectionStatus

VpnConnectionStatus

연결 상태.

properties.egressBytesTransferred

integer

전송된 송신 바이트입니다.

properties.egressNatRules

SubResource[]

송신 NatRules 목록입니다.

properties.enableBgp

boolean

EnableBgp 플래그.

properties.enableRateLimiting

boolean

EnableBgp 플래그.

properties.ingressBytesTransferred

integer

전송된 수신 바이트입니다.

properties.ingressNatRules

SubResource[]

수신 NatRules 목록입니다.

properties.ipsecPolicies

IpsecPolicy[]

이 연결에서 고려할 IPSec 정책입니다.

properties.provisioningState

ProvisioningState

VPN 사이트 링크 연결 리소스의 프로비전 상태입니다.

properties.routingWeight

integer

vpn 연결에 대한 라우팅 가중치입니다.

properties.sharedKey

string

vpn 연결에 대한 SharedKey입니다.

properties.useLocalAzureIpAddress

boolean

로컬 Azure IP를 사용하여 연결을 시작합니다.

properties.usePolicyBasedTrafficSelectors

boolean

정책 기반 트래픽 선택기를 사용하도록 설정합니다.

properties.vpnConnectionProtocolType

VirtualNetworkGatewayConnectionProtocol

이 연결에 사용되는 연결 프로토콜입니다.

properties.vpnGatewayCustomBgpAddresses

GatewayCustomBgpIpAddressIpConfiguration[]

이 연결에서 사용하는 vpnGatewayCustomBgpAddresses입니다.

properties.vpnLinkConnectionMode

VpnLinkConnectionMode

Vpn 링크 연결 모드입니다.

properties.vpnSiteLink

SubResource

연결된 vpn 사이트 링크의 ID입니다.

type

string

리소스 종류.