Configuration of advanced server settings

Available from 9.2.3. You use the PUT operation on the api/sam/configs element to change the values of the BigFix Inventory server settings.

An icon representing a user. You must be an Administrator to perform this task.
Table 1. Operation descriptions

The table consists of two columns and 15 rows.

Operation details Description
Operation PUT /api/sam/configs
Purpose Changes the current value of a server setting.
HTTP method PUT
Resource URI https://server_host_name:port_number/api/sam/configs
URL link relation n/a
URL query parameters For a list of query parameters, see: Query parameters.
Request headers
Header
Accept-Language (optional)
Values
en-US (only English is supported)

Used to negotiate the language of the response. If this header is not specified, the content is returned in the server language.

Request payload n/a
Request Content-Type
  • application/x-www-form-urlencoded
Response headers
Header
Content-Language
Values
en-US, …

Specifies the language of the response content. If this header is not specified, the content is returned in the server language.

Response payload n/a
Response Content-Type n/a
Normal HTTP response codes
  • 204
Error HTTP response codes
  • 400 - "Bad Request" if the provided value is invalid. For example, it is out of range or has a wrong type.
  • 404 - "Not Found"

Query parameters

The following table presents query parameters that you can use for the configs element.

Table 2. Query parameters for changing current values of server settings

The table consists of four columns and three rows.

Parameter Description Required Value
name Specifies the parameter whose value is to be changed. For a complete list of possible values and their explanation, see: Advanced server settings. Yes Name of the parameter
token A unique user authentication identifier. Yes Alphanumeric
value Specifies the new value of the parameter. Yes Value that is within the range specific for the parameter.

Example HTTP conversation

Request
PUT http://localhost:9981/api/sam/configs
?token=7adc3efb175e2bc0f4484bdd2efca54a8fa04623&name=
maxVMManagerInactivity&value=30