Instana REST API レート制限
Instana （ REST API ）では、公平な利用を確保し、 Instana のサービスの安定性を維持するため、1時間あたりに実行できる API 呼び出しの数に一定の制限を設けています。 レート制限は不正利用を防ぎ、 API のリソースへの公平なアクセスを確保するためのものです。
レート制限ポリシー
Instana （ REST API ）には、以下のレート制限ポリシーが適用されます：
1時間あたりの API 呼び出しの上限： 1時間あたり最大10,000回の API 呼び出しが可能です。
レート制限ヘッダー
Instana （ REST API ）からの各レスポンスには、リクエスト制限の管理に役立つ以下のヘッダーが含まれています：
| ヘッダー名 | 説明 |
|---|---|
X-RateLimit-Limit |
1時間あたりに許可される API 呼び出しの最大数。 |
X-RateLimit-Remaining |
現在の1時間に残っている API の呼び出し数。 |
X-RateLimit-Reset |
現在のレート制限ウィンドウがリセットされる時刻（ Unix エポックからの経過秒数）。 |
レート制限の管理
API の使用量をこれらの制限内に収めるために、以下の対策をご検討ください：
レート制限の管理
API のレスポンスに含まれるレート制限ヘッダーを確認することで、使用状況を追跡できます。 応答 429 Too Many Requests への対応には、指数関数的バックオフまたはリクエストのキューイングを使用してください。
API の呼び出しを最適化する
レスポンスをキャッシュすることで、 API への呼び出し頻度を減らす必要があります。 可能であれば、一括処理またはバッチ処理を使用して、 API へのリクエスト数を最小限に抑えてください。
エラーの処理
アプリケーションがレート制限エラーを適切に処理し、制限がリセットされた後に再試行できるようにしてください。
レート制限ヘッダーの使用例
次の例は、レート制限の使用方法を示しています：
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
FAQ
Q: レート制限を超えた場合はどうなりますか？
A: レート制限を超えた場合、 API は応答を返します 429 Too Many Requests 。 レート制限がリセットされるまでリクエストを一時停止し、応答 429 Too Many Requests を受け取らないようにしてください。
Q: 取引限度額の引き上げを申請することはできますか？
A: 通常、より高いレート制限はオンデマンドで利用できません。 アプリケーションのレート制限を引き上げる必要がある場合は、 Instana のサポートまでご連絡ください。
Q: レート制限がリセットされたかどうかはどうやって確認すればよいですか？
A: ` X-RateLimit-Reset ` ヘッダーには、レート制限がリセットされる時刻が、 Unix エポックからの経過秒数として指定されます。 API の使用方法やベストプラクティスに関する詳細については、 API のドキュメントを参照してください。