REST API リソースおよび HTTP メソッド
BigFix Inventory REST API プロトコルの操作は、特定の REST リソースに対する HTTP メソッドとして定義されます。
| ターゲット REST 操作 URI | HTTP メソッド | 操作の目的 |
|---|---|---|
api/get_token |
POST |
REST API 要求を認証するために必要な固有のトークンを返します。 |
api/sam/about |
BigFix Inventory のバージョンを返します。 | |
api/import_status.json |
GET |
データ・インポートの現在の状況を返します。 |
| コア API | ||
 api/sam/v2/license_usage |
GET |
インフラストラクチャー内にインストールされている製品のライセンス・メトリック使用状況に関する情報を返します。 |
PUT |
ライセンス・メトリックのしきい値と、「すべてのメトリック」レポートに追加されたカスタム・フィールド値を設定します。 | |
 api/sam/v2/software_instances |
GET |
インフラストラクチャー内のソフトウェア・インベントリーに関する情報を返します。 |
api/sam/v2/computers |
GET |
インフラストラクチャー内のハードウェア・インベントリーに関する情報を返します。 |
 api/sam/v2/detailed_hw_ip_addresses |
GET |
インフラストラクチャー内のコンピューターの IP アドレスに関連する情報を取得します。 |
api/sam/v2/detailed_hw_lpars |
GET |
論理パーティションとその CPU リソースに関連する情報を取得します。 |
api/sam/v2/detailed_hw_memories |
GET |
スキャンされたシステムのシステム・メモリーに関連する情報を取得します。 |
api/sam/v2/detailed_hw_network_adapters |
GET |
ネットワーク・アダプターのタイプ、モデル、および MAC アドレスに関連する情報を取得します。 |
api/sam/v2/detailed_hw_operating_systems |
GET |
スキャンされたコンピューター上のオペレーティング・システムに関連する情報を取得します。 |
api/sam/v2/detailed_hw_partitions |
GET |
スキャンされたシステムにマウントされている以下のファイル・システムに関連する情報を取得します。Unix マウント・ポイントおよび Windows 論理ドライブ。 |
api/sam/v2/detailed_hw_physical_processors |
GET |
すべてのアクティブな物理プロセッサーに関連する情報を取得します。 |
api/sam/v2/detailed_hw_smbios |
GET |
スキャンされたシステムの SMBIOS に関連する情報を取得します。 |
api/sam/v2/detailed_hw_storages |
GET |
スキャンされたシステム上のストレージ・デバイスに関連する情報を取得します。 |
api/sam/raw_app_usage_property_values |
GET |
未加工の課金データを取得します。 |
api/sam/raw_file_facts |
GET |
未加工のスキャン済みファイル・データを取得します。 |
api/sam/raw_package_facts |
GET |
未加工のパッケージ・データを取得します。 |
api/sam/raw_unix_package_facts |
GET |
未加工の UNIX パッケージ・データを取得します。 |
 /api/sam/unified/current/software |
GET |
現在インストールされているソフトウェア・インスタンスとパッケージ・データの統合ビューを提供します。 |
| 構成 API | ||
 /api/sam/v2/contracts.json |
GET |
コントラクト情報を取得します。 |
/api/sam/v2/contracts.json |
PUT |
コントラクトを追加および更新します。 |
api/sam/vmmanagers |
GET |
現在のインフラストラクチャー内で定義されている VM マネージャーに関する情報を返します。 |
PUT |
VM マネージャーの追加または更新を行います。 | |
api/v1/servers |
PUT |
サーバーに割り当てられている Oracle コア係数を変更します。 |
 sam/component_lifecycles |
POST |
ソフトウェア・コンポーネントのサポート終了日を設定します。 |
sam/software_components/software_component_id/component_lifecycles |
DELETE |
ソフトウェア・コンポーネントのサポート終了日を削除します。 |
sam/software_components/software_component_id/component_lifecycles |
DELETE |
ソフトウェア・コンポーネントのサポート終了日を削除します。 |
api/reports/report_ID |
GET |
保存されたレポート・ビューをエクスポートします。 |
api/reports |
POST |
保存されたレポート・ビューをインポートします。 |
api/sam/configs |
GET |
管理サーバーの現在の設定に関する情報を返します。 |
PUT |
管理サーバーの現在の設定を変更します。 | |
 api/sam/v2/metrics |
POST |
製品とメトリックを作成および管理します。 |
GET |
製品とメトリックのリストを返します。 | |
PUT |
製品のメトリックを更新します。 | |
DELETE |
製品のメトリックを削除します。 | |
| 履歴 API | ||
api/sam/clusters |
GET |
ホスト・コンピューター・システムをグループ化するクラスターに関する情報を返します。 |
api/sam/computer_systems |
GET |
インフラストラクチャー内のコンピューター・システムのリストを返します。 |
api/sam/license_usages |
GET |
コンピューター・システムからレポートされたライセンス使用状況に関する情報を返します。 |
api/sam/software_instances |
GET |
インストールされているソフトウェア・インスタンスのリストを返します。 注: この REST API は api/sam/v2/software_instances REST API に置き換えられました。 |
api/sam/swinventory/confirm |
POST |
バンドルするインスタンスまたは割り当てるインスタンスを確認します。 |
api/sam/swinventory/confirmRelease |
POST |
リリースのインスタンスの割り当てを確認します。 |
api/sam/swinventory/exclude |
POST |
価格計算からインスタンスを除外します。 |
api/sam/swinventory/include |
POST |
価格計算にインスタンスを含めます。 |
api/sam/swinventory/instanceToShare |
GET |
特定のインスタンスを共有できるソフトウェア・リリースのリストを返します。 |
api/sam/swinventory/product/{product_id}/releases |
GET |
ID で識別される特定のソフトウェア製品のリリースのリストを返します。 |
api/sam/swinventory/products |
GET |
ソフトウェア製品のリストを返します。 |
api/sam/swinventory/reassign |
POST |
製品にインスタンスを再割り当てします。 |
api/sam/swinventory/reassignRelease |
POST |
リリースのリストを対象として製品にインスタンスを再割り当てします。 |
api/sam/swinventory/release/{release_id}/instances |
GET |
要求されたソフトウェア製品リリースのインスタンスのリストを返します。 |
api/sam/swinventory/share |
POST |
ソフトウェア製品のリストを使用してインスタンスを共有します。 |
api/sam/swinventory/targetBundlesOfInstances |
GET |
要求されたソフトウェア・インスタンスを再割り当てできるリリースのリストを返します。 |
api/sam/swinventory/targetBundlesOfReleases |
GET |
要求されたソフトウェア・リリースのインスタンスを再割り当てできる可能性のあるリリースのリストを返します。 |
api/sam/swinventory/targetInstances |
GET |
特定のリリースに再割り当てされるターゲット・インスタンスのリストを返します。 |