Attivare e disattivare i servizi

Puoi utilizzare Service Usage per abilitare o disabilitare qualsiasi servizio disponibile per i tuoi Google Cloud progetti. Sono inclusi i servizi pubblici Google Cloud e i servizi privati creati con Cloud Endpoints. Per scoprire di più sulle differenze tra servizi pubblici e privati, consulta Servizi pubblici e privati.

La maggior parte degli utenti può attivare e disattivare i servizi con la console Google Cloud . Per gli script, utilizza Google Cloud CLI. Per accedere all'API Service Usage in modo programmatico, ti consigliamo di utilizzare una libreria client. Per provare l'API, puoi inviare una richiesta senza configurare un ambiente di sviluppo completo.

Per i limiti di quota di Service Usage, consulta Quote e limiti. Potresti voler limitare l'utilizzo fatturabile. A seconda dell'API, puoi limitare esplicitamente le richieste.

Prima di iniziare

Prima di attivare e disattivare i servizi, devi configurare il tuo progetto e il tuo ambiente per Service Usage.Google Cloud

Console

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

gcloud

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Abilita l'API Service Usage:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

gcloud services enable serviceusage.googleapis.com

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Abilita l'API Service Usage:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

gcloud services enable serviceusage.googleapis.com

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per attivare e disattivare i servizi, chiedi all'amministratore di concederti il ruolo IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Attivazione di un servizio

La procedura per attivare un servizio può variare. Alcune API ti chiedono di accettare prima i Termini di servizio o sono in anteprima e richiedono l'approvazione prima di poterle utilizzare. Altre API potrebbero richiedere informazioni aggiuntive, come i dati di contatto della tua organizzazione e il nome della tua applicazione. Le informazioni richieste rimangono riservate all'interno di Google. Lo utilizziamo per comprendere l'utilizzo dell'API e per contattarti se necessario.

Console

1. Nella console Google Cloud , vai alla pagina API e servizi > Libreria API.

   Vai alla libreria API

2. Seleziona un progetto recente o utilizza il selettore di risorse nella barra degli strumenti della console per selezionare il progetto Google Cloud in cui vuoi abilitare un'API.

3. Fai clic sull'API che vuoi abilitare o cercala utilizzando la casella Cerca API e servizi.

4. Fai clic su Attiva.

gcloud

Il comando gcloud services enable abilita un servizio con il nome specificato per il progetto corrente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• SERVICE: il nome del servizio che vuoi attivare.

Esegui il comando gcloud services enable:

Linux, macOS o Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

Dovresti ricevere una risposta simile alla seguente:

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Per abilitare più servizi, utilizza nomi di servizi separati da spazi. Ad esempio, il seguente comando abilita i servizi BigQuery e Pub/Sub:

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

Per recuperare i dettagli dell'operazione, utilizza il comando gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Sostituisci OPERATION_ID con l'ID operazione che hai ricevuto in risposta alla richiesta originale.

API REST

Attivare un singolo servizio

Per abilitare un singolo servizio, utilizza il metodo services.enable.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: il tuo Google Cloud ID progetto.
• SERVICE: il nome del servizio che vuoi attivare.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation appena creata:

{
  "name": "operations/OPERATION_ID"
}

Attivare più servizi

Per attivare fino a 20 servizi in una singola operazione, utilizza il metodo services.batchEnable.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: il tuo Google Cloud ID progetto.
• SERVICE1: il nome di un servizio che vuoi attivare.
• SERVICE2: il nome di un altro servizio che vuoi attivare.

Corpo JSON della richiesta:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

Quindi esegui questo comando per inviare la richiesta REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory corrente:

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi esegui questo comando per inviare la richiesta REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation appena creata:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

Disattivazione di un servizio

Puoi disabilitare un'API per un progetto in qualsiasi momento. Tuttavia, ti verranno comunque addebitati eventuali commissioni in sospeso e l'utilizzo fatturabile delle API nei tuoi progetti. Per saperne di più, consulta la guida Guida introduttiva per le API Cloud.

Molti servizi, come Cloud Storage e BigQuery, addebitano costi per l'archiviazione dei dati. La disattivazione dell'API di un servizio non comporta l'eliminazione dei dati e continuerai a ricevere le fatture. Per interrompere gli addebiti futuri e l'utilizzo di un servizio, elimina tutti i dati associati prima di disabilitarne l'API.

Se disabiliti l'API Google Kubernetes Engine, i cluster in esecuzione nel progetto vengono sospesi. Dopo 30 giorni, questi cluster sospesi vengono eliminati. Per riattivare i tuoi cluster, riabilita l'API GKE. Il reintegro dei cluster può richiedere fino a 24 ore. Per saperne di più, consulta Ciclo di vita del cluster.

Nota: se provi a disabilitare un servizio da cui dipendono altri servizi abilitati, la richiesta non andrà a buon fine e verrà restituito un errore. Per disabilitare il servizio specificato e tutti i servizi che dipendono da questo, imposta il parametro disableDependentServices nella richiesta services.disable su true.

Console

1. Nella console Google Cloud , vai alla pagina API e servizi > Libreria API.

   Vai alla libreria API

2. Seleziona un progetto recente o utilizza il selettore di risorse nella barra degli strumenti della console per selezionare il progetto Google Cloud in cui vuoi disattivare un'API.

3. Fai clic sull'API che vuoi disattivare o cercala utilizzando la casella Cerca API e servizi.

4. Fai clic su Disabilita API.

gcloud

Il comando gcloud services disable disabilita un servizio con il nome specificato per il progetto corrente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

• SERVICE: il nome del servizio che vuoi disattivare.

Esegui il comando gcloud services disable:

Linux, macOS o Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

Dovresti ricevere una risposta simile alla seguente:

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Per disattivare più servizi, utilizza nomi di servizi delimitati da spazi. Ad esempio, il seguente comando disattiva i servizi BigQuery e Pub/Sub:

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

Per recuperare i dettagli dell'operazione, utilizza il comando gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Sostituisci OPERATION_ID con l'ID operazione che hai ricevuto in risposta alla richiesta originale.

API REST

Per disabilitare un servizio, utilizza il metodo services.disable.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: il tuo Google Cloud ID progetto.
• SERVICE: il nome del servizio che vuoi disattivare.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation appena creata:

{
  "name": "operations/OPERATION_ID"
}

Controllare lo stato di un'operazione a lunga esecuzione

L'utilizzo del metodo di attivazione o disattivazione restituisce un'operazione (LRO) a lunga esecuzione. L'LRO monitora lo stato della richiesta e indica se la modifica al servizio è stata completata.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

OPERATION_ID: l'identificatore dell'operazione. Ricevi questo ID nella risposta alla tua richiesta originale.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

Quando il campo done è impostato su true, l'operazione è completata.