Ativar e desativar serviços

Esta página descreve como ativar e desativar serviços para um Google Cloud projeto. Pode usar a utilização de serviços para ativar ou desativar qualquer serviço disponível para os seus projetos, incluindo Google Cloud serviços públicos e serviços privados criados com o Cloud Endpoints. Para mais informações sobre as diferenças entre APIs e serviços públicos e privados, consulte o artigo Serviços públicos e privados.

Para a maioria dos exemplos de utilização operacional, a forma mais simples de ativar e desativar serviços é usar a Google Cloud consola. Se precisar de criar scripts, também pode usar a Google Cloud CLI. Se precisar de programar com base na API Service Usage, recomendamos que use uma das nossas bibliotecas cliente fornecidas. Para experimentar a API, pode seguir as instruções alternativas neste guia e usar o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicações completo.

Antes de começar

Para ativar e desativar APIs e serviços, precisa de:

• Um Google Cloud projeto. Para saber como criar um Google Cloud projeto, consulte o artigo Criar e gerir projetos.
• As autorizações corretas de gestão de identidade e de acesso. Para saber mais acerca dos requisitos da IAM para a utilização de serviços, consulte o artigo Controlo de acesso.
• Para instalar a CLI do Google Cloud.
• Se quiser usar os exemplos curl neste guia, certifique-se de que segue as instruções para concluir a configuração inicial em Introdução. Estes passos incluem a definição de gcurl, que é um alias autenticado para o comando curl padrão, e a definição da variável de ambiente PROJECT_NUMBER.

Ativar serviços

A ativação de serviços usa a quota da serviceusage.googleapis.com/mutate_requests métrica de quota. A quota disponível predefinida é de 2 consultas por segundo (CPS).

consola

Para ativar uma API para um projeto:

1. Aceda à página da Biblioteca de APIs da Google Cloud consola.
   Aceda à página da biblioteca de APIs

2. Selecione o Google Cloud projeto onde quer ativar uma API através de um dos seguintes procedimentos:

   • Clique num Google Cloud projeto em Selecionar um projeto recente.

   • Use o Google Cloud explorador de projetos seguindo os passos seguintes:

     1. Clique em Selecionar projeto para abrir o Google Cloud explorador de projetos.
     2. Encontre o seu projeto e, de seguida, clique no Google Cloud nome do projeto.
     3. Clique em Abrir para abrir o projeto.

3. Clique na API que quer ativar. Se precisar de ajuda para encontrar a API, use a caixa Pesquisar APIs e serviços junto à parte superior da página. É apresentada uma página a descrever a API.

4. Clique no botão Ativar.

gcloud

Execute o seguinte comando para ativar o serviço da API Pub/Sub no seu projeto atual:

gcloud services enable pubsub.googleapis.com

O comando produz um resultado semelhante ao seguinte:

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Pode usar o seguinte comando para obter os detalhes da operação:

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

Pode ativar um único serviço através do método services.enable. Pode ativar entre 2 e 20 serviços numa única operação através do método services.batchEnable.

Ative um único serviço

O seguinte comando ativa o serviço da API Pub/Sub no seu projeto:

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

O método services.enable devolve um recurso de operação de longa duração, que representa o trabalho em curso no servidor. Cada operação tem um nome do recurso exclusivo. Por exemplo, aqui está uma operação com o nome operations/acf.2e2fcfce-8327-4984-9040-a67777082687:

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

Para verificar o estado de execução através do método Service Usage operations.get, transmita o nome da operação à API:

OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

Ative vários serviços em simultâneo

Se quiser ativar vários serviços de API no seu projeto, pode emitir um comando de ativação para cada serviço de API individualmente ou pode emitir um comando de ativação em lote e especificar várias APIs. Por exemplo, para ativar os serviços de API do Pub/Sub e Dataflow no seu projeto:

gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable"

Tal como services.enable, services.batchEnable devolve um recurso de operação, que pode sondar através do respetivo name.

Nota: o processo de ativação de APIs pode variar. Algumas APIs pedem-lhe que aceite os respetivos Termos de Utilização antes de as poder ativar. Algumas APIs estão no modo de pré-visualização e requerem uma inscrição especial e a adição à lista de autorizações antes de poder usá-las. Outras APIs podem pedir informações adicionais, como as informações de contacto da sua organização e o nome da aplicação que está a desenvolver. Quando são pedidas mais informações, estas não são partilhadas fora da Google. São utilizadas para ajudar a Google a compreender como a API está a ser usada e como contacto secundário caso necessitemos de entrar em contacto consigo relativamente à sua utilização do serviço.

Desativar serviços

A desativação de serviços usa a quota da serviceusage.googleapis.com/mutate_requests métrica de quota. A quota disponível predefinida é de 2 consultas por segundo (CPS).

Pode desativar uma API para um projeto em qualquer altura, embora quaisquer taxas pendentes continuem a ser cobradas à sua conta, e a utilização de APIs faturáveis nos seus projetos seja cobrada. Para mais informações, consulte o artigo APIs e faturação.

Muitos serviços, como o Cloud Storage e o BigQuery, cobram pelo armazenamento de dados. Desativar o acesso à API de um serviço não elimina os dados subjacentes, que continuam a ser faturados. Se a sua intenção for descontinuar a utilização de um serviço e parar todas as cobranças futuras, certifique-se de que elimina todos os dados associados ao serviço antes de desativar o acesso à API do serviço.

Se desativar a API GKE, todos os clusters em execução no projeto ficam suspensos. Após 30 dias, os clusters suspensos são eliminados. Para repor os clusters suspensos, ative a API GKE. A reposição dos clusters pode demorar até 24 horas.

Nota: na v1 da API, se tentar desativar um serviço do qual outros serviços ativados dependem, a chamada falha. A chamada da API para desativar o serviço vai resultar numa mensagem de erro. Para desativar o serviço especificado e todos os serviços que dependem dele, defina o parâmetro disable_dependent_services no pedido services.disable como true.

consola

Para desativar uma API para um projeto:

1. Aceda à página do painel de controlo da API da Google Cloud consola.
   Aceda à página do painel de controlo da API

2. Selecione o Google Cloud projeto onde quer desativar uma API através de um dos seguintes procedimentos:

   • Clique num Google Cloud projeto em Selecionar um projeto recente.

   • Use o Google Cloud explorador de projetos seguindo os passos seguintes:

     1. Clique em Selecionar projeto para abrir o Google Cloud explorador de projetos.
     2. Encontre o seu projeto e, de seguida, clique no Google Cloud nome do projeto.
     3. Clique em Abrir para abrir o projeto.

3. Clique na API que quer desativar. Se precisar de ajuda para encontrar a API, use a caixa Pesquisar APIs e serviços junto à parte superior da página. É apresentada uma página a descrever a API.

4. Clique em Desativar API.

gcloud

Execute o seguinte comando para desativar o serviço da API Pub/Sub para o seu projeto atual:

gcloud services disable pubsub.googleapis.com

O comando produz um resultado semelhante ao seguinte:

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

Pode usar o seguinte comando para obter os detalhes da operação:

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

O seguinte comando desativa o serviço da API Pub/Sub no seu projeto:

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

Tal como services.enable, services.disable devolve um recurso de operação, que pode sondar através do respetivo name.