Elenca tutti i progetti e le cartelle nella gerarchia

L'API Cloud Resource Manager ti consente di rilevare e catalogare ogni cartella e progetto nella tua Google Cloud gerarchia delle risorse. Questa visibilità ti aiuta a eseguire controlli di audit e a creare strumenti di gestione personalizzati. Le operazioni di elenco standard possono omettere le risorse quando gli utenti hanno ruoli personalizzati limitati. Puoi filtrare le query in base ai riferimenti principali per ottenere risultati di ricerca coerenti e identificare i nodi che altrimenti potrebbero essere nascosti dalle autorizzazioni con privilegi minimi.

Elenca tutti i nodi delle risorse

Quando esegui la scansione della gerarchia delle risorse per elencare ogni risorsa, hai bisogno di risultati con elevata coerenza. Se la scansione non rileva risorse o fornisce risultati obsoleti, può essere difficile capire che qualcosa è andato storto. Per assicurarti di ottenere sempre i risultati più accurati e completi, utilizza un account di servizio ed esegui una scansione nel seguente modo:

  1. Concedi a un account di servizio le autorizzazioni list e get per organizzazioni, cartelle e progetti sulla risorsa Organizzazione.
  2. Se stai elencando le risorse Progetto e Cartella, specifica la risorsa padre nella stringa di filtro.
  3. Esegui il metodo projects.list() con questo account di servizio per ogni tipo di risorsa che vuoi trovare e per tutte le risorse intermedie, ad esempio le cartelle.

Esempio per elencare tutti i nodi delle risorse

Il seguente pseudocodice mostra come elencare ogni nodo di risorse nelle tue organizzazioni:

organizations = organizations.search()
projects = emptyList()

parentsToList = queueOf(organizations)
while (parent = parentsToList.pop()) {
  // TODO: Iterate over paginated results as needed.
  // TODO: Handle PERMISSION_DENIED appropriately.
  projects.addAll(projects.list(parent.type, parent.id))
  parentsToList.addAll(folders.list(parent))
}

Quando crei un'esperienza utente personalizzata, potresti anche voler combinare i risultati di ricerca e caricare le risorse principali in base alle esigenze (rilevando anche l'eccezione PERMISSION_DENIED).

Riduci la latenza nell'elenco dei progetti gcloud

Se la query gcloud projects list non va a buon fine o richiede troppo tempo, il numero di progettiGoogle Cloud da restituire potrebbe essere troppo elevato. Per risolvere il problema, applica i flag filter e page-size al comando gcloud projects list.

Per scoprire di più sui flag che puoi aggiungere al comando gcloud projects list, consulta gcloud projects list.

Esempio di esclusione di progetti Apps Script

La causa più comune di errori o latenza delle query è un numero elevato di progetti Apps Script all'interno di un'organizzazione. Il comando seguente mostra come escludere i progetti Apps Script dall'elenco dei progetti e limitare il numero di risorse restituite per pagina.

gcloud projects list --filter="NOT parent.id: 'APPS_SCRIPT_FOLDER_ID' "--page-size='30'

Recupera l'ID cartella di Apps Script

Per trovare l'ID cartella di Apps Script, segui questi passaggi.

  1. Nella barra degli strumenti della console Google Cloud , fai clic su Cerca risorse, documenti, prodotti e altro e digita apps-script.

    Vai alla console Google Cloud

  2. In Risorse, seleziona la cartella apps-script.

  3. In ID cartella, copia l'ID cartella.

Cerca risorse

Se la scansione ha lo scopo di cercare una risorsa creata un po' di tempo fa, puoi eseguire una scansione più rapida con coerenza finale anziché con elevata coerenza. Tieni presente che questo metodo di ricerca potrebbe omettere alcune risorse dai risultati di ricerca, in particolare quelle che sono state modificate di recente. Per cercare le risorse:

  1. Utilizza un account di servizio con l'autorizzazione get per la risorsa che stai cercando.
  2. Esegui il metodo projects.search() con questo account di servizio.

Risoluzione dei problemi relativi alle risorse omesse

