ホーム
REST API との統合
外部システム統合は、BigFix Inventory の主要な機能の一つです。統合のためのビジネス・ロジックが使用可能であり、共通の統合ポイント用のインターフェースが提供されています。
REST API
アプリケーション・ユーザー・インターフェースを使用して大量の情報を管理すると、多大な時間がかかる場合があります。グラフィカル・ユーザー・インターフェースの代わりに REST API を使用すると、ソフトウェア・インベントリー、およびソフトウェア・カタログのコンテンツを管理するために必要な時間を削減できます。
コア API
コア API には、BigFix Inventory と統合された API のすべての基本セットが含まれます。
未加工のスキャン結果を取得するための REST API
9.2.2 から使用可能です。REST API を使用した未加工スキャン結果の取得は、最近インストールまたは変更されたソフトウェアを素早くディスカバーできるようにすることで、環境のモニタリングを効果的に行うことを目的としたものです。短縮されたデータ・インポートを使用することで、ソフトウェアに関するデータがサーバーにより速く到達し、また同時に、毎日実行できるインポートの数を増やすことができます。

REST API との統合
外部システム統合は、BigFix Inventory の主要な機能の一つです。統合のためのビジネス・ロジックが使用可能であり、共通の統合ポイント用のインターフェースが提供されています。
- REST API
  アプリケーション・ユーザー・インターフェースを使用して大量の情報を管理すると、多大な時間がかかる場合があります。グラフィカル・ユーザー・インターフェースの代わりに REST API を使用すると、ソフトウェア・インベントリー、およびソフトウェア・カタログのコンテンツを管理するために必要な時間を削減できます。
  - ソフトウェア製品とソフトウェア・コンポーネント
    BigFix Inventory は、製品にバンドルされているソフトウェア・コンポーネントを検出します。
  - REST API リソースおよび HTTP メソッド
    BigFix Inventory REST API プロトコルの操作は、特定の REST リソースに対する HTTP メソッドとして定義されます。
  - 共通の REST API エレメント
    コネクターおよび演算子を使用すると、一致する条件および値に基づいてフィルタリングを行う照会セグメントを作成できます。
  - REST API バージョンのマッピング
    9.2.8 から使用できます。一部の REST API では、バージョン 2 が作成され、機能やエクスペリエンスが向上しています。そのような場合、元の API は時間とともに非推奨になり、バージョン 2 のみがさらに開発されます。そのような REST API に基づいているカスタム・ツールまたは内部プロセスがある場合は、新しいバージョンの API を使用するようにツールを調整することをお勧めします。
  - 認証トークンを取得するための REST API
    REST API 要求を認証するために必要なユーザー固有のトークンを要求するには、api/get_token エレメントに対して POST 操作を使用します。
  - BigFix Inventory のバージョンを取得するための REST API
    BigFix Inventory のバージョンに関する情報を要求するには、api/sam/about エレメントに対して GET 操作を使用します。
  - コア API
    コア API には、BigFix Inventory と統合された API のすべての基本セットが含まれます。
    - ハードウェア用 REST API (v2)
      9.2.8 から使用可能です。REST API 要求を使用して、削除されたコンピューターに関する履歴データも含め、ハードウェア・インベントリーに関連した大量のデータを迅速に取得できます。その後、そのデータを他のアプリケーションに渡して、さらに処理したり分析したりすることができます。
    - ソフトウェア・インベントリーおよびメトリック使用状況を取得してソフトウェアを分類するための REST API (v2)
      9.2.8 から使用可能です。REST API 要求を使用して、アンインストールされたコンピューターに関する履歴データも含め、ライセンス・メトリック使用状況とソフトウェア・インベントリーに関連した大量のデータを迅速に取得できます。その後、そのデータを他のアプリケーションに渡して、さらに処理したり分析したりすることができます。
    - REST API の関連付け
      9.2.8 から使用可能です。バージョン 2 の REST API では、関連付けを使用して、API 要求の一部として、追加のデータを取得できます。例えば、software_instances API 要求の一部として、コンピューター・ハードウェアに関する詳細情報を取得できます。
    - 未加工のスキャン結果を取得するための REST API
      9.2.2 から使用可能です。REST API を使用した未加工スキャン結果の取得は、最近インストールまたは変更されたソフトウェアを素早くディスカバーできるようにすることで、環境のモニタリングを効果的に行うことを目的としたものです。短縮されたデータ・インポートを使用することで、ソフトウェアに関するデータがサーバーにより速く到達し、また同時に、毎日実行できるインポートの数を増やすことができます。
      - データ・インポートの実行
        9.2.2 から使用可能です。この REST API を使用して、データ・インポートの状況を検査したり、未加工のデータのみまたは完全なデータのインポートを実行したりできます。これらのアクションはすべて、共通の API 要求を通じて実行されます。これらを区別するには、要求に特定のパラメーターを追加します。この API を使用するには、api/import_status.json エレメント、またはその別名である api/management/imports.json に対して GET 操作を使用します。
      - 未加工のスキャン済みファイル・データの取得
        9.2.2 から使用可能です。インフラストラクチャー内のコンピューターで検出されたすべてのファイルに関する情報を要求するには、/api/sam/raw_file_facts エレメントに対して GET 操作を使用します。この API は、既存のファイルの詳細、および削除されたファイルに関する履歴データを返します。デフォルトでは、未加工のデータは 7 日間保持されます。この期間を変更するには、「管理」 > 「サーバー詳細設定」に移動し、raw_data_api_history_keep_days パラメーターの値を変更します。
      - 未加工のパッケージ・データの取得
        9.2.2 から使用可能です。この API は、コンピューターで検出されたすべてのパッケージに関する情報が含まれる、未加工のパッケージ・データを取得します。この情報は、Windows レジストリーから取得されます。UI の場合とは異なり、この API を使用すると、データベースに保管されているすべての履歴データを取得できます。
      - 未加工の UNIX パッケージ・データの取得
        9.2.2 から使用可能です。この API は、UNIX オペレーティング・システムで検出されたすべてのパッケージに関する情報が含まれる、未加工の UNIX パッケージ・データを取得します。UI の場合とは異なり、この API を使用すると、データベースに保管されているすべての履歴データを取得できます。
      - 未加工の課金データの取得
        9.2.2 から使用可能です。この API は、コンピューターにインストールされたソフトウェア・アイテムの使用状況に関する情報を含む未加工の課金データを取得します。UI の場合とは異なり、この API を使用すると、データベースに保管されているすべての履歴データを取得できます。
      - ハードウェア・インベントリーの取得 (v2)
        9.2.8 から使用可能です。インフラストラクチャー内のコンピューターに関する情報を要求するには、api/sam/v2/computers エレメントに対して GET 操作を使用します。この API は、既存のコンピューターの詳細、および削除されたコンピューターに関する履歴データを返します。
      - 共有ディスクの取得 (v2)
        9.2.12 から使用可能です。インフラストラクチャー内の共有ディスクに関する情報を要求するには、api/sam/v2/shared_disks エレメントに対して GET 操作を使用します。
      - 詳細なハードウェア情報を取得するための REST API (v2)
        REST API 要求を使用して、メモリー、オペレーティング・システム、ストレージ、プロセッサー、パーティション、ネットワーク・アダプター、SMBIOS データ、IP アドレス、および論理パーティションのキャパシティー・データなど、詳細なハードウェア情報に関連するデータを取得することができます。その後、そのデータを他のアプリケーションに渡して、さらに処理したり分析したりすることができます。
    - 統合ビューの取得
      統合ビュー API は、インスタンスの統一されたビューを提供します。
  - 構成 API
    構成 API には、アプリケーションの構成に必要なすべての API が含まれます。
  - 履歴 API
    一部の REST API では、バージョン 2 が作成され、機能やエクスペリエンスが向上しています。このような場合、元の API は非推奨となり、バージョン 2 がサポートされます。カスタム・ツールまたは内部プロセスを、これらの API の新しいバージョンに合わせて調整する必要があります。

