BACKUP LIST 

BACKUP LIST
Available since:
Redis Open Source 8.10.0
Time complexity:
O(1)
ACL categories:
@admin, @slow, @dangerous,
Compatibility:
Redis Software and Redis Cloud compatibility

Returns the absolute paths of the immutable backup files pinned so far.

Examples

While the backup is still in the incrementing state, only the BASE file is pinned:

127.0.0.1:6379> BACKUP LIST
1) "/var/lib/redis/backupdir/appendonly.aof.3.base.rdb"

After BACKUP SEAL, the INCR file and the manifest are pinned as well:

127.0.0.1:6379> BACKUP LIST
1) "/var/lib/redis/backupdir/appendonly.aof.3.base.rdb"
2) "/var/lib/redis/backupdir/appendonly.aof.3.incr.aof"
3) "/var/lib/redis/backupdir/appendonly.aof.manifest"

Details

BACKUP LIST reports the absolute paths of the files that have been pinned by hard links so far. This lets the data plane start uploading the BASE snapshot while Redis is still accumulating incremental writes, before the backup is sealed. After the backup is sealed, the list also includes the INCR file and the manifest.

For the full workflow, see Redis persistence.

Redis Software and Redis Cloud compatibility

Redis
Software		 Redis
Cloud		 Notes
❌ Standard
❌ Active-Active		 ❌ Standard
❌ Active-Active

Return information

Array reply: the absolute paths of the immutable files pinned so far.

See also

BACKUP START | BACKUP SEAL | BACKUP STATUS | BACKUP ABORT | BACKUP CLEANUP

RATE THIS PAGE
Back to top ↑