Elenca le dipendenze del servizio

Anteprima — Attivazione gerarchica del servizio

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

L'attivazione gerarchica dei servizi consente di gestire l'abilitazione dei servizi ereditata tramite la gerarchia delle risorse Google Cloud . Per saperne di più, consulta la panoramica.

Molti servizi Google Cloud hanno bisogno di altri servizi per funzionare. Quando attivi un servizio utilizzando l'attivazione gerarchica dei servizi, le relative dipendenze richieste vengono aggiunte automaticamente a ConsumerPolicy. Un gruppo di dipendenze di servizio contiene questi servizi su cui si basa, che puoi elencare per comprenderli e gestirli meglio.

Questo documento mostra come utilizzare Google Cloud CLI per elencare le dipendenze dei servizi per progetti, cartelle e organizzazioni.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

1. Se non indichi la risorsa Google Cloud che vuoi gestire, i comandi in questo documento vengono impostati per impostazione predefinita sul progetto corrente. Ad esempio, gcloud beta services groups list-members bigquery.googleapis.com dependencies elenca i membri del progetto corrente.

   Puoi recuperare l'ID progetto attuale:

   gcloud config list --format='text(core.project)'

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per elencare le dipendenze del servizio, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore utilizzo del servizio (roles/serviceusage.serviceUsageViewer) sulla risorsa di destinazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per elencare le dipendenze del servizio. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per elencare le dipendenze del servizio sono necessarie le seguenti autorizzazioni:

• Elenca i membri del gruppo di dipendenze: serviceusage.groups.listMembers
• Elenco dei membri del gruppo di dipendenze espanso: serviceusage.groups.listExpandedMembers

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

Elenca i membri del gruppo di dipendenze

Puoi elencare i membri diretti di un gruppo di dipendenze di servizio per un progetto, una cartella o un'organizzazione utilizzando il comando gcloud beta services groups list-members:

gcloud beta services groups list-members SERVICE GROUP \
    --RESOURCE_TYPE=RESOURCE_ID

Sostituisci quanto segue:

• SERVICE: il nome del servizio per cui vuoi elencare i membri.

• GROUP: il nome del gruppo di dipendenze del servizio per cui vuoi elencare i membri. Il gruppo principale supportato è dependencies.

• RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i membri. I valori validi sono project, folder e organization. Puoi omettere completamente questo flag per restituire i risultati per il progetto corrente.

• RESOURCE_ID: l'ID progetto, l'ID cartella o l'ID organizzazione, a seconda del valore utilizzato per RESOURCE_TYPE.

Puoi utilizzare altri flag per filtrare e limitare i membri elencati.

Elenco dei membri del gruppo di dipendenze espanso

Puoi elencare i membri espansi di un gruppo di dipendenze del servizio per un progetto, una cartella o un'organizzazione utilizzando il comando gcloud beta services groups list-expanded-members.

Questo comando restituisce un elenco non strutturato di tutte le dipendenze, incluse quelle nei gruppi nidificati, per fornire un elenco completo e combinato di tutte le dipendenze del servizio.

gcloud beta services groups list-expanded-members SERVICE GROUP \
    --RESOURCE_TYPE=RESOURCE_ID

Sostituisci quanto segue:

• SERVICE: il nome del servizio per cui vuoi elencare i membri.

• GROUP: il nome del gruppo di dipendenze del servizio per cui vuoi elencare i membri. Il gruppo principale supportato è dependencies.

• RESOURCE_TYPE: il tipo di risorsa per cui vuoi elencare i membri. I valori validi sono project, folder e organization. Puoi omettere completamente questo flag per restituire i risultati per il progetto corrente.

• RESOURCE_ID: l'ID progetto, l'ID cartella o l'ID organizzazione, a seconda del valore utilizzato per RESOURCE_TYPE.

Puoi utilizzare altri flag per filtrare e limitare i membri elencati.

Esempi

Elenco dei membri del gruppo di dipendenze dirette

• Elenco delle dipendenze dirette del servizio BigQuery per il progetto corrente:

  gcloud beta services groups list-members bigquery.googleapis.com dependencies

  Output:

  NAME: services/analyticshub.googleapis.com
  REASON: BigQuery depends on this group to allow users to exchange data and analytics assets.
  
  NAME: services/bigquery.googleapis.com
  REASON: The service representing BigQuery which owns this dependency group and depends on the other members of this group.
  
  NAME: services/bigqueryconnection.googleapis.com
  REASON: BigQuery depends on this group to allow users to manage connections to external data sources.
  
  NAME: services/bigquerydatapolicy.googleapis.com
  REASON: BigQuery depends on this group to allow users to manage their data policies.
  
  ...

• Tentativo di elencare le dipendenze del servizio delle chiavi API senza un gruppo di dipendenze del servizio corrispondente:

  gcloud beta services groups list-members apikeys.googleapis.com dependencies --project=test-project

  Output:

  Listed 0 items.

Elenco dei membri del gruppo di dipendenze espanso

• Elenco delle dipendenze espanse del servizio BigQuery per il progetto corrente:

  gcloud beta services groups list-expanded-members bigquery.googleapis.com dependencies

  Output:

  services/analyticshub.googleapis.com
  services/bigquery.googleapis.com
  services/bigqueryconnection.googleapis.com
  services/bigquerydatapolicy.googleapis.com
  services/bigquerydatatransfer.googleapis.com
  services/bigquerymigration.googleapis.com
  services/bigqueryreservation.googleapis.com
  services/bigquerystorage.googleapis.com
  services/cloudresourcemanager.googleapis.com
  services/dataform.googleapis.com
  services/dataplex.googleapis.com

Passaggi successivi

• Per attivare e disattivare i servizi, consulta Gestire l'abilitazione dei servizi.
• Per gestire i criteri, vedi Gestisci le norme per i consumatori.