Como ativar e desativar APIs

Com a ativação, a API é associada ao projeto atual, páginas de monitoramento são adicionadas e o faturamento é ativado para a API se estiver ativado para o projeto.

Antes de começar

Para ativar uma API é necessário ter as duas permissões do Cloud Identity and Access Management a seguir:

  1. A permissão servicemanagement.services.bind no serviço para ativar. Esta permissão está presente para todos os usuários de serviços públicos. Para serviços particulares, compartilhe o serviço com o usuário que precisa ativá-lo.
  2. A permissão serviceusage.services.enable no projeto para ativar o serviço. Esta permissão está presente no papel de editor e no de administrador do Service Usage.

Se o faturamento não estiver ativado no seu projeto, talvez você não consiga usar algumas APIs até que faça isso. Para mais informações, consulte APIs e faturamento.

Ativar uma API

A maneira mais simples de ativar uma API no projeto é usar o Console do GCP, mas também é possível fazer isso com o gcloud ou a API Service Usage. Saiba mais sobre essas opções na documentação da API Service Usage.

Para ativar uma API no projeto com o console, siga estas etapas:

  1. Acesse a Biblioteca de APIs do Console do GCP.
  2. Na lista de projetos, selecione um projeto ou crie um novo.
  3. Na Biblioteca de APIs, selecione a API que você quer ativar. Se precisar de ajuda para encontrar a API, use o campo de pesquisa e/ou os filtros.
  4. Na página da API, clique em ATIVAR.

Desativar uma API

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

Assim como no processo de ativação, a maneira mais simples de desativar uma API no seu projeto é usar o Console do GCP, mas também é possível fazer isso com o gcloud ou a API Service Usage. Saiba mais sobre essas opções na documentação da API Service Usage.

Para desativar uma API do projeto com o console, siga estas etapas:

  1. Acesse a página do Painel de APIs e serviços do Console do GCP.
  2. Selecione um projeto na lista.
  3. Localize a API que você quer desativar na lista. Na linha da API, à direita das estatísticas, clique em Desativar.
    • Como alternativa, na lista de APIs, clique no nome da API que você quer desativar e depois em stop DESATIVAR API.

APIs e faturamento

O uso de algumas APIs do Google é cobrado, e você precisa ativar o faturamento antes de começar a usá-las. A ativação do faturamento das APIs que seus projetos usam também tem outras vantagens:

  • Em algumas APIs, o uso gratuito é permitido até um limite de cortesia. Em alguns casos, esse limite aumenta quando você ativa o faturamento.
  • Em algumas APIs, mais serviços ficam disponíveis depois que você ativar o faturamento. Por exemplo, quando você ativa o faturamento das APIs BigQuery do Google Cloud Platform, pode criar as próprias tabelas. Se você não ativar o faturamento, estará limitado a conjuntos de dados existentes.

Conceitos de faturamento

  • O faturamento é ativado no nível do projeto, não no nível da API.
  • Se você ativar o faturamento em um projeto, todas as APIs faturáveis dele serão cobradas com base no uso feito pelo projeto.
  • Todo o uso em um projeto é cobrado pelo método de pagamento que você especificar, e é possível mudar para um método diferente a qualquer momento.
  • Não é possível ativar o faturamento somente para algumas APIs. Quando você ativa o faturamento de um projeto, ele se aplica a todas as APIs usadas neste projeto, mesmo que a API esteja desativada no momento.
  • Você é cobrado somente pelo uso de APIs faturáveis.
  • Depois que você ativar o faturamento, todas as solicitações para APIs faturáveis que ultrapassarem o limite do uso de cortesia serão cobradas de acordo com os termos de faturamento de cada API.
  • Para as regras completas de cobrança e uso do Google Cloud Platform, consulte Detalhes de preços do Google Cloud Platform. Para outros detalhes de faturamento de uma API Google, consulte a documentação dessa API.

Mais informações

Para mais informações sobre faturamento, consulte Criar, modificar ou fechar sua conta de faturamento.

Para informações sobre como ativar o faturamento no seu projeto, consulte Modificar as configurações de faturamento de um projeto.

Para ver mais informações sobre como usar uma API ou uma ferramenta de linha de comando para ativar e desativar APIs, consulte Como ativar e desativar serviços na Documentação do Service Usage.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…