Elenco dei servizi

Questo documento descrive come elencare le API e i servizi attivati o disponibili in un progetto Google Cloud. L'elenco delle API e dei servizi disponibili o attivati può contenere sia servizi Google Cloud pubblici come Pub/Sub, sia qualsiasi 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 recuperare o monitorare i servizi attivati per un'organizzazione, vedi Elencare i servizi attivati in un'organizzazione.
Per elencare i servizi di un progetto, ti consigliamo di utilizzare la console Google 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.
Per sperimentare con l'API, ti consigliamo di utilizzare il comando curl. Non è necessario configurare un ambiente completo per l'applicazione; tuttavia, è richiesta alcune configurazioni.

Prima di iniziare

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

un progetto cloud. Per scoprire come creare un progetto cloud, consulta Creazione e gestione dei progetti.
Le autorizzazioni corrette di Identity and Access Management. Per scoprire i requisiti IAM per l'utilizzo dei servizi, vedi 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 Iniziare. 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 attivati 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 i cambiamenti di stato. Per esportare tutti i servizi attivati per una determinata organizzazione, segui la documentazione di Cloud Asset Inventory per l'elenco di asset.

Per elencare le API abilitate per un'organizzazione, esegui il comando seguente dopo aver impostato gli ID dell'organizzazione e del progetto 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 sperimentare 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 per cui è stata attivata la scheda utilizzano la quota della metrica relativa alla 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:

Vai alla pagina Dashboard dell'API della console Google Cloud.
Vai alla pagina della dashboard dell'API
Seleziona il progetto Cloud eseguendo una delle seguenti operazioni:
- Fai clic su un progetto Cloud in Seleziona un progetto recente.
- Utilizza il browser del progetto Cloud procedendo nel seguente modo:
  1. Fai clic su Seleziona progetto per aprire il browser del progetto Cloud.
  2. Trova il progetto e fai clic sul suo nome.
  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 Cloud nella tabella di questa pagina.

gcloud

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

gcloud services list

Il comando genera 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"

Elenca i servizi disponibili in un progetto

Per elencare tutti i servizi disponibili viene utilizzata 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 per un progetto:

Vai alla pagina Libreria API della console Google Cloud.
Vai alla pagina Libreria API
Seleziona il progetto Cloud eseguendo una delle seguenti operazioni:
- Fai clic su un progetto Cloud in Seleziona un progetto recente.
- Utilizza il browser del progetto Cloud procedendo nel seguente modo:
  1. Fai clic su Seleziona progetto per aprire il browser del progetto Cloud.
  2. Trova il progetto e fai clic sul suo nome.
  3. Fai clic su Apri per aprire il progetto.
Viene visualizzata la schermata Libreria API. Puoi cercare o scorrere le API disponibili da questa schermata.

gcloud

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

gcloud services list --available

I risultati includono i servizi già abilitati, oltre ai servizi che possono essere attivati per il progetto attuale. Il comando genera 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 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 ha l'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 attivare o disattivare i servizi nel tuo progetto Cloud, consulta la pagina relativa all'attivazione e alla disattivazione dei servizi.