Esercitazione: Creare e condividere una query di Azure Resource Graph nel portale di Azure

Azure Resource Graph Explorer consente di salvare le query di Resource Graph direttamente nel portale di Azure. Esistono due tipi di query: Private e Shared. Una query privata viene salvata nelle impostazioni del portale di Azure. Mentre una query condivisa è una risorsa di Azure Resource Manager che può essere gestita con il controllo degli accessi in base al ruolo di Azure e protetta con i blocchi delle risorse. Entrambi i tipi di query vengono crittografati quando sono a riposo.

Salvando le query nel portale di Azure, è possibile risparmiare tempo per cercare le query preferite o comunemente usate. Quando si condividono le query, è possibile aiutare il team a realizzare obiettivi di coerenza ed efficienza attraverso la ripetizione.

In questa esercitazione verranno completate le attività seguenti:

• Creare ed eliminare una query privata
• Creare una query condivisa
• Individuare query condivise
• Eliminare una query condivisa

Prerequisiti

Per completare questa esercitazione, è necessaria una sottoscrizione di Azure. Se non ne hai uno, crea un account gratuito prima di iniziare.

Creare ed eliminare una query privata

Le query private sono accessibili e visibili solo all'account che li crea. Quando vengono salvati nelle impostazioni del portale di Azure di un account, possono essere creati, usati ed eliminati solo dall'interno del portale di Azure. Una query privata non è una risorsa del Gestore delle risorse. Per creare una nuova query privata, seguire questa procedura:

1. Dal menu del portale selezionare Tutti i servizi o usare la casella di ricerca di Azure nella parte superiore di tutte le pagine. Cercare e quindi selezionare Resource Graph Explorer.

2. Nella scheda Query 1 della pagina Azure Resource Graph Explorer immettere la query seguente:

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Selezionare Esegui query per visualizzare i risultati della query nel riquadro inferiore.

   Per altre informazioni su questa query, vedere Esempi - Conteggio di macchine virtuali per tipo di sistema operativo.

3. Selezionare Salva o Salva con nome, immettere Conteggiare le VM per sistema operativo come nome, lasciare il tipo come query privata e quindi selezionare Salva nella parte inferiore del riquadro Salva query. Il titolo della scheda passa da Query 1 a Cnt VM per OS.

4. Allontanarsi da Azure Resource Graph Explorer nel portale di Azure e quindi tornare a esso. Si noti che la query salvata non viene più visualizzata e che la scheda Query 1 è stata restituita.

5. Selezionare Apri una query. Assicurarsi che il tipo sia Query privata. Il nome salvato Numero di macchine virtuali per tipo di sistema operativo ora viene visualizzato nell'elenco Nome query. Quando si seleziona il collegamento del titolo della query salvata, viene aperta una nuova scheda in cui la query viene caricata con il suo nome.

   Annotazioni

   Quando una query salvata è aperta e la scheda ne mostra il nome, selezionando il pulsante Salva viene aggiornato con le modifiche apportate. Per creare una nuova query salvata da questa query aperta, selezionare Salva con nome e procedere come se si salvasse una nuova query.

6. Per eliminare la query salvata, selezionare di nuovo Apri una query e verificare che il campo Tipo sia impostato su Query privata. Nella riga della query salvata Count VMs by OS selezionare Elimina (icona Cestino). Nella finestra di dialogo di conferma selezionare Sì per completare l'eliminazione della query. Chiudere quindi il riquadro Apri una query .

Creare una query condivisa

A differenza di una query privata, una query condivisa è una risorsa di Resource Manager. Questo significa che la query viene salvata in un gruppo di risorse, può essere gestita e controllata con Azure RBAC e può anche essere protetta con blocchi delle risorse. Come risorsa, chiunque disponga delle autorizzazioni appropriate può visualizzarlo e usarlo. Per creare una nuova query condivisa, seguire questa procedura:

1. Dal menu del portale selezionare Tutti i servizi oppure usare la casella di ricerca di Azure nella parte superiore di tutte le pagine per cercare e selezionare Resource Graph Explorer.

2. Nella scheda Query 1 della pagina Azure Resource Graph Explorer immettere la query seguente:

   Resources
   | where type =~ 'Microsoft.Compute/virtualMachines'
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

   Selezionare Esegui query per visualizzare i risultati della query nel riquadro inferiore.

   Per altre informazioni su questa query, vedere Esempi - Conteggio di macchine virtuali per tipo di sistema operativo.

3. Selezionare Salva o Salva con nome.

   

4. Nel riquadro Salva query, immettere Count VMs by OS come nome.

5. Modificare il tipo in Query condivisa, impostare la descrizione su Conteggio delle macchine virtuali per tipo di sistema operativo e impostare Sottoscrizione per specificare dove viene creata la risorsa di query.

6. Lasciare selezionata la casella di controllo Pubblica nel gruppo di risorse resource-graph-queries e la località del gruppo di risorse impostata su (USA) West Central US.

