Welcome
Integrating with REST API
External systems integration is one of the key features of BigFix Inventory. Business logic is enabled for integration and interfaces are provided for common integration points.
REST API
Managing large amounts of information by using the application user interface can be time-consuming. You can use the REST APIs as an alternative to the graphical user interface to reduce the time that is needed to manage your software inventory and the content of your software catalog.
Configuration APIs
Configuration APIs include all APIs that you need to configure the application.
REST API for setting and deleting the end of support date
Available from 9.2.11. You can set and delete the end of support date for any software component by using REST API.
Deleting the end of support date for software components
Available from 9.2.11. You use the DELETE operation on the sam/software_components/software_component_id/component_lifecycles/ element to remove the end of support date for a software component.

BigFix Documentation Homepage
BigFix 10 Inventory Documentation
Overview
Become familiar with key concepts that are necessary to understand how BigFix Inventory works and learn about features and functions that are introduced in every version of the application.
Installing
Learn about the requirements and available installation scenarios to ensure that the deployment of BigFix Inventory goes smoothly in your environment.
Configuring
After you install BigFix Inventory, configure the application. Create accounts for the users who need access to the application and set up scans to collect software and hardware inventory data from your environment.
Upgrading
A new version of BigFix Inventory is released periodically, typically at the end of each calendar quarter. Upgrade to the new version regularly to take full advantage of new features and application fixes.
Managing the infrastructure
After you complete the initial configuration of BigFix Inventory, learn how to manage components of its infrastructure: VM managers, server, database, and data sources.
Software inventory and license utilization
You can classify the discovered software so that reports in BigFix Inventory reflect your entitlements and properly show utilization of license metrics by particular products.
Managing security threats
Learn how to use BigFix Inventory to manage security threats in your environment. You can view whether any of the installed components is prone to any Common Vulnerability and Exposure (CVE).
Tutorials
Tutorials help you understand how to use BigFix Inventory. They consist of modules that focus on broad goals. Modules consist of tasks that show how to configure specific settings step-by-step.
Security
Configure different security features to adequately protect business assets and resources in the data model when using BigFix Inventory.
Troubleshooting and support
Learn about solutions to common problems that might arise when you use BigFix Inventory BigFix Inventory and how to find logs and trace files that help you troubleshoot those problems.
Tuning performance
Learn how to plan the infrastructure of BigFix Inventory and to configure the application server to achieve optimal performance. The following guidelines are applicable in big data environments as well as in smaller environments that are running on low-performance hardware.
Integrating with REST API
External systems integration is one of the key features of BigFix Inventory. Business logic is enabled for integration and interfaces are provided for common integration points.
- REST API
  Managing large amounts of information by using the application user interface can be time-consuming. You can use the REST APIs as an alternative to the graphical user interface to reduce the time that is needed to manage your software inventory and the content of your software catalog.
  - Software Products and Software Components
    BigFix Inventory detects software components which are bundled with the product.
  - REST API resources and HTTP methods
    The operations of the BigFix Inventory REST API protocol are defined as HTTP methods on certain REST resources.
  - Common REST API elements
    You use connectors and operators to build query segments that filter on matching conditions and values.
  - Mapping REST API versions
    Available from 9.2.8. For some REST APIs, version 2 is created to provide improved functions or experience. In such cases, the original API becomes deprecated with time and only version 2 is further developed. If you have custom tools or internal processes that are based on such REST APIs, it is best to adjust the tools to use the new version of the APIs.
  - REST API for retrieving authentication token
    You use the POST operation on the api/get_token element to request your unique token that is required to authenticate the REST API requests.
  - REST API for retrieving the BigFix Inventory version
    You use the GET operation on the api/sam/about element to request information about the version of BigFix Inventory.
  - Core APIs
    Core APIs include all primary set of APIs that are integrated with BigFix Inventory.
  - Configuration APIs
    Configuration APIs include all APIs that you need to configure the application.
    - REST API for managing VM managers
      You can use REST API requests to add and change VM managers in your infrastructure.
    - REST API for changing advanced server settings
      Available from 9.2.3. You can change the parameters of the BigFix Inventory server by using REST API.
    - REST API for setting and deleting the end of support date
      Available from 9.2.11. You can set and delete the end of support date for any software component by using REST API.
      - Setting the end of support date for software components
        Available from 9.2.11. You use the POST operation on the sam/component_lifecycles element to set the end of support date for software components. The end of support date is added on the Software Components report. If you want to change the end of support date, you must first delete the current date and then set a new one by using this API.
      - Deleting the end of support date for software components
        Available from 9.2.11. You use the DELETE operation on the sam/software_components/software_component_id/component_lifecycles/ element to remove the end of support date for a software component.
    - REST API for adding and removing tags
      Available from 9.2.14. You can add and remove tags for any software component by using REST API.
    - REST API for export and import of saved report views
      You can use REST API requests to export a saved report view from one instance of BigFix Inventory and import it to another instance of the application.
    - REST API for updating the Oracle core factor
      Available from 9.2.8. You use the PUT operation on the api/v1/servers element to change the processor core factor that is applied to a group of servers for the purpose of calculating utilization of the Oracle Processor Core metric.
    - REST API for managing license metrics
      Use REST API requests to retrieve, create, change, and delete license metrics. From version 10.0.5, you can also manage metrics through the UI. See also, managing license metrics through UI.
    - REST API for managing contracts
      With the /api/sam/v2/contracts.json API, you can import and export contract data with purchase information. This operation is used to automate integration with external purchase systems. You can also manage contracts using: contracts CSV import, user interface - All Contracts panel and deprecated contracts migration.
  - Historical APIs
    For some REST APIs, version 2 is created to provide improved functions or experience. In such cases, the original API is deprecated and version 2 is supported. You must adjust your custom tools or internal processes to the new version of these APIs.
Glossary
Guide in PDF format

Deleting the end of support date for software components

9.2.11 Available from 9.2.11. You use the DELETE operation on the sam/software_components/software_component_id/component_lifecycles/ element to remove the end of support date for a software component.

Permissions

User You must have the Manage Catalogs permission to use this API.

Resource URL

https://hostname:port/sam/software_components/software_component_id/component_lifecycles?token=token

Resource information

Table 1. Resource information
Operation details	Description
HTTP method	`DELETE`
Request headers	Header `Accept-Language` (optional) Values en-US (only English is supported) Negotiates the language of the response. If the header is not specified, the content is returned in the server language.
Request format	`application/json`
Response headers	Header `Content-Type` Values `application/json` Specifies the content type of the response.
Response headers	Header `Content-Language` Values en-US, … Specifies the language of the response content. If the header is not specified, the content is returned in the server language.
Response format	`application/json`
Response codes	`200 – OK`

Example conversation - clearing the end of support date for a software component

To retrieve information about the software component ID for which you want to clear the end of support date, perform the following steps:
1. Log in to BigFix Inventory.
2. Go to Reports > Software Components.
3. Hover over the component name and check the URL address at the bottom of the page. The software component ID is a number at the end of the URL. For example: sam/catalog/software_components/10379

To remove the end of support date, use the following DELETE request.

Request header

DELETE sam/software_components/10379/component_lifecycles?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623
Host: localhost:9081 
Accept: application/json 
Accept-Language: en-US

Response

200 - OK