Abilitazione e disabilitazione dei servizi

In questa pagina viene descritto 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, incluse le risorse Servizi Google Cloud e servizi privati creati utilizzando Cloud Endpoints. 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 abilitare e disabilitare 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 fare esperimenti con l'API, puoi seguire le istruzioni alternative in questa guida e utilizzare curl per testare l'API senza configurare uno sviluppo completo dell'applicazione completamente gestito di Google Cloud.

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 corrette per Identity and Access Management. Per informazioni sui requisiti IAM per l'utilizzo del servizio, 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'abilitazione dei servizi utilizza la quota serviceusage.googleapis.com/mutate_requests metrica della quota. Il valore predefinito la quota disponibile è di 2 query al secondo (QPS).

console

Per abilitare un'API per un progetto:

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

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

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

    • Usa il browser del progetto Google Cloud eseguendo queste operazioni 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 attivare. Se hai bisogno di aiuto per trovare l'API, utilizza l'icona 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 services.enable . Puoi abilitare da 2 a 20 servizi in una singola operazione utilizzando services.batchEnable .

Abilita 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 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 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 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"

Come services.enable, services.batchEnable restituisce una risorsa dell'operazione, che puoi eseguire il polling utilizzando il relativo name.

Disabling services

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

Puoi disabilitare un'API per un progetto in qualsiasi momento, anche se eventuali tariffe in sospeso l'addebito verrà effettuato sul 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 di un l'accesso all'API del servizio non elimina i dati sottostanti che continueranno da fatturare. 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.

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 disattivare un'API eseguendo una delle seguenti operazioni:

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

    • Usa il browser del progetto Google Cloud eseguendo queste operazioni 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 disabilitare. Se hai bisogno di aiuto per trovare l'API, utilizza l'icona 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 che si applicano ai tuoi consulta Gestione della quota di servizio.