Limitação de taxa da API REST de entrada

Para evitar solicitações excessivas de API REST de entrada, defina regras que limitem o número de solicitações de API REST de entrada processadas por hora. Você pode criar regras para limitar solicitações de usuários específicos, usuários com funções específicas ou todos os usuários.

As regras de limite de taxa são criadas na tabela Regras de limite de taxa [sys_rate_limit_rules].

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.

Prioridade de limitação de taxa

Se uma solicitação de API REST de entrada corresponder a várias regras de limite de taxa para o mesmo recurso, a prioridade de limitação de taxa será imposta da seguinte forma:

• Conjunto de regras para Usuário único substituir regras para Todos os usuários e regras para Usuários com função .
• Conjunto de regras para Usuários com função substituir regras para Todos os usuários .

Neste exemplo, há quatro regras de limite de taxa para o recurso da REST API OBTENHA /now/v2/table/incident .

Estas regras de limite de taxa são aplicadas na seguinte ordem:

1. Limitar incidentes por usuário Aplica-se ao usuário de ITIL, que pode enviar até 200 solicitações por hora.
2. Limitar incidentes por administrador de importação aplica-se a todos os usuários com a função import_admin. Cada usuário com a função import_admin pode enviar até 500 solicitações por hora.
3. Limite incidentes por itil aplica-se a todos os usuários com a função itil. Cada usuário com a função itil pode enviar até 100 solicitações por hora.
4. Limitar incidentes aplica-se a todos os usuários. Cada usuário pode enviar até 100 solicitações por hora.

Quando o usuário de ITIL faz a solicitação OBTENHA /now/v2/table/incident , a solicitação corresponde aos critérios de três regras: Limitar incidentes , Limite incidentes por itil e. Limitar incidentes por usuário . Apenas o. Limitar incidentes por usuário a regra é aplicada porque tem precedência sobre as outras regras. Como resultado, o usuário de ITIL pode enviar no máximo 200 solicitações por hora.

Se um usuário tiver duas ou mais funções correspondentes aos critérios de várias regras de limitação de taxa para um recurso da REST API, a regra que permite o menor número de solicitações se aplicará às solicitações do usuário para o recurso. Para as regras de exemplo na figura acima, suponha que o usuário abel tuter tenha a função import_admin e a função itil. Quando Abel Tuter envia uma solicitação, ela atende aos critérios para ambos Limitar incidentes por administrador e Limite incidentes por itil regra. Apenas o. Limite incidentes por itil a regra é aplicada porque permite o menor número de solicitações. Como resultado, Abel Tuter pode enviar um máximo de 100 solicitações por hora.

Cabeçalhos de resposta da REST API

Você pode gerar solicitações de REST API de entrada usando REST API Explorer Ou um cliente HTTP, como Plataforma da API Postman. Se a solicitação corresponder a uma regra de limite de taxa, vários cabeçalhos de resposta HTTP fornecerão informações sobre a limitação de taxa.

• Limite de taxa X. exibe o número de solicitações permitidas por hora.
• Limite de taxa-X-Redefinição exibe um UNIX carimbo de data/hora da próxima redefinição agendada da janela de limite de taxa.
• Regra Limite de Taxa X. exibe o sys_id da regra de limite de taxa [sys_rate_limit_rules] que está sendo imposta.

Se uma solicitação for negada porque excede o limite de taxa, o sistema retornará um Tentar novamente após cabeçalho de resposta, além dos cabeçalhos de resposta sobre limitação de taxa. . Tentar novamente após o cabeçalho de resposta exibe o número de segundos após os quais você pode repetir a solicitação para evitar exceder o limite de taxa. A seguinte resposta de erro é retornada:

{
    "error": {
        "message": "Rate limit exceeded",
        "detail": "Rate limit of 100 requests per hour for Table API exceeded"
    },
    "status": "failure"
}

O código de status de uma solicitação negada é 429 Muitas solicitações .

• 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.
• Redefina um limite de taxa de REST API de entrada
  Redefina uma regra de limite de taxa para redefinir a contagem de limite de taxa para zero (0) e excluir todas as violações da hora atual.
• Monitore contagens e violações de limite de taxa da REST API de entrada
  Para determinar se você definiu uma regra de limite de taxa adequadamente, monitore as contagens e violações de solicitações de REST API de entrada que são restritas pela regra.
• Investigar violações de limite de taxa de REST API de entrada
  Investigue violações de limite de taxa para determinar quais regras de limite de taxa estão sendo excedidas e quais usuários estão excedendo esses limites de taxa.