Faça a gestão da ativação de serviços

Pré-visualização — Hierarchical service activation

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

A ativação hierárquica de serviços permite-lhe gerir a ativação de serviços que é herdada através da Google Cloud hierarquia de recursos. Para mais informações, consulte a vista geral.

Este documento mostra-lhe como usar a CLI do Google Cloud para gerir a ativação de serviços para projetos, pastas e organizações.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Create or select 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.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

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.

gcloud services enable serviceusage.googleapis.com

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Create or select 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.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

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.

gcloud services enable serviceusage.googleapis.com

1. Se não indicar o Google Cloud recurso que quer gerir, os comandos neste documento são predefinidos para o projeto atual. Por exemplo, o comando gcloud beta services list --enabled devolve uma lista de serviços ativados para o projeto atual.

   Pode obter o ID do projeto atual:

   gcloud config list --format='text(core.project)'

Funções necessárias

Para receber as autorizações de que precisa para gerir a ativação de serviços, peça ao seu administrador que lhe conceda a função de IAM Administrador de utilização de serviços (roles/serviceusage.serviceUsageAdmin) no seu recurso de destino. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para gerir a ativação de serviços. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para gerir a ativação de serviços:

• Apresente serviços:
  • serviceusage.effectivepolicy.get
  • serviceusage.services.list
  • serviceusage.services.get
• Ative os serviços:
  • serviceusage.consumerpolicy.get
  • serviceusage.consumerpolicy.update
  • serviceusage.groups.listExpandedMembers
• Desative os serviços:
  • serviceusage.consumerpolicy.get
  • serviceusage.consumerpolicy.update
  • serviceusage.consumerpolicy.analyze

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Apresentar serviços

Pode listar as APIs e os serviços Google ativados ou disponíveis para um projeto, uma pasta ou uma organização através do comando gcloud beta services list.

A ativação e a disponibilidade dos serviços podem ser herdadas dos antecessores dos recursos. Os serviços ativados de um recurso incluem serviços ativados no próprio recurso e ativados em todos os antecessores do recurso.

Nota: os serviços ocultos na versão anterior de utilização de serviços podem agora aparecer na lista de serviços ativados quando usar a ativação hierárquica de serviços. Isto não significa necessariamente que foram ativadas recentemente. Se necessário, pode desativá-los.

Projeto

gcloud beta services list --enabled \
    --project=PROJECT_ID

Substitua PROJECT_ID pelo seu Google Cloud ID do projeto. Em alternativa, omita a flag para usar o projeto atual como predefinição.

Pasta

gcloud beta services list --enabled \
    --folder=FOLDER_ID

Substitua FOLDER_ID pelo seu Google Cloud ID da pasta.

Organização

gcloud beta services list --enabled \
    --organization=ORGANIZATION_ID

Substitua ORGANIZATION_ID pelo Google Cloud ID do recurso da organização.

Tenha em conta o seguinte:

• Tem de especificar uma das seguintes flags:

  • --available para apresentar os serviços que podem ser ativados para consumo.
  • --enabled para apresentar uma lista dos serviços que estão ativados para consumo.

• Pode usar outras flags para filtrar e limitar os serviços apresentados.

Ative os serviços

Pode ativar um ou mais serviços para um projeto, uma pasta ou uma organização através do comando gcloud beta services enable.

Este comando atualiza o ConsumerPolicy no recurso de destino. Para mais informações, consulte Faça a gestão das políticas do consumidor.

Projeto

gcloud beta services enable SERVICE \
    --project=PROJECT_ID

Substitua o seguinte:

• SERVICE: o nome do serviço que quer ativar. Para ativar vários serviços, use nomes de serviços delimitados por espaços. Por exemplo, o seguinte comando ativa os serviços de chaves de API e do BigQuery: gcloud beta services enable apikeys.googleapis.com bigquery.googleapis.com.
• PROJECT_ID: o seu Google Cloud ID do projeto. Em alternativa, omita a flag para usar o projeto atual como predefinição.

Pasta

gcloud beta services enable SERVICE \
    --folder=FOLDER_ID

Substitua o seguinte:

• SERVICE: o nome do serviço que quer ativar. Para ativar vários serviços, use nomes de serviços delimitados por espaços, por exemplo: gcloud beta services enable apikeys.googleapis.com bigquery.googleapis.com.
• FOLDER_ID: o seu Google Cloud ID da pasta.

Organização

gcloud beta services enable SERVICE \
    --organization=ORGANIZATION_ID

Substitua o seguinte:

• SERVICE: o nome do serviço que quer ativar. Para ativar vários serviços, use nomes de serviços delimitados por espaços, por exemplo: gcloud beta services enable apikeys.googleapis.com bigquery.googleapis.com.
• ORGANIZATION_ID: o Google Cloud ID do recurso da sua organização.

