Viewing Long-Term Retention Policy

To view the long-term retention policy defined for the backup job, use the following command:

veeamconfig gfs show --jobid <job_id>

or

veeamconfig gfs show --jobname <job_name>

where:

  • <job_id> — ID of the backup job for which you want to view the long-term retention policy.
  • <job_name> — name of the backup job for which you want to view the long-term retention policy.

Veeam Agent displays the following information about the backup job long-term retention policy:

Viewing Long-Term Retention Policy

Parameter

Description

GFS state

State of long-term retention policy. Possible values:

  • GFS is enabled
  • GFS is disabled
  • GFS is not set

Enabled

Possible values: true or false.

Desired time

Weekday, week number or month when Veeam Agent will set the GFS flag on the full restore point.

Keep for

Period of time for retaining the GFS flag on the full restore point.

The information listed in the table above is displayed for weekly, monthly and yearly retention policies.

For example:

user@wrk01:~$ veeamconfig gfs show --jobid 4849a3ae-1935-4969-98a3-d8acd2f6c73f

GFS is enabled

Weekly:

Enabled: true

Desired time: Friday

Keep for: 1 weeks

Monthly:

Enabled: false

Desired time: First

Keep for: 1 months

Yearly:

Enabled: false

Desired time: January

Keep for: 1 years

Page updated 2026-10-20

Page content applies to build 13.1.2.4