Esecuzione di query sugli asset

Questo argomento mostra come eseguire query sui metadati degli asset per il progetto, la cartella o l'organizzazione senza dover prima esportare i dati in una tabella BigQuery.

Limitazioni

La query fornita nella richiesta deve essere una query SELECT.
I risultati delle query di dimensioni superiori a 10 GB non sono supportati.
I risultati delle query di dimensioni superiori a 10 MB o con 1000 righe vengono sempre impaginati.
L'elaborazione delle query non deve richiedere più di sei ore.
L'SQL precedente di BigQuery non è supportato.
I risultati della query possono essere salvati solo in un set di dati BigQuery nella località US con più regioni.
Per le risorse di Google Kubernetes Engine elencate nella pagina dei tipi di asset supportati, sono supportati solo container.googleapis.com/Cluster e container.googleapis.com/NodePool.
Per i nuovi abbonamenti al livello Premium di Security Command Center, possono essere necessarie fino a 6 ore per ottenere l'accesso all'API e fino a 48 ore prima che i dati storici siano pronti.

Prima di iniziare

Prima di iniziare, completa i seguenti passaggi.

Abilita l'API Cloud Asset Inventory nel progetto in cui eseguirai i comandi API.

Abilitare l'API Cloud Asset Inventory
Configura le autorizzazioni necessarie per chiamare l'API Cloud Asset Inventory utilizzando gcloud CLI o l'API.
Completa i seguenti passaggi per configurare il tuo ambiente.
Interfaccia a riga di comando gcloud
Per configurare il tuo ambiente in modo da utilizzare gcloud CLI per chiamare l'API Cloud Asset Inventory, installa Google Cloud CLI sul tuo client locale.
REST
Per configurare il tuo ambiente in modo da chiamare l'API Cloud Asset Inventory con il comando curl, completa i passaggi seguenti.
1. Verifica di avere accesso al comando curl.
2. Assicurati di concedere al tuo account uno dei seguenti ruoli nel progetto, nella cartella o nell'organizzazione.
  - Ruolo Visualizzatore asset cloud (roles/cloudasset.viewer)
  - Ruolo di base del proprietario (roles/owner)
Se stai esportando i metadati da un progetto a un altro, assicurati che l'account di servizio Cloud Asset Inventory predefinito esista e abbia le autorizzazioni corrette del progetto di esportazione.

Autorizzazioni

Il seguente elenco mostra le autorizzazioni necessarie per ogni ContentType in una richiesta.

Tipo di contenuti		Autorizzazione
Nome gcloud	Nome REST
`access-policy`	`ACCESS_POLICY`	`cloudasset.assets.queryAccessPolicy`
`iam-policy`	`IAM_POLICY`	`cloudasset.assets.queryIamPolicy`
`os-inventory`	`OS_INVENTORY`	`cloudasset.assets.queryOSInventories`
`relationship`	`RELATIONSHIP`	`cloudasset.assets.queryResource`
`resource`	`RESOURCE`	`cloudasset.assets.queryResource`

Il ruolo concesso quando configuri le autorizzazioni (cloudasset.viewer o cloudasset.owner) contiene queste autorizzazioni.

Formattare una query

L'API Query Assets richiede che le query utilizzino un dialetto compatibile con SQL Standard di BigQuery.

Quando esegui una query per un asset, il nome deve seguire un formato specifico. Ad esempio, una query per la ricerca di VM eseguirà una query per compute_googleapis_com_Instance. Scopri di più sui tipi di asset supportati.

I nomi utilizzati in una query vengono trasformati: / e . vengono sostituiti con _ (ad esempio, compute.googleapis.com/Instance diventa compute_googleapis_com_Instance).

I nomi delle tabelle nel set di dati corrispondono al nome del tipo di asset. Per i contenuti il cui content_type non è RESOURCE, il nome della tabella è il tipo di contenuto in lettere maiuscole (ad esempio, IAM_POLICY, OS_INVENTORY, ACCESS_POLICY).

Per eseguire query sui metadati standard delle risorse in tutti i tipi di risorsa, il nome della tabella è STANDARD_METADATA. I metadati delle risorse supportate includono tutti i campi tranne resource.DATA, che è specifico di un tipo di risorsa.

