Gestisci query salvate

Questa pagina mostra come creare, gestire ed eseguire le query di Analisi criteri salvate. Puoi creare fino a 200 query salvate in un asset. Questo limite non include le query salvate dei relativi elementi secondari. Ad esempio, se hai 10 progetti in un'organizzazione, ogni progetto può avere fino a 200 query salvate e l'organizzazione può avere fino a 200 query salvate.

Prima di iniziare

  1. Enable the Cloud Asset API.

    Enable the API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire le query salvate, chiedi all'amministratore di concederti il ruolo IAM Proprietario asset cloud (roles/cloudasset.owner) nel progetto, nella cartella o nell'organizzazione in cui salverai la query. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire le query salvate. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare e gestire le query salvate sono necessarie le seguenti autorizzazioni:

  • cloudasset.savedqueries.create
  • cloudasset.savedqueries.delete
  • cloudasset.savedqueries.get
  • cloudasset.savedqueries.list
  • cloudasset.savedqueries.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Crea una query salvata

gcloud

Per creare una query di Policy Analyzer salvata in un progetto, una cartella o un'organizzazione principale, utilizza il comando gcloud asset saved-queries create.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • SCOPE_RESOURCE_TYPE_PLURAL: il tipo di risorsa a cui vuoi limitare la ricerca, in forma plurale. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Utilizza il valore projects, folders o organizations.
  • SCOPE_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud a cui vuoi limitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • FULL_RESOURCE_NAME: facoltativo. Il nome completo della risorsa per la quale vuoi analizzare l'accesso. Per un elenco dei formati dei nomi delle risorse completi, consulta Formato del nome della risorsa.
  • PRINCIPAL: facoltativo. Il principale di cui vuoi analizzare l'accesso, nel formato PRINCIPAL_TYPE:ID, ad esempio user:my-user@example.com. Per un elenco completo dei tipi di principali, consulta Identificatori principali.
  • PERMISSION_1, PERMISSION_2… PERMISSION_N: facoltativo. Le autorizzazioni che vuoi verificare, ad esempio compute.instances.get. Se elencate più autorizzazioni, Analizzatore criteri ne verificherà la presenza.
  • QUERY_ID: l'ID da utilizzare per la query salvata, che deve essere univoco nella risorsa principale specificata (progetto, cartella o organizzazione). Puoi utilizzare lettere, numeri e trattini nell'ID query.
  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi salvare una query. Utilizza il valore project, folder o organization.
  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud per cui vuoi salvare una query. Gli ID progetto possono essere alfanumerici o numerici. Gli ID cartella e organizzazione sono numerici.
  • LABEL_KEY e LABEL_VALUE: facoltativi. Un elenco di coppie chiave/valore separati da virgole da associare alla query, che può essere utilizzato nelle operazioni di ricerca e elenco. Puoi includere fino a 10 etichette per ogni query salvata.
  • DESCRIPTION: facoltativo. Una stringa che descrive la query.

Salva i seguenti contenuti in un file denominato request.json: 

{
  "IamPolicyAnalysisQuery": {
    "scope": "SCOPE_RESOURCE_TYPE_PLURAL/SCOPE_RESOURCE_ID",
    "resourceSelector": {
      "fullResourceName": "FULL_RESOURCE_NAME"
    },
    "identitySelector": {
      "identity": "PRINCIPAL"
    },
    "accessSelector": {
      "permissions": [
        "PERMISSION_1",
        "PERMISSION_2",
        "PERMISSION_N"
      ]
    }
  }
}

Esegui il seguente comando:

Linux, macOS o Cloud Shell

gcloud asset saved-queries create \
QUERY_ID \
--RESOURCE_TYPE=RESOURCE_ID \
--query-file-path=request.json \
--labels="LABEL_KEY=LABEL_VALUE" \
--description="DESCRIPTION"

Windows (PowerShell)

