Connection Monitors - Query

Consulte um instantâneo dos estados de conexão mais recentes.

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

Parâmetros de URI

Name In Required Type Description
connectionMonitorName
path True
  • string

O nome fornecido ao monitor de conexão.

networkWatcherName
path True
  • string

O nome do recurso Observador de Rede.

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém Observador de Rede.

subscriptionId
path True
  • string

As credenciais de assinatura que identificam exclusivamente a assinatura Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True
  • string

Versão de API do cliente.

Respostas

Name Type Description
200 OK

Consulta bem-sucedida dos estados de conexão.

202 Accepted

Consulta aceita de estados de conexão.

Other Status Codes

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Azure Active Directory Flow OAuth2.

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

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

Definições

ConnectionMonitorQueryResult

Lista de instantâneos de estados de conexão.

ConnectionMonitorSourceStatus

Status da origem do monitor de conexão.

ConnectionState

O estado da conexão.

ConnectionStateSnapshot

Instantâneo do estado da conexão.

ConnectivityHop

Informações sobre um salto entre a origem e o destino.

ConnectivityIssue

Informações sobre um problema encontrado no processo de verificação de conectividade.

ErrorDetails

Representação de detalhes de erro comuns.

ErrorResponse

O objeto de erro.

EvaluationState

Estado de avaliação da análise de conectividade.

HopLink

Link de salto.

IssueType

O tipo de problema.

Origin

A origem do problema.

Severity

A gravidade do problema.

ConnectionMonitorQueryResult

Lista de instantâneos de estados de conexão.

Name Type Description
sourceStatus

Status da origem do monitor de conexão.

states

Informações sobre estados de conexão.

ConnectionMonitorSourceStatus

Status da origem do monitor de conexão.

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

ConnectionState

O estado da conexão.

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

ConnectionStateSnapshot

Instantâneo do estado da conexão.

Name Type Description
avgLatencyInMs
  • integer

Latência média em ms.

connectionState

O estado da conexão.

endTime
  • string

A hora de término do instantâneo de conexão.

evaluationState

Estado de avaliação da análise de conectividade.

hops

Lista de saltos entre a origem e o destino.

maxLatencyInMs
  • integer

Latência máxima em ms.

minLatencyInMs
  • integer

Latência mínima em ms.

probesFailed
  • integer

O número de investigações com falha.

probesSent
  • integer

O número de investigações enviadas.

startTime
  • string

A hora de início do instantâneo de conexão.

ConnectivityHop

Informações sobre um salto entre a origem e o destino.

Name Type Description
address
  • string

O endereço IP do salto.

id
  • string

A ID do salto.

issues

Lista de problemas.

links

Lista de links de salto.

nextHopIds
  • string[]

Lista de identificadores do próximo salto.

previousHopIds
  • string[]

Lista de identificadores de salto anteriores.

previousLinks

Lista de links de salto anteriores.

resourceId
  • string

A ID do recurso correspondente a este salto.

type
  • string

O tipo do salto.

ConnectivityIssue

Informações sobre um problema encontrado no processo de verificação de conectividade.

Name Type Description
context
  • object[]

Fornece contexto adicional sobre o problema.

origin

A origem do problema.

severity

A gravidade do problema.

type

O tipo de problema.

ErrorDetails

Representação de detalhes de erro comuns.

Name Type Description
code
  • string

Código do erro.

message
  • string

Mensagem de erro.

target
  • string

Destino de erro.

ErrorResponse

O objeto de erro.

Name Type Description
error

Erro
O objeto de detalhes do erro.

EvaluationState

Estado de avaliação da análise de conectividade.

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

Link de salto.

Name Type Description
context
  • object

Fornece contexto adicional em links.

issues

Lista de problemas.

linkType
  • string

Tipo de link.

nextHopId
  • string

A ID do próximo salto.

properties.roundTripTimeAvg
  • integer

Tempo médio de ida e volta em milissegundos.

properties.roundTripTimeMax
  • integer

Tempo máximo de ida e volta em milissegundos.

properties.roundTripTimeMin
  • integer

Tempo mínimo de ida e volta em milissegundos.

resourceId
  • string

ID do recurso.

IssueType

O tipo de problema.

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

Origin

A origem do problema.

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

Severity

A gravidade do problema.

Name Type Description
Error
  • string
Warning
  • string