1+ ---
2+ layout : page
3+ parent : CRD reference
4+ title : ArangoBackup V1
5+ ---
6+
17# API Reference for ArangoBackup V1
28
39## Spec
410
511### .spec.backoff.iterations
612
7- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec_backoff.go#L31 ) </sup >
13+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec_backoff.go#L31 ) </sup >
814
915Iterations defines number of iterations before reaching MaxDelay. Default to 5
1016
1117***
1218
1319### .spec.backoff.max_delay
1420
15- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec_backoff.go#L29 ) </sup >
21+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec_backoff.go#L29 ) </sup >
1622
1723MaxDelay defines maximum delay in seconds. Default to 600
1824
1925***
2026
2127### .spec.backoff.max_iterations
2228
23- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec_backoff.go#L33 ) </sup >
29+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec_backoff.go#L33 ) </sup >
2430
2531MaxIterations defines maximum number of iterations after backoff will be disabled. Default to nil (no limit)
2632
2733***
2834
2935### .spec.backoff.min_delay
3036
31- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec_backoff.go#L27 ) </sup >
37+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec_backoff.go#L27 ) </sup >
3238
3339MinDelay defines minimum delay in seconds. Default to 30
3440
3541***
3642
3743### .spec.deployment.name
3844
39- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L54 ) </sup >
45+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L54 ) </sup >
4046
4147Name of the ArangoDeployment Custom Resource within same namespace as ArangoBackup Custom Resource.
4248
@@ -46,7 +52,7 @@ This field is **immutable**: can't be changed after backup creation
4652
4753### .spec.download.credentialsSecretName
4854
49- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L81 ) </sup >
55+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L81 ) </sup >
5056
5157CredentialsSecretName is the name of the secret used while accessing repository
5258
@@ -59,7 +65,7 @@ This field is **immutable**: can't be changed after backup creation
5965
6066### .spec.download.id
6167
62- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L89 ) </sup >
68+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L89 ) </sup >
6369
6470ID of the ArangoBackup to be downloaded
6571
@@ -69,7 +75,7 @@ This field is **immutable**: can't be changed after backup creation
6975
7076### .spec.download.repositoryURL
7177
72- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L77 ) </sup >
78+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L77 ) </sup >
7379
7480RepositoryURL is the URL path for file storage
7581Same repositoryURL needs to be defined in ` credentialsSecretName ` if protocol is other than local.
@@ -90,15 +96,15 @@ This field is **immutable**: can't be changed after backup creation
9096
9197### .spec.lifetime
9298
93- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L47 ) </sup >
99+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L47 ) </sup >
94100
95101Lifetime is the time after which the backup will be deleted. Format: "1.5h" or "2h45m".
96102
97103***
98104
99105### .spec.options.allowInconsistent
100106
101- Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L66 ) </sup >
107+ Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L66 ) </sup >
102108
103109AllowInconsistent flag for Backup creation request.
104110If this value is set to true, backup is taken even if we are not able to acquire lock.
@@ -111,7 +117,7 @@ This field is **immutable**: can't be changed after backup creation
111117
112118### .spec.options.timeout
113119
114- Type: ` number ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L61 ) </sup >
120+ Type: ` number ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L61 ) </sup >
115121
116122Timeout for Backup creation request in seconds. Works only when AsyncBackupCreation feature is set to false.
117123
@@ -123,7 +129,7 @@ This field is **immutable**: can't be changed after backup creation
123129
124130### .spec.policyName
125131
126- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L42 ) </sup >
132+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L42 ) </sup >
127133
128134PolicyName name of the ArangoBackupPolicy which created this Custom Resource
129135
@@ -133,7 +139,7 @@ This field is **immutable**: can't be changed after backup creation
133139
134140### .spec.upload.credentialsSecretName
135141
136- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L81 ) </sup >
142+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L81 ) </sup >
137143
138144CredentialsSecretName is the name of the secret used while accessing repository
139145
@@ -146,7 +152,7 @@ This field is **immutable**: can't be changed after backup creation
146152
147153### .spec.upload.repositoryURL
148154
149- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_spec.go#L77 ) </sup >
155+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_spec.go#L77 ) </sup >
150156
151157RepositoryURL is the URL path for file storage
152158Same repositoryURL needs to be defined in ` credentialsSecretName ` if protocol is other than local.
@@ -167,99 +173,99 @@ This field is **immutable**: can't be changed after backup creation
167173
168174### .status.available
169175
170- Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L36 ) </sup >
176+ Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L36 ) </sup >
171177
172178Available Determines if we can restore from ArangoBackup
173179
174180***
175181
176182### .status.backoff.iterations
177183
178- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status_backoff.go#L30 ) </sup >
184+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status_backoff.go#L30 ) </sup >
179185
180186***
181187
182188### .status.backup.downloaded
183189
184- Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L66 ) </sup >
190+ Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L66 ) </sup >
185191
186192Downloaded Determines if ArangoBackup has been downloaded.
187193
188194***
189195
190196### .status.backup.id
191197
192- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L56 ) </sup >
198+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L56 ) </sup >
193199
194200***
195201
196202### .status.backup.imported
197203
198- Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L67 ) </sup >
204+ Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L67 ) </sup >
199205
200206***
201207
202208### .status.backup.keys
203209
204- Type: ` array ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L70 ) </sup >
210+ Type: ` array ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L70 ) </sup >
205211
206212***
207213
208214### .status.backup.numberOfDBServers
209215
210- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L62 ) </sup >
216+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L62 ) </sup >
211217
212218NumberOfDBServers Cluster size of the Backup in ArangoDB
213219
214220***
215221
216222### .status.backup.potentiallyInconsistent
217223
218- Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L58 ) </sup >
224+ Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L58 ) </sup >
219225
220226***
221227
222228### .status.backup.sizeInBytes
223229
224- Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L60 ) </sup >
230+ Type: ` integer ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L60 ) </sup >
225231
226232SizeInBytes Size of the Backup in ArangoDB.
227233
228234***
229235
230236### .status.backup.uploaded
231237
232- Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L64 ) </sup >
238+ Type: ` boolean ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L64 ) </sup >
233239
234240Uploaded Determines if ArangoBackup has been uploaded
235241
236242***
237243
238244### .status.backup.version
239245
240- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_status.go#L57 ) </sup >
246+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_status.go#L57 ) </sup >
241247
242248***
243249
244250### .status.message
245251
246- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_state.go#L88 ) </sup >
252+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_state.go#L91 ) </sup >
247253
248254Message for the state this object is in.
249255
250256***
251257
252258### .status.progress.jobID
253259
254- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_state.go#L111 ) </sup >
260+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_state.go#L114 ) </sup >
255261
256262JobID ArangoDB job ID for uploading or downloading
257263
258264***
259265
260266### .status.progress.progress
261267
262- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_state.go#L114 ) </sup >
268+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_state.go#L117 ) </sup >
263269
264270Progress ArangoDB job progress in percents
265271
@@ -272,22 +278,25 @@ Example:
272278
273279### .status.state
274280
275- Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.35 /pkg/apis/backup/v1/backup_state.go#L82 ) </sup >
281+ Type: ` string ` <sup >[ \[ ref\] ] ( https://github.com/arangodb/kube-arangodb/blob/1.2.36 /pkg/apis/backup/v1/backup_state.go#L85 ) </sup >
276282
277283State holds the current high level state of the backup
278284
279285Possible Values:
280- * Pending (default) - state in which Custom Resource is queued. If Backup is possible changed to "Scheduled"
281- * Scheduled - state which will start create/download process
282- * Download - state in which download request will be created on ArangoDB
283- * DownloadError - state when download failed
284- * Downloading - state for downloading progress
285- * Create - state for creation, field available set to true
286- * Upload - state in which upload request will be created on ArangoDB
287- * Uploading - state for uploading progress
288- * UploadError - state when uploading failed
289- * Ready - state when Backup is finished
290- * Deleted - state when Backup was once in ready, but has been deleted
291- * Failed - state for failure
292- * Unavailable - state when Backup is not available on the ArangoDB. It can happen in case of upgrades, node restarts etc.
286+ * ` "" ` (default) - state for un-initialized Custom Resource
287+ * ` "Pending" ` - state in which Custom Resource is queued. If Backup is possible changed to "Scheduled"
288+ * ` "Scheduled" ` - state which will start create/download process
289+ * ` "Download" ` - state in which download request will be created on ArangoDB
290+ * ` "DownloadError" ` - state when download failed
291+ * ` "Downloading" ` - state for downloading progress
292+ * ` "Create" ` - state for backup when it is scheduled for creation, field available set to true
293+ * ` "Creating" ` - state for backup when it is creating
294+ * ` "CreateError" ` - state for backup when it is creation failed
295+ * ` "Upload" ` - state in which upload request will be created on ArangoDB
296+ * ` "Uploading" ` - state for uploading progress
297+ * ` "UploadError" ` - state when uploading failed
298+ * ` "Ready" ` - state when Backup is finished
299+ * ` "Deleted" ` - state when Backup was once in ready, but has been deleted
300+ * ` "Failed" ` - state for failure
301+ * ` "Unavailable" ` - state when Backup is not available on the ArangoDB. It can happen in case of upgrades, node restarts etc.
293302
0 commit comments