Visualizzare la topologia di Network Watcher con l'API RESTView Network Watcher topology with REST API

La funzionalità per la visualizzazione della topologia di Network Watcher offre una rappresentazione visiva delle risorse di rete in una sottoscrizione.The Topology feature of Network Watcher provides a visual representation of the network resources in a subscription. Nel portale, questa visualizzazione è automatica.In the portal, this visualization is presented to you automatically. È possibile recuperare le informazioni sottostanti alla visualizzazione della topologia nel portale usando PowerShell.The information behind the topology view in the portal can be retrieved through PowerShell. Questa funzionalità rende le informazioni sulla topologia più versatili, poiché i dati possono essere usati anche da altri strumenti per compilare la visualizzazione.This capability makes the topology information more versatile as the data can be consumed by other tools to build out the visualization.

L'interconnessione è modellata in due relazioni.The interconnection is modeled under two relationships.

  • Contenimento - Esempio: la rete virtuale contiene una subnet che contiene una scheda NICContainment - Example: VNet contains a Subnet contains a NIC
  • Associazione - Esempio: la scheda NIC è associata a una macchina virtualeAssociated - Example: NIC is associated with a VM

L'elenco include le proprietà restituite quando si esegue una query all'API REST della topologia.The following list is properties that are returned when querying the Topology REST API.

  • name - Il nome della risorsa.name - The name of the resource
  • id - L'URI della risorsa.id - The uri of the resource.
  • location - La località in cui si risiede la risorsa.location - The location where the resource exists.
  • associations - Un elenco di associazioni all'oggetto di riferimento.associations - A list of associations to the referenced object.
    • name - Il nome della risorsa di riferimento.name - The name of the referenced resource.
    • resourceId - ResourceId è l'URI della risorsa di riferimento nell'associazione.resourceId - The resourceId is the uri of the resource referenced in the association.
    • associationType - Il valore fa riferimento alla relazione tra l'oggetto figlio e l'oggetto padre.associationType - This value references the relationship between the child object and the parent. I valori validi sono Contains o Associated.Valid values are Contains or Associated.

Prima di iniziareBefore you begin

In questo scenario, vengono recuperate le informazioni sulla topologia.In this scenario, you retrieve the topology information. ARMclient viene usato per chiamare l'API REST con PowerShell.ARMclient is used to call the REST API using PowerShell. ARMClient è reperibile in Chocolatey in ARMClient on Chocolatey (ARMClient in Chocolatey)ARMClient is found on chocolatey at ARMClient on Chocolatey

Questo scenario presuppone il completamento dei passaggi descritti in Creare un servizio Network Watcher per creare un servizio Network Watcher.This scenario assumes you have already followed the steps in Create a Network Watcher to create a Network Watcher.

ScenarioScenario

Lo scenario illustrato in questo articolo consente di recuperare la risposta relativa alla topologia per un gruppo di risorse specificato.The scenario covered in this article retrieves the topology response for a given resource group.

Accedere con ARMClientLog in with ARMClient

Accedere ad armclient con le credenziali di Azure.Log in to armclient with your Azure credentials.

armclient login

Recuperare una topologiaRetrieve topology

L'esempio seguente richiede la topologia dall'API REST.The following example requests the topology from the REST API. Nell'esempio vengono impostati parametri per consentire flessibilità nella creazione di un esempio.The example is parameterized to allow for flexibility in creating an example. Sostituire tutti i valori con < > intorno a essi.Replace all values with < > surrounding them.

$subscriptionId = "<subscription id>"
$resourceGroupName = "<resource group name>" # Resource group name to run topology on
$NWresourceGroupName = "<resource group name>" # Network Watcher resource group name
$networkWatcherName = "<network watcher name>"
$requestBody = @"
{
    'targetResourceGroupName': '${resourceGroupName}'
}
"@

armclient POST "https://management.azure.com/subscriptions/${subscriptionId}/ResourceGroups/${NWresourceGroupName}/providers/Microsoft.Network/networkWatchers/${networkWatcherName}/topology?api-version=2016-07-01" $requestBody

La risposta seguente è un esempio di risposta abbreviata che viene restituita quando si recupera la topologia per un gruppo di risorse:The following response is an example of a shortened response that is returned when retrieve topology for a resourcegroup:

{
  "id": "ecd6c860-9cf5-411a-bdba-512f8df7799f",
  "createdDateTime": "2017-01-18T04:13:07.1974591Z",
  "lastModified": "2017-01-17T22:11:52.3527348Z",
  "resources": [
    {
      "name": "virtualNetwork1",
      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}",
      "location": "westcentralus",
      "associations": [
        {
          "name": "{subnetName}",
          "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/(virtualNetworkName)/subnets
/{subnetName}",
          "associationType": "Contains"
        }
      ]
    },
    {
      "name": "webtestnsg-wjplxls65qcto",
      "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups/{nsgName}
s65qcto",
      "associationType": "Associated"
    },
    ...
  ]
}

Passaggi successiviNext steps

Per informazioni su come visualizzare i log dei flussi dei gruppi di sicurezza di rete con Power BI, vedere Visualizzare i log dei flussi dei gruppi di sicurezza di rete con Power BILearn how to visualize your NSG flow logs with Power BI by visiting Visualize NSG flows logs with Power BI