Abilitazione e disabilitazione dei servizi

Questa pagina descrive come attivare e disattivare i servizi per un progetto Google Cloud. Puoi utilizzare l'utilizzo dei servizi per attivare o disattivare qualsiasi servizio disponibile per i tuoi progetti, inclusi i servizi Google Cloud pubblici e i servizi privati creati utilizzando Endpoints Cloud. Per ulteriori informazioni sul differenze tra API e servizi pubblici e privati, vedi 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 a API Service Usage, ti consigliamo di utilizzare una delle librerie client. 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 le API e i servizi, hai bisogno di:

• 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 apprendere sui requisiti IAM per Service Usage, consulta 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 Guida introduttiva. Questi passaggi includono definisce gcurl, che è un alias autenticato per lo standard curl che definisce la variabile di ambiente PROJECT_NUMBER.

Attivazione dei servizi

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

console

Per attivare un'API per un progetto:

1. Vai alla console Google Cloud Libreria API .
   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 del progetto 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 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 attivare un singolo servizio utilizzando il metodo services.enable. Puoi abilitare da 2 a 20 servizi in una singola operazione utilizzando 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"

La services.enable restituisce un Operazione a lunga esecuzione risorsa, 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 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 abilitare più servizi API sul tuo progetto, puoi emettere un comando di abilitazione per ogni servizio API singolarmente, oppure puoi emettere uno di abilitazione in batch 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"

Mi piace services.enable, services.batchEnable restituisce una risorsa dell'operazione, che puoi eseguire il polling utilizzando la relativa name.

Nota: la procedura per attivare le API può variare. Alcune API chiedono di accettare i relativi Termini di servizio prima che tu possa abilitarli. 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 serviceusage.googleapis.com/mutate_requests metrica della quota. 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 pagamento 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 la tua intenzione è interrompere l'utilizzo di un servizio e interrompere tutti i futuri addebiti, assicurati di eliminare tutti i dati associati al servizio prima disattivando l'accesso all'API del servizio.

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 disabilitare genererà 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 disabilitare un'API per un progetto:

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

2. Seleziona il progetto Google Cloud in cui vuoi disabilitare eseguendo una delle operazioni seguenti:

   • 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 del progetto 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. 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 disabilita il servizio API Pub/Sub su il tuo progetto:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"

Mi piace services.enable, services.disable restituisce una risorsa dell'operazione, che puoi eseguire il polling utilizzando la relativa 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.