Abilitazione e disabilitazione dei servizi

Questa pagina descrive come attivare e disattivare i servizi per un progetto Google Cloud. Puoi utilizzare Service Usage per attivare o disattivare 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 attivare e disattivare i servizi è utilizzare la console Google Cloud. 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 progetto Google Cloud. Per scoprire come creare un progetto Google Cloud, 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 Libreria API della console Google Cloud.
   Vai alla pagina Libreria API

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

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

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

     1. Fai clic su Seleziona progetto per aprire il browser dei progetti Google Cloud.
     2. Individua il tuo 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 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.

Per recuperare i dettagli dell'operazione, puoi utilizzare il seguente comando:

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

Disabling services

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 tenti di 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 Dashboard API della console Google Cloud.
   Vai alla pagina Dashboard dell'API

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

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

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

     1. Fai clic su Seleziona progetto per aprire il browser dei progetti Google Cloud.
     2. Individua il tuo 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 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.

Per recuperare i dettagli dell'operazione, puoi utilizzare il seguente comando:

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.