Virtual Network Gateways - Get Bgp Peer Status
Der GetBgpPeerStatus-Vorgang ruft den Status aller BGP-Peers ab.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworkGateways/{virtualNetworkGatewayName}/getBgpPeerStatus?api-version=2025-03-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworkGateways/{virtualNetworkGatewayName}/getBgpPeerStatus?peer={peer}&api-version=2025-03-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
|
subscription
|
path | True |
string |
Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
|
virtual
|
path | True |
string |
Der Name des virtuellen Netzwerkgateways. |
|
api-version
|
query | True |
string |
Client-API-Version. |
|
peer
|
query |
string |
Die IP-Adresse des Peers, um den Status abzurufen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Liste der BGP-Peerstatus. |
|
| 202 Accepted |
Akzeptiert, und der Vorgang wird asynchron abgeschlossen. |
|
| Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
GetVirtualNetworkGatewayBGPPeerStatus
Beispielanforderung
Beispiel für eine Antwort
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
{}
Definitionen
| Name | Beschreibung |
|---|---|
|
Bgp |
Der BGP-Peer-Status. |
|
Bgp |
BGP-Peerstatusdetails. |
|
Bgp |
Antwort für den BGP-Peerstatus-API-Dienstaufruf. |
|
Cloud |
Eine Fehlerantwort des Diensts. |
|
Cloud |
Eine Fehlerantwort des Diensts. |
BgpPeerState
Der BGP-Peer-Status.
| Wert | Beschreibung |
|---|---|
| Unknown | |
| Stopped | |
| Idle | |
| Connecting | |
| Connected |
BgpPeerStatus
BGP-Peerstatusdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| asn |
integer (int64) minimum: 0maximum: 4294967295 |
Die autonome Systemnummer des Remote-BGP-Peers. |
| connectedDuration |
string |
Wie lange das Peering schon aktiv ist. |
| localAddress |
string |
Die lokale Adresse des Gateways für virtuelle Netzwerke. |
| messagesReceived |
integer (int64) |
Die Anzahl der empfangenen BGP-Nachrichten. |
| messagesSent |
integer (int64) |
Die Anzahl der gesendeten BGP-Nachrichten. |
| neighbor |
string |
Der Remote-BGP-Peer. |
| routesReceived |
integer (int64) |
Die Anzahl der Routen, die von diesem Peer gelernt wurden. |
| state |
Der BGP-Peer-Status. |
BgpPeerStatusListResult
Antwort für den BGP-Peerstatus-API-Dienstaufruf.
| Name | Typ | Beschreibung |
|---|---|---|
| value |
Liste der BGP-Peers. |
CloudError
Eine Fehlerantwort des Diensts.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Cloud-Fehlertext. |
CloudErrorBody
Eine Fehlerantwort des Diensts.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden. |
| details |
Eine Liste mit zusätzlichen Details zum Fehler. |
|
| message |
string |
Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist. |
| target |
string |
Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler. |