Como ativar e desativar serviços

Esta página descreve como ativar e desativar serviços em um projeto do Google Cloud. O Service Usage permite ativar ou desativar qualquer serviço disponível para seus projetos, incluindoserviços públicos do Google Cloud e serviços privados criados usando o Cloud Endpoints. Para mais informações sobre as diferenças entre APIs e serviços públicos e privados, consulte Serviços públicos e privados.

Na maioria dos casos de uso operacional, a maneira mais simples de ativar e desativar serviços é usar o console do Google Cloud. Se você precisar criar scripts, também poderá usar a Google Cloud CLI. Se precisar programar com a API Service Usage, recomendamos que você use uma das bibliotecas de clientes fornecidas. Para testar a API, siga as instruções alternativas neste guia e use o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicativo completo.

Antes de começar

Para ativar e desativar APIs e serviços, você precisa dos seguintes itens:

• Um projeto do Google Cloud. Para saber como criar um projeto do Google Cloud, consulte Criar e gerenciar projetos.
• As permissões corretas de Gerenciamento de identidade e acesso. Para aprender mais sobre os requisitos de IAM do Service Usage, consulte Controle de acesso.
• Instale a Google Cloud CLI.
• Se você quiser usar os exemplos curl neste guia, siga as instruções para concluir a configuração inicial em Primeiros passos. Essas etapas incluem a definição de gcurl, que é um alias autenticado do comando curlpadrão, e a definição da variável de ambiente PROJECT_NUMBER.

Ativação dos serviços

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

Console

Para ativar uma API para um projeto, siga estas etapas:

1. Acesse a página Biblioteca de APIs do console do Google Cloud.
   Acesse a página "Biblioteca de APIs"

2. Selecione o projeto do Google Cloud em que você quer ativar uma API executando uma das seguintes ações:

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

   • Para usar o navegador do projeto do Google Cloud, siga estas etapas:

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

3. Clique na API que você pretende ativar. Se você precisar de ajuda para encontrar a API, use a caixa Pesquisar APIs e serviços na parte superior da página. Será exibida uma página descrevendo a API.

4. Clique no botão Ativar.

gcloud

Execute o seguinte comando para ativar o serviço da API Pub/Sub em 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.

Você pode usar o seguinte comando para ver os detalhes da operação:

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

curl

É possível ativar um único serviço usando o método services.enable. É possível ativar entre 2 e 20 serviços em uma única operação usando o método services.batchEnable.

Ativar um único serviço

O comando a seguir 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 retorna um recurso Operação de longa duração, que representa o trabalho em andamento no servidor. Cada operação tem um nome de recurso exclusivo. Por exemplo, veja uma operação com o nome operations/acf.2e2fcfce-8327-4984-9040-a67777082687:

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

Para pesquisar o status da operação usando o método do 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}"

Ativar vários serviços de uma só vez

Se quiser ativar vários serviços de API no seu projeto, você poderá emitir um comando de ativação para cada serviço de API individualmente ou emitir um comando de ativação em lote e especificar várias APIs. Por exemplo, para ativar os serviços da API 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"

Como services.enable, services.batchEnable retorna um recurso de operação, que você pode pesquisar usando o name dele.

Observação: o processo para ativar APIs pode variar. Algumas APIs exigem que você aceite os Termos de Serviço antes de ativá-las. Algumas APIs estão no modo de visualização e exigem uma assinatura especial e listas de permissões antes de serem usadas. Outras APIs podem solicitar informações adicionais, como as informações de contato da organização e o nome do aplicativo que você está desenvolvendo. Quando mais informações forem solicitadas, elas não serão compartilhadas fora do Google. Essas informações serão usadas para ajudar o Google a entender como a API está sendo usada e também servem como um contato secundário, caso seja preciso falar com você sobre o uso do serviço.

Desativação de serviços

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

É possível desativar uma API em um projeto a qualquer momento. Você receberá cobranças sobre qualquer taxa pendente na sua conta e por qualquer uso de API faturável nos seus projetos. Para mais informações, consulte APIs e faturamento.

Muitos serviços, como o Cloud Storage e o BigQuery, cobram para armazenar dados. A desativação do acesso à API de um serviço não exclui os dados subjacentes, que vão continuar sendo faturados. Se você quiser interromper o uso de um serviço e impedir todas as cobranças futuras, exclua todos os dados associados ao serviço antes de desativar o acesso à API dele.

Se você desativar a API GKE, todos os clusters em execução no projeto serão suspensos. Após 30 dias, os clusters suspensos são excluídos. Para restabelecer os clusters suspensos, ative a API GKE. Pode levar até 24 horas para que os clusters sejam restabelecidos.

Observação: na v1 da API, se você tentar desativar um serviço de que outros serviços ativados dependem, a chamada falhará. A chamada de API para desativar o serviço resultará em uma mensagem de erro. Para desativar o serviço especificado e todos os serviços que dependem dele, defina o parâmetro disable_dependent_services na solicitação services.disable como true.

Console

Para desativar uma API em um projeto, siga estas etapas:

1. Acesse a página Painel de APIs do console do Google Cloud.
   Acesse a página "Painel de API"

2. Selecione o projeto do Google Cloud em que você quer desativar uma API executando uma das seguintes ações:

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

   • Para usar o navegador do projeto do Google Cloud, siga estas etapas:

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

3. Clique na API que você pretende desativar. Se você precisar de ajuda para encontrar a API, use a caixa Pesquisar APIs e serviços na parte superior da página. Será exibida uma página descrevendo a API.

4. Clique em Desativar API.

gcloud

Execute o seguinte comando para desativar o serviço da API Pub/Sub no 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.

Você pode usar o seguinte comando para ver os detalhes da operação:

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

curl

O comando a seguir 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"

Como services.enable, services.disable retorna um recurso de operação, que você pode pesquisar usando o name dele.

Próximas etapas

Para saber como visualizar e gerenciar as métricas e os limites de cota que se aplicam ao projeto, consulte Como gerenciar a cota de serviços.