Obtiene todos los monitores de red por suscripción.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/networkWatchers?api-version=2024-05-01
Parámetros de identificador URI
Nombre |
En |
Requerido |
Tipo |
Description |
subscriptionId
|
path |
True
|
string
|
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
|
api-version
|
query |
True
|
string
|
Versión de la API de cliente.
|
Respuestas
Nombre |
Tipo |
Description |
200 OK
|
NetworkWatcherListResult
|
Solicitud correcta. La operación devuelve una lista de recursos de Network Watcher.
|
Other Status Codes
|
ErrorResponse
|
Respuesta de error que describe por qué se produjo un error en la operación.
|
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
Solicitud de ejemplo
GET https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/networkWatchers?api-version=2024-05-01
/**
* Samples for NetworkWatchers List.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/NetworkWatcherListAll.json
*/
/**
* Sample code: List all network watchers.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void listAllNetworkWatchers(com.azure.resourcemanager.AzureResourceManager azure) {
azure.networks().manager().serviceClient().getNetworkWatchers().list(com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.network import NetworkManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-network
# USAGE
python network_watcher_list_all.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = NetworkManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.network_watchers.list_all()
for item in response:
print(item)
# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/NetworkWatcherListAll.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armnetwork_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ab04533261eff228f28e08900445d0edef3eb70c/specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/NetworkWatcherListAll.json
func ExampleWatchersClient_NewListAllPager() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
pager := clientFactory.NewWatchersClient().NewListAllPager(nil)
for pager.More() {
page, err := pager.NextPage(ctx)
if err != nil {
log.Fatalf("failed to advance page: %v", err)
}
for _, v := range page.Value {
// You could use page here. We use blank identifier for just demo purposes.
_ = v
}
// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// page.WatcherListResult = armnetwork.WatcherListResult{
// Value: []*armnetwork.Watcher{
// {
// Name: to.Ptr("nw1"),
// Type: to.Ptr("Microsoft.Network/networkWatchers"),
// ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1"),
// Location: to.Ptr("eastus"),
// Tags: map[string]*string{
// },
// Etag: to.Ptr("W/\"00000000-0000-0000-0000-000000000000\""),
// Properties: &armnetwork.WatcherPropertiesFormat{
// ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
// },
// },
// {
// Name: to.Ptr("nw2"),
// Type: to.Ptr("Microsoft.Network/networkWatchers"),
// ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw2"),
// Location: to.Ptr("westus"),
// Tags: map[string]*string{
// },
// Etag: to.Ptr("W/\"00000000-0000-0000-0000-000000000000\""),
// Properties: &armnetwork.WatcherPropertiesFormat{
// ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
// },
// }},
// }
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* 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/stable/2024-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 (let 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
{
"value": [
{
"name": "nw1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw1",
"etag": "W/\"00000000-0000-0000-0000-000000000000\"",
"type": "Microsoft.Network/networkWatchers",
"location": "eastus",
"tags": {},
"properties": {
"provisioningState": "Succeeded"
}
},
{
"name": "nw2",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkWatchers/nw2",
"etag": "W/\"00000000-0000-0000-0000-000000000000\"",
"type": "Microsoft.Network/networkWatchers",
"location": "westus",
"tags": {},
"properties": {
"provisioningState": "Succeeded"
}
}
]
}
Definiciones
ErrorDetails
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 de error.
Nombre |
Tipo |
Description |
error
|
ErrorDetails
|
Error
Objeto de detalles del error.
|
NetworkWatcher
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
|
Estado de aprovisionamiento del recurso de Network Watcher.
|
tags
|
object
|
Etiquetas de recursos.
|
type
|
string
|
Tipo de recurso.
|
NetworkWatcherListResult
Respuesta para la llamada del servicio API ListNetworkWatchers.
Nombre |
Tipo |
Description |
value
|
NetworkWatcher[]
|
Lista de recursos de Network Watcher.
|
ProvisioningState
Estado de aprovisionamiento actual.
Nombre |
Tipo |
Description |
Deleting
|
string
|
|
Failed
|
string
|
|
Succeeded
|
string
|
|
Updating
|
string
|
|