Enable processes after relocation

By default, after relocating devices from a Remote Agent to a Central Manager, or between Remote Agents, some processes may be disabled on the Remote Agent, including monitoring, scheduled analysis, and syslog messaging. This topic describes APIs that enable you to enable these services again on a device after relocation.

For more details, see Default configurations for relocated devices.

Enable processes for a specific device

Enables monitoring, scheduled analysis, and syslog messaging on a specific device after relocation from a Remote Agent For more details, see Relocate devices.

Resource Name: /api/v1/device/relocation/enableDevices

Request Method: PUT

Request URL Parameters:

Element

Type

Description

treeNames

Mandatory

String

One or more treeNamesClosed A name for the device that includes an aggregated string of the device's name and the name of any parent or grandparent devices. This name is not displayed in the UI, and must be returned from the database by API. Since this name includes the tree hierarchy, it's used as the unique system device. Alternate terms: tree name, name, unique name, database name, canonized name of devices on which you want to enable processes.

Separate multiple values with commas.

Response:

Code

Description

200

Operation completed successfully

400

Bad request

401

Unauthorized

Request example

curl -X PUT "https://10.20.7.20/afa/api/v1/device/relocation/enableDevices" -H "accept: */*" -H "Content-Type: application/json" -d "[ \"10.20.150.1_Lion_New_Lion_New_secure\",\"10.20.150.1_Lion_New_Lion_New_management\"]"

Back to top

Enable processes for all devices on a Remote Agent

Enables monitoring, scheduled analysis, and syslog messaging on all devices managed by a specific Remote Agent, after relocating from a different Remote Agent. For more details, see Relocate devices.

Resource Name: /api/v1/device/relocation/enableDevicesOnRemoteAgent

Request Method: PUT

Request URL Parameters:

Element

Type

Description

node

Mandatory

String

Name of the node on which you want to enable processes, as listed on the Architecture tab of the AFAAdministration area.

Response:

Code

Description

200

Operation completed successfully

400

Bad request

401

Unauthorized

Request example:

curl -X PUT "https://10.20.7.20/afa/api/v1/device/relocation/enableDevicesOnRemoteAgent?node=RA1" -H "accept: */*"

Back to top