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 operacionais, a maneira mais simples de ativar e desativar serviços é com 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 deste guia e use o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicativos 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 Como 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.
  • Para instalar 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 dos serviços usa a cota da métrica de cota serviceusage.googleapis.com/mutate_requests. A cota padrão disponível é de duas 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. Para isso, execute 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, execute as seguintes etapas:

      1. Clique em Selecionar projeto para abrir o navegador do projeto do Google Cloud.
      2. Encontre seu projeto e clique no nome dele 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.

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 duas 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 pelo armazenamento de dados. Desativar o acesso à API de um serviço não exclui os dados subjacentes que continuarão sendo cobrados. Se sua intenção for deixar de usar um serviço e interromper todas as cobranças futuras, exclua todos os dados associados ao serviço antes de desativar o acesso à API do serviço.

Console

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

  1. Acesse a página Painel de APIs do console do Google Cloud.
    Acessar a página "Painel de APIs"
  2. Selecione o projeto do Google Cloud em que você quer desativar uma API. Para isso, execute 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, execute as seguintes etapas:

      1. Clique em Selecionar projeto para abrir o navegador do projeto do Google Cloud.
      2. Encontre seu projeto e clique no nome dele 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.