Sets the expiration time of the backup. The expiration time of the backup, with
microseconds granularity that must be at least 6 hours and at most 366 days from the time the
request is received. Once the expireTime has passed, Cloud Spanner will delete the backup and
free the resources used by the backup.
Specifies the timestamp to have an externally consistent copy of the database. If no
version time is specified, it will be automatically set to the backup create time.
The version time can be as far in the past as specified by the database earliest version
time (see Database#getEarliestVersionTime()).
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class BackupInfo.Builder (6.98.1)\n\nVersion latestkeyboard_arrow_down\n\n- [6.98.1 (latest)](/java/docs/reference/google-cloud-spanner/latest/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.98.0](/java/docs/reference/google-cloud-spanner/6.98.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.97.1](/java/docs/reference/google-cloud-spanner/6.97.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.96.1](/java/docs/reference/google-cloud-spanner/6.96.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.95.1](/java/docs/reference/google-cloud-spanner/6.95.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.94.0](/java/docs/reference/google-cloud-spanner/6.94.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.93.0](/java/docs/reference/google-cloud-spanner/6.93.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.89.0](/java/docs/reference/google-cloud-spanner/6.89.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.88.0](/java/docs/reference/google-cloud-spanner/6.88.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.87.0](/java/docs/reference/google-cloud-spanner/6.87.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.86.0](/java/docs/reference/google-cloud-spanner/6.86.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.85.0](/java/docs/reference/google-cloud-spanner/6.85.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.83.0](/java/docs/reference/google-cloud-spanner/6.83.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.82.0](/java/docs/reference/google-cloud-spanner/6.82.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.80.1](/java/docs/reference/google-cloud-spanner/6.80.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.79.0](/java/docs/reference/google-cloud-spanner/6.79.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.77.0](/java/docs/reference/google-cloud-spanner/6.77.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.74.1](/java/docs/reference/google-cloud-spanner/6.74.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.72.0](/java/docs/reference/google-cloud-spanner/6.72.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.71.0](/java/docs/reference/google-cloud-spanner/6.71.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.69.0](/java/docs/reference/google-cloud-spanner/6.69.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.68.0](/java/docs/reference/google-cloud-spanner/6.68.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.66.0](/java/docs/reference/google-cloud-spanner/6.66.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.65.1](/java/docs/reference/google-cloud-spanner/6.65.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.62.0](/java/docs/reference/google-cloud-spanner/6.62.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.60.0](/java/docs/reference/google-cloud-spanner/6.60.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.58.0](/java/docs/reference/google-cloud-spanner/6.58.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.57.0](/java/docs/reference/google-cloud-spanner/6.57.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.56.0](/java/docs/reference/google-cloud-spanner/6.56.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.55.0](/java/docs/reference/google-cloud-spanner/6.55.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.54.0](/java/docs/reference/google-cloud-spanner/6.54.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.53.0](/java/docs/reference/google-cloud-spanner/6.53.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.52.1](/java/docs/reference/google-cloud-spanner/6.52.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.51.0](/java/docs/reference/google-cloud-spanner/6.51.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.50.1](/java/docs/reference/google-cloud-spanner/6.50.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.49.0](/java/docs/reference/google-cloud-spanner/6.49.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.25.1](/java/docs/reference/google-cloud-spanner/6.25.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.24.0](/java/docs/reference/google-cloud-spanner/6.24.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.23.4](/java/docs/reference/google-cloud-spanner/6.23.4/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.22.0](/java/docs/reference/google-cloud-spanner/6.22.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.21.2](/java/docs/reference/google-cloud-spanner/6.21.2/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.20.0](/java/docs/reference/google-cloud-spanner/6.20.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.19.1](/java/docs/reference/google-cloud-spanner/6.19.1/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.18.0](/java/docs/reference/google-cloud-spanner/6.18.0/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.17.4](/java/docs/reference/google-cloud-spanner/6.17.4/com.google.cloud.spanner.BackupInfo.Builder)\n- [6.14.1](/java/docs/reference/google-cloud-spanner/6.14.1/com.google.cloud.spanner.BackupInfo.Builder) \n\n public abstract static class BackupInfo.Builder\n\nInheritance\n-----------\n\n[java.lang.Object](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html) \\\u003e BackupInfo.Builder \n\nInherited Members\n-----------------\n\n[Object.clone()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--) \n[Object.equals(Object)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-) \n[Object.finalize()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--) \n[Object.getClass()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--) \n[Object.hashCode()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--) \n[Object.notify()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--) \n[Object.notifyAll()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--) \n[Object.toString()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--) \n[Object.wait()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--) \n[Object.wait(long)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-) \n[Object.wait(long,int)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-)\n\nConstructors\n------------\n\n### Builder()\n\n public Builder()\n\nMethods\n-------\n\n### addAllReferencingBackups(List\\\u003cString\\\u003e referencingBackups)\n\n protected BackupInfo.Builder addAllReferencingBackups(List\u003cString\u003e referencingBackups)\n\nOutput Only.\n\nReturns the names of the destination backups being created by copying this source backup.\n\n### build()\n\n public abstract Backup build()\n\nBuilds the backup from this builder.\n\n### setDatabase(DatabaseId database)\n\n public abstract BackupInfo.Builder setDatabase(DatabaseId database)\n\nRequired for creating a new backup.\n\nSets the source database to use for creating the backup.\n\n### setEncryptionConfig(BackupEncryptionConfig encryptionConfig)\n\n public abstract BackupInfo.Builder setEncryptionConfig(BackupEncryptionConfig encryptionConfig)\n\nOptional for creating a new backup.\n\nThe encryption configuration to be used for the backup. The possible configurations are\n[com.google.cloud.spanner.encryption.CustomerManagedEncryption](/java/docs/reference/google-cloud-spanner/latest/com.google.cloud.spanner.encryption.CustomerManagedEncryption), [com.google.cloud.spanner.encryption.GoogleDefaultEncryption](/java/docs/reference/google-cloud-spanner/latest/com.google.cloud.spanner.encryption.GoogleDefaultEncryption) and [com.google.cloud.spanner.encryption.UseDatabaseEncryption](/java/docs/reference/google-cloud-spanner/latest/com.google.cloud.spanner.encryption.UseDatabaseEncryption).\n\nIf no encryption config is given the backup will be created with the same encryption as\nset by the database ([com.google.cloud.spanner.encryption.UseDatabaseEncryption](/java/docs/reference/google-cloud-spanner/latest/com.google.cloud.spanner.encryption.UseDatabaseEncryption)).\n\n### setExpireTime(Timestamp expireTime)\n\n public abstract BackupInfo.Builder setExpireTime(Timestamp expireTime)\n\nRequired for creating a new backup.\n\nSets the expiration time of the backup. The expiration time of the backup, with\nmicroseconds granularity that must be at least 6 hours and at most 366 days from the time the\nrequest is received. Once the expireTime has passed, Cloud Spanner will delete the backup and\nfree the resources used by the backup.\n\n### setMaxExpireTime(Timestamp maxExpireTime)\n\n protected BackupInfo.Builder setMaxExpireTime(Timestamp maxExpireTime)\n\nOutput Only.\n\nReturns the max allowed expiration time of the backup, with microseconds granularity.\n\n### setVersionTime(Timestamp versionTime)\n\n public abstract BackupInfo.Builder setVersionTime(Timestamp versionTime)\n\nOptional for creating a new backup.\n\nSpecifies the timestamp to have an externally consistent copy of the database. If no\nversion time is specified, it will be automatically set to the backup create time.\n\nThe version time can be as far in the past as specified by the database earliest version\ntime (see [Database#getEarliestVersionTime()](/java/docs/reference/google-cloud-spanner/latest/com.google.spanner.admin.database.v1.Database#com_google_spanner_admin_database_v1_Database_getEarliestVersionTime__))."]]
