Connection Monitors - Query

가장 최근 연결 상태의 스냅샷을 쿼리합니다.

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

URI 매개 변수

Name In Required Type Description
connectionMonitorName
path True
  • string

연결 모니터에 지정된 이름입니다.

networkWatcherName
path True
  • string

Network Watcher 리소스의 이름입니다.

resourceGroupName
path True
  • string

Network Watcher 포함하는 리소스 그룹의 이름입니다.

subscriptionId
path True
  • string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

api-version
query True
  • string

클라이언트 API 버전입니다.

응답

Name Type Description
200 OK

연결 상태 쿼리가 성공했습니다.

202 Accepted

연결 상태의 허용된 쿼리입니다.

Other Status Codes

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory.

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

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

정의

ConnectionMonitorQueryResult

연결 상태 스냅샷 목록입니다.

ConnectionMonitorSourceStatus

연결 모니터 원본의 상태입니다.

ConnectionState

연결 상태입니다.

ConnectionStateSnapshot

연결 상태 스냅샷.

ConnectivityHop

원본과 대상 간의 홉에 대한 정보입니다.

ConnectivityIssue

연결을 확인하는 과정에서 발생한 문제에 대한 정보입니다.

ErrorDetails

일반적인 오류 세부 정보 표현입니다.

ErrorResponse

오류 개체입니다.

EvaluationState

연결 분석 평가 상태입니다.

HopLink

홉 링크.

IssueType

문제의 유형입니다.

Origin

문제의 출처입니다.

Severity

문제의 심각도입니다.

ConnectionMonitorQueryResult

연결 상태 스냅샷 목록입니다.

Name Type Description
sourceStatus

연결 모니터 원본의 상태입니다.

states

연결 상태에 대한 정보입니다.

ConnectionMonitorSourceStatus

연결 모니터 원본의 상태입니다.

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

ConnectionState

연결 상태입니다.

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

ConnectionStateSnapshot

연결 상태 스냅샷.

Name Type Description
avgLatencyInMs
  • integer

ms의 평균 대기 시간

connectionState

연결 상태입니다.

endTime
  • string

연결 스냅샷의 종료 시간입니다.

evaluationState

연결 분석 평가 상태입니다.

hops

원본과 대상 간의 홉 목록입니다.

maxLatencyInMs
  • integer

최대 대기 시간(밀리초)입니다.

minLatencyInMs
  • integer

최소 대기 시간(밀리초)입니다.

probesFailed
  • integer

실패한 프로브의 수입니다.

probesSent
  • integer

전송된 프로브의 수입니다.

startTime
  • string

연결 스냅샷의 시작 시간입니다.

ConnectivityHop

원본과 대상 간의 홉에 대한 정보입니다.

Name Type Description
address
  • string

홉의 IP 주소입니다.

id
  • string

홉의 ID입니다.

issues

문제 목록입니다.

links

홉 링크 목록입니다.

nextHopIds
  • string[]

다음 홉 식별자 목록입니다.

previousHopIds
  • string[]

이전 홉 식별자 목록입니다.

previousLinks

이전 홉 링크 목록입니다.

resourceId
  • string

이 홉에 해당하는 리소스의 ID입니다.

type
  • string

홉의 형식입니다.

ConnectivityIssue

연결을 확인하는 과정에서 발생한 문제에 대한 정보입니다.

Name Type Description
context
  • object[]

문제에 대한 추가 컨텍스트를 제공합니다.

origin

문제의 출처입니다.

severity

문제의 심각도입니다.

type

문제의 유형입니다.

ErrorDetails

일반적인 오류 세부 정보 표현입니다.

Name Type Description
code
  • string

오류 코드

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

ErrorResponse

오류 개체입니다.

Name Type Description
error

Error
오류 세부 정보 개체입니다.

EvaluationState

연결 분석 평가 상태입니다.

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

홉 링크.

Name Type Description
context
  • object

링크에 대한 추가 컨텍스트를 제공합니다.

issues

문제 목록입니다.

linkType
  • string

링크 유형입니다.

nextHopId
  • string

다음 홉의 ID입니다.

properties.roundTripTimeAvg
  • integer

평균 왕복 시간(밀리초)입니다.

properties.roundTripTimeMax
  • integer

최대 왕복 시간(밀리초)입니다.

properties.roundTripTimeMin
  • integer

최소 왕복 시간(밀리초)입니다.

resourceId
  • string

리소스 ID입니다.

IssueType

문제의 유형입니다.

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

Origin

문제의 출처입니다.

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

Severity

문제의 심각도입니다.

Name Type Description
Error
  • string
Warning
  • string