Condividi tramite


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
networkWatcherName
path True

string

Nome del network watcher.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

subscriptionId
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

NetworkWatcher

Operazione di aggiornamento della risorsa 'NetworkWatcher' riuscita

201 Created

NetworkWatcher

Risorsa 'NetworkWatcher' crea l'operazione con successo

Other Status Codes

ErrorResponse

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
ErrorDetails

Rappresentazione comune dei dettagli degli errori.

ErrorResponse

Oggetto error.

NetworkWatcher

Network Watcher in un gruppo di risorse.

ProvisioningState

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

ErrorDetails

Errore
L'oggetto dei dettagli dell'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

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