Instana REST API limites de débit
Le site Instana REST API impose certaines limites quant au nombre d'appels API que vous pouvez effectuer en une heure, afin de garantir une utilisation équitable et d'assurer la stabilité des services de Instana. Les limites de débit permettent d'éviter les abus et garantissent à tous un accès équitable aux ressources de l' API.
Politiques de limitation du débit
L'interface de programmation d'applications (API) Instana REST API applique la politique de limitation de débit suivante :
Nombre maximal d'appels « API » par heure : vous pouvez passer jusqu'à 10 000 appels « API » par heure.
En-têtes de limitation de débit
Chaque réponse provenant de l' Instana REST API comprend les en-têtes suivants pour vous aider à gérer vos limites de requêtes :
| Nom d'en-tête | Description |
|---|---|
X-RateLimit-Limit |
Le nombre maximal d'appels « API » autorisés par heure. |
X-RateLimit-Remaining |
Le nombre d'appels d' API s encore en attente pour l'heure en cours. |
X-RateLimit-Reset |
Le moment (en secondes depuis l'époque de l' Unix ) où la fenêtre de limitation de débit actuelle est réinitialisée. |
Gestion des limites de débit
Pour gérer votre utilisation d' API. dans ces limites, vous pouvez envisager les stratégies suivantes :
Limites de débit
Vous pouvez surveiller les en-têtes de limitation de débit dans les réponses de l' API pour suivre votre utilisation. Pour gérer 429 Too Many Requests les réponses, utilisez le recul exponentiel ou la mise en file d'attente des requêtes.
Optimiser les appels d' API
Vous devez réduire la fréquence des appels à l'interface API en mettant les réponses en cache. Utilisez les opérations groupées ou par lots lorsqu'elles sont disponibles afin de réduire au minimum le nombre de requêtes d' API.
Gérer les erreurs
Assurez-vous que votre application est capable de gérer les erreurs liées à la limitation de débit et de réessayer une fois que la limite a été réinitialisée.
Exemple d'utilisation des en-têtes de limitation de débit
L'exemple suivant illustre l'utilisation de la limitation de débit :
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
Questions fréquentes
Q : Que se passe-t-il si je dépasse la limite de fréquence?
R : Si vous dépassez la limite de fréquence, l' API renvoie une 429 Too Many Requests réponse. Vous devez suspendre votre requête jusqu'à ce que la limite de débit soit réinitialisée afin d'éviter de recevoir 429 Too Many Requests une réponse.
Q : Puis-je demander une augmentation de ma limite de taux?
R : Des limites de débit plus élevées ne sont généralement pas disponibles sur demande. Si vous avez besoin d'une limite de débit plus élevée pour votre application, veuillez contacter le service d'assistance d' Instana.
Q : Comment savoir quand la limite de requêtes est réinitialisée?
R : L'en-tête « X-RateLimit-Reset » indique le moment où la limite de débit est réinitialisée, en secondes depuis l'époque de l' Unix. Pour plus d'informations sur l'utilisation d' API et les bonnes pratiques, consultez la documentation disponible à l'adresse API.