Bandeiras suportadas:

• --async para retornar imediatamente, sem aguardar a conclusão da operação em curso.

• --skip-dependency para ignorar a ativação de dependências de serviços. Caso contrário, todas as dependências de serviços estão ativadas por predefinição.

  Pode inspecionar as dependências de serviços. Para mais informações, consulte o artigo Liste as dependências de serviços.

• --validate-only para validar a ativação sem realizar efetivamente a operação.

Tenha em conta o seguinte:

• Se tentar ativar um serviço que já está ativado, recebe um erro a indicar que o serviço já está ativado e presente na política do consumidor. (Se o serviço já estiver ativado, mas as respetivas dependências não, o comando é bem-sucedido.)

• Se ativar um serviço ao nível da pasta ou da organização, a restrição da política da organização constraints/serviceuser.services pode não funcionar como esperado. Em alternativa, recomendamos que use a restrição Restrict Resource Service Usage. Para mais informações, consulte o artigo Restringir a utilização de recursos.

• Google Cloud cria e gere contas de serviço para muitos Google Cloud serviços. Estas contas de serviço são conhecidas como agentes de serviço. Se encontrar um erro service account not found, pode ter de criar um agente de serviço através do comando gcloud beta services identity create.

Desative serviços

Pode desativar um ou mais serviços para um projeto, uma pasta ou uma organização através do comando gcloud beta services disable.

Este comando atualiza o ConsumerPolicy no recurso de destino. Para mais informações, consulte Faça a gestão das políticas do consumidor.

Nota: os recursos existentes podem impedir a desativação de um serviço. Pode eliminar estes recursos e tentar desativar o serviço novamente. Em alternativa, pode restringir a utilização de recursos através de uma restrição de política da organização.

Projeto

gcloud beta services disable SERVICE \
    --project=PROJECT_ID

Substitua o seguinte:

• SERVICE: o nome do serviço que quer desativar. Para desativar vários serviços, use nomes de serviços delimitados por espaços, por exemplo: gcloud beta services disable apikeys.googleapis.com bigquery.googleapis.com.
• PROJECT_ID: o seu Google Cloud ID do projeto. Em alternativa, omita a flag para usar o projeto atual como predefinição.

Pasta

gcloud beta services disable SERVICE \
    --folder=FOLDER_ID

Substitua o seguinte:

• SERVICE: o nome do serviço que quer desativar. Para desativar vários serviços, use nomes de serviços delimitados por espaços, por exemplo: gcloud beta services disable apikeys.googleapis.com bigquery.googleapis.com.
• FOLDER_ID: o seu Google Cloud ID da pasta.

Organização

gcloud beta services disable SERVICE \
    --organization=ORGANIZATION_ID

Substitua o seguinte:

• SERVICE: o nome do serviço que quer desativar. Para desativar vários serviços, use nomes de serviços delimitados por espaços, por exemplo: gcloud beta services disable apikeys.googleapis.com bigquery.googleapis.com.
• ORGANIZATION_ID: o Google Cloud ID do recurso da sua organização.

Bandeiras suportadas:

• --async para retornar imediatamente, sem aguardar a conclusão da operação em curso.

• --bypass-api-usage-check para ignorar as verificações de utilização. Caso contrário, o sistema devolve um erro se o serviço que quer desativar tiver sido usado nos últimos 30 dias ou ativado nos últimos 3 dias.

• Pode especificar uma das seguintes flags:

  • --bypass-dependency-service-check para ignorar a verificação de dependências; todos os serviços ativados que dependem do serviço que está a desativar permanecem ativados.
  • --disable-dependency-services para continuar com a desativação do serviço e de todos os serviços ativados que dependem do serviço que está a desativar.

  Pode inspecionar as dependências de serviços. Para mais informações, consulte o artigo Liste as dependências de serviços.

• --force para continuar, mesmo que existam serviços ativados que dependam do serviço, ou o serviço tenha sido usado nos últimos 30 dias, ou ativado nos últimos 3 dias. Todos os serviços dependentes também são desativados.

  As flags --bypass-api-usage-check, --bypass-dependency-service-check e --disable-dependency-services têm todas prioridade sobre a flag --force.

  A utilização das flags --disable-dependency-services e --bypass-api-usage-check é equivalente à utilização da flag --force. O serviço e as respetivas dependências são desativados sem verificar a respetiva utilização.

• --validate-only para validar a desativação sem executar efetivamente a operação.

Exemplos

Ativar um serviço