Se stai sviluppando uno strumento di scansione, ti consigliamo di utilizzare le autorizzazioni list e get concesse a livello di organizzazione. In questo modo si evitano i problemi causati dal fatto che l'utente dispone di autorizzazioni parziali, il che comporta l'omissione di alcune risorse dall'elenco.

Se stai progettando un'esperienza utente personalizzata che controlla le autorizzazioni dell'utente, non esiste una soluzione semplice. Se un utente non dispone di autorizzazioni a livello di organizzazione, dovrà avere determinate autorizzazioni su ogni risorsa affinché questa venga visualizzata. Se un utente non dispone delle autorizzazioni per una risorsa in un punto della gerarchia, alcune risorse potrebbero non essere visualizzate.

Se un utente dispone dell'autorizzazione list, ma non dell'autorizzazione get per una determinata risorsa, questa non sarà visibile nella consoleGoogle Cloud . Tuttavia, la risorsa verrà restituita in una ricerca utilizzando l'API o Google Cloud CLI che specifica l'elemento padre della risorsa. Questa disparità tra la console Google Cloud e altri metodi è una fonte comune di confusione quando si tenta di analizzare la gerarchia delle risorse.

I seguenti diagrammi mostrano alcune configurazioni comuni delle autorizzazioni e come cambiano le risorse visibili a un utente che esegue una ricerca.

Elenco di tutte le risorse

In questo esempio, tutte le autorizzazioni richieste vengono concesse nella risorsa Organization. Pertanto, l'intera gerarchia è visibile quando si esegue un elenco o una ricerca.

Autorizzazioni dell'organizzazione mancanti

L'utente in questo esempio dispone di tutte le autorizzazioni richieste, ad eccezione di resourcemanager.organizations.get, ma queste autorizzazioni sono concesse a livello di cartella. Questo divario di autorizzazioni offre loro visibilità completa sull'elenco o sulla ricerca di quella parte della gerarchia, ma non sull'altra metà.

Solo autorizzazione Get per il progetto

Questo esempio mostra l'esperienza di un utente con solo l'autorizzazione resourcemanager.projects.get concessa a livello di risorsa Cartella. Possono visualizzare i progetti sottostanti alla cartella nella gerarchia, ma solo tramite ricerca. L'utilizzo della funzionalità di elenco non restituirà alcun risultato.

Solo autorizzazione di recupero delle cartelle

Questo esempio illustra uno scenario simile in cui le autorizzazioni concesse ti consentono solo di trovare le risorse cartella tramite la ricerca. L'operazione di elenco non restituisce risultati.

Autorizzazioni miste

L'utente in questo esempio dispone di un insieme di autorizzazioni in tutta l'organizzazione. Possono elencare le cartelle a livello di organizzazione, il che consente loro di trovarle con ricerche che specificano la risorsa padre in tutta la gerarchia. Può elencare le risorse del progetto per una cartella, ma non per l'altra, e dispone dell'autorizzazione resourcemanager.projects.get su un progetto nella parte inferiore della gerarchia.

Di conseguenza, non possono restituire i progetti sul lato sinistro di questa gerarchia delle risorse. Possono elencare i progetti sul lato destro solo utilizzando una ricerca che specifica la risorsa padre e solo un progetto è visibile se visualizzato nella console Google Cloud .

Risorse non rilevabili

In questo esempio, puoi ottenere la risorsa Organization ed elencare le risorse Project specificando l'elemento principale in tutta la gerarchia. Tuttavia, non hai l'autorizzazione per elencare o cercare cartelle intermedie. I tuoi progetti sono ricercabili se conosci l'ID della cartella principale. Le cartelle non sono visibili, quindi non puoi scoprire l'ID se non lo hai già. L'unica risorsa visualizzata nella console Google Cloud è l'organizzazione.

Quando progetti la tua esperienza utente personalizzata, è importante essere consapevole di situazioni simili a queste. Puoi utilizzare una combinazione di elenchi e ricerche per eseguire il rendering della gerarchia delle risorse. Dovresti anche valutare come comunicare agli utenti che non dispongono delle autorizzazioni necessarie per visualizzare l'intera gerarchia delle risorse.