Crie um limite de taxa de entrada da REST API

Crie regras de limite de taxa para limitar o número de solicitações de REST API de entrada processadas por hora.

Antes de Iniciar

Função necessária: Rate_limit_admin

Por Que e Quando Desempenhar Esta Tarefa

Defina limites de taxa para todos os usuários, usuários com funções específicas ou todos os usuários.

Nota:

À medida que as solicitações chegam a uma instância, cada nó mantém uma contagem de limite de taxa por usuário. A cada 30 segundos, a contagem é confirmada no banco de dados. Como resultado, uma regra de limite de taxa pode não entrar em vigor por até 30 segundos.

Procedimento

1. Navegar até Tudo > Serviços web do sistema > REST > Regras de Limite de Taxa.
2. Clique em Novo e insira os seguintes valores de campo.

   Tabela 1. Formulário Regra de limite de taxa da REST API

   Campo	Descrição
   Recurso de API REST	Valor derivado dos valores inseridos nos seguintes campos.
   Nome	Nome exclusivo para a regra de limite de taxa.
   API REST	REST API selecionada na lista de todas as REST APIs externas da instância.
   Versão	Versão do REST API . Os valores listados dependem de REST API selecionado.
   Recurso	Recurso para Versão . Os valores listados dependem de Versão selecionado.
   Tabela	Tabela que você deseja direcionar. Aparece somente quando você seleciona API de tabela . REST API .
   Tabela do conjunto de importação	Tabela do conjunto de importação que você deseja direcionar. Aparece somente que você seleciona API do conjunto de importação . REST API .
   Ativo	Marque a caixa para indicar que a regra de limite de taxa está ativa. As regras de limite de taxa são ativadas por padrão assim que são criadas. Você pode desativar as regras de limite de taxa para interromper a aplicação de um limite de taxa ou para ativar regras de limite de taxa para retomar a aplicação de um limite de taxa.
   Limite de solicitação por hora	Número máximo de solicitações permitidas por hora. Nota: Sempre que você atualizar o valor deste campo, o ServiceNow AI Platform redefine a contagem de solicitações como 0 e exclui todas as violações da hora atual.
   Aplicar a	Usuários restritos por esta regra: Usuário único aplica o limite de taxa a um usuário específico. Usuários com função aplica o limite de taxa a todos os usuários com uma função específica. Todos os usuários aplica o limite de taxa a todos os usuários.
   Função	Função à qual o limite de taxa se aplica. Aparece somente quando você seleciona Usuários com função em Aplicar a. campo.
   Usuário	Usuário ao qual o limite de taxa se aplica. Aparece somente quando você seleciona Usuário único em Aplicar a. campo.

3. Clique em Enviar.
   O novo limite de taxa entra em vigor.

O que Fazer Depois

Depois de enviar a regra, o ServiceNow AI Platform adiciona as seguintes listas relacionadas ao registro de regra:

Contagens de limites de taxas

Lista, por usuário, o número de solicitações de REST API de entrada afetadas por esta regra de limite de taxa.

Violações de Limite de Taxa

Lista, por usuário, as violações desta regra de limite de taxa.

Você pode usar essas listas relacionadas para Monitore contagens e violações de limite de taxa da REST API de entrada.