Abilitazione e disabilitazione dei servizi
Questa pagina descrive come abilitare e disabilitare i servizi per un progetto Google Cloud. Puoi utilizzare Service Usage per abilitare o disabilitare qualsiasi servizio disponibile per i tuoi progetti, inclusi i servizi Google Cloud pubblici e i servizi privati creati utilizzando Cloud Endpoints. Per ulteriori informazioni sulle differenze tra API e servizi pubblici e privati, consulta Servizi pubblici e privati.
Per la maggior parte dei casi d'uso operativi, il modo più semplice per abilitare e disabilitare i servizi è utilizzare la console Google Cloud. Se devi creare script, puoi anche utilizzare
Google Cloud CLI. Se devi effettuare una programmazione mediante l'API Service Usage, ti consigliamo di utilizzare una delle librerie client da noi fornite. Per sperimentare l'API, puoi seguire le istruzioni alternative in questa guida e utilizzare il comando curl
per testare l'API senza configurare un ambiente di sviluppo dell'applicazione completo.
Prima di iniziare
Per abilitare e disabilitare le API e i servizi, hai bisogno di:
- 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 digcurl
, un alias autenticato per il comandocurl
standard, e la definizione della variabile di ambientePROJECT_NUMBER
.
Attivazione dei servizi
L'abilitazione dei servizi utilizza la quota della metrica di quota serviceusage.googleapis.com/mutate_requests
. La quota predefinita disponibile è di 2 query al secondo (QPS).
console
Per abilitare un'API per un progetto:
- Vai alla pagina Libreria API della console Google Cloud.
Vai alla pagina della libreria API Seleziona il progetto Google Cloud in cui vuoi abilitare un'API 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:
- Fai clic su Seleziona progetto per aprire il browser del progetto Google Cloud.
- Individua il progetto e fai clic sul nome del progetto Google Cloud.
- Fai clic su Apri per aprire il progetto.
Fai clic sull'API che vuoi abilitare. Se hai bisogno di aiuto per trovare l'API, utilizza la casella Cerca API e servizi nella parte superiore della pagina. Viene visualizzata una pagina che descrive l'API.
Fai clic sul pulsante Attiva.
gcloud
Esegui questo comando per abilitare il servizio API Pub/Sub nel progetto attuale:
gcloud services enable pubsub.googleapis.com
Il comando produce un output simile al seguente:
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
Puoi utilizzare il seguente comando per ottenere i dettagli dell'operazione:
gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687
arricciare
Puoi abilitare un singolo servizio utilizzando il metodo services.enable
. Puoi abilitare tra 2 e 20 servizi in una singola operazione utilizzando il metodo services.batchEnable
.
Abilita un singolo servizio
Il seguente comando abilita il servizio API Pub/Sub sul tuo progetto:
gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable"
Il metodo services.enable
restituisce una risorsa operazione di lunga durata, che rappresenta il lavoro in corso sul server. Ogni operazione ha un nome risorsa univoco. Ad esempio, ecco un'operazione
con il nome operations/acf.2e2fcfce-8327-4984-9040-a67777082687
:
{
"name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}
Per eseguire il polling dello stato dell'operazione con il metodo Service Usage
operations.get
passa il nome dell'operazione all'API:
OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"
Abilita più servizi contemporaneamente
Se vuoi abilitare più servizi API nel tuo progetto, puoi inviare un comando di abilitazione per ogni servizio API singolarmente oppure inviare un comando di abilitazione in batch e specificare più API. Ad esempio, per abilitare entrambi i servizi API Pub/Sub e Dataflow nel tuo progetto:
gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable"
Come services.enable
, services.batchEnable
restituisce una risorsa dell'operazione. Puoi eseguire il polling della risorsa utilizzando il relativo name
.
Disabling services
La disabilitazione dei servizi utilizza la quota della metrica della quota serviceusage.googleapis.com/mutate_requests
. La quota predefinita disponibile è di 2 query al secondo (QPS).
Puoi disabilitare un'API per un progetto in qualsiasi momento, anche se le eventuali tariffe in sospeso verranno comunque addebitate al tuo account e ti verranno addebitati i costi per l'uso fatturabile dell'API nei tuoi progetti. Per ulteriori informazioni, consulta API e fatturazione.
Molti servizi come Cloud Storage e BigQuery addebitano un costo per l'archiviazione dei dati. La disabilitazione dell'accesso all'API di un servizio non elimina i dati sottostanti che continueranno a essere fatturati. Se il tuo intento è interrompere l'utilizzo di un servizio e interrompere tutti gli addebiti futuri, assicurati di eliminare tutti i dati associati al servizio prima di disattivare l'accesso all'API del servizio.
console
Per disabilitare un'API per un progetto:
- Vai alla pagina Dashboard delle API della console Google Cloud.
Vai alla pagina Dashboard dell'API Seleziona il progetto Google Cloud in cui vuoi disabilitare un'API 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:
- Fai clic su Seleziona progetto per aprire il browser del progetto Google Cloud.
- Individua il progetto e fai clic sul nome del progetto Google Cloud.
- Fai clic su Apri per aprire il progetto.
Fai clic sull'API da disabilitare. Se hai bisogno di aiuto per trovare l'API, utilizza la casella Cerca API e servizi nella parte superiore della pagina. Viene visualizzata una pagina che descrive l'API.
Fai clic su stop Disabilita API.
gcloud
Esegui questo comando per disabilitare il servizio API Pub/Sub per il progetto attuale:
gcloud services disable pubsub.googleapis.com
Il comando produce un output simile al seguente:
Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete... Operation finished successfully.
Puoi utilizzare il seguente comando per ottenere i dettagli dell'operazione:
gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8
arricciare
Il seguente comando disabilita il servizio API Pub/Sub nel tuo progetto:
gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"
Come services.enable
, services.disable
restituisce una risorsa dell'operazione. Puoi eseguire il polling della risorsa utilizzando il relativo name
.
Passaggi successivi
Per informazioni su come visualizzare e gestire le metriche e i limiti della quota che si applicano al tuo progetto, consulta Gestione delle quote di servizio.