Connection Monitors - Query

Fragen Sie eine Momentaufnahme der letzten Verbindungszustände ab.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/connectionMonitors/{connectionMonitorName}/query?api-version=2020-11-01

URI-Parameter

Name In Required Type Description
connectionMonitorName
path True
  • string

Der Dem Verbindungsmonitor gegebene Name.

networkWatcherName
path True
  • string

Der Name der Network Watcher Ressource.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe, die Network Watcher.

subscriptionId
path True
  • string

Die Abonnementanmeldeinformationen, die das Microsoft Azure eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True
  • string

Client-API-Version.

Antworten

Name Type Description
200 OK

Erfolgreiche Abfrage von Verbindungszuständen.

202 Accepted

Akzeptierte Abfrage von Verbindungszuständen.

Other Status Codes

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

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

Scopes

Name Description
user_impersonation Imitate your user account (Identität Ihres Benutzerkontos imitieren)

Beispiele

Query connection monitor

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/connectionMonitors/cm1/query?api-version=2020-11-01

Sample Response

{
  "sourceStatus": "Active",
  "states": [
    {
      "connectionState": "Reachable",
      "startTime": "2018-01-08T03:42:33.3387305Z",
      "endTime": "2018-01-08T05:12:41.5265438Z",
      "evaluationState": "Completed",
      "hops": [
        {
          "type": "Source",
          "id": "7dbbe7aa-60ba-4650-831e-63d775d38e9e",
          "address": "10.1.1.4",
          "resourceId": "subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic0/ipConfigurations/ipconfig1",
          "nextHopIds": [
            "75c8d819-b208-4584-a311-1aa45ce753f9"
          ],
          "issues": []
        },
        {
          "type": "VirtualNetwork",
          "id": "75c8d819-b208-4584-a311-1aa45ce753f9",
          "address": "192.168.100.4",
          "resourceId": "subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1/ipConfigurations/ipconfig1",
          "nextHopIds": [],
          "issues": []
        }
      ]
    }
  ]
}
{
  "sourceStatus": "Active",
  "states": [
    {
      "connectionState": "Reachable",
      "startTime": "2018-01-08T03:42:33.3387305Z",
      "endTime": "2018-01-08T05:12:41.5265438Z",
      "evaluationState": "Completed",
      "hops": [
        {
          "type": "Source",
          "id": "7dbbe7aa-60ba-4650-831e-63d775d38e9e",
          "address": "10.1.1.4",
          "resourceId": "subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic0/ipConfigurations/ipconfig1",
          "nextHopIds": [
            "75c8d819-b208-4584-a311-1aa45ce753f9"
          ],
          "issues": []
        },
        {
          "type": "VirtualNetwork",
          "id": "75c8d819-b208-4584-a311-1aa45ce753f9",
          "address": "192.168.100.4",
          "resourceId": "subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1/ipConfigurations/ipconfig1",
          "nextHopIds": [],
          "issues": []
        }
      ]
    }
  ]
}

Definitionen

ConnectionMonitorQueryResult

Liste der Momentaufnahmen des Verbindungszuständes.

ConnectionMonitorSourceStatus

Status der Verbindungsmonitorquelle.

ConnectionState

Der Verbindungsstatus.

ConnectionStateSnapshot

Momentaufnahme des Verbindungszustands.

ConnectivityHop

Informationen zu einem Hop zwischen der Quelle und dem Ziel.

ConnectivityIssue

Informationen zu einem Problem, das beim Überprüfen der Konnektivität aufgetreten ist.

ErrorDetails

Darstellung der allgemeinen Fehlerdetails.

ErrorResponse

Das Fehlerobjekt.

EvaluationState

Auswertungsstatus der Konnektivitätsanalyse.

HopLink

Hoplink.

IssueType

Der Typ des Problems.

Origin

Der Ursprung des Problems.

Severity

Der Schweregrad des Problems.

ConnectionMonitorQueryResult

