revert_device_revision
Revert a managed device's stored configuration database to a past revision without changing the live FortiGate; push the reverted DB separately after confirmation.
Instructions
Revert a device's device DB to a past revision.
This rewrites FortiManager's stored device DB copy for device only --
the live FortiGate is not touched. Push the reverted device DB to the
device the same way any other device DB change is pushed: preview_install
then install_device_settings.
Safety: governed by FMG_REVERT_SAFETY (default "strict"), same pattern as revert_adom_revision -- refused unless confirm=True is also passed. Set FMG_REVERT_SAFETY=disabled to remove it.
Note:
Requires the device to have at least one device DB revision on
record -- see the note on list_device_revisions. Not live-tested
(reverting a device's config is a real, consequential write); the
request shape matches the FNDN-documented, non-deprecated
/deployment/revert command exactly (see client.py), which the
sibling get/checkout calls confirm works correctly on this FMG
generation for devices that have revision history.
Args: device: Managed device name revision: Revision number to revert to (see list_device_revisions) confirm: Must be True to proceed under FMG_REVERT_SAFETY=strict (default). Ignored when FMG_REVERT_SAFETY=disabled.
Returns: dict: status, device, revision, message
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"device": "<device>",
"revision": "<revision>"
},
"name": "revert_device_revision"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | Yes | ||
| confirm | No | ||
| revision | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||