次の方法で共有


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 パラメーター

名前 / 必須 説明
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 バージョン。

応答

名前 説明
200 OK

VpnConnection

要求が成功しました。 VPN 接続の詳細を返します。

Other Status Codes

CloudError

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

Scopes

名前 説明
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"
      }
    }
  }
}

定義

名前 説明
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

IKE フェーズ 2 で新しい子 SA に使用される 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

サービスからのエラー応答。

名前 説明
error

CloudErrorBody

クラウド エラー本文。

CloudErrorBody

サービスからのエラー応答。

名前 説明
code

string

エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。

details

CloudErrorBody[]

エラーに関するその他の詳細の一覧。

message

string

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

target

string

特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。

DhGroup

初期 SA に IKE フェーズ 1 で使用される DH グループ。

名前 説明
DHGroup1

string

DHGroup14

string

DHGroup2

string

DHGroup2048

string

DHGroup24

string

ECP256

string

ECP384

string

None

string

GatewayCustomBgpIpAddressIpConfiguration

仮想ネットワーク ゲートウェイ接続の GatewayCustomBgpIpAddressIpConfiguration。

名前 説明
customBgpIpAddress

string

IpconfigurationId に属するカスタム BgpPeeringAddress。

ipConfigurationId

string

ゲートウェイに属する ipconfiguration の IpconfigurationId。

IkeEncryption

IKE 暗号化アルゴリズム (IKE フェーズ 2)。

名前 説明
AES128

string

AES192

string

AES256

string

DES

string

DES3

string

GCMAES128

string

GCMAES256

string

IkeIntegrity

IKE 整合性アルゴリズム (IKE フェーズ 2)。

名前 説明
GCMAES128

string

GCMAES256

string

MD5

string

SHA1

string

SHA256

string

SHA384

string

IpsecEncryption

IPSec 暗号化アルゴリズム (IKE フェーズ 1)。

名前 説明
AES128

string

AES192

string

AES256

string

DES

string

DES3

string

GCMAES128

string

GCMAES192

string

GCMAES256

string

None

string

IpsecIntegrity

IPSec 整合性アルゴリズム (IKE フェーズ 1)。

名前 説明
GCMAES128

string

GCMAES192

string

GCMAES256

string

MD5

string

SHA1

string

SHA256

string

IpsecPolicy

仮想ネットワーク ゲートウェイ接続の IPSec ポリシー構成。

名前 説明
dhGroup

DhGroup

初期 SA に IKE フェーズ 1 で使用される 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

IKE フェーズ 2 で新しい子 SA に使用される Pfs グループ。

名前 説明
ECP256

string

ECP384

string

None

string

PFS1

string

PFS14

string

PFS2

string

PFS2048

string

PFS24

string

PFSMM

string

PropagatedRouteTable

ルートをアドバタイズする RouteTable の一覧。

名前 説明
ids

SubResource[]

すべての RouteTable のリソース ID の一覧。

labels

string[]

ラベルの一覧。

ProvisioningState

現在のプロビジョニング状態。

名前 説明
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

この接続に関連付けられているルート テーブルと伝達されたルート テーブルを示すルーティング構成。

名前 説明
associatedRouteTable

SubResource

この RoutingConfiguration に関連付けられているリソース ID RouteTable。

inboundRouteMap

SubResource

受信学習ルートのこの RoutingConfiguration に関連付けられている RouteMap のリソース ID。

outboundRouteMap

SubResource

送信アドバタイズされたルートのこの RoutingConfiguration に関連付けられているRouteMap のリソース ID。

propagatedRouteTables

PropagatedRouteTable

ルートをアドバタイズする RouteTable の一覧。

vnetRoutes

VnetRoute

VirtualHub から仮想ネットワーク接続へのルーティングを制御するルートの一覧。

StaticRoute

すべての静的ルートの一覧。

名前 説明
addressPrefixes

string[]

すべてのアドレス プレフィックスの一覧。

name

string

VnetRoute 内で一意の StaticRoute の名前。

nextHopIpAddress

string

次ホップの IP アドレス。

StaticRoutesConfig

この HubVnetConnection での静的ルートの構成この HubVnetConnection の静的ルートの構成。

名前 説明
propagateStaticRoutes

boolean

この接続の静的ルートが、この接続が伝達されるルート テーブルに自動的に伝達されるかどうかを示すブール値。

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

スポーク vnet 内の NVA がスポーク内の宛先を持つトラフィックに対してバイパスされるかどうかを決定するパラメーター。

SubResource

別のサブリソースへの参照。

名前 説明
id

string

リソースの ID

TrafficSelectorPolicy

仮想ネットワーク ゲートウェイ接続のトラフィック セレクター ポリシー。

名前 説明
localAddressRanges

string[]

CIDR 形式のローカル アドレス空間のコレクション。

remoteAddressRanges

string[]

CIDR 形式のリモート アドレス空間のコレクション。

VirtualNetworkGatewayConnectionProtocol

この接続に使用される接続プロトコル。

名前 説明
IKEv1

string

IKEv2

string

VnetLocalRouteOverrideCriteria

スポーク vnet 内の NVA がスポーク vnet 内の宛先を持つトラフィックに対してバイパスされるかどうかを決定するパラメーター。

名前 説明
Contains

string

Equal

string

VnetRoute

VirtualHub から仮想ネットワーク接続へのルーティングを制御するルートの一覧。

名前 説明
bgpConnections

SubResource[]

HubBgpConnection オブジェクトへの参照の一覧。

staticRoutes

StaticRoute[]

すべての静的ルートの一覧。

staticRoutesConfig

StaticRoutesConfig

この HubVnetConnection 上の静的ルートの構成。

VpnConnection

VpnConnection リソース。

名前 説明
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 接続の現在の状態。

名前 説明
Connected

string

Connecting

string

NotConnected

string

Unknown

string

VpnLinkConnectionMode

Vpn リンク接続モード。

名前 説明
Default

string

InitiatorOnly

string

ResponderOnly

string

VpnSiteLinkConnection

VpnSiteLinkConnection リソース。

名前 説明
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

リソースの種類。