Liste der Momentaufnahmen des Verbindungszuständes.

Name Type Description
sourceStatus

Status der Verbindungsmonitorquelle.

states

Informationen zu Verbindungszuständen.

ConnectionMonitorSourceStatus

Status der Verbindungsmonitorquelle.

Name Type Description
Active
  • string
Inactive
  • string
Unknown
  • string

ConnectionState

Der Verbindungsstatus.

Name Type Description
Reachable
  • string
Unknown
  • string
Unreachable
  • string

ConnectionStateSnapshot

Momentaufnahme des Verbindungszustands.

Name Type Description
avgLatencyInMs
  • integer

Durchschnittliche Latenz in ms.

connectionState

Der Verbindungsstatus.

endTime
  • string

Die Endzeit der Verbindungsmomentaufnahme.

evaluationState

Auswertungsstatus der Konnektivitätsanalyse.

hops

Liste der Hops zwischen Quelle und Ziel.

maxLatencyInMs
  • integer

Maximale Latenz in ms.

minLatencyInMs
  • integer

Minimale Latenz in ms.

probesFailed
  • integer

Die Anzahl fehlgeschlagener Tests.

probesSent
  • integer

Die Anzahl der gesendeten Tests.

startTime
  • string

Die Startzeit der Verbindungsmomentaufnahme.

ConnectivityHop

Informationen zu einem Hop zwischen der Quelle und dem Ziel.

Name Type Description
address
  • string

Die IP-Adresse des Hops.

id
  • string

Die ID des Hops.

issues

Liste der Probleme.

links

Liste der Hoplinks.

nextHopIds
  • string[]

Liste der Bezeichner des nächsten Hops.

previousHopIds
  • string[]

Liste der vorherigen Hopbezeichner.

previousLinks

Liste der vorherigen Hoplinks.

resourceId
  • string

Die ID der Ressource, die diesem Hop entspricht.

type
  • string

Der Typ des Hops.

ConnectivityIssue

Informationen zu einem Problem, das beim Überprüfen der Konnektivität aufgetreten ist.

Name Type Description
context
  • object[]

Stellt zusätzlichen Kontext zu dem Problem zur Seite.

origin

Der Ursprung des Problems.

severity

Der Schweregrad des Problems.

type

Der Typ des Problems.

ErrorDetails

Darstellung der allgemeinen Fehlerdetails.

Name Type Description
code
  • string

Fehlercode

message
  • string

Fehlermeldung.

target
  • string

Fehlerziel.

ErrorResponse

Das Fehlerobjekt.

Name Type Description
error

Fehler
Das Fehlerdetailsobjekt.

EvaluationState

Auswertungsstatus der Konnektivitätsanalyse.

Name Type Description
Completed
  • string
InProgress
  • string
NotStarted
  • string

Hoplink.

Name Type Description
context
  • object

Stellt zusätzlichen Kontext für Links zur Seite.

issues

Liste der Probleme.

linkType
  • string

Linktyp.

nextHopId
  • string

Die ID des nächsten Hops.

properties.roundTripTimeAvg
  • integer

Durchschnittliche Roundtripzeit in Millisekunden.

properties.roundTripTimeMax
  • integer

Maximale Roundtripzeit in Millisekunden.

properties.roundTripTimeMin
  • integer

Minimale Roundtripzeit in Millisekunden.

resourceId
  • string

Ressourcen-ID

IssueType

Der Typ des Problems.

Name Type Description
AgentStopped
  • string
DnsResolution
  • string
GuestFirewall
  • string
NetworkSecurityRule
  • string
Platform
  • string
PortThrottled
  • string
SocketBind
  • string
Unknown
  • string
UserDefinedRoute
  • string

Origin

Der Ursprung des Problems.

Name Type Description
Inbound
  • string
Local
  • string
Outbound
  • string

Severity

Der Schweregrad des Problems.

Name Type Description
Error
  • string
Warning
  • string