未加工のスキャン結果を取得するための REST API

9.2.8 9.2.2 から使用可能です。REST API を使用した未加工スキャン結果の取得は、最近インストールまたは変更されたソフトウェアを素早くディスカバーできるようにすることで、環境のモニタリングを効果的に行うことを目的としたものです。短縮されたデータ・インポートを使用することで、ソフトウェアに関するデータがサーバーにより速く到達し、また同時に、毎日実行できるインポートの数を増やすことができます。

データ・インポートは複数のステップで構成されます。その中でも最も重要なステップは、未加工スキャン結果の取得、このデータの集約、およびライセンス使用量の計算です。大規模環境では、完全なデータ・インポートには数時間かかる場合があり、これは、BigFix Inventory が最近の変更に関する情報を表示するために必要な時間を増加させます。

REST API を使用して未加工スキャン結果を取得する場合、未加工のスキャン結果をインポートし、以降のステップ (集約やライセンス計算など) を省略する「未加工のデータのみ」タイプのデータ・インポートを実行できます。このデータ・インポートは時間が大幅に短くなりますが、インポートされた未加工データは、REST API を使用してのみ取得できます。このデータは集約されていないため、 BigFix Inventory UI には表示されません。UI には、引き続き最後の正常な完全データ・インポートによる環境の状態が表示されます。