Puoi fare riferimento agli schemi utilizzati da vari asset nella pagina Inventario asset nella console Google Cloud.

Formato della risposta del valore del campo

In una risposta, i campi schema e rows sono simili a quelli in BigQuery. I metadati dei campi vengono relegati in uno struct separato denominato schema. Questo formato consente di comprimere una risposta potenzialmente molto grande evitando la duplicazione di nomi di campo e tipi. Per lo stesso motivo vengono utilizzati i valori f e v al posto di fields e value.

Questo esempio mostra la risposta a una query per tutti gli asset di un determinato tipo con page-size di 2:

{
  "jobReference": "CiBqb2JfTHhIQ2xCeXlJejc1bHdQSTRNZ3NEVndXU2o5QxIBARjLq-_g5fO5t1I",
  "done": true,
  "queryResult": {
    "rows": [
      {
        "f": [
          {
            "v": "//compute.googleapis.com/projects/PROJECT1/zones/us-central1-a/instances/INSTANCE1"
          },
          {
            "v": "compute.googleapis.com/Instance"
          }
        ]
      },
      {
        "f": [
          {
            "v": "//compute.googleapis.com/projects/PROJECT2/zones/us-central1-a/instances/INSTANCE2"
          },
          {
            "v": "compute.googleapis.com/Instance"
          }
        ]
      }
    ],
    "schema": {
      "fields": [
        {
          "field": "name",
          "type": "STRING",
          "mode": "NULLABLE",
          "fields": []
        },
        {
          "field": "assetType",
          "type": "STRING",
          "mode": "NULLABLE",
          "fields": []
        }
      ]
    },
    "nextPageToken": "BHKVJIOAPUAQAAASA4EAAEEAQCAAKGQIBABBB7X7777QOIFQVYKQ====",
    "totalRows": "11"
  }
}

Query nella console Google Cloud

Console

Per eseguire una query sui metadati degli asset per il progetto, la cartella o l'organizzazione, completa i seguenti passaggi:

Vai alla pagina Inventario asset nella console Google Cloud.

Vai ad Asset Inventory
Per impostare l'ambito della ricerca, seleziona un progetto, una cartella o un'organizzazione.
Fai clic sulla scheda Query sugli asset.
Per eseguire una query sui metadati degli asset, utilizza una query di esempio o creane una personalizzata:
- Per utilizzare un esempio, fai clic su una voce della scheda Libreria di query per visualizzare l'anteprima della query. Fai clic su Applica per copiare l'esempio nella casella Modifica query, quindi modifica la query o fai clic su Esegui per eseguirla.
- Per creare una query, inserisci il testo della query direttamente nella casella Modifica query, poi fai clic su Esegui per eseguirla. Per facilitare la scrittura di una query personalizzata, puoi fare clic su una tabella nel riquadro Seleziona tabella per visualizzarne l'anteprima dello schema e dei contenuti. Scopri di più sulla sintassi delle query.
I metadati della risorsa corrispondenti alla query vengono mostrati nella scheda Risultato della query.
(Facoltativo) Per scaricare i set di risultati della query in formato CSV, fai clic su Esporta.

La dimensione massima del file CSV è 2 MB. Se la richiesta di download non va a buon fine perché le dimensioni del file superano questo limite, viene visualizzato un messaggio con le istruzioni per esportare i risultati completi.

Salva i risultati della query

I risultati delle query vengono restituiti come risposte dell'API Query Assets. Per esportare i risultati nella tua tabella BigQuery, specifica una destinazione BigQuery nella richiesta. Se non ne hai già uno, devi creare un set di dati BigQuery prima di effettuare queste richieste.

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --billing-project=BILLING_PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --write-disposition="write-truncate"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.
BILLING_PROJECT_ID: facoltativo. L'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per scrivere in BigQuery. Questa operazione non è necessaria se hai già effettuato il passaggio al progetto di fatturazione con gcloud config set project. Scopri di più sui progetti di fatturazione.
DATASET_ID: l'ID del set di dati BigQuery.
TABLE_NAME: la tabella in cui stai esportando i metadati. Se non esiste, viene creato.

Altri flag:

