---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/restoreTemplates"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/restoreTemplates"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/restoreTemplates

`GET /v1/projects/{projectsId}/locations/{locationsId}/restoreTemplates`

## Request

- Base URL: `https://backupdr.googleapis.com`
- URL: `https://backupdr.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/restoreTemplates`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-backupdr`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-backupdr`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

Lists RestoreTemplates in a given project and location.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListRestoreTemplatesResponse: Response message for listing RestoreTemplates.
  - `nextPageToken` string: A token which may be sent as `page_token` in a subsequent `ListRestoreTemplates` call.
  - `restoreTemplates` RestoreTemplate[]: The list of RestoreTemplates.
    - `backupSelectionConfig` BackupSelectionConfig: Configuration for selecting a backup.
      - `dataSource` string: Required. Immutable. The fully qualified URI of the backupdr data source.
    - `createTime` string, google-datetime: Output only. The time when the restore template was created.
    - `description` string: Optional. User-provided description of the restore template.
    - `etag` string: Optional. Etag for concurrency control.
    - `executionSummary` ExecutionSummary: Summary of the last execution.
      - `lastExecution` string: Output only. The resource name of the last execution. Format: `projects/{project}/locations/{location}/restoreTemplates/{restore_template}/executions/{execution}`
      - `lastExecutionState` 'EXECUTION_STATE_UNSPECIFIED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'DELETING': Output only. The state of the last execution.
    - `labels` object: Optional. User-defined labels.
    - `name` string: Identifier. The resource name of the RestoreTemplate.
    - `postRestoreConfig` PostRestoreConfig: Configuration for Post-Restore.
      - `cloudRunJob` string: Cloud Run job action to execute. Format: `projects/{project}/locations/{location}/jobs/{job}`
      - `timeout` string, google-duration: Optional. The `timeout` for this phase. If set, the `timeout` must be positive and less than or equal to 24 hours (86400s).
    - `preRestoreConfig` PreRestoreConfig: Configuration for Pre-Restore.
      - `cloudRunJob` string: Cloud Run job action to execute. Format: `projects/{project}/locations/{location}/jobs/{job}`
      - `timeout` string, google-duration: Optional. The `timeout` for this phase. If set, the `timeout` must be positive and less than or equal to 24 hours (86400s).
    - `resourceType` string: Required. Immutable. The specific type of the workload being restored. The format is "{service_name}/{resource_kind}", for example, "compute.googleapis.com/Instance".
    - `restoreProperties` object: Required. Defines target environments where the resource will be restored. The target resource name in `restore_properties` supports the `{EXECUTION_ID}` token to dynamically generate unique resource names for each execution. During restore execution, every occurrence of `{EXECUTION_ID}` in the target resource name is replaced with the 8-character `RestoreTemplateExecution` ID (for example, `"restored-resource-{EXECUTION_ID}"` or `"restored-{EXECUTION_ID}-resource"` resolves to `"restored-resource-5d437b06"` or `"restored-5d437b06-resource"`).
    - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING': Output only. The state of the restore template.
    - `updateTime` string, google-datetime: Output only. The time when the restore template was last updated.
    - `verificationConfig` VerificationConfig: Configuration for Verification.
      - `cloudRunJob` string: Cloud Run job action to execute. Format: `projects/{project}/locations/{location}/jobs/{job}`
      - `timeout` string, google-duration: Optional. The `timeout` for this phase. If set, the `timeout` must be positive and less than or equal to 24 hours (86400s).
  - `unreachable` string[]: Locations that could not be reached.

## Changes

- **2026-11-05** `da857420b4f6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/backupdr/changes/v1/projects/:projectsId/locations/:locationsId/restoreTemplates/get.md)

---

[API](https://skmtc.dev/google/apis/backupdr.md) - [All operations](https://skmtc.dev/google/apis/backupdr/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/backupdr/revisions/da857420b4f6?raw)