リストエンジンAPI(クラシック)
概要
エンジンリストAPI を使用すると、Portalにリンクされた全てのEngineの接続ステータスと詳細をプログラムで取得できます。
エンジンリストAPIのクライアントは、プライマリーアプライアンス(Portal)の証明書を信頼する必要があります。
クライアントを認証するために、エンジンリストAPIは基本認証を使用します。 Nexthinkは、APIのクライアントを専用に認証するためのローカルアカウントの作成を推奨します。
認証
ユーザーアカウント
クライアントを認証するために、エンジンリストAPIは基本認証をサポートしています。 Nexthinkは、APIのクライアントを専用に認証するためのローカルアカウントの作成を推奨します。
OAuth
Nexthinkを設定して、アクセスの委譲のためのオープンスタンダードであるOAuthを使用してエンジンリストAPIへのアクセスを許可することができます。 Nexthink サポートに問い合わせて、詳細情報を入手してください。
APIのクエリ
ユーザーアカウント
エンジンリストAPIにクエリを送るために、以下のパラメータなしのGETリクエストをPortalに送信してください:
https:///api/configuration/v1/engines
<Portal_DNS_FQDN>をPortalの実際の名前に置き換えてください。
OAuth
エンジンリストAPIにクエリを送るために、以下のパラメータなしのGETリクエストをPortalに送信してください:
https://agora.<region>.nexthink.cloud/api/configuration/v1/engines
<region>は、導入時に組織に割り当てられたNexthink Experienceプラットフォームの地域と一致する必要があります。
エンリッチメントAPIは、現在以下の地域で利用可能です:
- eu 
- meta 
- pac 
- us 
エンジンリストAPIの出力
エンジンリストAPIから取得できるデータは、PortalをEngineに接続したときのEngineダッシュボードから得られるものと類似しています。
出力には、JSON形式でエンジンのリストが保持されています。 各エンジンについて、次を見つけます:
名前
エンジンの名前
databaseUID
エンジンデータベースのUID
machineID
エンジンを動かしているマシンのID
説明
接続時に管理者がエンジンに与えた説明。
ステータス
Portalとエンジン間の接続ステータス:
- 接続済み 
- 未接続 
- 接続中 
アドレス
エンジンのIPアドレス
ポート
Portalの接続を待っているエンジンのTCPポート番号。
タイムゾーン
エンジンで設定されているタイムゾーン。
バージョン
エンジンのバージョン番号。
Last updated
Was this helpful?