Network Watchers - Create Or Update

Service:: Network Watcher

Version d'API:: 2025-05-01

Crée ou met à jour un observateur de réseau dans le groupe de ressources spécifié.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkWatchers/{networkWatcherName}?api-version=2025-05-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
networkWatcherName	path	True	string	Nom de l’observateur réseau.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
id	string	ID de ressource.
location	string	Emplacement des ressources.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	Common.NetworkWatcher	Opération de mise à jour de la ressource 'NetworkWatcher' réussie
201 Created	Common.NetworkWatcher	Ressource 'NetworkWatcher' créer l’opération réussie
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Create network watcher

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": {}
}

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Creates or updates a network watcher in the specified resource group.
 *
 * @summary Creates or updates a network watcher in the specified resource group.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkWatcherCreate.json
 */
async function createNetworkWatcher() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const networkWatcherName = "nw1";
  const parameters = { location: "eastus" };
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.networkWatchers.createOrUpdate(
    resourceGroupName,
    networkWatcherName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "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": {}
}

Code d’état:: 201

{
  "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": {}
}

Définitions

Nom	Description
Common.NetworkWatcher	Observateur réseau dans un groupe de ressources.
ErrorDetails	Représentation des détails d’erreur courants.
ErrorResponse	Objet d’erreur.
ProvisioningState	État d’approvisionnement du journal de flux.

Common.NetworkWatcher

Objet

Observateur réseau dans un groupe de ressources.

Nom	Type	Description
etag	string	Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id	string	ID de ressource.
location	string	Emplacement des ressources.
name	string	Nom de la ressource.
properties.provisioningState	ProvisioningState	État de provisionnement de la ressource d’observateur réseau.
tags	object	Balises de ressource.
type	string	Type de ressource.

ErrorDetails

Objet

Représentation des détails d’erreur courants.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Objet d’erreur.

Nom	Type	Description
error	ErrorDetails	Erreur L’objet détails de l’erreur.

ProvisioningState

Énumération

État d’approvisionnement du journal de flux.

Valeur	Description
Failed	Échec
Succeeded	Réussi
Canceled	Opération annulée
Creating	Création
Updating	Mise à jour
Deleting	Suppression