レッスン 2: 使用量計算からのソフトウェア・インスタンスの除外

このレッスンでは、REST API および cURL コマンド・ライン・ツールを使用して、ライセンス使用量の計算から製品を除外する方法を示します。このレッスンの情報を使用して、大規模な再バンドルのための自動外部ツールを実装できます。

始める前に

root オペレーティング・システム特権を保有している必要があります。

このタスクについて

このレッスンでは、お客様はいくつかの BigFix エンドポイントでリソース・バリュー・ユニット (RVU) サブキャパシティー・ライセンスを使用します。すべてのコンピューターは BigFix コンソールで BigFix Inventory v10 サイトをサブスクライブしており、インフラストラクチャーのソフトウェア・スキャンは完了しています。サブスクライブしたコンピューターは、80% がデスクトップ・コンピューターで、20% がサーバーです。RVU レポートが生成される前に、すべてのデスクトップ・コンピューターをライセンス使用量の計算から除外しておく必要があります。

重要: このレッスンの一部のコマンドは長いため、表示のためにいくつかの改行が挿入されています。改行をスペースとして扱ってください。

手順

コマンド行インターフェースを開始します。
ご使用の環境でディスカバーされたすべての製品のリストを取得するには、以下のコマンドを実行します。
```
curl -v -X GET http://server_url:server_port/api/sam/swinventory/products
```
リストを確認し、BigFix アプリケーションの製品 ID を入手します。
多数の BigFix アプリケーションが存在する可能性があります。「BigFix」で始まるすべての製品を検索してください。
```
{
  "id": "21555",
  "level": "product",
  "isConfirmed": "false",
  "productReleaseComponent": "BigFix Lifecycle",
  "children": "true",
  "nmbOfAllRows": "45",
  "confidence": "23",
  "type": "root"}
```
各 BigFix 製品のすべてのリリースのリスト、およびすべてのインスタンスのリストを取得します。
リリースのリストおよびインスタンスのリストを取得するには、以下のコマンドを使用します。
```
curl -v -X GET http://server_url:server_port/api/sam/swinventory/product/product_ID
/releases
```
```
curl -v -X GET http://server_url:server_port/api/sam/swinventory/release/release_ID
/instances
```
外部ツールでインスタンスのリストをフィルタリングし、デスクトップ・コンピューターにインストールされているすべての BigFix 製品インスタンスのリストを取得します。
リストのフィルタリングには、スプレッドシートなどの外部ツールを使用できます。複数の基準に基づいてフィルタリングすることができます。デスクトップは、オペレーティング・システム名に「サーバー」という語を含まないコンピューターとして定義できます。ライセンス・タイプは Windows サーバーではなく、コンピューター・モデルは VMware ではありません。
フィルタリングされたリストからインベントリー ID を使用して、デスクトップ・コンピューターにインストールされている BigFix 製品のすべてのインスタンスを除外します。検索結果を除外するには、以下のコマンドを実行します。
```
curl -v -X POST http://server_url:server_port/api/sam/swinventory/exclude -d 
"productInventoryId=inventory_IDs&reason=no_licensing&updateTime=timestamp"
```
各部の意味は以下のとおりです。
- inventory_IDs は、再割り当てするインスタンスです。
- timestamp は、ミリ秒で表された更新時刻です。タイム・スタンプは、ステップで再割り当てするインスタンスのプロパティーとして取得したタイム・スタンプ以降の時刻でなければなりません。4
以下の例に示すとおり、すべてのインスタンスをコンマで区切って入力できます。
```
curl -v -X POST http://server_url:server_port/api/sam/swinventory/exclude -d 
"productInventoryId=134,137&reason=no_licensing&updateTime=9949237658579"
```
HTTP レスポンス 204 を受け取ります。選択されたインスタンスは除外されています。
「すべてのメトリック」レポートを開き、「再計算」をクリックして、BigFix の RVU 値を更新します。