Cotas e limites

Esta página descreve os limites de cota do gateway de API.

Limites em APIs, configurações de APIs e gateways

O gateway de APIs impõe os seguintes limites:

  • APIs: 50 no total
  • Configurações de APIs: 100 por API
  • Gateways: 50 por região

Se você tentar criar uma segunda configuração de API antes da conclusão da primeira configuração da API para uma mesma API, uma ou ambas as configurações poderão não estar disponíveis para uso posterior em um gateway.

Solicitar limites de taxa

Por padrão, é aplicado um limite de taxa de 10.000.000 unidades de cota a cada 100 segundos por projeto de produtor de serviços. Uma unidade de cota é consumida a cada chamada para services.check e a cada operação informada como services.report.

Limites de tamanho do payload

Os limites a seguir se aplicam especificamente ao tamanho máximo do payload para o tráfego por meio de gateways implantados:

Limite Valor
Tamanho da solicitação 32 megabytes
Tamanho da resposta 32 megabytes
Tamanho da resposta da transcodificação do gRPC 1 megabyte
Tamanho da solicitação de transcodificação do gRPC 1 megabyte

O streaming não é compatível.

Limites de tamanho do cabeçalho

Os limites a seguir se aplicam especificamente ao tamanho máximo do cabeçalho para o tráfego por gateways implantados:

Limite Valor
Tamanho dos cabeçalhos de solicitação 60 kilobytes

O serviço de back-end chamado pelo gateway de API pode ter limites mais baixos.

Como aumentar a cota

As solicitações de ajuste de cotas do Cloud estão sujeitas a revisão. Se o pedido de ajuste de cota exigir análise, você vai receber um e-mail confirmando o recebimento da solicitação. Se precisar de mais ajuda, responda ao e-mail. Depois de analisar sua solicitação, você vai receber uma notificação por e-mail indicando se ela foi aprovada. É possível solicitar um ajuste de cota usando o console Google Cloud , a API Cloud Quotas ou a Google Cloud CLI. As instruções a seguir mostram como solicitar um novo valor de cota usando o console Google Cloud ou fazendo uma solicitação REST para a API Cloud Quotas.

Console

Para solicitar um ajuste de cota, siga estas etapas:

  1. No console do Google Cloud , acesse a página IAM e administrador > Cotas e limites do sistema:

    Acesse "Cotas e limites do sistema

    Se for preciso selecionar um projeto, escolha aquele que você quer ajustar.

  2. Encontre a cota que você quer ajustar e abra a caixa de diálogo Mudanças de cota:

    • Cotas que não estão na tabela:

      • Pesquise sua cota na caixa de pesquisa Filtro. Não especifique a região ou a zona (se aplicável), porque as cotas que não têm valores de uso ou ajustados não aparecem na tabela.
      • Encontre uma entrada para sua cota na tabela. Pode ser a entrada padrão ou qualquer entrada com histórico, independente da região ou zona.
      • Na linha da entrada, clique em Mais ações > Configurar mais regiões/zonas.
      • Selecione a região ou zona que você quer ajustar. Clique em Editar.

    • Todas as outras cotas:

      • Pesquise sua cota na caixa de pesquisa Filtro.
      • Na linha da entrada, marque a caixa de seleção da cota.
      • Clique em Editar.

    A caixa de diálogo Mudanças de cota aparece.

  3. Se você vir um link para Inscrever-se para uma cota maior acima do campo Novo valor e quiser aumentar o valor da cota além do número indicado na tela, siga o link. Preencha e envie o formulário, pulando as etapas restantes. Caso contrário, continue seguindo este guia.

  4. No campo Novo valor, insira o valor da cota aumentada que você quer. Se um campo Descrição da solicitação aparecer, insira uma descrição. Clique em Concluído.

    • Se você encontrar uma caixa de seleção com o texto "Entendo que esta solicitação vai remover todas as substituições", isso significa que o valor da cota está definido abaixo do padrão. Ajustar o valor da cota para o padrão ou além dele remove a substituição. Para continuar, marque a caixa de seleção. Saiba mais sobre substituições de cotas.

    Se um botão Avançar aparecer, clique nele e preencha as informações de contato na tela seguinte.

  5. Clique em Enviar solicitação.

Se você não conseguir solicitar um ajuste no console, peça o aumento ao Cloud Customer Care.

Para saber mais sobre como o processo de aumento de cota funciona, consulte Sobre ajustes de cota.

Solicitações em lote para ajustes de cota

É possível agrupar solicitações de ajustes de cota selecionando a caixa de seleção de cada cota que você quer incluir. No entanto, as solicitações em lote podem aumentar o tempo que o Google Cloud leva para analisar sua solicitação.

Para reduzir o tempo de análise, agrupe as solicitações de ajuste de cota por produto e área. Por exemplo, se você quiser solicitar ajustes nas cotas de rede e de VM do Compute Engine, crie uma solicitação para as cotas de rede e outra para as cotas de VM do Compute Engine.

REST

Para solicitar um ajuste de cota da API Cloud Quotas, use o exemplo de código a seguir. Preencha os marcadores editáveis com seus valores. Para saber mais sobre os campos de marcador de posição, consulte as descrições após o exemplo de código.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Substitua:

  • PROJECT_NUMBER: o número do projeto do Google Cloud . Encontre o número do projeto na página Boas-vindas do console Google Cloud ou executando o seguinte comando da CLI gcloud:

    PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"

  • QUOTA_PREFERENCE_ID: o ID da preferência de cota que você está atualizando.

  • QUOTA_ID: o ID da cota que você está atualizando.

  • SERVICE_ID: o ID do Google Cloud a que a cota que você está ajustando pertence. Normalmente, ele tem o formato SERVICE_NAME.googleapis.com. Por exemplo, o nome do serviço Compute Engine é compute.googleapis.com.

  • DIMENSION_1: o tipo de dimensão que você quer ajustar, por exemplo, region ou zone. É possível incluir várias dimensões. Separe cada dimensão seguindo o valor dela, por exemplo, VALUE_1, com uma vírgula. Para ajustar todas as dimensões da cota, omita essa linha.

  • VALUE_1: o valor da dimensão anterior. Por exemplo, se a dimensão anterior for region, insira uma região como us-central1.

  • JUSTIFICATION: o motivo da solicitação.

  • EMAIL: um endereço de e-mail que pode ser usado como um contato, caso o Google Cloud precise de mais informações para tomar uma decisão antes que uma cota extra possa ser concedida.

Exemplo de solicitação

Confira abaixo um exemplo de solicitação de aumento de valor de cota para a cota PUS-PER-GPU-FAMILY-per-project-region do Compute Engine. Ele solicita um valor de cota de 100 para máquinas da família de GPU NVIDIA_H100 que estão na região us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}