Como limitar o uso da API

Dependendo da API, é possível limitar explicitamente as solicitações de diversas formas, incluindo solicitações por dia, solicitações por 100 segundos e solicitações por 100 segundos por usuário.

Defina limites para regular o uso faturável. Por exemplo, para evitar a cobrança pelo uso além dos limites de cortesia, defina limites de solicitações diárias.

Modificar o número de solicitações

É possível definir limites para todas as solicitações de qualquer API faturável. A maioria das APIs tem limites padrão, mas você pode alterar esse limite até o máximo especificado pelo Google. Em algumas APIs, o limite definido é bem baixo até que você ative o faturamento no seu projeto.

Para visualizar ou alterar os limites da sua API, faça o seguinte:

  1. Acesse a página do Painel de APIs e serviços do Console do GCP.
  2. Na lista de projetos, selecione um projeto ou crie um novo.
  3. Clique no nome da API em que está interessado.
  4. Clique em Cotas.
  5. Na linha da cota que você quer alterar, clique no ícone de edição (edit) e insira a cota total de sua preferência até o limite especificado pelo Google.

Para algumas APIs, é possível solicitar um limite maior por meio de um formulário. Em certas APIs, o acesso a cotas mais altas é permitido somente se o faturamento estiver ativado no projeto.

Como limitar solicitações por segundo por usuário

Para impedir que usuários individuais esgotem sua cota de API, limite o número de solicitações por segundo por usuário. Cada API inclui um limite padrão por usuário, mas é possível modificar esse valor conforme descrito na seção anterior.

Usuários individuais são identificados por um string único. Se você estiver criando um aplicativo no servidor (em que o código de chamada está hospedado em um servidor seu) para fazer solicitações em nome dos usuários, suas solicitações precisam conter o parâmetro quotaUser, conforme descrito abaixo.

Para identificar um usuário, use o parâmetro quotaUser=userID. Esse valor é apenas para a aplicação de cotas de curto prazo, portanto, você não precisa usar um código de usuário real. Escolha qualquer string arbitrário com menos de quarenta caracteres que identifique um usuário de maneira exclusiva.

O parâmetro quotaUser é usado apenas para limitar solicitações por usuário por segundo. Se você não enviar o parâmetro quotaUser, todas as chamadas serão atribuídas às máquinas do seu servidor, caso em que as chamadas não poderão ser limitadas por usuário.

Ver e editar todas as cotas de APIs de um projeto

Para revisar, editar e solicitar limites de cota mais altos para todas as APIs faturáveis de determinado projeto, acesse a página Cotas que está em IAM e administrador.

Para visualizar e editar as cotas de todas as APIs faturáveis do projeto, siga estas etapas:

  1. Acesse a página Cotas do Console do GCP no IAM e administrador.
  2. Na lista de projetos, selecione um projeto ou crie um novo.
    A página "Cotas" do projeto selecionado é exibida e lista um item de linha para cada tipo de cota disponível em cada serviço.
  3. Use os filtros na parte superior da página para ajustar a lista por Tipo de cota, Serviço, Métrica e/ou Local.
  4. Para editar várias cotas, clique em + EDITAR COTAS e marque a caixa de seleção ao lado de cada uma para selecionar uma ou mais cotas para edição. O faturamento precisa estar ativado no projeto para que você possa clicar nas caixas de seleção.
  5. No painel Editar cotas, à direita, preencha o formulário com seu Nome, endereço de e-mail e número de telefone e clique em Próxima.
  6. No painel Editar Cotas, selecione o serviço para expandir a visualização, edite as cotas desse serviço e clique em Concluído.
  7. Repita para editar as cotas de cada um dos serviços selecionados.
    • Um serviço com um ícone de alerta (error) ainda não foi editado.
    • Para adicionar cotas para edição, selecione as cotas na lista da esquerda.
    • Para remover um serviço do painel Editar cotas, clique no ícone de exclusão (delete).
  8. Quando terminar de editar as cotas, clique em Enviar solicitação.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…