--write-disposition: specifica l'azione che si verifica se la tabella o la partizione di destinazione BigQuery esiste già impostando l'opzione per la scrittura. Sono supportati i seguenti valori:
- write-truncate: se la tabella o la partizione esiste già, BigQuery sovrascrive i dati dell'intera tabella o di tutte le partizioni.
- write-append: se la tabella o la partizione esiste già, BigQuery aggiunge i dati alla tabella o alla partizione più recente.
- write-empty: se la tabella esiste già e contiene dati, viene restituito un errore duplicate nel risultato del job.
Il valore predefinito è write-empty.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --billing-project=BILLING_PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --write-disposition="write-truncate"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID
BILLING_PROJECT_ID: facoltativo. L'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per scrivere in BigQuery. Questa operazione non è necessaria se hai già effettuato il passaggio al progetto di fatturazione con gcloud config set project. Scopri di più sui progetti di fatturazione.
PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery.
DATASET_ID: l'ID del set di dati BigQuery.
TABLE_NAME: la tabella in cui stai esportando i metadati. Se non esiste, viene creato.

Altri flag:

--write-disposition: specifica l'azione che si verifica se la tabella o la partizione di destinazione BigQuery esiste già impostando l'opzione per la scrittura. Sono supportati i seguenti valori:
- write-truncate: se la tabella o la partizione esiste già, BigQuery sovrascrive l'intera tabella o tutti i dati delle partizioni.
- write-append: se la tabella o la partizione esiste già, BigQuery aggiunge i dati alla tabella o alla partizione più recente.
- write-empty: se la tabella esiste già e contiene dati, viene restituito un errore duplicate nel risultato del job.
Il valore predefinito è write-empty.

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2" \
    --bigquery-table=projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_NAME \
    --write-disposition="write-truncate"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
BILLING_PROJECT_ID: facoltativo. L'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per scrivere in BigQuery. Questa operazione non è necessaria se hai già effettuato il passaggio al progetto di fatturazione con gcloud config set project. Scopri di più sui progetti di fatturazione.
PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery.
DATASET_ID: l'ID del set di dati BigQuery.
TABLE_NAME: la tabella in cui stai esportando i metadati. Se non esiste, viene creato.

Altri flag:

--write-disposition: specifica l'azione che si verifica se la tabella o la partizione di destinazione BigQuery esiste già impostando l'opzione per la scrittura. Sono supportati i seguenti valori:
- write-truncate: se la tabella o la partizione esiste già, BigQuery sovrascrive l'intera tabella o tutti i dati delle partizioni.
- write-append: se la tabella o la partizione esiste già, BigQuery aggiunge i dati alla tabella o alla partizione più recente.
- write-empty: se la tabella esiste già e contiene dati, viene restituito un errore duplicate nel risultato del job.
Il valore predefinito è write-empty.

Di seguito è riportato un esempio di risposta per una richiesta riuscita che salva i risultati della query in una tabella di destinazione BigQuery specificata:

done: true
jobReference: CiBqb2JfMkpzOERxN2l5RnRKeWJQRksxWUlmYkxWNTUzbhIBARixoYOcs9T_qcgB
outputConfig:
  bigqueryDestination:
    dataset: projects/test-project/datasets/my_dataset
    table: my-table
    writeDisposition: write-truncate

Di seguito è riportato un esempio di risposta per un job che non è riuscito a salvare i risultati della query:

done: true
error:
  code: 9
  message: '1 errors encountered during query: notFound'