7. Selezionare Salva nella parte inferiore del riquadro Salva query . Il titolo della scheda passa da Query 1 a Cnt VM per OS. La prima volta che viene usato il gruppo di risorse resource-graph-queries , il salvataggio richiede più tempo del previsto quando viene creato il gruppo di risorse.

   

   Annotazioni

   È possibile deselezionare la casella di controllo Pubblica nel gruppo di risorse resource-graph-queries se si vuole specificare il nome di un gruppo di risorse esistente in cui salvare la query condivisa. L'uso del gruppo di risorse denominato predefinito per le query semplifica l'individuazione delle query condivise. Rende anche più evidente lo scopo del gruppo di risorse. Tuttavia, è possibile scegliere di selezionare un gruppo di risorse esistente per motivi di sicurezza in base alle autorizzazioni esistenti.

8. Allontanarsi da Azure Resource Graph Explorer nel portale di Azure e quindi tornare a esso. Si noti che la query salvata non viene più visualizzata e che la scheda Query 1 è stata restituita.

9. Selezionare Apri una query. Verificare che il tipo sia impostato su Query condivisa e che la combinazione di sottoscrizione e gruppo di risorse corrisponda al percorso in cui è stata salvata la query. L'elemento Count VMs by OS salvato viene ora visualizzato nell'elenco Nome query . Selezionare il collegamento del titolo della query salvata per caricarlo in una nuova scheda con il nome della query. Come query condivisa, nella scheda accanto al titolo viene visualizzata un'icona che la indica come condivisa.

   

   Annotazioni

   Quando una query salvata è aperta e la scheda ne mostra il nome, il pulsante Salva lo aggiorna con tutte le modifiche apportate. Per creare una nuova query salvata, selezionare Salva con nome e procedere come se si salvasse una nuova query.

Individuare query condivise

Poiché una query condivisa è una risorsa di Resource Manager, è possibile trovarne una in diversi modi:

• Da Resource Graph Explorer. Selezionare Apri una query e impostare il tipo su Query condivisa.
• Dalla pagina del portale delle query di Resource Graph.
• Dal gruppo di risorse in cui è stata salvata la query condivisa.
• Tramite una query in Resource Graph.

Visualizzare le query di Resource Graph

Nella pagina Query di Resource Graph del portale di Azure vengono visualizzate query condivise a cui l'account connesso ha accesso. Questa pagina consente di filtrare in base al nome, alla sottoscrizione, al gruppo di risorse e ad altre proprietà della query di Resource Graph. È anche possibile contrassegnare, esportare ed eliminare query di Resource Graph usando questa interfaccia.

Se si seleziona una delle query, viene aperta la pagina query di Resource Graph. Analogamente ad altre risorse di Resource Manager, questa pagina offre una panoramica interattiva insieme al log attività, al controllo di accesso e ai tag. È anche possibile applicare un blocco delle risorse direttamente da questa pagina.

Passare alla pagina Query di Resource Graph dal menu del portale selezionando Tutti i servizi o usando la casella di ricerca di Azure nella parte superiore di tutte le pagine. Cercare e selezionare Resource Graph Explorer.

Elencare le risorse dei gruppi di risorse

La query di Resource Graph è elencata insieme ad altre risorse che fanno parte di un gruppo di risorse. Quando si seleziona la query di Resource Graph si apre la pagina della query stessa. I puntini di sospensione e le opzioni del menu a comparsa, attivati selezionandoli e tenendoli premuti (o facendo clic con il pulsante destro del mouse), funzionano allo stesso modo della pagina della query di Resource Graph.

Eseguire una query in Resource Graph

È possibile trovare query di Resource Graph eseguendo una query su Resource Graph. La query seguente di Resource Graph limita per tipo Microsoft.ResourceGraph/queries, e quindi usa project per elencare solo il nome, l'ultima modifica e la query stessa:

Resources
| where type == "microsoft.resourcegraph/queries"
| project name, properties.timeModified, properties.query

Eseguire una query condivisa

È possibile eseguire una query condivisa di Resource Graph con la {{shared-query-uri}} sintassi (anteprima). Per altre informazioni, vedere Sintassi di query condivise.

Eliminare una query condivisa

Se una query condivisa non è più necessaria, eliminarla. Eliminando una query condivisa, si rimuove la risorsa di Resource Manager corrispondente. Qualsiasi dashboard a cui è stato aggiunto il grafico dei risultati ora visualizza un messaggio di errore. Quando viene visualizzato il messaggio di errore, usare il pulsante Rimuovi dal dashboard per pulire il dashboard.

È possibile eliminare una query condivisa tramite le interfacce seguenti:

• Pagina delle query di Resource Graph
• Pagina di query di Resource Graph
• Pagina Apri una query in Resource Graph Explorer
• Pagina Gruppi di risorse

Pulire le risorse

Al termine di questa esercitazione, eliminare le query private e condivise create se non sono più desiderate.

Passaggi successivi

In questo tutorial, hai creato query private e condivise. Per altre informazioni sul linguaggio Resource Graph, passare alla pagina dei dettagli del linguaggio di query.

Ottenere altre informazioni sul linguaggio di query