Instana REST API を使い始める

始める前に、RESTful API と HTTP プロトコルの基本的な理解と、Instana アカウントがあることを確認してください。

Instana REST API へのリクエストを認証するには、API トークンが必要です。 以下の手順でAPIトークンを生成してください：

1. Instanaアカウントにログインします。
2. Instana UI のナビゲーションメニューから、[ 設定] をクリックします。
3. セキュリティとアクセス] タブの [アクセス制御] セクションで、[ APIトークン ]をクリックします。
4. トークンの名前を入力し、適切なパーミッションを設定します。
5. APIトークンが生成されたら、APIトークンをコピーし、将来の使用のために安全に保管してください。

Instana REST API は、標準の HTTP メソッドを使用します。 Instana REST API のベース URL は、各 Instana インスタンスに固有で、テナントとユニットで構成されます。 ベースとなる URL は、Instana のユーザーインターフェイスにアクセスするために使用される URL と同じです。

各リクエストの認証にはAPIトークンを使用します。

• 基本 URL: https://<TENANT>-<UNIT>.instana.io/api
• 認証： Bearer スキームを使用して、API トークンを Authorization ヘッダーに含めます。

次の例は、curlを使ったリクエストである：

curl -X GET https://<TENANT>-<UNIT>.instana.io/api/<INSTANA_REST_API_ENDPOINT> \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Instana REST API の API エンドポイントとは、API がさまざまな機能または操作に使用するさまざまなルートまたはパスを指します。 これらのエンドポイントを使用すると、モニタリングデータ管理、アラート、カスタムイベントなど、Instanaプラットフォームのさまざまな側面と対話できます。 リクエストパラメータ、レスポンスフォーマット、リクエスト例など、Instana REST API と各エンドポイントの使用方法の詳細については、 API ドキュメントを参照してください。

Instana REST API のレート制限を常に確認する必要があります。 これらの制限は、すべてのユーザーのためにサービスの可用性とパフォーマンスを維持するのに役立ちます。

統合やトラブルシューティングに関するご質問やサポートが必要な場合は、 Instana サポートをご覧ください。