Welcome
REST API との統合
外部システム統合は、BigFix Inventory の主要な機能の一つです。統合のためのビジネス・ロジックが使用可能であり、共通の統合ポイント用のインターフェースが提供されています。
REST API
アプリケーション・ユーザー・インターフェースを使用して大量の情報を管理すると、多大な時間がかかる場合があります。グラフィカル・ユーザー・インターフェースの代わりに REST API を使用すると、ソフトウェア・インベントリー、およびソフトウェア・カタログのコンテンツを管理するために必要な時間を削減できます。
構成 API
構成 API には、アプリケーションの構成に必要なすべての API が含まれます。
サーバーの詳細設定を変更する REST API
9.2.3 から使用可能です。REST API を使用して、BigFix Inventory サーバーのパラメーターを変更することができます。
サーバー詳細設定の構成
9.2.3 から使用可能です。BigFix Inventory サーバーの設定値を変更するには、 api/sam/configs エレメントに対して PUT 操作を使用します。

BigFix 資料ホーム・ページ
BigFix 10 Inventory 資料
概要
BigFix Inventory がどのように機能するかを理解するために必要な主要な概念に習熟し、アプリケーションのすべてのバージョンで導入される機能について学習してください。
インストール
ご使用の環境への BigFix Inventory のデプロイメントが円滑に行われるようにするための要件と使用可能なインストール・シナリオについて説明します。
構成
BigFix Inventory をインストールしたら、アプリケーションを構成します。アプリケーションへのアクセスを必要とするユーザーのアカウントを作成し、ご使用の環境からソフトウェアおよびハードウェアのインベントリ・データを収集するためにスキャンをセットアップします。
アップグレード
の新しいバージョンは、通常、カレンダーの各四半期の終わりにリリースされます。新しい機能とアプリケーションのフィックスを最大限に活用するため、新しいバージョンに定期的にアップグレードしてください。
インフラストラクチャーの管理
の初期構成が完了したら、そのインフラストラクチャーの次のコンポーネントを管理する方法を確認してください。VM マネージャー、サーバー、データベース、およびデータ・ソース。
ソフトウェア・インベントリーとライセンスの使用状況
BigFix Inventory のレポートが使用権を反映し、特定の製品によるライセンス・メトリックの使用状況を適切に表示できるように、検出されたソフトウェアを分類できます。
セキュリティー上の脅威の管理
を使用して、ご使用の環境でのセキュリティーの脅威を管理する方法について説明します。インストールされているコンポーネントのいずれかが、一般的な脆弱性と危険度 (CVE) の影響を受けやすいかどうかを確認できます。
チュートリアル
チュートリアルは、の使用方法を理解するのに役立ちます。これらは、幅広い目標に焦点を当てたモジュールで構成されています。モジュールは、特定の設定の構成方法をステップバイステップで示すタスクで構成されています。
Security (セキュリティー)
様々なセキュリティー機能を構成して、BigFix Inventory 使用時にデータ・モデルに含まれるビジネス資産とリソースを適切に保護します。
トラブルシューティングおよびサポート
BigFix Inventory を使用する際に発生する可能性がある一般的な問題の解決方法と、それらの問題のトラブルシューティングに役立つログおよびトレース・ファイルの検索方法について説明します。
パフォーマンスのチューニング
BigFix Inventory のインフラストラクチャーを計画し、最適なパフォーマンスを実現するためにアプリケーション・サーバーを構成する方法について説明します。以下のガイドラインは、ビッグ・データ環境にも、低パフォーマンス・ハードウェア上で実行されている小規模な環境にも当てはまります。
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 のすべての基本セットが含まれます。
  - 構成 API
    構成 API には、アプリケーションの構成に必要なすべての API が含まれます。
    - VM マネージャーを管理するための REST API
      REST API 要求を使用して、インフラストラクチャー内で VM マネージャーの追加と変更を行うことができます。
    - サーバーの詳細設定を変更する REST API
      9.2.3 から使用可能です。REST API を使用して、BigFix Inventory サーバーのパラメーターを変更することができます。
      - サーバーの詳細設定の現行値の取得
        9.2.3 から使用可能です。BigFix Inventory サーバー設定の現行値に関する情報を要求するには、api/sam/configs エレメントに対して GET 操作を使用します。出力を JSON 形式で戻します。
      - サーバー詳細設定の構成
        9.2.3 から使用可能です。BigFix Inventory サーバーの設定値を変更するには、 api/sam/configs エレメントに対して PUT 操作を使用します。
    - サポート終了日を設定および削除するための REST API
      9.2.11 から使用可能。REST API を使用して、任意のソフトウェア・コンポーネントのサポート終了日を設定および削除することができます。
    - タグを追加および削除するための REST API
      9.2.14 から使用可能です。REST API を使用して、任意のソフトウェア・コンポーネントのタグを追加および削除することができます。
    - 保存されたレポート・ビューをエクスポートおよびインポートするための REST API
      REST API 要求を使用して、保存されたレポート・ビューを BigFix Inventory の 1 つのインスタンスからエクスポートし、それをアプリケーションの別のインスタンスにインポートすることができます。
    - Oracle コア係数を更新するための REST API
      9.2.8 から使用可能です。api/v1/servers エレメントで PUT 操作を使用して、Oracle プロセッサー・コアのメトリック使用状況を計算するためにサーバーのグループに適用されるプロセッサー・コア係数を変更します。
    - ライセンス・メトリックを管理するための REST API
      REST API 要求を使用して、ライセンス・メトリックを取得、作成、変更、および削除します。バージョン 10.0.5 以降では、UI を使用してメトリックを管理することもできます。UI を使用したライセンス・メトリックの管理も参照してください。
    - コントラクトを管理するための REST API
      /api/sam/v2/contracts.json API を使用すると、購入情報を使用してコントラクト・データをインポートおよびエクスポートできます。この操作は、外部購入システムとの統合を自動化するために使用されます。コントラクトを管理するために、コントラクト CSV のインポート、ユーザー・インターフェース - 「すべてのコントラクト」パネルおよび非推奨のコントラクト移行を使用することもできます。
  - 履歴 API
    一部の REST API では、バージョン 2 が作成され、機能やエクスペリエンスが向上しています。このような場合、元の API は非推奨となり、バージョン 2 がサポートされます。カスタム・ツールまたは内部プロセスを、これらの API の新しいバージョンに合わせて調整する必要があります。
