Abilitazione e disabilitazione dei servizi

Questa pagina descrive come attivare e disattivare i servizi per un Google Cloud progetto. Puoi utilizzare l'utilizzo dei servizi per attivare o disattivare qualsiasi servizio disponibile per i tuoi progetti, inclusi i Google Cloud servizi 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 attivare e disattivare i servizi è utilizzare la Google Cloud console. Se devi creare script, puoi utilizzare anche Google Cloud CLI. Se devi programmare per l'API Service Usage, ti consigliamo di utilizzare una delle nostre librerie client fornite. Per eseguire esperimenti con l'API, puoi seguire le istruzioni alternative riportate in questa guida e utilizzare il comando curl per testare l'API senza configurare un ambiente di sviluppo completo delle applicazioni.

Prima di iniziare

Per abilitare e disabilitare API e servizi, devi:

• Un Google Cloud progetto. Per scoprire come creare un Google Cloud progetto, 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.

Attivazione dei servizi

L'attivazione dei servizi utilizza la quota della metrica della quota serviceusage.googleapis.com/mutate_requests. La quota predefinita disponibile è di 2 query al secondo (QPS).

console

Per attivare un'API per un progetto:

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

2. Seleziona il Google Cloud progetto in cui vuoi attivare un'API eseguendo una delle seguenti operazioni:

   • Fai clic su un Google Cloud progetto in Seleziona un progetto recente.

   • Utilizza il Google Cloud browser dei progetti seguendo questa procedura:

     1. Fai clic su Seleziona progetto per aprire il Google Cloud browser dei progetti.
     2. Individua il progetto e fai clic sul Google Cloud nome del progetto.
     3. Fai clic su Apri per aprire il progetto.

3. Fai clic sull'API che vuoi attivare. 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 il seguente comando per abilitare il servizio API Pub/Sub nel tuo progetto corrente:

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

curl

Puoi attivare un singolo servizio utilizzando il metodo services.enable. Puoi attivare da 2 a 20 servizi in un'unica operazione utilizzando il metodo services.batchEnable.

Attivare un singolo servizio

Il seguente comando abilita il servizio API Pub/Sub nel 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 a lunga esecuzione che rappresenta il lavoro in corso sul server. Ogni operazione ha un nome della 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 utilizzando 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}"

Attivare più servizi contemporaneamente

Se vuoi attivare più servizi API nel tuo progetto, puoi emettere un comando di abilitazione per ciascun servizio API singolarmente oppure un comando di abilitazione collettiva e specificare più API. Ad esempio, per attivare 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, che puoi eseguire il polling utilizzando il relativo name.

Nota: la procedura per attivare le API può variare. Alcune API ti chiedono di accettare i relativi Termini di servizio prima di poterle attivare. Alcune API sono in modalità di anteprima e richiedono una registrazione e l'inserimento nella lista consentita speciali prima di poter essere utilizzate. Altre API potrebbero richiedere informazioni aggiuntive, ad esempio i dati di contatto della tua organizzazione e il nome dell'applicazione che stai sviluppando. Quando vengono richieste altre informazioni, queste non verranno condivise al di fuori di Google; vengono utilizzate per aiutare Google a comprendere come viene utilizzata l'API e come contatto secondario se dovessimo contattarti in merito al tuo utilizzo del servizio.

Disattivazione dei servizi

La disattivazione dei servizi utilizza la quota della metrica serviceusage.googleapis.com/mutate_requests. La quota predefinita disponibile è di 2 query al secondo (QPS).

Puoi disattivare un'API per un progetto in qualsiasi momento, anche se eventuali commissioni in sospeso verranno comunque addebitate sul tuo account e ti verrà addebitato l'utilizzo dell'API fatturabile nei tuoi progetti. Per ulteriori informazioni, consulta API e fatturazione.

Molti servizi, come Cloud Storage e BigQuery, richiedono un addebito per l'archiviazione dei dati. La disattivazione dell'accesso all'API di un servizio non comporta l'eliminazione dei dati sottostanti, che continueranno a essere fatturati. Se intendi interrompere l'utilizzo di un servizio e interrompere tutti i caricamenti futuri, assicurati di eliminare tutti i dati associati al servizio prima di disattivare l'accesso all'API del servizio.

Se disattivi l'API GKE, tutti i cluster in esecuzione nel progetto vengono sospesi. Dopo 30 giorni, i cluster sospesi vengono eliminati. Per reintegrare i cluster sospesi, abilita l'API GKE. Potrebbero essere necessarie fino a 24 ore per il reintegro dei cluster.

Nota: nella versione 1 dell'API, se provi a disattivare un servizio da cui dipendono altri servizi attivati, la chiamata non andrà a buon fine. La chiamata API per disattivare il servizio comporterà un messaggio di errore. Per disattivare 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 disattivare un'API per un progetto:

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

2. Seleziona il Google Cloud progetto in cui vuoi disattivare un'API eseguendo una delle seguenti operazioni:

   • Fai clic su un Google Cloud progetto in Seleziona un progetto recente.

   • Utilizza il Google Cloud browser dei progetti seguendo questa procedura:

     1. Fai clic su Seleziona progetto per aprire il Google Cloud browser dei progetti.
     2. Individua il progetto e fai clic sul Google Cloud nome del progetto.
     3. Fai clic su Apri per aprire il progetto.

3. Fai clic sull'API che vuoi disattivare. 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 il seguente comando per disattivare il servizio API Pub/Sub per il progetto corrente:

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

curl

Il seguente comando disattiva 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, che puoi eseguire il polling utilizzando il relativo name.

Passaggi successivi

Per scoprire come visualizzare e gestire le metriche e i limiti delle quote applicabili al tuo progetto, consulta Gestire la quota del servizio.