- [Resource: Backup](https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups#Backup)
  - [JSON representation](https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups#Backup.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups#State)
- [Methods](https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups#METHODS_SUMMARY)

## Resource: Backup

The details of a backup resource.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "endTime": string, "state": enum (`https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups#State`), "serviceRevision": { object (`https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services#Service`) }, "description": string, "restoringServices": [ string ] } ``` |

| Fields ||
|---|---|
| `name` | `string` Immutable. Identifier. The relative resource name of the backup, in the following form: `projects/{projectNumber}/locations/{locationId}/services/{serviceId}/backups/{backupId}` |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the backup was started. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `endTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the backup finished creating. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `state` | ``enum (`https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups#State`)`` Output only. The current state of the backup. |
| `serviceRevision` | ``object (`https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services#Service`)`` Output only. The revision of the service at the time of backup. |
| `description` | `string` Optional. The description of the backup. |
| `restoringServices[]` | `string` Output only. Services that are restoring from the backup. |

## State

The current state of the backup.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | The state of the backup is unknown. |
| `CREATING` | The backup is being created. |
| `DELETING` | The backup is being deleted. |
| `ACTIVE` | The backup is active and ready to use. |
| `FAILED` | The backup failed. |
| `RESTORING` | The backup is being restored. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/create` | Creates a new backup in a given project and location. |
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/delete` | Deletes a single backup. |
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/get` | Gets details of a single backup. |
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/getIamPolicy` | Gets the access control policy for a resource. |
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/list` | Lists backups in a service. |
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/setIamPolicy` | Sets the access control policy on the specified resource. |
| ### `https://docs.cloud.google.com/dataproc-metastore/docs/reference/rest/v1beta/projects.locations.services.backups/testIamPermissions` | Returns permissions that a caller has on the specified resource. |