Network Watchers - Check Connectivity
Überprüft die Möglichkeit, eine direkte TCP-Verbindung zwischen einem virtuellen Computer und einem angegebenen Endpunkt herzustellen, einschließlich mit anderen VMs oder einem freien Remoteserver.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/connectivityCheck?api-version=2023-09-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
network
|
path | True |
string |
Der Name der Network Watcher-Ressource. |
resource
|
path | True |
string |
Der Name der Network Watcher-Ressourcengruppe. |
subscription
|
path | True |
string |
Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
api-version
|
query | True |
string |
Client-API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
destination | True |
Das Ziel der Verbindung. |
|
source | True |
Die Quelle der Verbindung. |
|
preferredIPVersion |
Bevorzugte IP-Version der Verbindung. |
||
protocol |
Netzwerkprotokoll. |
||
protocolConfiguration |
Konfiguration des Protokolls. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreiche Anforderung zum Überprüfen der Konnektivität. |
|
202 Accepted |
Akzeptiert, und der Vorgang wird asynchron abgeschlossen. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Check connectivity
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/connectivityCheck?api-version=2023-09-01
{
"source": {
"resourceId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Compute/virtualMachines/vm1"
},
"destination": {
"address": "192.168.100.4",
"port": 3389
},
"preferredIPVersion": "IPv4"
}
Sample Response
{
"hops": [
{
"type": "Source",
"id": "7dbbe7aa-60ba-4650-831e-63d775d38e9e",
"address": "10.1.1.4",
"resourceId": "subscriptions/subid/resourceGroups/rg2/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/rg2/providers/Microsoft.Network/networkInterfaces/nic1/ipConfigurations/ipconfig1",
"nextHopIds": [],
"issues": []
}
],
"connectionStatus": "Connected",
"avgLatencyInMs": 1,
"minLatencyInMs": 1,
"maxLatencyInMs": 4,
"probesSent": 100,
"probesFailed": 0
}
Location: https:/management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/connectivityCheck?api-version=2023-09-01
{
"hops": [
{
"type": "Source",
"id": "7dbbe7aa-60ba-4650-831e-63d775d38e9e",
"address": "10.1.1.4",
"resourceId": "subscriptions/subid/resourceGroups/rg2/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/rg2/providers/Microsoft.Network/networkInterfaces/nic1/ipConfigurations/ipconfig1",
"nextHopIds": [],
"issues": []
}
],
"connectionStatus": "Connected",
"avgLatencyInMs": 1,
"minLatencyInMs": 1,
"maxLatencyInMs": 4,
"probesSent": 100,
"probesFailed": 0
}
Definitionen
Name | Beschreibung |
---|---|
Connection |
Die Verbindung status. |
Connectivity |
Parameter, die das Verbindungsziel definieren. |
Connectivity |
Informationen zu einem Hop zwischen der Quelle und dem Ziel. |
Connectivity |
Informationen zur konnektivitäts-status. |
Connectivity |
Informationen zu einem Problem, das bei der Überprüfung auf Konnektivität aufgetreten ist. |
Connectivity |
Parameter, die bestimmen, wie die Konnektivitätsprüfung ausgeführt wird. |
Connectivity |
Parameter, die die Quelle der Verbindung definieren. |
Error |
Allgemeine Darstellung von Fehlerdetails. |
Error |
Das Fehlerobjekt. |
Hop |
Hoplink. |
HTTPConfiguration |
HTTP-Konfiguration der Konnektivitätsprüfung. |
HTTPHeader |
Der HTTP-Header. |
HTTPMethod |
HTTP-Methode. |
IPVersion |
IP-Adressversion. |
Issue |
Der Typ des Problems. |
Origin |
Der Ursprung des Problems. |
Protocol |
Netzwerkprotokoll. |
Protocol |
Konfiguration des Protokolls. |
Severity |
Der Schweregrad des Problems. |
ConnectionStatus
Die Verbindung status.
Name | Typ | Beschreibung |
---|---|---|
Connected |
string |
|
Degraded |
string |
|
Disconnected |
string |
|
Unknown |
string |
ConnectivityDestination
Parameter, die das Verbindungsziel definieren.
Name | Typ | Beschreibung |
---|---|---|
address |
string |
Die IP-Adresse oder der URI der Ressource, mit der eine Verbindung versucht wird. |
port |
integer |
Port, an dem die Konnektivität überprüft wird. |
resourceId |
string |
Die ID der Ressource, mit der eine Verbindung versucht wird. |
ConnectivityHop
Informationen zu einem Hop zwischen der Quelle und dem Ziel.
Name | Typ | Beschreibung |
---|---|---|
address |
string |
Die IP-Adresse des Hops. |
id |
string |
Die ID des Hops. |
issues |
Liste der Probleme. |
|
links |
Hop |
Liste der Hoplinks. |
nextHopIds |
string[] |
Liste der Bezeichner des nächsten Hops. |
previousHopIds |
string[] |
Liste der vorherigen Hopbezeichner. |
previousLinks |
Hop |
Liste der vorherigen Hoplinks. |
resourceId |
string |
Die ID der Ressource, die diesem Hop entspricht. |
type |
string |
Der Typ des Hops. |
ConnectivityInformation
Informationen zur konnektivitäts-status.
Name | Typ | Beschreibung |
---|---|---|
avgLatencyInMs |
integer |
Durchschnittliche Latenz in Millisekunden. |
connectionStatus |
Die Verbindung status. |
|
hops |
Liste der Hops zwischen Quelle und Ziel. |
|
maxLatencyInMs |
integer |
Maximale Latenz in Millisekunden. |
minLatencyInMs |
integer |
Minimale Latenz in Millisekunden. |
probesFailed |
integer |
Anzahl fehlerhafter Tests. |
probesSent |
integer |
Gesamtzahl der gesendeten Tests. |
ConnectivityIssue
Informationen zu einem Problem, das bei der Überprüfung auf Konnektivität aufgetreten ist.
Name | Typ | Beschreibung |
---|---|---|
context |
object[] |
Stellt zusätzlichen Kontext für das Problem bereit. |
origin |
Der Ursprung des Problems. |
|
severity |
Der Schweregrad des Problems. |
|
type |
Der Typ des Problems. |
ConnectivityParameters
Parameter, die bestimmen, wie die Konnektivitätsprüfung ausgeführt wird.
Name | Typ | Beschreibung |
---|---|---|
destination |
Das Ziel der Verbindung. |
|
preferredIPVersion |
Bevorzugte IP-Version der Verbindung. |
|
protocol |
Netzwerkprotokoll. |
|
protocolConfiguration |
Konfiguration des Protokolls. |
|
source |
Die Quelle der Verbindung. |
ConnectivitySource
Parameter, die die Quelle der Verbindung definieren.
Name | Typ | Beschreibung |
---|---|---|
port |
integer |
Der Quellport, von dem aus eine Konnektivitätsprüfung durchgeführt wird. |
resourceId |
string |
Die ID der Ressource, von der aus eine Konnektivitätsprüfung initiiert wird. |
ErrorDetails
Allgemeine Darstellung von Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode |
message |
string |
Fehlermeldung. |
target |
string |
Fehlerziel. |
ErrorResponse
Das Fehlerobjekt.
Name | Typ | Beschreibung |
---|---|---|
error |
Fehler |
HopLink
Hoplink.
Name | Typ | Beschreibung |
---|---|---|
context |
object |
Stellt zusätzlichen Kontext für Links bereit. |
issues |
Liste der Probleme. |
|
linkType |
string |
Linktyp. |
nextHopId |
string |
Die ID des nächsten Hops. |
properties.roundTripTimeAvg |
integer |
Durchschnittliche Roundtripzeit in Millisekunden. |
properties.roundTripTimeMax |
integer |
Maximale Roundtripzeit in Millisekunden. |
properties.roundTripTimeMin |
integer |
Minimale Roundtripzeit in Millisekunden. |
resourceId |
string |
Ressourcen-ID |
HTTPConfiguration
HTTP-Konfiguration der Konnektivitätsprüfung.
Name | Typ | Beschreibung |
---|---|---|
headers |
Liste der HTTP-Header. |
|
method |
HTTP-Methode. |
|
validStatusCodes |
integer[] |
Gültige status Codes. |
HTTPHeader
Der HTTP-Header.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name im HTTP-Header. |
value |
string |
Der Wert im HTTP-Header. |
HTTPMethod
HTTP-Methode.
Name | Typ | Beschreibung |
---|---|---|
Get |
string |
IPVersion
IP-Adressversion.
Name | Typ | Beschreibung |
---|---|---|
IPv4 |
string |
|
IPv6 |
string |
IssueType
Der Typ des Problems.
Name | Typ | Beschreibung |
---|---|---|
AgentStopped |
string |
|
DnsResolution |
string |
|
GuestFirewall |
string |
|
NetworkSecurityRule |
string |
|
Platform |
string |
|
PortThrottled |
string |
|
SocketBind |
string |
|
Unknown |
string |
|
UserDefinedRoute |
string |
Origin
Der Ursprung des Problems.
Name | Typ | Beschreibung |
---|---|---|
Inbound |
string |
|
Local |
string |
|
Outbound |
string |
Protocol
Netzwerkprotokoll.
Name | Typ | Beschreibung |
---|---|---|
Http |
string |
|
Https |
string |
|
Icmp |
string |
|
Tcp |
string |
ProtocolConfiguration
Konfiguration des Protokolls.
Name | Typ | Beschreibung |
---|---|---|
HTTPConfiguration |
HTTP-Konfiguration der Konnektivitätsprüfung. |
Severity
Der Schweregrad des Problems.
Name | Typ | Beschreibung |
---|---|---|
Error |
string |
|
Warning |
string |