gcloud asset saved-queries create `
QUERY_ID `
--RESOURCE_TYPE=RESOURCE_ID `
--query-file-path=request.json `
--labels="LABEL_KEY=LABEL_VALUE" `
--description="DESCRIPTION"

Windows (cmd.exe)

gcloud asset saved-queries create ^
QUERY_ID ^
--RESOURCE_TYPE=RESOURCE_ID ^
--query-file-path=request.json ^
--labels="LABEL_KEY=LABEL_VALUE" ^
--description="DESCRIPTION"

La risposta contiene la query salvata. Ad esempio, potrebbe avere il seguente aspetto: 

content:
  iamPolicyAnalysisQuery:
    resourceSelector:
      fullResourceName: //cloudresourcemanager.googleapis.com/projects/my-project
    identitySelector:
      identity: user:my-user@example.com
    scope: projects/scope-project
createTime: '2022-04-18T22:47:25.640783Z'
description: A query checking what permissions my-user@example.com has on my-project
labels:
  user: my-user
lastUpdateTime: '2022-04-18T22:47:25.640783Z'
name: projects/12345678901/savedQueries/my-query

REST

Per creare una query di Analisi criteri salvata in un progetto, una cartella o un'organizzazione principale, utilizza il metodo savedQueries.create dell'API Cloud Asset Inventory.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa per cui vuoi salvare una query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud per cui vuoi salvare una query. Gli ID progetto possono essere alfanumerici o numerici. Gli ID cartella e organizzazione sono numerici.
  • QUERY_ID: l'ID da utilizzare per la query salvata, che deve essere univoco nella risorsa principale specificata (progetto, cartella o organizzazione). Nell'ID query puoi utilizzare lettere, numeri e trattini.
  • SCOPE_RESOURCE_TYPE: il tipo di risorsa per la quale vuoi delimitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Utilizza il valore projects, folders o organizations.
  • SCOPE_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud a cui vuoi limitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • FULL_RESOURCE_NAME: facoltativo. Il nome completo della risorsa per la quale vuoi analizzare l'accesso. Per un elenco dei formati dei nomi delle risorse completi, consulta Formato del nome della risorsa.
  • PRINCIPAL: facoltativo. Il principale di cui vuoi analizzare l'accesso, nel formato PRINCIPAL_TYPE:ID, ad esempio user:my-user@example.com. Per un elenco completo dei tipi di principali, consulta Identificatori principali.
  • PERMISSION_1, PERMISSION_2… PERMISSION_N: facoltativo. Le autorizzazioni che vuoi verificare, ad esempio compute.instances.get. Se elencate più autorizzazioni, Analizzatore criteri ne verificherà la presenza.
  • LABEL_KEY e LABEL_VALUE: facoltativi. Una coppia chiave/valore da associare alla query, che può essere utilizzata nelle operazioni di ricerca e di elenco. Puoi includere fino a 10 etichette per ogni query salvata.
  • DESCRIPTION: facoltativo. Una stringa che descrive la query.

Metodo HTTP e URL: 

POST https://cloudasset.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/savedQueries?savedQueryId=QUERY_ID

Corpo JSON della richiesta: 

{
  "content": {
    "iamPolicyAnalysisQuery": {
      "scope": "SCOPE_RESOURCE_TYPE/SCOPE_RESOURCE_ID",
      "resourceSelector": {
        "fullResourceName": "FULL_RESOURCE_NAME"
      },
      "identitySelector": {
        "identity": "PRINCIPAL"
      },
      "accessSelector": {
        "permissions": [
          "PERMISSION_1",
          "PERMISSION_2",
          "PERMISSION_N"
        ]
      }
    }
  },
  "labels": {
    "LABEL_KEY": "LABEL_VALUE"
  },
  "description": "DESCRIPTION"
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene la query salvata. Ad esempio, potrebbe avere il seguente aspetto: 

{
  "name": "projects/12345678901/savedQueries/my-query",
  "description": "A query checking what permissions my-user@example.com has on my-project",
  "createTime": "2022-04-18T22:47:25.640783Z",
  "lastUpdateTime": "2022-04-18T22:47:25.640783Z",
  "labels": {
    "user": "my-user"
  },
  "content": {
    "iamPolicyAnalysisQuery": {
      "scope": "projects/scope-project",
      "resourceSelector": {
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/my-project"
      },
      "identitySelector": {
        "identity": "user:my-user@example.com"
      }
    }
  }
}

Eseguire una query salvata

gcloud

Per eseguire una query di analisi salvata, utilizza il comando gcloud asset analyze-iam-policy.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • SCOPE_RESOURCE_TYPE: il tipo di risorsa per la quale vuoi delimitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Utilizza il valore project, folder o organization.
  • SCOPE_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud a cui vuoi limitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • RESOURCE_TYPE_PLURAL: il tipo di risorsa in cui è salvata la query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_NUM_ID: l'ID numerico del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Non puoi utilizzare l'ID progetto alfanumerico per identificare un progetto, devi utilizzare il numero di progetto.
  • QUERY_ID: l'ID della query salvata che vuoi utilizzare.

Esegui il comando gcloud asset analyze-iam-policy:

Linux, macOS o Cloud Shell

gcloud asset analyze-iam-policy \
--SCOPE_RESOURCE_TYPE=SCOPE_RESOURCE_ID \
--saved-analysis-query=RESOURCE_TYPE_PLURAL/RESOURCE_NUM_ID/savedQueries/QUERY_ID

Windows (PowerShell)

gcloud asset analyze-iam-policy `
--SCOPE_RESOURCE_TYPE=SCOPE_RESOURCE_ID `
--saved-analysis-query=RESOURCE_TYPE_PLURAL/RESOURCE_NUM_ID/savedQueries/QUERY_ID

Windows (cmd.exe)

gcloud asset analyze-iam-policy ^
--SCOPE_RESOURCE_TYPE=SCOPE_RESOURCE_ID ^
--saved-analysis-query=RESOURCE_TYPE_PLURAL/RESOURCE_NUM_ID/savedQueries/QUERY_ID

La risposta contiene i risultati dell'esecuzione della query salvata sulla risorsa specificata. Per esempi di risultati delle query, consulta Analisi dei criteri IAM.

REST

Per eseguire una query di analisi salvata, utilizza il metodo analyzeIamPolicy dell'API Cloud Asset Inventory.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • SCOPE_RESOURCE_TYPE: il tipo di risorsa per la quale vuoi delimitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai suoi discendenti. Utilizza il valore projects, folders o organizations.
  • SCOPE_RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud a cui vuoi limitare la ricerca. Verranno analizzati solo i criteri di autorizzazione IAM associati a questa risorsa e ai relativi discendenti. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_NUM_ID: l'ID numerico del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Non puoi utilizzare l'ID progetto alfanumerico per identificare un progetto, devi utilizzare il numero di progetto.
  • QUERY_ID: l'ID della query salvata che vuoi utilizzare.

Metodo HTTP e URL: 

POST https://cloudasset.googleapis.com/v1/SCOPE_RESOURCE_TYPE/SCOPE_RESOURCE_ID:analyzeIamPolicy

Corpo JSON della richiesta: 

{
  "savedAnalysisQuery": "RESOURCE_TYPE/RESOURCE_NUM_ID/savedQueries/QUERY_ID"
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene i risultati dell'esecuzione della query salvata sulla risorsa specificata. Per esempi di risultati di query, consulta Analisi dei criteri IAM.

Recuperare una query salvata

gcloud

Per recuperare una query di Policy Analyzer salvata, utilizza il gcloud asset saved-queries get comando.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • QUERY_ID: l'ID della query salvata che vuoi recuperare.
  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore project, folder o organization.
  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Gli ID progetto possono essere alfanumerici o numerici. Gli ID cartella e dell'organizzazione sono numerici.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

gcloud asset saved-queries describe QUERY_ID --RESOURCE_TYPE=RESOURCE_NUM_ID

Windows (PowerShell)

gcloud asset saved-queries describe QUERY_ID --RESOURCE_TYPE=RESOURCE_NUM_ID

Windows (cmd.exe)

gcloud asset saved-queries describe QUERY_ID --RESOURCE_TYPE=RESOURCE_NUM_ID

La risposta contiene la query salvata. Ad esempio, potrebbe avere il seguente aspetto: 

content:
  iamPolicyAnalysisQuery:
    resourceSelector:
      fullResourceName: //cloudresourcemanager.googleapis.com/projects/my-project
    identitySelector:
      identity: user:my-user@example.com
    scope: projects/scope-project
createTime: 2022-04-18T22:47:25.640783Z
description: A query checking what permissions my-user@example.com has on my-project
labels:
  user: my-user
lastUpdateTime: 2022-04-18T22:47:25.640783Z
name: projects/12345678901/savedQueries/my-query

REST

Per ottenere una query di Policy Analyzer salvata, utilizza il metodo savedQueries.get dell'API Cloud Asset Inventory.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_NUM_ID: l'ID numerico del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Non puoi utilizzare l'ID progetto alfanumerico per identificare un progetto, devi utilizzare il numero di progetto.
  • QUERY_ID: l'ID della query salvata che vuoi recuperare.

Metodo HTTP e URL: 

GET https://cloudasset.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_NUM_ID/savedQueries/QUERY_ID

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene la query salvata. Ad esempio, potrebbe avere il seguente aspetto: 

{
  "name": "projects/12345678901/savedQueries/my-query",
  "description": "A query checking what permissions my-user@example.com has on my-project",
  "createTime": "2022-04-18T22:47:25.640783Z",
  "lastUpdateTime": "2022-04-18T22:47:25.640783Z",
  "labels": {
    "user": "my-user"
  },
  "content": {
    "iamPolicyAnalysisQuery": {
      "scope": "projects/scope-project",
      "resourceSelector": {
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/my-project"
      },
      "identitySelector": {
        "identity": "user:my-user@example.com"
      }
    }
  }
}

Elenco delle query salvate

gcloud

Per elencare tutte le query di Policy Analyzer salvate in un progetto, in una cartella o in un'organizzazione, utilizza il comando gcloud asset saved-queries list.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui sono salvate le query. Utilizza il valore project, folder o organization.
  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud per cui vuoi elencare le query salvate. Gli ID progetto possono essere alfanumerici o numerici. Gli ID cartella e organizzazione sono numerici.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

gcloud asset saved-queries list --RESOURCE_TYPE=RESOURCE_ID

Windows (PowerShell)

gcloud asset saved-queries list --RESOURCE_TYPE=RESOURCE_ID

Windows (cmd.exe)

gcloud asset saved-queries list --RESOURCE_TYPE=RESOURCE_ID

La risposta contiene tutte le query di Analizzatore criteri salvate per il progetto, la cartella o l'organizzazione. Ad esempio, potrebbe avere il seguente aspetto: 

savedQueries:
- content:
    iamPolicyAnalysisQuery:
      resourceSelector:
        fullResourceName: //cloudresourcemanager.googleapis.com/projects/my-project
      identitySelector:
        identity: user:my-user@example.com
      scope: projects/scope-project
  createTime: '2022-04-15T21:17:33.777212Z'
  description: A query checking what permissions my-user@example.com has on my-project
  labels:
    missing-info: permissions
  lastUpdateTime: '2022-04-15T21:17:33.777212Z'
  name: projects/12345678901/savedQueries/query-1
- content:
    iamPolicyAnalysisQuery:
      accessSelector:
        permissions:
        - iam.roles.get
        - iam.roles.list
      identitySelector:
        identity: user:my-user@example.com
      scope: projects/scope-project
  createTime: '2022-04-18T22:47:25.640783Z'
  description: A query checking what resources my-user@example.com has permission to view roles on
  labels:
    missing-info: resource
  lastUpdateTime: '2022-04-18T22:47:25.640783Z'
  name: projects/12345678901/savedQueries/query-2

REST

Per elencare tutte le query di Analisi criteri salvate in un progetto, una cartella o un'organizzazione, utilizza il metodo savedQueries.list dell'API Cloud Asset Inventory.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui sono salvate le query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud per cui vuoi elencare le query salvate. Gli ID progetto possono essere alfanumerici o numerici. Gli ID cartella e organizzazione sono numerici.

Metodo HTTP e URL: 

GET https://cloudasset.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/savedQueries

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene tutte le query di Analizzatore criteri salvate per il progetto, la cartella o l'organizzazione. Ad esempio, potrebbe avere il seguente aspetto: 

{
  "savedQueries": [
    {
      "name": "projects/12345678901/savedQueries/query-1",
      "description": "A query checking what permissions my-user@example.com has on my-project",
      "createTime": "2022-04-15T21:17:33.777212Z",
      "lastUpdateTime": "2022-04-15T21:17:33.777212Z",
      "labels": {
        "missing-info": "permission"
      },
      "content": {
        "iamPolicyAnalysisQuery": {
          "scope": "projects/scope-project",
          "resourceSelector": {
            "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/my-project"
          },
          "identitySelector": {
            "identity": "user:my-user@example.com"
          }
        }
      }
    },
    {
      "name": "projects/12345678901/savedQueries/query-2",
      "description": "A query checking what resources my-user@example.com has permission to view roles on",
      "createTime": "2022-04-18T22:47:25.640783Z",
      "lastUpdateTime": "2022-04-18T22:47:25.640783Z",
      "labels": {
        "missing-info": "resource"
      },
      "content": {
        "iamPolicyAnalysisQuery": {
          "scope": "projects/scope-project",
          "accessSelector": {
            "permissions": [
              "iam.roles.get",
              "iam.roles.list"
            ]
          },
          "identitySelector": {
            "identity": "user:my-user@example.com"
          }
        }
      }
    }
  ]
}

Aggiornare una query salvata

gcloud

Per aggiornare una query di Policy Analyzer salvata, utilizza il comando gcloud asset saved-queries update.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • UPDATED_QUERY: facoltativo. La query di Policy Analyzer aggiornata che vuoi salvare. Per scoprire come formattare la query, consulta Creare una query salvata.
  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore project, folder o organization.
  • QUERY_ID: l'ID della query salvata che vuoi modificare.
  • RESOURCE_ID: l'ID del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Gli ID progetto possono essere alfanumerici o numerici. Gli ID cartella e dell'organizzazione sono numerici.
  • UPDATED_LABELS: facoltativo. Le etichette aggiornate da associare alla query salvata. Puoi anche rimuovere le etichette con il flag --remove-labels="KEY_1,KEY_2" o cancellare tutte le etichette con il flag --clear-labels.
  • UPDATED_DESCRIPTION: facoltativo. Una descrizione aggiornata della query salvata.

Salva i seguenti contenuti in un file denominato request.json: 

{
  "IamPolicyAnalysisQuery": {
    UPDATED_QUERY
  }
}

Esegui il seguente comando:

Linux, macOS o Cloud Shell

gcloud asset saved-queries update \
QUERY_ID \
--RESOURCE_TYPE=RESOURCE_ID \
--query-file-path=request.json \
--update-labels="UPDATED_LABELS" \
--description="DESCRIPTION"

Windows (PowerShell)

gcloud asset saved-queries update `
QUERY_ID `
--RESOURCE_TYPE=RESOURCE_ID `
--query-file-path=request.json `
--update-labels="UPDATED_LABELS" `
--description="DESCRIPTION"

