Machine backup policy
Machine backup policy provides a backup functionality to the workload. For more information on the machine backup functionality, see this section of the Acronis Cyber Protection User Guide.
The following example can be used when creating a protection plan with this protection policy:
Policy example
1{
2 # Put a unique ID of the policy here.
3 "id": "",
4 # Machine backup policy type is 'policy.backup.machine'
5 'type': 'policy.backup.machine',
6 'parent_ids': [
7 # Put the ID of total protection policy here.
8 ],
9 'origin': 'upstream',
10 'enabled': True,
11 'settings_schema': '2.0',
12 'settings': {
13 # Archive compression level. Available values: ``normal``, ``high``, ``max``. When value is not specified - no compression is applied.
14 'compression': 'normal',
15 # Format of the Acronis backup archive. Available values: ``11``, ``12``, ``auto``.
16 'format': 'auto',
17 # If true, snapshots of multiple volumes will be taken simultaneously. Equals to false if value is not specified.
18 'multi_volume_snapshotting_enabled': True,
19 # If true, the file security settings will be preserved. Equals to false if value is not specified.
20 'preserve_file_security_settings': True,
21 # Configuration of retries on recoverable errors during the backup operations like reconnection to destination. No attempts to fix recoverable errors will be made if retry configuration is not set.
22 'reattempts': {
23 # If true, enables retry on recoverable errors.
24 'enabled': True,
25 # An interval between retry attempts.
26 'interval': {
27 # A type of the interval. Available values are: ``seconds``, ``minutes``, ``hours``, ``days``.
28 'type': 'seconds',
29 # The amount of value specified in ``interval.type``.
30 'count': 30
31 },
32 # Max number of retry attempts. Operation will be considered as failed when max number of retry attempts is reached.
33 'max_attempts': 30
34 },
35 # If true, a user interaction will be avoided when possible. Equals to false if value is not specified.
36 'silent_mode_enabled': True,
37 # Determines the size to split backups on. Splitting is not performed if value is not specified.
38 'splitting': {
39 # The size of split backup file in bytes.
40 'size': 9223372036854775807
41 },
42 # Configuration of retries on errors during the creation of the virtual machine snapshot. No attempts to fix recoverable errors will be made if retry configuration is not set.
43 'vm_snapshot_reattempts': {
44 # If true, enables retry on errors.
45 'enabled': True,
46 # Configuration of the interval between retry attempts.
47 'interval': {
48 # A type of the interval. Available values are: ``seconds``, ``minutes``, ``hours``, ``days``.
49 'type': 'minutes',
50 # The amount of value specified in ``interval.type``.
51 'count': 5
52 },
53 # Max number of retry attempts. Operation will be considered as failed when max number of retry attempts is reached.
54 'max_attempts': 3
55 },
56 # Settings for the Volume Shadow Copy Service (VSS) provider. If not set, no VSS provider is used.
57 'vss': {
58 # If true, the VSS will be enabled.
59 'enabled': True,
60 # A type of VSS provider to use in backup. Only ``native`` and ``target_system_defined`` options are available.
61 'provider': 'target_system_defined'
62 },
63 # The archive properties.
64 'archive': {
65 # The name of the generated archive. The name may use the following variables: ``[Machine Name]``, ``[Plan ID]``, ``[Plan Name]``, ``[Unique ID]``, ``[Virtualization Server Type]``.
66 'name': '[Machine Name]-[Plan ID]-[Unique ID]A'
67 },
68 # Time windows for performance limitations of backup and storage maintenance operations.
69 'performance_window': {
70 'enabled': False # If true, the time windows will be enabled.
71 },
72 # Configuration of backup retention rules.
73 'retention': {
74 # A list of retention rules.
75 'rules': [
76 {
77 # A list of backup sets where rules are effective.
78 'backup_set': [
79 'daily'
80 ],
81 # Configuration of the duration to keep backups in archive created by the policy.
82 'max_age': {
83 # A type of the duration. Available values are: ``seconds``, ``minutes``, ``hours``, ``days``.
84 'type': 'days',
85 # The amount of value specified in ``max_age.type``.
86 'count': 7
87 }
88 },
89 {
90 'backup_set': [
91 'weekly'
92 ],
93 'max_age': {
94 'type': 'weeks',
95 'count': 4
96 }
97 },
98 {
99 'backup_set': [
100 'monthly'
101 ],
102 'max_age': {
103 'type': 'months',
104 'count': 6
105 }
106 }
107 ],
108 # If true, retention rules will be applied after backup is finished.
109 'after_backup': True
110 },
111 # Storage location of the archives.
112 'vault': {
113 # Type of storage location. Available values: ``local_folder``, ``network_share``, ``ftp``, ``sftp``, ``cd``, ``tape``, ``storage_node``, ``asz``, ``removable``, ``cloud``, ``nfs_share``, ``esx``, ``astorage2``, ``script``.
114 'type': 'cloud',
115 # If true, the vault will be accessed using the policy credentials.
116 'use_policy_credentials': True
117 },
118 # Configuration of policy-related alerts.
119 'alerts': {
120 # If true, the alerts will be enabled.
121 'enabled': False,
122 # Number of days that will trigger the alert about the passed number of days without a backup.
123 'max_days_without_backup': 5
124 },
125 # Configuration of the backup schedule.
126 'scheduling': {
127 # A list of schedules with backup sets that compose the whole scheme.
128 'backup_sets': [
129 {
130 'type': 'auto',
131 'schedule': {
132 'alarms': {
133 'time': {
134 'weekdays': [
135 'mon',
136 'tue',
137 'wed',
138 'thu',
139 'fri'
140 ],
141 'repeat_at': [
142 {
143 'hour': 21,
144 'minute': 0
145 }
146 ]
147 }
148 },
149 'conditions': {},
150 'prevent_sleep': True,
151 'type': 'weekly'
152 }
153 }
154 ],
155 # If true, the backup schedule will be enabled.
156 'enabled': True,
157 # Max number of backup processes allowed to run in parallel. Unlimited if not set.
158 'max_parallel_backups': 2,
159 'rand_max_delay': { # Configuration of the random delay between the execution of parallel tasks.
160 # A type of the duration. Available values are: ``seconds``, ``minutes``, ``hours``, ``days``.
161 'type': 'minutes',
162 # The amount of value specified in ``rand_max_delay.type``.
163 'count': 30
164 },
165 # A backup scheme. Available values: ``simple``, ``always_full``, ``always_incremental``, ``weekly_incremental``, ``weekly_full_daily_incremental``, ``custom``, ``cdp``.
166 'scheme': 'always_incremental',
167 # A day of week to start weekly backups in 3-letter abbreviation format.
168 'weekly_backup_day': 'mon'
169 },
170 # A configuration of Changed Block Tracking (CBT). Available values: ``use_if_enabled``, ``enable_and_use``, ``do_not_use``.
171 'cbt': 'enable_and_use',
172 # If true, determines whether a file has changed by the file size and timestamp. Otherwise, the entire file contents are compared to those stored in the backup.
173 'fast_backup_enabled': True,
174 # If true, a quiesced snapshot of the virtual machine will be taken.
175 'quiesce_snapshotting_enabled': True
176 }
177}