• Ativar o serviço BigQuery sem as respetivas dependências:

  gcloud beta services enable bigquery.googleapis.com --skip-dependency

  Saída:

  Operation [operations/ucpat.p39-581601899707-73a57d57-aa46-4d0b-a5ee-57034a42f2b3] complete. Result: {
        "@type":"type.googleapis.com/google.api.serviceusage.with Hierarchical Service Activationbeta.ConsumerPolicy",
        "createTime":"2025-01-31T20:17:37.272343Z",
        "enableRules":[
            {
                "services":[
                    "services/apikeys.googleapis.com",
                    "services/compute.googleapis.com",
                    "services/oslogin.googleapis.com",
                    "services/serviceusage.googleapis.com",
                    "services/bigquery.googleapis.com"
                ]
            }
        ],
        "etag":"W/\"W9nsVJK0V1m7ee7tM7pFDg==\"",
        "name":"projects/PROJECT_ID/consumerPolicies/default",
        "updateTime":"2025-09-11T23:05:22.758394Z"
    }

• Ativar o serviço BigQuery com as respetivas dependências:

  gcloud beta services enable bigquery.googleapis.com

  Saída:

  Operation [operations/ucpat.p39-581601899707-73192b0f-053c-46ee-911a-7eca6b8fe899] complete. Result: {
        "@type":"type.googleapis.com/google.api.serviceusage.with Hierarchical Service Activationbeta.ConsumerPolicy",
        "createTime":"2025-01-31T20:17:37.272343Z",
        "enableRules":[
            {
                "services":[
                    "services/apikeys.googleapis.com",
                    "services/compute.googleapis.com",
                    "services/oslogin.googleapis.com",
                    "services/serviceusage.googleapis.com",
                    "services/cloudresourcemanager.googleapis.com",
                    "services/dataplex.googleapis.com",
                    "services/bigquery.googleapis.com",
                    "services/bigquerystorage.googleapis.com",
                    "services/bigqueryconnection.googleapis.com",
                    "services/analyticshub.googleapis.com",
                    "services/bigquerymigration.googleapis.com",
                    "services/dataform.googleapis.com",
                    "services/bigquerydatapolicy.googleapis.com",
                    "services/bigquerydatatransfer.googleapis.com",
                    "services/bigqueryreservation.googleapis.com"
                ]
            }
        ],
        "etag":"W/\"FDXMAIdsBW7BrXjL7oP6FA==\"",
        "name":"projects/PROJECT_ID/consumerPolicies/default",
        "updateTime":"2025-09-12T19:44:23.675769Z"
    }

Desativar um serviço

• A tentar desativar o serviço BigQuery com dependências ativas:

  gcloud beta services disable bigquery.googleapis.com

  Mensagem de erro:

  ERROR: (gcloud.beta.services.disable) The services are depended on by the following active service(s) {"bigquery.googleapis.com": ["services/bigquerystorage.googleapis.com"]} . Please remove the active dependent services or provide the --disable-dependency-services flag to disable them, or --bypass-dependency-service-check to ignore this check.

• Tentativa de desativar o serviço BigQuery com utilização recente:

  gcloud beta services disable bigquery.googleapis.com --disable-dependency-services

  Mensagem de erro:

  ERROR: (gcloud.beta.services.disable) The operation "operations/ucpat.p39-581601899707-d35c2e2b-d2a3-47af-a1c0-033ed65df236" resulted in a failure "The services bigquery.googleapis.com,bigquerystorage.googleapis.com have usage in the last 30 days or were enabled in the past 3 days. Please specify force if you want to proceed with the destructive policy change.

• Desativar o serviço BigQuery e as respetivas dependências e ignorar a verificação de utilização:

  gcloud beta services disable bigquery.googleapis.com --disable-dependency-services --bypass-api-usage-check

  Saída:

  Operation [operations/ucpat.p39-581601899707-5c02aa04-7ad7-4eb6-a6a1-dc68653bcdb4] complete. Result: {
      "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy",
      "createTime":"2025-01-31T20:17:37.272343Z",
      "enableRules":[
          {
              "services":[
                  "services/analyticshub.googleapis.com",
                  "services/apikeys.googleapis.com",
                  "services/bigqueryconnection.googleapis.com",
                  "services/bigquerydatapolicy.googleapis.com",
                  "services/bigquerydatatransfer.googleapis.com",
                  "services/bigquerymigration.googleapis.com",
                  "services/bigqueryreservation.googleapis.com",
                  "services/cloudresourcemanager.googleapis.com",
                  "services/compute.googleapis.com",
                  "services/dataform.googleapis.com",
                  "services/dataplex.googleapis.com",
                  "services/oslogin.googleapis.com",
                  "services/serviceusage.googleapis.com"
              ]
          }
      ],
      "etag":"W/\"TqbPaELDHlZQOj7As1P06g==\"",
      "name":"projects/PROJECT_ID/consumerPolicies/default",
      "updateTime":"2025-09-30T21:39:40.746125Z"
  }

O que se segue?

• Para gerir políticas, consulte o artigo Gerir políticas do consumidor.
• Para inspecionar as dependências de serviços, consulte o artigo Liste as dependências de serviços.