Windows (cmd.exe)

gcloud asset saved-queries update ^
QUERY_ID ^
--RESOURCE_TYPE=RESOURCE_ID ^
--query-file-path=request.json ^
--update-labels="UPDATED_LABELS" ^
--description="DESCRIPTION"

La risposta contiene la query aggiornata.

REST

Per aggiornare una query di Policy Analyzer salvata, utilizza il metodo savedQueries.patch dell'API Cloud Asset Inventory.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_NUM_ID: l'ID numerico del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Non puoi utilizzare l'ID progetto alfanumerico per identificare un progetto, devi utilizzare il numero di progetto.
  • QUERY_ID: l'ID della query salvata che vuoi modificare.
  • UPDATED_FIELDS: un elenco di campi separati da virgole da aggiornare. Ad esempio, se stai aggiornando i campi dei contenuti, delle etichette e della descrizione, dovrai utilizzare il valore content,labels,description.
  • UPDATED_QUERY: facoltativo. La query di Policy Analyzer aggiornata che vuoi salvare. Per scoprire come formattare la query, consulta Creare una query salvata.
  • UPDATED_LABELS: facoltativo. Le etichette aggiornate da associare alla query salvata.
  • UPDATED_DESCRIPTION: facoltativo. Una descrizione aggiornata della query salvata.

