Network Watchers - Create Or Update
Crea o aggiorna un controllo di rete nel gruppo di risorse specificato.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}?api-version=2025-05-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
network
|
path | True |
string |
Nome del network watcher. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa. |
| location |
string |
Percorso della risorsa. |
| tags |
object |
Tag di risorsa. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione di aggiornamento della risorsa 'NetworkWatcher' riuscita |
|
| 201 Created |
Risorsa 'NetworkWatcher' crea l'operazione con successo |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Create network watcher
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1?api-version=2025-05-01
{
"location": "eastus",
"properties": {}
}
Risposta di esempio
{
"name": "nw1",
"type": "Microsoft.Network/networkWatchers",
"etag": "W/\"00000000-0000-0000-0000-000000000000\"",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1",
"location": "eastus",
"properties": {
"provisioningState": "Succeeded"
},
"tags": {}
}
{
"name": "nw1",
"type": "Microsoft.Network/networkWatchers",
"etag": "W/\"00000000-0000-0000-0000-000000000000\"",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1",
"location": "eastus",
"properties": {
"provisioningState": "Succeeded"
},
"tags": {}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Error |
Rappresentazione comune dei dettagli degli errori. |
|
Error |
Oggetto error. |
|
Network |
Network Watcher in un gruppo di risorse. |
|
Provisioning |
Stati di provisioning di una risorsa. |
ErrorDetails
Rappresentazione comune dei dettagli degli errori.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore. |
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione errore. |
ErrorResponse
Oggetto error.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Errore |
NetworkWatcher
Network Watcher in un gruppo di risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| etag |
string |
Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata. |
| id |
string |
ID risorsa. |
| location |
string |
Percorso della risorsa. |
| name |
string |
Nome risorsa. |
| properties.provisioningState |
Stato di provisioning della risorsa Network Watcher. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. |
ProvisioningState
Stati di provisioning di una risorsa.
| Valore | Descrizione |
|---|---|
| Failed |
Non riuscito |
| Succeeded |
Succeeded |
| Canceled |
Operazione annullata |
| Creating |
Creazione |
| Updating |
Aggiornamento |
| Deleting |
Deleting |