Connection Monitors - Query

Fråga en ögonblicksbild av de senaste anslutningstillstånden.

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

URI-parametrar

Name In Required Type Description
connectionMonitorName
path True
  • string

Namnet på anslutningsövervakaren.

networkWatcherName
path True
  • string

Namnet på den Network Watcher resursen.

resourceGroupName
path True
  • string

Namnet på resursgruppen som innehåller Network Watcher.

subscriptionId
path True
  • string

Autentiseringsuppgifterna för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

api-version
query True
  • string

Klient-API-version.

Svar

Name Type Description
200 OK

Lyckad fråga om anslutningstillstånd.

202 Accepted

Godkända frågor om anslutningstillstånd.

Other Status Codes

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

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 personifiera ditt användarkonto

Exempel

Query connection monitor

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/connectionMonitors/cm1/query?api-version=2022-01-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": []
        }
      ]
    }
  ]
}
Location: https:/management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/connectionMonitors/cm1/query?api-version=2022-01-01
{
  "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": []
        }
      ]
    }
  ]
}

Definitioner

ConnectionMonitorQueryResult

Lista över ögonblicksbilder av anslutningstillstånd.

ConnectionMonitorSourceStatus

Status för anslutningsövervakarens källa.

ConnectionState

Anslutningstillståndet.

ConnectionStateSnapshot

Ögonblicksbild av anslutningstillstånd.

ConnectivityHop

Information om ett hopp mellan källan och målet.

ConnectivityIssue

Information om ett problem som påträffades i processen för att söka efter anslutningar.

ErrorDetails

Representation av vanliga felinformation.

ErrorResponse

Felobjektet.

EvaluationState

Utvärderingstillstånd för anslutningsanalys.

HopLink

Hopplänk.

IssueType

Typ av problem.

Origin

Problemets ursprung.

Severity

Problemets allvarlighetsgrad.

ConnectionMonitorQueryResult

Lista över ögonblicksbilder av anslutningstillstånd.

Name Type Description
sourceStatus

Status för anslutningsövervakarens källa.

states

Information om anslutningstillstånd.

ConnectionMonitorSourceStatus

Status för anslutningsövervakarens källa.

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

ConnectionState

Anslutningstillståndet.

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

ConnectionStateSnapshot

Ögonblicksbild av anslutningstillstånd.

Name Type Description
avgLatencyInMs
  • integer

Genomsnittlig svarstid i ms.

connectionState

Anslutningstillståndet.

endTime
  • string

Sluttiden för ögonblicksbilden av anslutningen.

evaluationState

Utvärderingstillstånd för anslutningsanalys.

hops

Lista över hopp mellan källan och målet.

maxLatencyInMs
  • integer

Maximal svarstid i ms.

minLatencyInMs
  • integer

Minsta svarstid i ms.

probesFailed
  • integer

Antalet misslyckade avsökningar.

probesSent
  • integer

Antalet skickade avsökningar.

startTime
  • string

Starttiden för anslutningsögonblicksbilden.

ConnectivityHop

Information om ett hopp mellan källan och målet.

Name Type Description
address
  • string

IP-adressen för hoppet.

id
  • string

ID:t för hoppet.

issues

Lista över problem.

links

Lista över hopplänkar.

nextHopIds
  • string[]

Lista över identifierare för nästa hopp.

previousHopIds
  • string[]

Lista över tidigare hoppidentifierare.

previousLinks

Lista över tidigare hopplänkar.

resourceId
  • string

ID:t för resursen som motsvarar det här hoppet.

type
  • string

Hopptypen.

ConnectivityIssue

Information om ett problem som påträffades i processen för att söka efter anslutningar.

Name Type Description
context
  • object[]

Ger ytterligare kontext om problemet.

origin

Problemets ursprung.

severity

Problemets allvarlighetsgrad.

type

Typ av problem.

ErrorDetails

Representation av vanliga felinformation.

Name Type Description
code
  • string

Felkod.

message
  • string

Felmeddelande.

target
  • string

Felmål.

ErrorResponse

Felobjektet.

Name Type Description
error

Fel
Objektet med felinformation.

EvaluationState

Utvärderingstillstånd för anslutningsanalys.

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

Hopplänk.

Name Type Description
context
  • object

Ger ytterligare kontext för länkar.

issues

Lista över problem.

linkType
  • string

Länktyp.

nextHopId
  • string

ID:t för nästa hopp.

properties.roundTripTimeAvg
  • integer

Genomsnittlig tur- och returtid i millisekunder.

properties.roundTripTimeMax
  • integer

Maximal tur- och returtid i millisekunder.

properties.roundTripTimeMin
  • integer

Minsta tur- och returtid i millisekunder.

resourceId
  • string

Resurs-ID.

IssueType

Typ av problem.

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

Origin

Problemets ursprung.

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

Severity

Problemets allvarlighetsgrad.

Name Type Description
Error
  • string
Warning
  • string