レッスン 1: 指定されたコンピューターのソフトウェア割り当てに関する情報を取得する

9.2.14 から使用可能です。このレッスンでは、REST API 要求を使用して、新しい BigFix サーバーに移動されたコンピューターのソフトウェア割り当てを取得する方法について説明します。

始める前に

このタスクを実行するには、「エンドポイントの表示」権限および「ハードウェア・インベントリーの表示」権限が必要です。

このタスクについて

このチュートリアルは、新しい BigFix サーバーに移行されたコンピューターの古いデータ・ソースのコンピューター ID と新しいデータ・ソースのコンピューター ID に基づいています。この情報は、REST API 要求にとって重要です。複数のコンピューターのソフトウェア割り当てを移行するには、影響を受けるすべてのコンピューターについて、古いデータ・ソースのコンピューター ID と新しいデータ・ソースのコンピューター ID のリストを準備することから開始します。その後、最適な結果を得るために、ご使用の環境内の各コンピューターに対してソフトウェア割り当てを個別に移行します。単一 API 要求ごとのソフトウェア・インスタンスの数は、150 を超えてはなりません。

手順

コンピューターを新しい BigFix サーバーに移動します。
新規データ・ソースを BigFix Inventory に追加します。
新しい BigFix サーバーに接続されているコンピューターからソフトウェアのスキャン結果をアップロードします。
コンピューターの古いデータ・ソースのコンピューター ID と新しいデータ・ソースのコンピューター ID のペアを収集します。
1. BigFix Inventory にログインします。
2. 「レポート」 > 「コンピューター」に移動します。
3. 「構成」にカーソルを合わせて、「ビューの設定」をクリックします。列のリストから「データ・ソース名」と「データ・ソースのコンピューター ID」を選択し、「送信」をクリックします。
4. 列ヘッダーをクリックして、「コンピューター名」でレポートをソートします。コンピューター名とデータ・ソース名を調べて、コンピューターの古いデータ・ソースのコンピューター ID と新しいデータ・ソースのコンピューター ID のペアを準備します。このチュートリアルでは、以下の例を使用します。
  - レポート上の古いデータ・ソースに割り当てられているデータ・ソースのコンピューター ID:9596634
  - レポートに新しく作成されたデータ・ソースに割り当てられているデータ・ソースのコンピューター ID:778906
  ヒント: 複数のコンピューターのソフトウェア割り当てを移行する場合は、影響を受けるすべてのコンピューターについて、古いデータ・ソースのコンピューター ID と新しいデータ・ソースのコンピューター ID のリストを準備することから開始すると、時間と労力を節約できます。

このコンピューターに関連するソフトウェア割り当てに関する情報を取得するには、以下の API クエリーを実行します。

https://hostname:port/api/sam/v2/software_instances?limit=150&
                        columns[]=product_name&columns[]=component_name&columns[]=discovery_path&columns[]=is_charged&
                        columns[]=is_confirmed&columns[]=computer_bigfix_id&columns[]=discoverable_guid&columns[]=product_release_guid&
                        columns[]=metric_id&token=user_token&criteria={"and":[["is_present","=","1"],
                        ["computer_bigfix_id","=","9596634"]]}

computer_bigfix_id は、古いデータ・ソースのコンピューター ID と同じです。この例では、古いデータ・ソースのコンピューター ID は 9596634 です。

次の例は、このコンピューターのクエリーの結果を示しています。

{
    "total": 2,
    "rows": [
        {
            "product_name": "BigFix Inventory",
            "component_name": "BigFix Inventory Server",
            "is_charged": 0,
            "is_confirmed": 1,
            "computer_bigfix_id": 9596634,
            "discoverable_guid": "cdf19da9-a9de-4ee9-ab41-ff09fa6eda92",
            "product_release_guid": "1ecbbb8d-1d1e-4beb-a40f-cb9b9b9462fb",
            "metric_id": -13103
        },
        {
            "product_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "component_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "is_charged": 1,
            "is_confirmed": 0,
            "computer_bigfix_id": 9596634,
            "discoverable_guid": "57628995-cf33-4335-984d-d2c8abde750e",
            "product_release_guid": "befa759d-0473-47bd-ae60-f1e16c13e8cc",
            "metric_id": 1
        }
    ]
}

クエリーの結果を要求の Body にコピーし、computer_bigfix_id の値を新しいデータ・ソースのコンピューター ID に変更します。

以下の例は、新規サーバー上のコンピューターにソフトウェア割り当てを移行するために必要な修正を示しています。新しいデータ・ソースのコンピューター ID は 778906 です。

{
    "total": 2,
    "rows": [
        {
            "product_name": "BigFix Inventory",
            "component_name": "BigFix Inventory Server",
            "is_charged": 0,
            "is_confirmed": 1,
            "computer_bigfix_id": 778906,
            "discoverable_guid": "cdf19da9-a9de-4ee9-ab41-ff09fa6eda92",
            "product_release_guid": "1ecbbb8d-1d1e-4beb-a40f-cb9b9b9462fb",
            "metric_id": -13103
        },
        {
            "product_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "component_name": "IBM DB2 Enterprise Server Edition Unlicensed Product Base",
            "is_charged": 1,
            "is_confirmed": 0,
            "computer_bigfix_id": 778906,
            "discoverable_guid": "57628995-cf33-4335-984d-d2c8abde750e",
            "product_release_guid": "befa759d-0473-47bd-ae60-f1e16c13e8cc",
            "metric_id": 1
        }
    ]
}