Attivare e disattivare i 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 pubblici Google Cloud e i servizi privati creati utilizzando Cloud Endpoints. Per saperne di più sulle differenze tra servizi e API 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 in base all'API Service Usage, ti consigliamo di utilizzare una delle nostre librerie client fornite. Per sperimentare 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 dell'applicazione.

Prima di iniziare

Per abilitare e disabilitare API e servizi, devi:

• Un Google Cloud progetto. Per scoprire come creare un progetto Google Cloud , consulta la pagina Creare e gestire progetti.
• Le autorizzazioni Identity and Access Management corrette. Per informazioni sui requisiti IAM per Service Usage, vedi Controllo dell'accesso.
• 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 in Per iniziare. Questi passaggi includono la definizione di gcurl, che è un alias autenticato per il comando standard curl e la definizione della variabile di ambiente PROJECT_NUMBER.

Attivazione dei servizi

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

console

Per abilitare un'API per un progetto:

1. Vai alla pagina Google Cloud della libreria API della console.
   Vai alla pagina 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 nella sezione Seleziona un progetto recente.

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

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

curl

Puoi abilitare un singolo servizio utilizzando il metodo services.enable. Puoi attivare da 2 a 20 servizi in una singola operazione utilizzando il metodo services.batchEnable.

Attivare 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 a lunga esecuzione, 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 utilizzando il metodo operations.get dell'API Service Usage, trasmetti 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 abilitare più servizi API nel tuo progetto, puoi eseguire un comando di abilitazione per ogni servizio API singolarmente oppure puoi eseguire un comando di abilitazione batch e specificare più API. Ad esempio, per abilitare i servizi API Pub/Sub e Dataflow sul 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 di operazione, di cui puoi eseguire il polling utilizzando il relativo name.

Nota: la procedura per attivare le API può variare. Alcune API ti chiedono di accettare i Termini di servizio prima di poterle attivare. Alcune API sono in modalità di anteprima e richiedono una registrazione e un inserimento nella lista consentita speciali prima di poter essere utilizzate. Altre API potrebbero richiedere informazioni aggiuntive, come i dati di contatto della tua organizzazione e il nome dell'applicazione che stai sviluppando. Quando vengono richieste ulteriori informazioni, queste non vengono condivise al di fuori di Google. Vengono utilizzate per aiutare Google a comprendere come viene utilizzata l'API e come contatto secondario nel caso in cui 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 disponibile predefinita è di 2 query al secondo (QPS).

Puoi disattivare un'API per un progetto in qualsiasi momento, anche se le eventuali tariffe in attesa verranno comunque addebitate al tuo account e ti verranno addebitati eventuali utilizzi fatturabili dell'API nei tuoi progetti. Per ulteriori informazioni, vedi API e fatturazione.

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

Se disabiliti 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. Il reintegro dei cluster può richiedere fino a 24 ore.

Nota: nella versione 1 dell'API, se tenti di disattivare un servizio da cui dipendono altri servizi attivi, la chiamata non andrà a buon fine. La chiamata API per disattivare il servizio genererà un messaggio di errore. Per disattivare il servizio specificato e tutti i servizi che dipendono da questo, 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 della dashboard delle 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 nella sezione Seleziona un progetto recente.

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

     1. Fai clic su Seleziona progetto per aprire il browser dei progetti Google Cloud .
     2. Trova 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 questo comando per disattivare il servizio API Pub/Sub per il tuo 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

curl

Il seguente comando disabilita il servizio API Pub/Sub sul 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 di operazione, di cui puoi eseguire il polling utilizzando il relativo name.