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, come 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, consulta Elenco dei 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 programmare con l'API Service Usage, utilizza una delle nostre librerie client.
  • Per eseguire esperimenti con l'API, ti consigliamo di utilizzare il comando curl. Non è necessario configurare un ambiente di applicazione completo, ma è necessaria qualche configurazione.

Prima di iniziare

Per elencare le API e i servizi abilitati e disponibili di cui hai bisogno:

  • Un progetto Google Cloud. Per scoprire come creare un progetto Google Cloud, consulta Creare e gestire progetti.
  • Le autorizzazioni Identity and Access Management corrette. Per informazioni sui requisiti IAM per l'Service Usage, consulta Controllo dell'accesso.
  • Per installare Google Cloud CLI.
  • Se vuoi utilizzare gli esempi curl in questa guida, assicurati di seguire le istruzioni per completare la configurazione iniziale in Per iniziare. 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.

Elenco dei 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 un'unica 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, consulta la documentazione di Cloud Asset Inventory relativa agli asset di elenco.

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

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 eseguire esperimenti con i comandi di Cloud Asset Inventory, applicali a un progetto specifico. Ad esempio, il seguente comando elenca tutti i servizi abilitati per un determinato 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'

Elenco dei servizi abilitati in un progetto

I servizi abilitati per le schede utilizzano la quota della metrica 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 API della console Google Cloud.
    vai alla pagina Dashboard 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 dei progetti Google Cloud seguendo questi passaggi:

      1. Fai clic su Seleziona progetto per aprire il browser dei progetti Google Cloud.
      2. Individua il tuo 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 attivate nel tuo progetto Google Cloud nella tabella di questa pagina.

gcloud

Per elencare le API e i servizi abilitati nel progetto corrente, esegui il seguente 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
...

curl

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 il seguente 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 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 a tua disposizione in un progetto:

  1. Vai alla pagina Libreria API della console Google Cloud.
    Vai alla pagina 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 dei progetti Google Cloud seguendo questi passaggi:

      1. Fai clic su Seleziona progetto per aprire il browser dei progetti Google Cloud.
      2. Individua il tuo 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 a tua disposizione nel tuo progetto corrente, esegui il seguente comando:

gcloud services list --available

I risultati includono tutti i servizi già abilitati, nonché i servizi che possono essere attivati 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 metodo services.list.

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

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 che sono già stati attivati nel progetto.

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

Passaggi successivi

Per informazioni su come attivare o disattivare i servizi nel progetto Google Cloud, consulta Attivare e disattivare i servizi.