Metodo HTTP e URL: 

POST https://cloudasset.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_NUM_ID/savedQueries/QUERY_ID?update_mask=UPDATED_FIELDS

Corpo JSON della richiesta: 

{
  "content": {
    "iamPolicyAnalysisQuery": {
      UPDATED_QUERY
  },
  "labels": {
    UPDATED_LABELS
  },
  "description": "UPDATED_DESCRIPTION"
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene la query aggiornata.

Eliminare una query salvata

gcloud

Per eliminare una query di Analisi criteri salvata, utilizza il comando gcloud asset saved-queries delete.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • QUERY_ID: l'ID della query salvata che vuoi eliminare.
  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore project, folder o organization.
  • RESOURCE_NUM_ID: l'ID numerico del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Non puoi utilizzare l'ID progetto alfanumerico per identificare un progetto, devi utilizzare il numero di progetto.

Esegui il seguente comando:

Linux, macOS o Cloud Shell

gcloud asset saved-queries delete \
QUERY_ID \
--RESOURCE_TYPE=RESOURCE_NUM_ID

Windows (PowerShell)

gcloud asset saved-queries delete `
QUERY_ID `
--RESOURCE_TYPE=RESOURCE_NUM_ID

Windows (cmd.exe)

gcloud asset saved-queries delete ^
QUERY_ID ^
--RESOURCE_TYPE=RESOURCE_NUM_ID

REST

Per eliminare una query di Policy Analyzer salvata, utilizza il metodo savedQueries.delete dell'API Cloud Asset Inventory.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • RESOURCE_TYPE: il tipo di risorsa in cui è salvata la query. Utilizza il valore projects, folders o organizations.
  • RESOURCE_NUM_ID: l'ID numerico del progetto, della cartella o dell'organizzazione Google Cloud in cui è salvata la query. Non puoi utilizzare l'ID progetto alfanumerico per identificare un progetto, devi utilizzare il numero di progetto.
  • QUERY_ID: l'ID della query salvata che vuoi eliminare.

Metodo HTTP e URL: 

DELETE https://cloudasset.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_NUM_ID/savedQueries/QUERY_ID

Per inviare la richiesta, espandi una di queste opzioni:

Se la query viene eliminata correttamente, l'API restituisce una risposta vuota.