Elenca le dipendenze dei servizi

Anteprima - Attivazione dei servizi gerarchici

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 ti 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 richiedono altri servizi per funzionare. Quando attivi un servizio utilizzando l'attivazione dei servizi gerarchici, le relative dipendenze richieste vengono aggiunte automaticamente a ConsumerPolicy. Un gruppo di dipendenze dei servizi contiene questi servizi da cui dipendono altri servizi, 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 workload.

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 progetto Google Cloud .

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 cui 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 i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già 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 progetto Google Cloud .

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 cui 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 i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già 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 applicati per impostazione predefinita al 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 dei servizi, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore utilizzo servizi (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 dei servizi. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per elencare le dipendenze dei servizi sono necessarie le seguenti autorizzazioni:

• Elenca i membri del gruppo di dipendenze: serviceusage.groups.listMembers
• Elenca i 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 dei servizi 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 dei servizi 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.

Elenca i membri del gruppo di dipendenze espanso

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

Questo comando restituisce un elenco semplificato di tutte le dipendenze, incluse quelle nei gruppi nidificati, per fornire un elenco completo e combinato di tutte le dipendenze dei servizi.

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 dei servizi 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 dipendenza diretta

• 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 dei servizi 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 Gestisci l'attivazione dei servizi.
• Per gestire le policy, consulta Gestisci le policy dei consumer.