Connection Monitors - Query
가장 최근 연결 상태의 스냅샷 쿼리합니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/connectionMonitors/{connectionMonitorName}/query?api-version=2023-09-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
connection
|
path | True |
string |
연결 모니터에 지정된 이름입니다. |
network
|
path | True |
string |
Network Watcher 리소스의 이름입니다. |
resource
|
path | True |
string |
Network Watcher 포함하는 리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
Connection |
연결 상태 쿼리에 성공했습니다. |
202 Accepted |
Connection |
연결 상태의 허용된 쿼리입니다. |
Other Status Codes |
Error |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 | 사용자 계정 가장 |
예제
Query connection monitor
Sample Request
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=2023-09-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": []
}
]
}
]
}
정의
Name | Description |
---|---|
Connection |
연결 상태 스냅샷 목록입니다. |
Connection |
연결 모니터 원본의 상태입니다. |
Connection |
연결 상태입니다. |
Connection |
연결 상태 스냅샷. |
Connectivity |
원본과 대상 간의 홉에 대한 정보입니다. |
Connectivity |
연결을 확인하는 과정에서 발생한 문제에 대한 정보입니다. |
Error |
일반적인 오류 세부 정보 표현입니다. |
Error |
Error 개체. |
Evaluation |
연결 분석 평가 상태입니다. |
Hop |
홉 링크. |
Issue |
문제의 유형입니다. |
Origin |
문제의 원본입니다. |
Severity |
문제의 심각도입니다. |
ConnectionMonitorQueryResult
연결 상태 스냅샷 목록입니다.
Name | 형식 | Description |
---|---|---|
sourceStatus |
Connection |
연결 모니터 원본의 상태입니다. |
states |
Connection |
연결 상태에 대한 정보입니다. |
ConnectionMonitorSourceStatus
연결 모니터 원본의 상태입니다.
Name | 형식 | Description |
---|---|---|
Active |
string |
|
Inactive |
string |
|
Unknown |
string |
ConnectionState
연결 상태입니다.
Name | 형식 | Description |
---|---|---|
Reachable |
string |
|
Unknown |
string |
|
Unreachable |
string |
ConnectionStateSnapshot
연결 상태 스냅샷.
Name | 형식 | Description |
---|---|---|
avgLatencyInMs |
integer |
ms의 평균 대기 시간. |
connectionState |
Connection |
연결 상태입니다. |
endTime |
string |
연결의 종료 시간이 스냅샷. |
evaluationState |
Evaluation |
연결 분석 평가 상태입니다. |
hops |
Connectivity |
원본과 대상 간의 홉 목록입니다. |
maxLatencyInMs |
integer |
최대 대기 시간(ms)입니다. |
minLatencyInMs |
integer |
최소 대기 시간(ms)입니다. |
probesFailed |
integer |
실패한 프로브의 수입니다. |
probesSent |
integer |
전송된 프로브의 수입니다. |
startTime |
string |
연결 스냅샷 시작 시간입니다. |
ConnectivityHop
원본과 대상 간의 홉에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
address |
string |
홉의 IP 주소입니다. |
id |
string |
홉의 ID입니다. |
issues |
Connectivity |
문제 목록입니다. |
links |
Hop |
홉 링크 목록입니다. |
nextHopIds |
string[] |
다음 홉 식별자 목록입니다. |
previousHopIds |
string[] |
이전 홉 식별자 목록입니다. |
previousLinks |
Hop |
이전 홉 링크 목록입니다. |
resourceId |
string |
이 홉에 해당하는 리소스의 ID입니다. |
type |
string |
홉의 형식입니다. |
ConnectivityIssue
연결을 확인하는 과정에서 발생한 문제에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
context |
object[] |
문제에 대한 추가 컨텍스트를 제공합니다. |
origin |
문제의 원본입니다. |
|
severity |
문제의 심각도입니다. |
|
type |
Issue |
문제의 유형입니다. |
ErrorDetails
일반적인 오류 세부 정보 표현입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드 |
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
Error 개체.
Name | 형식 | Description |
---|---|---|
error |
Error |
오류 |
EvaluationState
연결 분석 평가 상태입니다.
Name | 형식 | Description |
---|---|---|
Completed |
string |
|
InProgress |
string |
|
NotStarted |
string |
HopLink
홉 링크.
Name | 형식 | Description |
---|---|---|
context |
object |
링크에 대한 추가 컨텍스트를 제공합니다. |
issues |
Connectivity |
문제 목록입니다. |
linkType |
string |
링크 유형입니다. |
nextHopId |
string |
다음 홉의 ID입니다. |
properties.roundTripTimeAvg |
integer |
평균 왕복 시간(밀리초)입니다. |
properties.roundTripTimeMax |
integer |
최대 왕복 시간(밀리초)입니다. |
properties.roundTripTimeMin |
integer |
최소 왕복 시간(밀리초)입니다. |
resourceId |
string |
리소스 ID입니다. |
IssueType
문제의 유형입니다.
Name | 형식 | Description |
---|---|---|
AgentStopped |
string |
|
DnsResolution |
string |
|
GuestFirewall |
string |
|
NetworkSecurityRule |
string |
|
Platform |
string |
|
PortThrottled |
string |
|
SocketBind |
string |
|
Unknown |
string |
|
UserDefinedRoute |
string |
Origin
문제의 원본입니다.
Name | 형식 | Description |
---|---|---|
Inbound |
string |
|
Local |
string |
|
Outbound |
string |
Severity
문제의 심각도입니다.
Name | 형식 | Description |
---|---|---|
Error |
string |
|
Warning |
string |