Network Watchers - Get Troubleshooting
Initiieren sie die Problembehandlung für eine angegebene Ressource.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}/troubleshoot?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 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 |
---|---|---|---|
properties.storageId | True |
string |
Die ID für das Speicherkonto, um das Problembehandlungsergebnis zu speichern. |
properties.storagePath | True |
string |
Der Pfad zum Blob, in dem das Problembehandlungsergebnis gespeichert werden soll. |
targetResourceId | True |
string |
Die Zielressource für die Problembehandlung. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreiche Problembehandlungsanforderung. |
|
202 Accepted |
Akzeptierte Get-Problembehandlungsanforderung. |
|
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
Get troubleshooting
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/troubleshoot?api-version=2023-09-01
{
"targetResourceId": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Compute/virtualMachines/vm1",
"properties": {
"storageId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/st1",
"storagePath": "https://st1.blob.core.windows.net/cn1"
}
}
Sample Response
{
"startTime": "2017-01-12T00:19:47.0442834Z",
"endTime": "2017-01-12T00:20:09.914Z",
"code": "UnHealthy",
"results": [
{
"id": "000000",
"reasonType": "VipUnResponsive",
"summary": "We are sorry, your VPN gateway is unreachable from the Internet",
"detail": "During this time S2S VPN tunnels to on premises sites or other Azure virtual networks will be disconnected",
"recommendedActions": [
{
"actionText": "Verify if there is a network security group (NSG) applied to the GatewaySubnet",
"actionUri": "https://docs.microsoft.com/en-us/azure/virtual-network/virtual-networks-create-nsg-arm-pportal",
"actionUriText": "Verify"
},
{
"actionText": "If your VPN gateway isn't up and running by the expected resolution time, contact support",
"actionUri": "http://azure.microsoft.com/support",
"actionUriText": "contact support"
}
]
}
]
}
Location: https:/management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1/troubleshoot?api-version=2023-09-01
{
"startTime": "2017-01-12T00:19:47.0442834Z",
"endTime": "2017-01-12T00:20:09.914Z",
"code": "UnHealthy",
"results": [
{
"id": "000000",
"reasonType": "VipUnResponsive",
"summary": "We are sorry, your VPN gateway is unreachable from the Internet",
"detail": "During this time S2S VPN tunnels to on premises sites or other Azure virtual networks will be disconnected",
"recommendedActions": [
{
"actionText": "Verify if there is a network security group (NSG) applied to the GatewaySubnet",
"actionUri": "https://docs.microsoft.com/en-us/azure/virtual-network/virtual-networks-create-nsg-arm-pportal",
"actionUriText": "Verify"
},
{
"actionText": "If your VPN gateway isn't up and running by the expected resolution time, contact support",
"actionUri": "http://azure.microsoft.com/support",
"actionUriText": "contact support"
}
]
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Error |
Allgemeine Darstellung von Fehlerdetails. |
Error |
Das Fehlerobjekt. |
Troubleshooting |
Informationen, die bei der Problembehandlung für die angegebene Ressource gewonnen wurden. |
Troubleshooting |
Parameter, die die Zu behandelnde Ressource definieren. |
Troubleshooting |
Empfohlene Aktionen basierend auf ermittelten Problemen. |
Troubleshooting |
Problembehandlungsinformationen aus der angegebenen Ressource. |
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 |
TroubleshootingDetails
Informationen, die bei der Problembehandlung für die angegebene Ressource gewonnen wurden.
Name | Typ | Beschreibung |
---|---|---|
detail |
string |
Details zu Den Ergebnissen der Problembehandlung. |
id |
string |
Die ID des Get-Problembehandlungsvorgangs. |
reasonType |
string |
Grundtyp des Fehlers. |
recommendedActions |
Liste der empfohlenen Aktionen. |
|
summary |
string |
Eine Zusammenfassung der Problembehandlung. |
TroubleshootingParameters
Parameter, die die Zu behandelnde Ressource definieren.
Name | Typ | Beschreibung |
---|---|---|
properties.storageId |
string |
Die ID für das Speicherkonto, um das Problembehandlungsergebnis zu speichern. |
properties.storagePath |
string |
Der Pfad zum Blob, in dem das Problembehandlungsergebnis gespeichert werden soll. |
targetResourceId |
string |
Die Zielressource für die Problembehandlung. |
TroubleshootingRecommendedActions
Empfohlene Aktionen basierend auf ermittelten Problemen.
Name | Typ | Beschreibung |
---|---|---|
actionId |
string |
ID der empfohlenen Aktion. |
actionText |
string |
Beschreibung der empfohlenen Aktionen. |
actionUri |
string |
Der URI, der mit einer Dokumentation für die empfohlenen Problembehandlungsaktionen verknüpft ist. |
actionUriText |
string |
Die Informationen aus dem URI für die empfohlenen Problembehandlungsaktionen. |
TroubleshootingResult
Problembehandlungsinformationen aus der angegebenen Ressource.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Ergebniscode der Problembehandlung. |
endTime |
string |
Die Endzeit der Problembehandlung. |
results |
Informationen zur Problembehandlung. |
|
startTime |
string |
Die Startzeit der Problembehandlung. |