jobReference: CiBqb2JfZWlmOUNsVFQ3b05hVzhpYkdVZ291dkZXc1VFXxIBARj73sbsmLmE1BggAQ

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name, assetType
            FROM
              compute_googleapis_com_Instance
            LIMIT 2",
          "outputConfig": {
            "bigqueryDestination": {
              "dataset": "projects/PROJECT_ID/datasets/DATASET_ID",
              "table": "TABLE_NAME",
              "writeDisposition": "WRITE_TRUNCATE"
            }
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

BILLING_PROJECT_ID: l'ID progetto in cui si trova l'agente di servizio Cloud Asset Inventory predefinito che dispone delle autorizzazioni per gestire i set di dati e le tabelle BigQuery. Scopri di più sui progetti di fatturazione.
PROJECT_ID: l'ID del progetto in cui si trova la tabella BigQuery.
DATASET_ID: l'ID del set di dati BigQuery.
TABLE_NAME: la tabella in cui stai esportando i metadati. Se non esiste, viene creato.
SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Altri parametri:

writeDisposition: specifica l'azione che si verifica se la tabella o la partizione di destinazione BigQuery esiste già impostando l'opzione per la scrittura. Sono supportati i seguenti valori:
- WRITE_TRUNCATE: se la tabella o la partizione esiste già, BigQuery sovrascrive l'intera tabella o tutti i dati delle partizioni.
- WRITE_APPEND: se la tabella o la partizione esiste già, BigQuery aggiunge i dati alla tabella o all'ultima partizione.
- WRITE_EMPTY: se la tabella esiste già e contiene dati, viene restituito un errore duplicate nel risultato del job.
Il valore predefinito è WRITE_EMPTY.

Di seguito è riportato un esempio di risposta per una richiesta riuscita che salva i risultati della query in una tabella di destinazione BigQuery specificata:

{
  "jobReference": "CiBqb2JfZmNlbTZ5SjVZcHFKajVIYjMycFNSd2xSRlZXdBIBARiAnb6R1I63wdkB",
  "done": true,
  "outputConfig": {
    "bigqueryDestination": {
      "dataset": "projects/test-project/datasets/my_dataset",
      "table": "my-table",
      "writeDisposition": "WRITE_TRUNCATE"
    }
  }
}

Di seguito è riportato un esempio di risposta per un job che non è riuscito a salvare i risultati della query:

{
  "jobReference": "CiBqb2JfZWlmOUNsVFQ3b05hVzhpYkdVZ291dkZXc1VFXxIBARj73sbsmLmE1BggAQ",
  "done": true,
  "error": {
    "code": 9,
    "message": "1 errors encountered during query: notFound"
  }
}

Lo schema e le righe non vengono restituiti direttamente nella risposta alla query. Puoi visualizzarli nella tabella di destinazione BigQuery specificata.

Query di esempio

Asset di query

I seguenti esempi eseguono query sugli asset in un progetto, una cartella o un'organizzazione.

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name, assetType
      FROM
        compute_googleapis_com_Instance
      LIMIT 2"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Di seguito è riportato un esempio di risposta per una richiesta andata a buon fine che restituisce tutte le righe:

done: true
jobReference: CiBqb2JfMkpzOERxN2l5RnRKeWJQRksxWUlmYkxWNTUzbhIBARixoYOcs9T_qcgB
queryResult:
  nextPageToken: ''
  totalRows: '2'

name: //compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME
assetType: compute.googleapis.com/Instance

name: //compute.googleapis.com/projects/PROJECT_ID/zones/ZONE/instances/VM_INSTANCE_NAME
assetType; compute.googleapis.com/Instance

REST

curl -X POST \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
      "statement": "
        SELECT
          name, assetType
        FROM
          compute_googleapis_com_Instance
        LIMIT 2" }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Di seguito è riportato un esempio di risposta per una richiesta andata a buon fine che restituisce tutte le righe:

{
  "jobReference": "CiBqb2JfZmNlbTZ5SjVZcHFKajVIYjMycFNSd2xSRlZXdBIBARiAnb6R1I63wdkB",
  "done": true,
  "queryResult": {
    "rows": [...],
    "schema": {...},
    "nextPageToken": "",
    "totalRows": "2"
  }
}

Lo schema e le righe sono stati rimossi per una migliore leggibilità. Puoi visualizzarli nel formato Risposta del valore del campo.

Esegui query sui metadati standard delle risorse su più tipi di risorse

L'esempio seguente esegue una query sul campo di metadati standard della risorsa name e assetType per tutti i tipi di risorse in una regione specifica.

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name,
        assetType
      FROM
        STANDARD_METADATA
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name,
        assetType
      FROM
        STANDARD_METADATA
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name,
        assetType
      FROM
        STANDARD_METADATA
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              assetType
            FROM
              STANDARD_METADATA
            WHERE
              resource.location LIKE \"%asia%\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Recupero di una risposta in modo asincrono tramite riferimento al job

Esegui il comando seguente che scade.

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --timeout="1s" \
    --statement="
    SELECT
      name, assetType
    FROM
      compute_googleapis_com_Instance";

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Quando una richiesta non viene completata in tempo, il campo done è impostato su false, il che significa che la richiesta non è stata completata in tempo, ma è in fase di elaborazione. Il seguente esempio mostra una risposta che indica che l'elaborazione della richiesta non è completata.

done: false
job_reference: "JOB_REFERENCE_ID"

Puoi utilizzare questo ID di riferimento del job per ottenere il risultato in modo asincrono successivamente con un'altra chiamata API:

gcloud asset query \
    --project=PROJECT_ID \
    --job-reference=JOB_REFERENCE_ID

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --timeout="1s" \
    --statement="
    SELECT
      name, assetType
    FROM
      compute_googleapis_com_Instance";

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

done: false
job_reference: "JOB_REFERENCE_ID"

Puoi utilizzare questo ID di riferimento del job per ottenere il risultato in modo asincrono successivamente con un'altra chiamata API:

gcloud asset query \
    --folder=FOLDER_ID \
    --job-reference=JOB_REFERENCE_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --timeout="1s" \
    --statement="
    SELECT
      name, assetType
    FROM
      compute_googleapis_com_Instance";

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

done: false
job_reference: "JOB_REFERENCE_ID"

Puoi utilizzare questo ID di riferimento del job per ottenere il risultato in modo asincrono successivamente con un'altra chiamata API:

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --job-reference=JOB_REFERENCE_ID

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "timeout": "1s",
          "statement": "
            SELECT
              name, assetType
            FROM
              compute_googleapis_com_Instance"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Quando una richiesta non viene completata in tempo, il campo done viene impostato su false, il che significa che la richiesta non è stata completata in tempo, ma è in fase di elaborazione. Il seguente esempio mostra una risposta che indica che l'elaborazione della richiesta non è completata.

{
  "jobReference": "JOB_REFERENCE_ID",
  "done": false,
  "queryResult": {
    "rows": [],
    "schema": {
      "fields": []
    },
    "nextPageToken": "",
    "totalRows": "0"
  }
}

Puoi utilizzare questo ID di riferimento del job per ottenere il risultato in modo asincrono in un secondo momento con un'altra chiamata API:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "jobReference": "JOB_REFERENCE_ID"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Recupero della pagina successiva dei risultati per le richieste impaginate con l'API REST

Esegui la query seguente, che imposta un valore pageSize di 1:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "pageSize": "1",
          "statement": "
            SELECT
              name, assetType
            FROM
              compute_googleapis_com_Instance"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Altri parametri:

pageSize: il numero massimo di risorse da mostrare per pagina.

La risposta ha un nextPageToken che può essere impostato in una richiesta con jobReference per ottenere la pagina successiva di risposte.

{
  "jobReference": "JOB_REFERENCE_ID",
  "done": true,
  "queryResult": {
    "rows": [ ... ],
    "schema": { ... },
    "nextPageToken": "NEXT_PAGE_TOKEN",
    "totalRows": "11"
  }
}

Lo schema e le righe sono stati rimossi per una migliore leggibilità. Puoi visualizzarli nel formato Risposta del valore del campo.

Puoi visualizzare la pagina di risultati successiva facendo riferimento al token della pagina:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "jobReference": "JOB_REFERENCE_ID",
          "pageToken": "NEXT_PAGE_TOKEN"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Esegui una query su quante VM ci sono in ogni regione

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        resource.location,
        COUNT(*)
      FROM
        compute_googleapis_com_Instance
      GROUP BY
        resource.location"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        resource.location,
        COUNT(*)
      FROM
        compute_googleapis_com_Instance
      GROUP BY
        resource.location"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        resource.location,
        COUNT(*)
      FROM
        compute_googleapis_com_Instance
      GROUP BY
        resource.location"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              resource.location,
              COUNT(*)
            FROM
              compute_googleapis_com_Instance
            GROUP BY
              resource.location"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Esecuzione di query per identificare le VM in una regione specifica

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              resource.DATA.creationTimestamp
            FROM
              compute_googleapis_com_Instance
            WHERE
              resource.location LIKE \"%asia%\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Query per identificare ogni bucket Cloud Storage accessibile pubblicamente

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        name
      FROM
        IAM_POLICY
      CROSS JOIN
        UNNEST(iamPolicy.bindings) AS binding
      WHERE
        ('allUsers' IN UNNEST(binding.members)
        OR 'allAuthenticatedUsers' IN UNNEST(binding.members))
        AND assetType = 'storage.googleapis.com/Bucket'"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        name
      FROM
        IAM_POLICY
      CROSS JOIN
        UNNEST(iamPolicy.bindings) AS binding
      WHERE
        ('allUsers' IN UNNEST(binding.members)
        OR 'allAuthenticatedUsers' IN UNNEST(binding.members))
        AND assetType = 'storage.googleapis.com/Bucket'"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        name
      FROM
        IAM_POLICY
      CROSS JOIN
        UNNEST(iamPolicy.bindings) AS binding
      WHERE
        ('allUsers' IN UNNEST(binding.members)
        OR 'allAuthenticatedUsers' IN UNNEST(binding.members))
        AND assetType = 'storage.googleapis.com/Bucket'"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name
            FROM
              IAM_POLICY
            CROSS JOIN
              UNNEST(iamPolicy.bindings) AS binding
            WHERE
              (\"allUsers\" IN UNNEST(binding.members)
              OR \"allAuthenticatedUsers\" IN UNNEST(binding.members))
              AND assetType = \"storage.googleapis.com/Bucket\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Query per trovare le subnet senza VM collegate

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        subnetwork_table.name
      FROM
        compute_googleapis_com_Subnetwork AS subnetwork_table
      LEFT JOIN (
        SELECT
          interface.subnetwork AS subnetwork
        FROM
          compute_googleapis_com_Instance
        CROSS JOIN
          UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
      ON
        SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
      WHERE
        instance_table.subnetwork IS NULL
        AND NOT subnetwork_table.name LIKE '%default%'"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        subnetwork_table.name
      FROM
        compute_googleapis_com_Subnetwork AS subnetwork_table
      LEFT JOIN (
        SELECT
          interface.subnetwork AS subnetwork
        FROM
          compute_googleapis_com_Instance
        CROSS JOIN
          UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
      ON
        SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
      WHERE
        instance_table.subnetwork IS NULL
        AND NOT subnetwork_table.name LIKE '%default%'"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        subnetwork_table.name
      FROM
        compute_googleapis_com_Subnetwork AS subnetwork_table
      LEFT JOIN (
        SELECT
          interface.subnetwork AS subnetwork
        FROM
          compute_googleapis_com_Instance
        CROSS JOIN
          UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
      ON
        SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
      WHERE
        instance_table.subnetwork IS NULL
        AND NOT subnetwork_table.name LIKE '%default%'"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              subnetwork_table.name
            FROM
              compute_googleapis_com_Subnetwork AS subnetwork_table
            LEFT JOIN (
              SELECT
                interface.subnetwork AS subnetwork
              FROM
                compute_googleapis_com_Instance
              CROSS JOIN
                UNNEST(resource.DATA.networkInterfaces) AS interface) AS instance_table
            ON
              SUBSTR(subnetwork_table.name, 25) = SUBSTR(instance_table.subnetwork,38)
            WHERE
              instance_table.subnetwork IS NULL
              AND NOT subnetwork_table.name LIKE \"%default%\""
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Query per trovare il numero di set di dati BigQuery in ogni progetto

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --statement="
      SELECT
        ancestor AS project,
        COUNT(*)
      FROM
        bigquery_googleapis_com_Dataset
      CROSS JOIN
        UNNEST (ancestors) AS ancestor
      WHERE
        ancestor LIKE '%project%'
      GROUP BY
        ancestor
      ORDER BY
        2 DESC"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --statement="
      SELECT
        ancestor AS project,
        COUNT(*)
      FROM
        bigquery_googleapis_com_Dataset
      CROSS JOIN
        UNNEST (ancestors) AS ancestor
      WHERE
        ancestor LIKE '%project%'
      GROUP BY
        ancestor
      ORDER BY
        2 DESC"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --statement="
      SELECT
        ancestor AS project,
        COUNT(*)
      FROM
        bigquery_googleapis_com_Dataset
      CROSS JOIN
        UNNEST (ancestors) AS ancestor
      WHERE
        ancestor LIKE '%project%'
      GROUP BY
        ancestor
      ORDER BY
        2 DESC"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              ancestor AS project,
              COUNT(*)
            FROM
              bigquery_googleapis_com_Dataset
            CROSS JOIN
              UNNEST (ancestors) AS ancestor
            WHERE
              ancestor LIKE \"%project%\"
            GROUP BY
              ancestor
            ORDER BY
              2 DESC"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Query per identificare le VM in una regione specifica in un timestamp specifico

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --snapshot-time="SNAPSHOT_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui eseguire la query sui metadati.
SNAPSHOT_TIME: facoltativo. Il momento in cui vuoi acquisire un'istantanea degli asset. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non fornito, uno snapshot viene acquisito all'ora attuale. Per informazioni sui formati temporali, consulta gcloud topic datetimes.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --snapshot-time="SNAPSHOT_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui eseguire la query sui metadati.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID
SNAPSHOT_TIME: facoltativo. Il momento in cui vuoi acquisire un'istantanea degli asset. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non fornito, uno snapshot viene acquisito all'ora attuale. Per informazioni sui formati temporali, consulta gcloud topic datetimes.

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --snapshot-time="SNAPSHOT_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance
      WHERE
        resource.location LIKE '%asia%'"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi eseguire una query sui metadati.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
SNAPSHOT_TIME: facoltativo. Il momento in cui vuoi acquisire un'istantanea degli asset. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non fornito, uno snapshot viene acquisito all'ora attuale. Per informazioni sui formati temporali, consulta gcloud topic datetimes.

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              resource.DATA.creationTimestamp
            FROM
              compute_googleapis_com_Instance
            WHERE
              resource.location LIKE \"%asia%\"",
          "readTime": "SNAPSHOT_TIME"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

SNAPSHOT_TIME: facoltativo. L'ora in cui vuoi acquisire uno snapshot degli asset, in formato RFC 3339. Il valore deve essere l'ora corrente o un'ora non superiore a 35 giorni nel passato. Se non specificato, l'istantanea viene acquisita all'ora attuale.
SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Query per identificare la cronologia delle modifiche delle VM in un intervallo di tempo specifico

gcloud

Progetti

gcloud asset query \
    --project=PROJECT_ID \
    --start-time="START_TIME" \
    --end-time="END_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance"

Specifica i seguenti valori:

PROJECT_ID: l'ID del progetto di cui vuoi elencare gli asset.
START_TIME: facoltativo. L'inizio dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.
END_TIME: facoltativo. Il punto finale dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non viene fornita, si presume che l'ora di fine sia l'ora attuale. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.

Cartelle

gcloud asset query \
    --folder=FOLDER_ID \
    --start-time="START_TIME" \
    --end-time="END_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance"

Specifica i seguenti valori:

FOLDER_ID: l'ID della cartella di cui vuoi elencare gli asset.
Come trovare l'ID di una cartella Google Cloud
Console

Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
Interfaccia a riga di comando gcloud

Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.

Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:

gcloud resource-manager folders list --folder=FOLDER_ID
START_TIME: facoltativo. L'inizio dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.
END_TIME: facoltativo. Il punto finale dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non viene fornita, si presume che l'ora di fine sia l'ora attuale. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.

Organizzazioni

gcloud asset query \
    --organization=ORGANIZATION_ID \
    --start-time="START_TIME" \
    --end-time="END_TIME" \
    --statement="
      SELECT
        name,
        resource.DATA.creationTimestamp
      FROM
        compute_googleapis_com_Instance"

Specifica i seguenti valori:

ORGANIZATION_ID: l'ID dell'organizzazione di cui vuoi elencare gli asset.
Come trovare un ID organizzazione Google Cloud
Console

Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:

Vai alla console Google Cloud.

Vai alla console Google Cloud

Fai clic sulla casella del selettore nella barra dei menu.

Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.

Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
Interfaccia a riga di comando gcloud

Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
START_TIME: facoltativo. L'inizio dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.
END_TIME: facoltativo. Il punto finale dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non viene fornita, si presume che l'ora di fine sia l'ora attuale. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.

REST

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "statement": "
            SELECT
              name,
              resource.DATA.creationTimestamp
            FROM
              compute_googleapis_com_Instance",
          "readTimeWindow": {
            "startTime": "START_TIME",
            "endTime": "END_TIME"
          }
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE:queryAssets

Specifica i seguenti valori:

START_TIME: facoltativo. L'inizio dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve essere l'ora attuale o un'ora non superiore a 35 giorni prima. Per informazioni sui formati temporali, consulta gcloud topic datetimes.
END_TIME: facoltativo. Il punto finale dell'intervallo di tempo. L'intervallo di tempo massimo è 7 giorni. Il valore deve corrispondere all'ora corrente o a un'ora non superiore a 35 giorni prima. Se non viene fornita, si presume che l'ora di fine sia l'ora attuale. Per informazioni sui formati dell'ora, consulta gcloud topic datetimes.
SCOPE: un ambito può essere un progetto, una cartella o un'organizzazione.

I valori consentiti sono:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Come trovare il numero di un progetto Google Cloud
  Console
  
  Per trovare il numero di un progetto Google Cloud, completa questi passaggi:
  
  Vai alla pagina Dashboard nella console Google Cloud.
  
  Vai alla dashboard
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Seleziona la tua organizzazione dalla casella Seleziona da, quindi cerca il nome del tuo progetto.
  
  Fai clic sul nome del progetto per passare a quel progetto. Il numero di progetto è visualizzato nella scheda Informazioni sul progetto.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare il numero di un progetto Google Cloud con il seguente comando:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Come trovare l'ID di una cartella Google Cloud
  Console
  
  Per trovare l'ID di una cartella Google Cloud, completa i seguenti passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Cerca il nome della cartella. L'ID cartella è visualizzato accanto al nome della cartella.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare l'ID di una cartella Google Cloud che si trova a livello di organizzazione con il seguente comando:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dove TOP_LEVEL_FOLDER_NAME può essere una corrispondenza stringa completa o parziale. Rimuovi l'opzione --format per visualizzare ulteriori informazioni sulle cartelle trovate.
  
  Per ottenere l'ID di una cartella all'interno di un'altra cartella, elenca le sottocartelle:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Come trovare un ID organizzazione Google Cloud
  Console
  
  Per trovare l'ID organizzazione di Google Cloud, completa questi passaggi:
  
  Vai alla console Google Cloud.
  
  Vai alla console Google Cloud
  
  Fai clic sulla casella del selettore nella barra dei menu.
  
  Fai clic sulla casella Seleziona da, quindi seleziona la tua organizzazione.
  
  Fai clic sulla scheda Tutte. L'ID organizzazione è visualizzato accanto al nome dell'organizzazione.
  
  Interfaccia a riga di comando gcloud
  
  Puoi recuperare un ID organizzazione Google Cloud con il seguente comando:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Esecuzione di query sugli asset

Limitazioni

Prima di iniziare

Interfaccia a riga di comando gcloud

REST

Autorizzazioni

Formattare una query

Formato della risposta del valore del campo

Query nella console Google Cloud

Console

Salva i risultati della query

gcloud

Progetti

Cartelle

Console

Interfaccia a riga di comando gcloud

Organizzazioni

Console

Interfaccia a riga di comando gcloud

REST

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Query di esempio

Asset di query

gcloud

Progetti

Cartelle

Console

Interfaccia a riga di comando gcloud

Organizzazioni

Console

Interfaccia a riga di comando gcloud

REST

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Esegui query sui metadati standard delle risorse su più tipi di risorse

gcloud

Progetti

Cartelle

Console

Interfaccia a riga di comando gcloud

Organizzazioni

Console

Interfaccia a riga di comando gcloud

REST

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Recupero di una risposta in modo asincrono tramite riferimento al job

gcloud

Progetti

Cartelle

Console

Interfaccia a riga di comando gcloud

Organizzazioni

Console

Interfaccia a riga di comando gcloud

REST

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud

Recupero della pagina successiva dei risultati per le richieste impaginate con l'API REST

Console

Interfaccia a riga di comando gcloud

Console

Interfaccia a riga di comando gcloud