Avvio rapido: Creare una query condivisa di Resource Graph usando il modello di Resource Manager

In questo argomento di avvio rapido si usa un modello di Azure Resource Manager (modello di ARM) per creare una query condivisa di Resource Graph. Le query di Resource Graph possono essere salvate come query private o query condivise. Una query privata viene salvata nel profilo del portale dei singoli utenti e non è visibile ad altri. Una query condivisa è un oggetto di Resource Manager che può essere condiviso con altri utenti tramite le autorizzazioni e l'accesso in base al ruolo. Una query condivisa fornisce un'esecuzione comune e coerente dell'individuazione delle risorse.

Un modello di Azure Resource Manager è un file JSON (JavaScript Object Notation) che definisce l'infrastruttura e la configurazione del progetto. Il modello utilizza la sintassi dichiarativa. Si descrive la distribuzione prevista senza scrivere la sequenza di comandi di programmazione necessari per creare la distribuzione.

Se l'ambiente soddisfa i prerequisiti e si ha familiarità con l'uso dei modelli di Resource Manager, selezionare il pulsante Distribuisci in Azure. Il modello viene visualizzato nel portale di Azure.

Pulsante per distribuire il modello di Resource Manager in Azure.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Rivedere il modello

In questa guida di avvio rapido verrà creata una query condivisa denominata Conta macchine virtuali per sistema operativo. Per provare questa query nell'SDK o nel portale con Resource Graph Explorer, vedere Esempi - Contare le macchine virtuali per tipo di sistema operativo.

Il modello usato in questo avvio rapido proviene dai modelli di avvio rapido di Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.6.1.6515",
      "templateHash": "3085789505121407565"
    }
  },
  "parameters": {
    "queryName": {
      "type": "string",
      "defaultValue": "Count VMs by OS",
      "metadata": {
        "description": "The name of the shared query."
      }
    },
    "queryCode": {
      "type": "string",
      "defaultValue": "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by tostring(properties.storageProfile.osDisk.osType)",
      "metadata": {
        "description": "The Azure Resource Graph query to be saved to the shared query."
      }
    },
    "queryDescription": {
      "type": "string",
      "defaultValue": "This shared query counts all virtual machine resources and summarizes by the OS type.",
      "metadata": {
        "description": "The description of the saved Azure Resource Graph query."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ResourceGraph/queries",
      "apiVersion": "2018-09-01-preview",
      "name": "[parameters('queryName')]",
      "location": "global",
      "properties": {
        "query": "[parameters('queryCode')]",
        "description": "[parameters('queryDescription')]"
      }
    }
  ]
}

La risorsa definita nel modello è Microsoft.ResourceGraph/queries.

Distribuire il modello

  1. Fare clic sull'immagine seguente per accedere al portale di Azure e aprire il modello:

    Pulsante per distribuire il modello di Resource Manager in Azure.

  2. Immetti o seleziona i valori seguenti:

    Nome Valore
    Abbonamento Seleziona la tua sottoscrizione di Azure.
    Gruppo di risorse Selezionare Crea nuovo, specificare un nome e quindi fare clic su OK. In alternativa, selezionare un gruppo di risorse esistente.
    Ufficio Scegliere un'area. Ad esempio, Stati Uniti occidentali.
    Nome query Usare il valore predefinito: Conta macchine virtuali per sistema operativo.
    Codice query Usare il valore predefinito: Resources | where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by tostring(properties.storageProfile.osDisk.osType)
    Descrizione query Usare il valore predefinito: This shared query counts all virtual machine resources and summarizes by the OS type (Questa query condivisa conta tutte le risorse macchina virtuale e le riepiloga in base al tipo di sistema operativo).

  3. Selezionare Rivedi e crea.

  4. Seleziona Crea.

Qualche altra risorsa:

Convalidare la distribuzione

Per eseguire la nuova query condivisa, seguire questa procedura:

  1. Dalla barra di ricerca del portale cercare Query di Resource Graph e selezionare la voce.
  2. Selezionare la query condivisa denominata Conta macchine virtuali per sistema operativo, quindi selezionare la scheda Risultati nella pagina Panoramica.

È anche possibile aprire la query condivisa da Resource Graph Explorer:

  1. Dalla barra di ricerca del portale cercare Resource Graph Explorer e selezionare la voce.
  2. Selezionare Apri una query.
  3. Modificare il valore di Tipo e impostarlo su Query condivise. Se la query Conta macchine virtuali per sistema operativo non è visualizzata nell'elenco, usare la casella filtro per limitare i risultati per Sottoscrizione o Gruppo di risorse. Quando la query condivisa Conta macchine virtuali per sistema operativo è visibile, selezionarne il nome.
  4. Selezionare Esegui query e risultati vengono visualizzati nella scheda Risultati.

In Resource Graph Explorer, sul lato sinistro della pagina, è possibile modificare l'ambito per l’uso di Directory, Gruppo di gestione o Sottoscrizione.

Pulire le risorse

Per rimuovere la query condivisa creata, seguire questa procedura:

  1. Dalla barra di ricerca del portale cercare Query di Resource Graph e selezionare la voce.
  2. Selezionare la casella di controllo accanto alla query condivisa denominata Conta macchine virtuali per sistema operativo.
  3. Selezionare Elimina.
  4. Immettere elimina e selezionare Elimina.
  5. Selezionare Elimina dalla richiesta di conferma.

Passaggi successivi

In questa guida di avvio rapido è stata creata una query condivisa di Resource Graph. Per altre informazioni sul linguaggio di Resource Graph, passare alla pagina dei dettagli del linguaggio di query.

Informazioni sul linguaggio di query di Azure Resource Graph

  • Last updated on