Elenco dei servizi

Questo documento descrive come elencare le API e i servizi abilitati o disponibili in un progetto Google Cloud. L'elenco di API e 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 ulteriori informazioni sulle differenze tra API e servizi pubblici e privati, consulta Servizi pubblici e privati.

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

Prima di iniziare

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

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

Elencare i servizi attivati 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 attivati per una determinata organizzazione, segui la documentazione di Cloud Asset Inventory per Asset scheda.

Per elencare le API abilitate per un'organizzazione, esegui il comando seguente dopo aver impostato gli ID 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 i comandi Cloud Asset Inventory, applica questi comandi a un progetto specifico. Ad esempio, il seguente comando elenca tutti i servizi abilitati per un particolare progetto:

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

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

console

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

  1. Vai alla pagina Dashboard delle API della console Google Cloud.
    Vai alla pagina Dashboard delle API

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

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

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

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

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

gcloud

Per elencare le API e i servizi abilitati nel progetto attuale, esegui questo comando:

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
...

arricciare

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

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

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

Elenco dei servizi disponibili in un progetto

L'elenco di tutti i servizi disponibili utilizza la quota della quota serviceusage.googleapis.com/list_available_requests. La quota predefinita disponibile è 1 QPS. L'insieme dei 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 console Google Cloud.
    Vai alla pagina della libreria API

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

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

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

      1. Fai clic su Seleziona progetto per aprire il browser del progetto Google Cloud.
      2. Individua il progetto e fai clic sul nome del progetto Google Cloud.
      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 attuale, esegui questo comando:

gcloud services list --available

I risultati includono tutti i servizi che sono già stati abilitati, nonché quelli che possono essere abilitati per il progetto attuale. 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
...

arricciare

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

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

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

Il risultato include tutti i servizi pubblici, tutti i servizi per cui l'utente chiamante dispone dell'autorizzazione servicemanagement.services.bind e tutti i servizi che sono già stati 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 tuo progetto Google Cloud, consulta Abilitazione e disattivazione dei servizi.