用語集
ガイド (PDF 形式)

サーバー詳細設定の構成

9.2.3 から使用可能です。BigFix Inventory サーバーの設定値を変更するには、 api/sam/configs エレメントに対して PUT 操作を使用します。

An icon representing a user.

You must be an Administrator to perform this task.

表 1. 操作の説明
操作の詳細	「説明」
操作	`PUT /api/sam/configs`
目的	サーバー設定の現行値を変更します。
HTTP メソッド	`PUT`
リソース URI	https://`server_host_name`:`port_number`/api/sam/configs
URL リンク関係	n/a
URL 照会パラメーター	照会パラメーターのリストについては、以下を参照してください。「照会パラメーター」。
要求ヘッダー	ヘッダー `Accept-Language` (オプション) 値 en-US (英語のみをサポート) 応答の言語のネゴシエーションに使用されます。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
要求ペイロード	n/a
要求 `Content-Type`	`application/x-www-form-urlencoded`
応答ヘッダー	ヘッダー `Content-Language` 値 en-US, … 応答のコンテンツの言語を指定します。このヘッダーを指定しない場合、コンテンツはサーバーの言語で戻されます。
応答ペイロード	n/a
応答 `Content-Type`	n/a
正常な HTTP 応答コード	`204`
エラーの HTTP 応答コード	`400 - "Bad Request"` 指定された値が無効な場合。例えば、この値が範囲外であるか、またはタイプが正しくない場合です。 `404 - "Not Found"`

照会パラメーター

以下の表は、configs エレメントに対して使用できる照会パラメーターを示しています。

表 2. サーバー設定の現行値を変更するための照会パラメーター
パラメーター	「説明」	必須	値
name	値を変更するパラメーターを指定します。可能な値の完全なリストとその説明については、以下を参照してください:サーバーの詳細設定。	はい	パラメーターの名前
token	固有のユーザー認証 ID。	はい	英数字
value	パラメーターの新規の値を指定します。	はい	パラメーターに固有の範囲内の値。

HTTP 会話の例

要求

PUT http://localhost:9981/api/sam/configs
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&name=
maxVMManagerInactivity&value=30