Elenca servizi

Questo documento descrive come elencare le API e i servizi abilitati o disponibili in un Google Cloud progetto. L'elenco delle API e dei servizi disponibili o abilitati può contenere sia servizi Google Cloud pubblici come Pub/Sub sia API e servizi condivisi privatamente con te, ad esempio i servizi creati utilizzando Cloud Endpoints. Per saperne di più sulle differenze tra API e servizi pubblici e privati, consulta Servizi pubblici e privati.

  • Per ottenere o monitorare i servizi abilitati per un'organizzazione, consulta Elenca i servizi abilitati in un'organizzazione.
  • Per elencare i servizi in un progetto, ti consigliamo di utilizzare la Google Cloud console o Google Cloud CLI. Questo documento descrive come utilizzare entrambe le interfacce.
  • Per programmare con l'API Service Usage, utilizza una delle librerie client fornite .
  • Per sperimentare con l'API, ti consigliamo di utilizzare il comando curl. Non è necessario configurare un ambiente applicativo completo, ma è necessaria una configurazione.

Prima di iniziare

Per elencare le API e i servizi abilitati e disponibili, devi disporre di:

  • Un Google Cloud progetto. Per scoprire come creare un Google Cloud progetto, consulta Creazione e gestione dei progetti.
  • Le autorizzazioni Identity and Access Management corrette. Per scoprire di più sui requisiti IAM per Service Usage, consulta Controllo dell'accesso.
  • Google Cloud CLI.
  • Se vuoi utilizzare gli esempi curl in questa guida, assicurati di seguire le istruzioni per completare la configurazione iniziale in Guida introduttiva. Questi passaggi includono la definizione di gcurl, che è un alias autenticato per il comando curl standard, e la definizione della variabile di ambiente PROJECT_NUMBER.

Elenca i servizi abilitati in un'organizzazione

Per elencare i servizi abilitati in un'organizzazione, utilizza Cloud Asset Inventory, che consente di esportare lo stato di tutti i progetti sotto il controllo di un'organizzazione in una singola chiamata RPC. Cloud Asset Inventory può essere utilizzato anche per monitorare le modifiche dello stato. Per esportare tutti i servizi abilitati per una determinata organizzazione, segui la documentazione di Cloud Asset Inventory per l'elenco degli asset.

Per elencare le API abilitate per un'organizzazione, esegui il comando seguente dopo aver impostato gli ID del progetto di fatturazione e dell'organizzazione:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

L'esecuzione del comando precedente consente a un utente con privilegi sufficienti di elencare l'insieme di servizi abilitati per tutti i progetti di un'organizzazione.

Per sperimentare con i comandi di Cloud Asset Inventory, applicali a un progetto specifico. Ad esempio, il comando seguente elenca tutti i servizi abilitati per un progetto specifico:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Elenca i servizi abilitati in un progetto

L'elenco dei servizi abilitati utilizza la quota della metrica di quota serviceusage.googleapis.com/list_enabled_requests. La quota disponibile predefinita è di 10 query al secondo (QPS).

console

Per elencare le API e i servizi abilitati in un progetto:

  1. Vai alla Google Cloud console Dashboard API pagina.
    vai alla pagina Dashboard API

  2. Seleziona il tuo Google Cloud progetto eseguendo una delle seguenti operazioni:

    • Fai clic su un Google Cloud progetto in Seleziona un progetto recente.

    • Utilizza il Google Cloud browser del progetto seguendo questi passaggi:

      1. Fai clic su Seleziona progetto per aprire il Google Cloud browser del progetto.
      2. Trova il progetto e fai clic sul Google Cloud nome del progetto.
      3. Fai clic su Apri per aprire il progetto.

    Viene visualizzata la pagina API e servizi. Puoi trovare l'elenco delle API abilitate nel Google Cloud progetto nella tabella in questa pagina.

gcloud

Per elencare le API e i servizi abilitati nel progetto corrente, esegui il comando seguente:

gcloud services list

Il comando produce un output simile al seguente:

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

Per elencare i servizi abilitati, chiama il services.list metodo con il state:ENABLED filtro.

Per elencare le API e i servizi abilitati nel progetto, esegui il comando seguente:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

Elenca i servizi disponibili in un progetto

L'elenco di tutti i servizi disponibili utilizza la quota serviceusage.googleapis.com/list_available_requests. La quota disponibile predefinita è 1 QPS. L'insieme di servizi disponibili cambia raramente e può essere memorizzato nella cache per periodi di tempo prolungati.

console

Per elencare le API e i servizi disponibili in un progetto:

  1. Vai alla pagina Libreria API della Google Cloud console .
    Vai alla pagina Libreria API

  2. Seleziona il tuo Google Cloud progetto eseguendo una delle seguenti operazioni:

    • Fai clic su un Google Cloud progetto in Seleziona un progetto recente.

    • Utilizza il Google Cloud browser del progetto seguendo questi passaggi:

      1. Fai clic su Seleziona progetto per aprire il Google Cloud browser del progetto.
      2. Trova il progetto e fai clic sul Google Cloud nome del progetto.
      3. Fai clic su Apri per aprire il progetto.

    Viene visualizzata la schermata Libreria API. Da questa schermata puoi cercare o scorrere le API disponibili.

gcloud

Per elencare le API e i servizi disponibili nel progetto corrente, esegui il comando seguente:

gcloud services list --available

I risultati includono tutti i servizi già abilitati, nonché i servizi che possono essere abilitati per il progetto corrente. Il comando produce un output simile al seguente:

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

Per elencare i servizi disponibili, chiama il services.list metodo.

Per elencare le API e i servizi disponibili nel progetto, esegui il comando seguente:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

Il risultato include tutti i servizi pubblici, tutti i servizi per i quali l'utente chiamante dispone dell'autorizzazione servicemanagement.services.bind e tutti i servizi già abilitati nel progetto.

È possibile escludere i servizi attualmente attivi nel progetto passando filter=state:DISABLED alla chiamata precedente.

Passaggi successivi

Per informazioni su come abilitare o disabilitare i servizi nel Google Cloud progetto, consulta Abilitazione e disabilitazione dei servizi.