Connection Monitors - Query

Interrogez un instantané des États de connexion les plus récents.

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

Paramètres URI

Name In Required Type Description
connectionMonitorName
path True
  • string

Nom donné à l’analyse de la connexion.

networkWatcherName
path True
  • string

Nom de la ressource Network Watcher.

resourceGroupName
path True
  • string

Nom du groupe de ressources contenant Network Watcher.

subscriptionId
path True
  • string

Informations d’identification d’abonnement qui identifient de façon unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True
  • string

Version d’API client.

Réponses

Name Type Description
200 OK

Réussite de l’interrogation des États de la connexion.

202 Accepted

Requête d’États de connexion acceptée.

Other Status Codes

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Azure Active Directory le Flow OAuth2.

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

Scopes

Name Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

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": []
        }
      ]
    }
  ]
}

Définitions

ConnectionMonitorQueryResult

Liste des instantanés des États de connexion.

ConnectionMonitorSourceStatus

État de la source du moniteur de connexion.

ConnectionState

État de la connexion.

ConnectionStateSnapshot

Instantané de l’état de la connexion.

ConnectivityHop

Informations sur un tronçon entre la source et la destination.

ConnectivityIssue

Informations sur un problème rencontré dans le processus de vérification de la connectivité.

ErrorDetails

Représentation courante des détails de l’erreur.

ErrorResponse

Objet d’erreur.

EvaluationState

État d’évaluation de l’analyse de connectivité.

HopLink

Lien de tronçon.

IssueType

Type de problème.

Origin

Origine du problème.

Severity

La gravité du problème.

ConnectionMonitorQueryResult

Liste des instantanés des États de connexion.

Name Type Description
sourceStatus

État de la source du moniteur de connexion.

states

Informations sur les États de connexion.

ConnectionMonitorSourceStatus

État de la source du moniteur de connexion.

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

ConnectionState

État de la connexion.

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

ConnectionStateSnapshot

Instantané de l’état de la connexion.

Name Type Description
avgLatencyInMs
  • integer

Latence moyenne en ms.

connectionState

État de la connexion.

endTime
  • string

Heure de fin de l’instantané de connexion.

evaluationState

État d’évaluation de l’analyse de connectivité.

hops

Liste de sauts entre la source et la destination.

maxLatencyInMs
  • integer

Latence maximale en ms.

minLatencyInMs
  • integer

Latence minimale en ms.

probesFailed
  • integer

Nombre de sondes ayant échoué.

probesSent
  • integer

Nombre de sondes envoyées.

startTime
  • string

Heure de début de l’instantané de connexion.

ConnectivityHop

Informations sur un tronçon entre la source et la destination.

Name Type Description
address
  • string

Adresse IP du tronçon.

id
  • string

ID du tronçon.

issues

Liste des problèmes.

links

Liste des liens de tronçons.

nextHopIds
  • string[]

Liste des identificateurs de tronçon suivant.

previousHopIds
  • string[]

Liste des identificateurs de tronçon précédents.

previousLinks

Liste des liens de tronçon précédents.

resourceId
  • string

ID de la ressource correspondant à ce tronçon.

type
  • string

Type du tronçon.

ConnectivityIssue

Informations sur un problème rencontré dans le processus de vérification de la connectivité.

Name Type Description
context
  • object[]

Fournit un contexte supplémentaire sur le problème.

origin

Origine du problème.

severity

La gravité du problème.

type

Type de problème.

ErrorDetails

Représentation courante des détails de l’erreur.

Name Type Description
code
  • string

Code d’erreur.

message
  • string

Message d’erreur.

target
  • string

Cible de l’erreur.

ErrorResponse

Objet d’erreur.

Name Type Description
error

Error
Objet des détails de l’erreur.

EvaluationState

État d’évaluation de l’analyse de connectivité.

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

Lien de tronçon.

Name Type Description
context
  • object

Fournit un contexte supplémentaire sur les liens.

issues

Liste des problèmes.

linkType
  • string

Type de lien.

nextHopId
  • string

ID du tronçon suivant.

properties.roundTripTimeAvg
  • integer

Temps d’aller-retour moyen en millisecondes.

properties.roundTripTimeMax
  • integer

Durée d’aller-retour maximale en millisecondes.

properties.roundTripTimeMin
  • integer

Durée d’aller-retour minimale en millisecondes.

resourceId
  • string

ID de la ressource

IssueType

Type de problème.

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

Origin

Origine du problème.

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

Severity

La gravité du problème.

Name Type Description
Error
  • string
Warning
  • string