APIs used with OADP
You can use the following APIs with OADP:
- Velero API
Velero API documentation is maintained by Velero and is not maintained by Red Hat.
- OADP API
The following are the OADP APIs:
DataProtectionApplicationSpecBackupLocationSnapshotLocationApplicationConfigVeleroConfigCustomPluginResticConfigPodConfigFeaturesDataMover
DataProtectionApplicationSpec type
The following are DataProtectionApplicationSpec OADP APIs:
DataProtectionApplicationSpec
| Property | Type | Description |
|---|---|---|
backupLocations | [] BackupLocation | Defines the list of configurations to use for BackupStorageLocations. |
snapshotLocations | [] SnapshotLocation | Defines the list of configurations to use for VolumeSnapshotLocations. |
unsupportedOverrides | map [ UnsupportedImageKey ] string | Can be used to override the deployed dependent images for development. Options are veleroImageFqin, awsPluginImageFqin, hypershiftPluginImageFqin, openshiftPluginImageFqin, azurePluginImageFqin, gcpPluginImageFqin, csiPluginImageFqin, dataMoverImageFqin, resticRestoreImageFqin, kubevirtPluginImageFqin, and operator-type. |
podAnnotations | map [ string ] string | Used to add annotations to pods deployed by Operators. |
podDnsPolicy | DNSPolicy | Defines the configuration of the DNS of a pod. |
podDnsConfig | PodDNSConfig | Defines the DNS parameters of a pod in addition to those generated from DNSPolicy. |
backupImages | *bool | Used to specify whether or not you want to deploy a registry for enabling backup and restore of images. |
configuration | *ApplicationConfig | Used to define the data protection application’s server configuration. |
features | *Features | Defines the configuration for the DPA to enable the Technology Preview features. |
BackupLocation type
The following are BackupLocation OADP APIs:
BackupLocation
| Property | Type | Description |
|---|---|---|
velero | *velero.BackupStorageLocationSpec | Location to store volume snapshots, as described in Backup Storage Location. |
bucket | *CloudStorageLocation | Automates creation of a bucket at some cloud storage providers for use as a backup storage location. |
The bucket parameter is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.
SnapshotLocation type
The following are SnapshotLocation OADP APIs:
SnapshotLocation
| Property | Type | Description |
|---|---|---|
velero | *VolumeSnapshotLocationSpec | Location to store volume snapshots, as described in Volume Snapshot Location. |
ApplicationConfig type
The following are ApplicationConfig OADP APIs:
ApplicationConfig
| Property | Type | Description |
|---|---|---|
velero | *VeleroConfig | Defines the configuration for the Velero server. |
restic | *ResticConfig | Defines the configuration for the Restic server. |
VeleroConfig type
The following are VeleroConfig OADP APIs:
VeleroConfig
| Property | Type | Description |
|---|---|---|
featureFlags | [] string | Defines the list of features to enable for the Velero instance. |
defaultPlugins | [] string | The following types of default Velero plugins can be installed: aws,azure, csi, gcp, kubevirt, and openshift. |
customPlugins | []CustomPlugin | Used for installation of custom Velero plugins. |
restoreResourcesVersionPriority | string | Represents a config map that is created if defined for use in conjunction with the EnableAPIGroupVersions feature flag. Defining this field automatically adds EnableAPIGroupVersions to the Velero server feature flag. |
noDefaultBackupLocation | bool | To install Velero without a default backup storage location, you must set the noDefaultBackupLocation flag in order to confirm installation. |
podConfig | *PodConfig | Defines the configuration of the Velero pod. |
logLevel | string | Velero server’s log level (use debug for the most granular logging, leave unset for Velero default). Valid options are trace, debug, info, warning, error, fatal, and panic. |
CustomPlugin type
The following are CustomPlugin OADP APIs:
CustomPlugin
ResticConfig type
The following are ResticConfig OADP APIs:
ResticConfig
| Property | Type | Description |
|---|---|---|
enable | *bool | If set to true, enables backup and restore using Restic. If set to false, snapshots are needed. |
supplementalGroups | []int64 | Defines the Linux groups to be applied to the Restic pod. |
timeout | string | A user-supplied duration string that defines the Restic timeout. Default value is 1hr (1 hour). A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as 300ms, -1.5h, or 2h45m. Valid time units are ns, us (or µs), ms, s, m, and h. |
podConfig | *PodConfig | Defines the configuration of the Restic pod. |
PodConfig type
The following are PodConfig OADP APIs:
PodConfig
| Property | Type | Description |
|---|---|---|
nodeSelector | map [ string ] string | Defines the nodeSelector to be supplied to a Velero podSpec or a Restic podSpec. |
tolerations | []Toleration | Defines the list of tolerations to be applied to a Velero deployment or a Restic daemonset. |
resourceAllocations | ResourceRequirements | Set specific resource limits and requests for a Velero pod or a Restic pod as described in the Setting Velero CPU and memory resource allocations section. |
labels | map [ string ] string | Labels to add to pods. |
Features type
The following are Features OADP APIs:
Features
| Property | Type | Description |
|---|---|---|
dataMover | *DataMover | Defines the configuration of the Data Mover. |
DataMover type
The following are DataMover OADP APIs:
DataMover
| Property | Type | Description |
|---|---|---|
enable | bool | If set to true, deploys the volume snapshot mover controller and a modified CSI Data Mover plugin. If set to false, these are not deployed. |
credentialName | string | User-supplied Restic Secret name for Data Mover. |
timeout | string | A user-supplied duration string for VolumeSnapshotBackup and VolumeSnapshotRestore to complete. Default is 10m (10 minutes). A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as 300ms, -1.5h, or 2h45m. Valid time units are ns, us (or µs), ms, s, m, and h. |