Esercizio - Eseguire query sulle informazioni di sistema e di runtime relative alla macchina virtuale

10 minuti

Ora che è stata creata una macchina virtuale, si possono recuperare informazioni su di essa tramite altri comandi.

Si inizierà con l'esecuzione di vm list.

az vm list

Questo comando restituirà tutte le macchine virtuali definite nella sottoscrizione. È possibile filtrare l'output in base a un gruppo di risorse specifico tramite il parametro --resource-group.

Tipi di output

Si noti che il tipo di risposta predefinito per tutti i comandi finora eseguiti è JSON. È ottimale per gli script, ma per la maggior parte delle persone è più difficile da leggere. È possibile modificare lo stile dell'output per qualsiasi risposta tramite il flag --output. Eseguire, ad esempio, il comando seguente in Azure Cloud Shell per visualizzare uno stile di output diverso.

az vm list --output table

Oltre a table, è possibile specificare json (impostazione predefinita), jsonc (codice JSON colorato) o tsv (valori delimitati da tabulazioni). Provare alcune varianti con il comando precedente per osservare la differenza.

Ottenere l'indirizzo IP

Un altro comando utile è vm list-ip-addresses, che elenca gli indirizzi IP pubblico e privato di una VM. Se vengono modificati o non si sono acquisiti durante la creazione, è possibile recuperarli in qualsiasi momento.

az vm list-ip-addresses -n SampleVM -o table

Restituisce l'output come:

VirtualMachine    PublicIPAddresses    PrivateIPAddresses
----------------  -------------------  --------------------
SampleVM          168.61.54.62         10.0.0.4

Suggerimento

Si noti che per il flag --output si sta usando la sintassi abbreviata -o. La maggior parte dei parametri per i comandi dell'interfaccia della riga di comando di Azure può essere abbreviata in un singolo trattino e una lettera. Per esempio, è possibile abbreviare --name con -n e --resource-group con -g. L'abbreviazione è comoda per immettere i caratteri della tastiera, ma negli script è consigliabile usare il nome completo dell'opzione per maggiore chiarezza. Per informazioni dettagliate su ogni comando, vedere la documentazione.

Ottenere i dettagli della macchina virtuale

È possibile ottenere informazioni più dettagliate su una macchina virtuale specifica in base al nome o all'ID eseguendo il comando vm show.

az vm show --resource-group "<rgn>[sandbox resource group name]</rgn>" --name SampleVM

Questo comando restituisce un blocco JSON piuttosto esteso con tutti i tipi di informazioni sulla VM, tra cui i dispositivi di archiviazione collegati, le interfacce di rete e tutti gli ID oggetto per le risorse a cui la VM è connessa. Anche in questo caso si può passare a un formato di tabella, ma in tale formato vengono omessi quasi tutti i dati interessanti. Si può invece usare un linguaggio di query predefinito per JSON denominato JMESPath.

Aggiungere filtri alle query con JMESPath

JMESPath è un linguaggio di query standard del settore basato su oggetti JSON. La query più semplice consiste nello specificare un identificatore che seleziona una chiave nell'oggetto JSON.

Ad esempio, nel caso dell'oggetto seguente:

{
  "people": [
    {
      "name": "Fred",
      "age": 28
    },
    {
      "name": "Barney",
      "age": 25
    },
    {
      "name": "Wilma",
      "age": 27
    }
  ]
}

È possibile usare la query people per restituire la matrice di valori per la matrice people. Se si vuole restituire una sola persona, si può usare un indicizzatore. people[1], ad esempio, restituirà:

{
    "name": "Barney",
    "age": 25
}

È anche possibile aggiungere qualificatori specifici che restituiscano un subset degli oggetti in base ad alcuni criteri specificati. Ad esempio, l'aggiunta del qualificatore people[?age > '25'] restituirebbe:

[
  {
    "name": "Fred",
    "age": 28
  },
  {
    "name": "Wilma",
    "age": 27
  }
]

È infine possibile limitare i risultati aggiungendo una selezione come people[?age > '25'].[name], che restituisce solo i nomi:

[
  [
    "Fred"
  ],
  [
    "Wilma"
  ]
]

JMESPath offre diverse altre interessanti funzionalità di query. Quando si ha tempo, vedere l'esercitazione online disponibile nel sito JMESPath.org.

Applicare filtri alle query dell'interfaccia della riga di comando di Azure

Con una conoscenza di base delle query JMES, è possibile aggiungere filtri ai dati restituiti da query come il comando vm show. Ad esempio, si può recuperare il nome utente amministratore:

az vm show \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name SampleVM \
    --query "osProfile.adminUsername"

È possibile ottenere la dimensione assegnata alla VM:

az vm show \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name SampleVM \
    --query hardwareProfile.vmSize

Per recuperare tutti gli ID delle interfacce di rete, invece, si può eseguire la query seguente:

az vm show \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name SampleVM \
    --query "networkProfile.networkInterfaces[].id"

Questa tecnica di query funziona con qualsiasi comando dell'interfaccia della riga di comando di Azure e può essere usata per estrarre dati specifici nella riga di comando. È utile anche per la creazione di script. È ad esempio possibile estrarre un valore dall'account Azure e archiviarlo in una variabile di ambiente o di script. Se si decide di usarla in questo modo, è utile aggiungere il parametro --output tsv, abbreviabile in -o tsv. In questo modo, i risultati restituiti includono solo i valori di dati effettivi con tabulazioni come separatori.

Ad esempio:

az vm show \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name SampleVM \
    --query "networkProfile.networkInterfaces[].id" -o tsv