Network Watchers - List All

Servicio:: Network Watcher

Versión de la API:: 2025-05-01

Obtiene todos los observadores de la red por suscripción.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	NetworkWatcherListResult	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

List all network watchers

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/networkWatchers?api-version=2025-05-01

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

/**
 * This sample demonstrates how to Gets all network watchers by subscription.
 *
 * @summary Gets all network watchers by subscription.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkWatcherListAll.json
 */
async function listAllNetworkWatchers() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.networkWatchers.listAll()) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "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": "nw2",
      "type": "Microsoft.Network/networkWatchers",
      "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw2",
      "location": "westus",
      "properties": {
        "provisioningState": "Succeeded"
      },
      "tags": {}
    }
  ]
}

Definiciones

Nombre	Description
Common.NetworkWatcher	Network Watcher en un grupo de recursos.
ErrorDetails	Representación de detalles de error comunes.
ErrorResponse	Objeto de error.
NetworkWatcherListResult	Respuesta para la llamada del servicio API ListNetworkWatchers.
ProvisioningState	Estado de aprovisionamiento del registro de flujo.

Common.NetworkWatcher

Objeto

Network Watcher en un grupo de recursos.

Nombre	Tipo	Description
etag	string	Cadena de solo lectura única que cambia cada vez que se actualiza el recurso.
id	string	Identificador de recurso.
location	string	Ubicación del recurso.
name	string	Nombre del recurso.
properties.provisioningState	ProvisioningState	El estado de aprovisionamiento del recurso del observador de red.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

ErrorDetails

Objeto

Representación de detalles de error comunes.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error.
target	string	Destino de error.

ErrorResponse

Objeto

Objeto de error.

Nombre	Tipo	Description
error	ErrorDetails	Error El objeto de detalles del error.

NetworkWatcherListResult

Objeto

Respuesta para la llamada del servicio API ListNetworkWatchers.

Nombre	Tipo	Description
nextLink	string	URL para obtener el siguiente conjunto de resultados.
value	Common.NetworkWatcher[]	Lista de recursos de Network Watcher.

ProvisioningState

Enumeración

Estado de aprovisionamiento del registro de flujo.

Valor	Description
Failed	Fallido
Succeeded	Succeeded
Canceled	Cancelado
Creating	Creando
Updating	Actualización
Deleting	Eliminando