export_config

Use this command to propagate either Venafi or remote logging configurations from a central manager to some or all of its associated managed units.

This API is available in Guardium v11.3 and later.

REST API syntax

This API is available as a REST service with the PUT method. Call this API as follows: 
PUT https://[Guardium hostname or IP address]:8443/restAPI/export_config

GuardAPI syntax

export_config parameter=value

Parameters

Parameter Value type Description
force Boolean If set to 1 (true), propagate the requested configuration even if some managed units are offline.

If set to 0 (false), all managed units must be online or the command fails with an error message.

Valid values:
  • 0 (false)
  • 1 (true)
  • false
  • true

Default = 0 (false)
host String Required. The host name, where host can be one of the following:
  • all_managed: execute on all managed units but not the central manager
  • group:<group name>: execute on all managed units identified by <group name>
  • Host name or IP address of a managed unit: specified from the central manager to execute on a managed unit. For example, host=10.0.1.123.

IP addresses must conform to the IP mode of your network. For dual IP mode, use the same IP protocol with which the managed unit is registered with the central manager. For example, if the registration uses IPv6, specify an IPv6 address. The hostname is independent of IP mode and can be used with any mode.
type String Required. Valid values:
  • venafi
  • remotelog

Example

The following command sends the remote logging configuration to managed units in the 'eastern-mus' managed unit group. Force is enabled to proceed to the next unit if one or more units fail to retrieve the configuration.
grdapi export_config type=remotelog host=group:eastern-mus force=true
The following command sends the Venafi configuration to managed units in the 'eastern-mus' managed unit group. Force is enabled to proceed to the next unit if one or more units fail to retrieve the configuration.
grdapi export_config type=venafi host=group:eastern-mus force=true