A database backup is a dated export of a Database Instance stored on an offsite backend located in a different region than your database, by default. Once a backup is created, it can be used to restore the database. Each logical database in a Database Instance is backed up and can be restored separately.
List database backups
List all backups in a specified region, for a given Scaleway Organization or Scaleway Project. By default, the backups listed are ordered by creation date in ascending order. This can be modified via the order_by field.
path Parameters
regionThe region you want to target
query Parameters
nameName of the database backups.
order_byCriteria to use when ordering database backups listing.
instance_idUUID of the Database Instance.
organization_idOrganization ID of the Organization the database backups belong to.
project_idProject ID of the Project the database backups belong to.
pagepage_sizeList database backups › Responses
List of database backups.
total_countTotal count of database backups available.
Create a database backup
Create a new backup. You must set the instance_id, database_name, name and expires_at parameters.
path Parameters
regionThe region you want to target
Create a database backup › Request Body
instance_idUUID of the Database Instance.
database_nameName of the database you want to back up.
nameName of the backup.
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
Create a database backup › Responses
idUUID of the database backup.
instance_idUUID of the Database Instance.
database_nameName of backed up database.
nameName of the backup.
statusStatus of the backup.
sizeSize of the database backup. (in bytes)
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
created_atCreation date (must follow the ISO 8601 format). (RFC 3339 format)
updated_atUpdated date (must follow the ISO 8601 format). (RFC 3339 format)
instance_nameName of the Database Instance of the backup.
download_urlURL you can download the backup from.
download_url_expires_atExpiration date of the download link. (RFC 3339 format)
regionRegion of the database backup.
same_regionStore logical backups in the same region as the source Database Instance.
Get a database backup
Retrieve information about a given backup, specified by its database backup ID and region. Full details about the backup, like size, URL and expiration date, are returned in the response.
path Parameters
regionThe region you want to target
database_backup_idUUID of the database backup.
Get a database backup › Responses
idUUID of the database backup.
instance_idUUID of the Database Instance.
database_nameName of backed up database.
nameName of the backup.
statusStatus of the backup.
sizeSize of the database backup. (in bytes)
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
created_atCreation date (must follow the ISO 8601 format). (RFC 3339 format)
updated_atUpdated date (must follow the ISO 8601 format). (RFC 3339 format)
instance_nameName of the Database Instance of the backup.
download_urlURL you can download the backup from.
download_url_expires_atExpiration date of the download link. (RFC 3339 format)
regionRegion of the database backup.
same_regionStore logical backups in the same region as the source Database Instance.
Delete a database backup
Delete a backup, specified by its database backup ID and region. Deleting a backup is permanent, and cannot be undone.
path Parameters
regionThe region you want to target
database_backup_idUUID of the database backup to delete.
Delete a database backup › Responses
idUUID of the database backup.
instance_idUUID of the Database Instance.
database_nameName of backed up database.
nameName of the backup.
statusStatus of the backup.
sizeSize of the database backup. (in bytes)
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
created_atCreation date (must follow the ISO 8601 format). (RFC 3339 format)
updated_atUpdated date (must follow the ISO 8601 format). (RFC 3339 format)
instance_nameName of the Database Instance of the backup.
download_urlURL you can download the backup from.
download_url_expires_atExpiration date of the download link. (RFC 3339 format)
regionRegion of the database backup.
same_regionStore logical backups in the same region as the source Database Instance.
Update a database backup
Update the parameters of a backup, including name and expiration date.
path Parameters
regionThe region you want to target
database_backup_idUUID of the database backup to update.
Update a database backup › Request Body
nameName of the Database Backup.
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
Update a database backup › Responses
idUUID of the database backup.
instance_idUUID of the Database Instance.
database_nameName of backed up database.
nameName of the backup.
statusStatus of the backup.
sizeSize of the database backup. (in bytes)
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
created_atCreation date (must follow the ISO 8601 format). (RFC 3339 format)
updated_atUpdated date (must follow the ISO 8601 format). (RFC 3339 format)
instance_nameName of the Database Instance of the backup.
download_urlURL you can download the backup from.
download_url_expires_atExpiration date of the download link. (RFC 3339 format)
regionRegion of the database backup.
same_regionStore logical backups in the same region as the source Database Instance.
Export a database backup
Export a backup, specified by the database_backup_id and the region parameters. The download URL is returned in the response.
path Parameters
regionThe region you want to target
database_backup_idUUID of the database backup you want to export.
Export a database backup › Responses
idUUID of the database backup.
instance_idUUID of the Database Instance.
database_nameName of backed up database.
nameName of the backup.
statusStatus of the backup.
sizeSize of the database backup. (in bytes)
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
created_atCreation date (must follow the ISO 8601 format). (RFC 3339 format)
updated_atUpdated date (must follow the ISO 8601 format). (RFC 3339 format)
instance_nameName of the Database Instance of the backup.
download_urlURL you can download the backup from.
download_url_expires_atExpiration date of the download link. (RFC 3339 format)
regionRegion of the database backup.
same_regionStore logical backups in the same region as the source Database Instance.
Restore a database backup
Launch the process of restoring database backup. You must specify the instance_id of the Database Instance of destination, where the backup will be restored. Note that large database backups can take up to several hours to restore.
path Parameters
regionThe region you want to target
database_backup_idBackup of a logical database.
Restore a database backup › Request Body
instance_idDefines the Database Instance where the backup has to be restored.
database_nameDefines the destination database to restore into a specified database (the default destination is set to the origin database of the backup).
Restore a database backup › Responses
idUUID of the database backup.
instance_idUUID of the Database Instance.
database_nameName of backed up database.
nameName of the backup.
statusStatus of the backup.
sizeSize of the database backup. (in bytes)
expires_atExpiration date (must follow the ISO 8601 format). (RFC 3339 format)
created_atCreation date (must follow the ISO 8601 format). (RFC 3339 format)
updated_atUpdated date (must follow the ISO 8601 format). (RFC 3339 format)
instance_nameName of the Database Instance of the backup.
download_urlURL you can download the backup from.
download_url_expires_atExpiration date of the download link. (RFC 3339 format)
regionRegion of the database backup.
same_regionStore logical backups in the same region as the source Database Instance.