Supported versions:
Unsupported versions:
Apigee hybrid backup and restore feature lets you create backups of the hybrid data and, in case of disaster scenarios, restore the data to previous working snapshots. Backup availability and retention is based on the backup infrastructure provided by you.
A typical installation of Apigee hybrid consists of the following components:
All the components except for Cassandra are stateless and do not persist any data. Backup and restoration is not necessary for those components. During recovery, reinstallation of those components using the existing overrides is sufficient.
Backups are an important measure of protection against disaster scenarios. Each backup acts as a consistent snapshot of the Cassandra data existing at the time the backup is created. In addition to Cassandra data, this snapshot includes schema and metadata within the Cassandra cluster. In the event of a disaster, backups enable you to restore your hybrid instance to a previously operational state. Depending on the size of the hybrid instance, a single backup set may contain one or more backup files.
Cassandra is a replicated database that is configured to have at least three copies of your data in each region or data center. Cassandra uses streaming replication and read repairs to maintain the data replicas in each region or data center at any given point.
In hybrid, Cassandra backups are not enabled by default. It's a good practice to enable Cassandra backups in the event your data is lost to a catastrophic failure. Cassandra backups are intended for use in cases of disaster recovery and not for restoring data loss caused by accidental deletion.
Backups are created according to the schedule set in your overrides.yaml file. Once
a backup schedule is applied to your hybrid cluster, a Kubernetes backup job is executed according to the schedule.
The job triggers a backup script on each Cassandra node in your hybrid cluster that collects all the data on the
node, creates an archive file of the data, and sends the archive to Cloud Storage or a directory on a
remote server.
The hybrid scheduled backup is a complete backup of the persisted runtime data stored in Apigee's Cassandra at the time of backup. Any data modifications after the backup time will not be available in the backup. The scheduled backup consist of the following entities:
The location of the backup data depends on your backup method. Apigee hybrid supports the following methods for taking backups:
If you are using Cloud Storage for backup, the backup data is encrypted by default. In case of backups not on Cloud Storage, backup data is encrypted during the transfer to the remote server. But after the transfer, you must ensure that the backup data is encrypted in the remote server.
Use one of these two methods to configure backups. For both methods, you'll
configure backup in your overrides.yaml file. Apigee recommends you make a
copy of the overrides.yaml file, so that you can reuse it during the recovery process.
The following sections describe in detail how to schedule backups in Cloud Storage and in a remote server.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-07-23 UTC.