Instana REST API limites de taxa
O site Instana REST API impõe certos limites ao número de chamadas que você pode fazer por hora no API, a fim de garantir um uso justo e manter a estabilidade dos serviços do Instana. Os limites de taxa evitam abusos e ajudam a garantir que você tenha acesso igualitário aos recursos do API.
Políticas de limite de taxa
O Instana REST API possui a seguinte política de limite de solicitações:
Limite máximo de chamadas do API por hora: você pode fazer até 10.000 chamadas do API por hora.
Cabeçalhos de limite de taxa
Cada resposta do Instana REST API inclui os seguintes cabeçalhos para ajudá-lo a gerenciar seus limites de solicitação:
| Nome do cabeçalho | Descrição |
|---|---|
X-RateLimit-Limit |
O número máximo de chamadas do tipo “ API ” permitidas por hora. |
X-RateLimit-Remaining |
O número de chamadas do serviço de assistência ao motorista ( API ) que ainda estão pendentes nesta hora. |
X-RateLimit-Reset |
O tempo (em segundos desde a época do Unix ) em que a janela de limite de taxa atual é reiniciada. |
X-Ratelimit-Zone |
A zona limitadora de taxa aplicada a uma solicitação do tipo “ API ”. |
Gerenciamento de limites de taxa
Para gerenciar o uso do API dentro desses limites, você pode considerar as seguintes estratégias:
Limites de taxa de controle
Você pode monitorar os cabeçalhos de limite de taxa nas respostas de API para acompanhar seu uso. Para lidar com 429 Too Many Requests as respostas, utilize o backoff exponencial ou o enfileiramento de solicitações.
Otimizar chamadas d API
Você deve reduzir a frequência das chamadas ao ` API ` armazenando as respostas em cache. Utilize operações em massa ou em lote, quando disponíveis, para minimizar o número de solicitações de ` API `.
Tratar erros
Certifique-se de que sua aplicação seja capaz de lidar com erros de limite de taxa e de tentar novamente após a reinicialização do limite.
Exemplo de uso de cabeçalhos de limite de taxa
O exemplo a seguir mostra como usar o limite de taxa:
curl --request GET \
--url https://<TENANT>-<UNIT>.instana.io/api/<INSTANA_REST_API_ENDPOINT> \
--header 'Authorization: apiToken YOUR_API_TOKEN'
# Example response headers
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4995
X-RateLimit-Reset: 1609459200
Perguntas mais frequentes
P: O que acontece se eu ultrapassar o limite de taxa?
R: Se você exceder o limite de frequência, o API retorna uma 429 Too Many Requests resposta. Você deve suspender sua solicitação até que o limite de taxa seja reiniciado para evitar receber 429 Too Many Requests uma resposta.
P: Posso solicitar um limite de transações mais alto?
R: Limites de taxas mais elevados normalmente não estão disponíveis sob demanda. Se você precisar de um limite de taxa mais alto para sua aplicação, entre em contato com o suporte do Instana.
P: Como posso saber quando o limite de solicitações é reiniciado?
R: O cabeçalho ` X-RateLimit-Reset ` indica o momento em que o limite de taxa é reiniciado, em segundos desde a época ` Unix `. Para obter mais informações sobre o uso e as práticas recomendadas do ` API `, consulte a documentação em API.