REST API resources and HTTP methods

The operations of the BigFix InventoryLicense Metric Tool REST API protocol are defined as HTTP methods on certain REST resources.

Table 1. Overview of REST operations

The table consists of three columns and 26 rows.

Target REST operation URI HTTP methods Purpose of the operation
api/get_token POST Returns a unique token that is required to authenticate REST API requests.
api/import_status.json GET Returns the current status of the data import.
api/reports POST Imports a saved report view.
api/reports/report_ID GET Exports a saved report view.
api/sam/about GET Returns the version of BigFix InventoryLicense Metric Tool.
api/sam/clusters GET Returns information about clusters that group your host computer systems.
api/sam/computer_systems GET Returns a list of computer systems in your infrastructure.
api/sam/configs GET Returns information about the current settings of the administration server.
PUT Changes the current settings of the administration server.
api/sam/contracts/import POST Imports contracts from a csv file.
api/sam/license_usages GET Returns information about license usage reported by your computer systems.
api/sam/raw_app_usage_property_values GET Retrieves raw metering data.
api/sam/raw_file_facts GET Retrieves raw scanned file data.
api/sam/raw_package_facts GET Retrieves raw package data.
api/sam/raw_unix_package_facts GET Retrieves raw UNIX package data.
api/sam/software_instances GET Returns a list of installed software instances.
api/sam/swinventory/confirm POST Confirms instances to bundle or assign.
api/sam/swinventory/confirmRelease POST Confirms the assignment of instances for a release.
api/sam/swinventory/exclude POST Excludes instances from pricing calculations.
api/sam/swinventory/include POST Includes instances in pricing calculations.
api/sam/swinventory/instanceToShare GET Returns a list of software releases that can share a particular instance.
api/sam/swinventory/product/{product_id}/releases GET Returns a list of releases of a particular software product that is identified by its identifier.
api/sam/swinventory/products GET Returns a list of software products.
api/sam/swinventory/reassign POST Reassigns instances to a product.
api/sam/swinventory/reassignRelease POST Reassigns instances to a product for a list of releases.
api/sam/swinventory/release/{release_id}/instances GET Returns a list of instances for the requested software product release.
api/sam/swinventory/share POST Shares an instance with a list of software products.
api/sam/swinventory/targetBundlesOfInstances GET Returns a list of possible releases to which the requested software instance can be reassigned.
api/sam/swinventory/targetBundlesOfReleases GET Returns a list of possible releases to which the instances of the requested software releases can be reassigned.
api/sam/swinventory/targetInstances GET Returns a list of target instances that will be reassigned to a particular release.
9.2.8 api/sam/v2/computers GET Returns information about hardware inventory in your infrastructure.
9.2.10 api/sam/v2/license_usage GET Returns information about utilization of license metrics by products that are installed in your infrastructure.
PUT Sets up license metric thresholds as well as values of custom fields that were added on the All MetricsAll IBM Metrics report.
9.2.8 api/sam/v2/software_instances GET Returns information about software inventory in your infrastructure.
api/sam/vmmanagers GET Returns information about VM managers that are defined in your infrastructure.
PUT Adds or updates VM managers.
9.2.8 api/v1/servers PUT Changes Oracle core factor that is assigned to a server.
9.2.11 sam/component_lifecycles POST Sets the end of support date for software components.
9.2.11 sam/software_components/software_component_id/component_lifecycles DELETE Removes the end of support date for a software component.
9.2.12 api/sam/v2/detailed_hw_ip_addresses GET Retrieves information related to IP addresses of computers in your infrastructure.
9.2.12 api/sam/v2/detailed_hw_lpars GET Retrieves information related to the logical partition and its CPU resources.
9.2.12 api/sam/v2/detailed_hw_memories GET Retrieves information related to information related to the system memory of the scanned system.
9.2.12 api/sam/v2/detailed_hw_network_adapters GET Retrieves information related to information related to the type, model and MAC addresses of the network adapters.
9.2.12 api/sam/v2/detailed_hw_operating_systems GET Retrieves information related to information related to the operating system on the scanned computer.
9.2.12 api/sam/v2/detailed_hw_partitions GET Retrieves information related to information related to the file system that is mounted on a scanned system: Unix mount points and Windows logical drives.
9.2.12 api/sam/v2/detailed_hw_physical_processors GET Retrieves information related to information related to all active physical processors.
9.2.12 api/sam/v2/detailed_hw_smbios GET Retrieves information related to information related to SMBIOS of the scanned system.
9.2.12 api/sam/v2/detailed_hw_storages GET Retrieves information related to information related to storage devices on the scanned system.