Visualizzare la topologia di Network Watcher con l'interfaccia della riga di comando di AzureView Network Watcher topology with Azure CLI

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.

Questo articolo usa l'interfaccia della riga di comando di Azure 1.0 multipiattaforma, disponibile per Windows, Mac e Linux.This article uses cross-platform Azure CLI 1.0, which is available for Windows, Mac and Linux. Network Watcher usa attualmente l'interfaccia della riga di comando di Azure 1.0 per il supporto dell'interfaccia della riga di comando.Network Watcher currently uses Azure CLI 1.0 for CLI support.

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, il cmdlet network watcher topology viene usato per recuperare le informazioni sulla topologia.In this scenario, you use the network watcher topology cmdlet to retrieve the topology information. È anche disponibile un articolo che illustra come recuperare una topologia di rete con l'API REST.There is also an article on how to retrieve network topology with REST API.

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.

Recuperare una topologiaRetrieve topology

Il cmdlet network watcher topology recupera la topologia per un gruppo di risorse specificato.The network watcher topology cmdlet retrieves the topology for a given resource group. Aggiungere l'argomento "-json" per visualizzare l'output in formato JSON.Add the argument "--json" to view the oput in json format

azure network watcher topology -g resourceGroupName -n networkWatcherName -r topologyResourceGroupName --json

RisultatiResults

I risultati restituiti hanno il nome proprietà "Resources", che contiene il corpo della risposta in formato JSON per il cmdlet network watcher topology.The results returned have a property name "Resources", which contains the json response body for the network watcher topology cmdlet. La risposta contiene le risorse nel gruppo di sicurezza di rete e le relative associazioni (vale a dire, Contains, Associated).The response contains the resources in the Network Security Group and their associations (that is, Contains, Associated).

{
  "id": "00000000-0000-0000-0000-000000000000",
  "createdDateTime": "2017-02-17T22:20:59.461Z",
  "lastModified": "2016-12-19T22:23:02.546Z",
  "resources": [
    {
      "name": "testrg-vnet",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/testrg-vnet",
      "location": "westcentralus",
      "associations": [
        {
          "name": "default",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/testrg-vnet/subnets/default",
          "associationType": "Contains"
        }
      ]
    },
    {
      "name": "default",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/testrg-vnet/subnets/default",
      "location": "westcentralus",
      "associations": []
    },
    {
      "name": "testclient",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Compute/virtualMachines/testclient",
      "location": "westcentralus",
      "associations": [
        {
          "name": "testNic",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Network/networkInterfaces/testNic",
          "associationType": "Contains"
        }
      ]
    },
    ...    
  ]
}

Passaggi successiviNext steps

Per altre informazioni sulle regole di sicurezza applicate alle risorse di rete, leggere la panoramica sulla visualizzazione di gruppo di sicurezza.Learn more about the security rules that are applied to your network resources by visiting Security group view overview