Elenca 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 pubblici Google Cloud 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, vedi Elencare i servizi abilitati in un'organizzazione.
  • Per elencare i servizi in un progetto, ti consigliamo di utilizzare la consoleGoogle Cloud o Google Cloud CLI. Questo documento descrive come utilizzare entrambe le interfacce.
  • Per programmare in base all'API Service Usage, utilizza una delle nostre librerie client fornite.
  • Per sperimentare 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:

  • Un Google Cloud progetto. Per scoprire come creare un progetto Google Cloud , consulta la pagina Creare e gestire progetti.
  • Le autorizzazioni Identity and Access Management corrette. Per informazioni sui requisiti IAM per Service Usage, vedi Controllo dell'accesso.
  • 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 in Per iniziare. Questi passaggi includono la definizione di gcurl, che è un alias autenticato per il comando standard curl 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 una singola chiamata RPC. Cloud Asset Inventory può essere utilizzato anche per monitorare le modifiche di stato. Per esportare tutti i servizi abilitati per una determinata organizzazione, segui le istruzioni della documentazione di Cloud Asset Inventory per elencare gli asset.

Per elencare le API abilitate per un'organizzazione, esegui questo comando dopo aver impostato gli ID progetto di organizzazione e 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 sperimentare 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

L'elenco dei servizi abilitati utilizza la quota della metrica 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 pagina Google Cloud della console Dashboard API.
    vai alla pagina Dashboard API

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

    • Fai clic su un progetto Google Cloud nella sezione Seleziona un progetto recente.

    • Utilizza il Google Cloud browser dei progetti seguendo questi passaggi:

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

gcloud

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

curl

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

Per elencare le API e i servizi abilitati nel tuo 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 serviceusage.googleapis.com/list_available_requests. La quota disponibile predefinita è 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 a tua disposizione in un progetto:

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

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

    • Fai clic su un progetto Google Cloud nella sezione Seleziona un progetto recente.

    • Utilizza il Google Cloud browser dei progetti seguendo questi passaggi:

      1. Fai clic su Seleziona progetto per aprire il browser dei progetti Google Cloud .
      2. Trova 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 disponibili nel progetto corrente, esegui questo comando:

gcloud services list --available

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

Per elencare le API e i servizi disponibili nel tuo 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 i quali l'utente chiamante dispone dell'autorizzazione servicemanagement.services.bind e tutti i servizi già 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 tuo progettoGoogle Cloud , consulta Attivazione e disattivazione dei servizi.