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 di gcurl, un alias autenticato per il comando curl standard, e la definizione della variabile di ambiente PROJECT_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:

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

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

     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.

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

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

Nota: la procedura di abilitazione delle API può variare. Alcune API chiedono di accettare i rispettivi Termini di servizio prima di poter essere attivate. Alcune API sono in modalità di anteprima e richiedono un'iscrizione e una lista consentita speciali prima di poterle utilizzare. Altre API potrebbero richiedere informazioni aggiuntive, ad esempio i dati di contatto della tua organizzazione e il nome dell'applicazione che stai sviluppando. Se vengono richieste ulteriori informazioni, non vengono condivise all'esterno di Google, ma per aiutare Google a capire come viene utilizzata l'API e come contatto secondario nel caso in cui dovessimo contattarti in merito all'utilizzo del servizio da parte tua.

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.

Nota: nella versione 1 dell'API, se tenti di disabilitare un servizio da cui dipendono altri servizi abilitati, la chiamata avrà esito negativo. La chiamata API per disabilitare il servizio genererà un messaggio di errore. Per disabilitare il servizio specificato e tutti i servizi che dipendono da esso, imposta il parametro disable_dependent_services nella richiesta services.disable su true.

console

Per disabilitare un'API per un progetto:

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

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

     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.

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

4. Fai clic su 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.