# REST Resource: projects.locations.backupPlans.revisions

- [Resource: BackupPlanRevision](https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions#BackupPlanRevision)
  - [JSON representation](https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions#BackupPlanRevision.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions#State)
- [Methods](https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions#METHODS_SUMMARY)

## Resource: BackupPlanRevision

`BackupPlanRevision` represents a snapshot of a `BackupPlan` at a point in time.

| JSON representation |
|---|
| ``` { "name": string, "revisionId": string, "state": enum (`https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions#State`), "backupPlanSnapshot": { object (`https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans#BackupPlan`) }, "createTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. Identifier. The resource name of the `BackupPlanRevision`. Format: `projects/{project}/locations/{location}/backupPlans/{backupPlan}/revisions/{revision}` |
| `revisionId` | `string` Output only. The user friendly revision ID of the `BackupPlanRevision`. Example: v0, v1, v2, etc. |
| `state` | ``enum (`https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions#State`)`` Output only. Resource State |
| `backupPlanSnapshot` | ``object (`https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans#BackupPlan`)`` The Backup Plan being encompassed by this revision. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp that the revision was created. 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

The state of the `BackupPlanRevision`.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | State not set. |
| `CREATING` | The resource is being created. |
| `ACTIVE` | The resource has been created and is fully usable. |
| `DELETING` | The resource is being deleted. |
| `INACTIVE` | The resource has been created but is not usable. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions/get` | Gets details of a single BackupPlanRevision. |
| ### `https://docs.cloud.google.com/backup-disaster-recovery/docs/reference/rest/v1/projects.locations.backupPlans.revisions/list` | Lists BackupPlanRevisions in a given project and location. |