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

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

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

## Request

- Base URL: `https://backupdr.googleapis.com`
- URL: `https://backupdr.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/backupPlanAssociations`
- 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 BackupPlanAssociations in a given project and location.

## Path parameters

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

## Query parameters

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

## Response `200`

Successful response

- ListBackupPlanAssociationsResponse: Response message for List BackupPlanAssociation
  - `backupPlanAssociations` BackupPlanAssociation[]: The list of Backup Plan Associations in the project for the specified location. If the `{location}` value in the request is "-", the response contains a list of instances from all locations. In case any location is unreachable, the response will only return backup plan associations in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations.
    - `alloydbClusterBackupPlanAssociationProperties` AlloyDBClusterBackupPlanAssociationProperties: Properties for an AlloyDB cluster backup plan association.
      - `clusterUid` string: Output only. The cluster UID of the AlloyDB cluster.
    - `autoProtectionPolicyBinding` string: Output only. The resource name of the `AutoProtectionPolicyBinding` that manages this association, if any. Format: `projects/{project}/locations/{location}/autoProtectionPolicies/{policy}/bindings/{binding}`.
    - `backupPlan` string: Required. Resource name of backup plan which needs to be applied on workload. Format: projects/{project}/locations/{location}/backupPlans/{backupPlanId}
    - `backupPlanRevisionId` string: Output only. The user friendly revision ID of the `BackupPlanRevision`. Example: v0, v1, v2, etc.
    - `backupPlanRevisionName` string: Output only. The resource id of the `BackupPlanRevision`. Format: `projects/{project}/locations/{location}/backupPlans/{backup_plan}/revisions/{revision_id}`
    - `cloudSqlInstanceBackupPlanAssociationProperties` CloudSqlInstanceBackupPlanAssociationProperties: Cloud SQL instance's BPA properties.
      - `instanceCreateTime` string, google-datetime: Output only. The time when the instance was created.
    - `createTime` string, google-datetime: Output only. The time when the instance was created.
    - `dataSource` string: Output only. Resource name of data source which will be used as storage location for backups taken. Format : projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSources/{datasource}
    - `filestoreInstanceBackupPlanAssociationProperties` FilestoreInstanceBackupPlanAssociationProperties: Filestore instance's BPA properties.
      - `instanceCreateTime` string, google-datetime: Output only. The time when the instance was created.
    - `name` string: Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId}
    - `netappVolumeBackupPlanAssociationProperties` NetAppVolumeBackupPlanAssociationProperties: NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. .
      - `sourceResourceCreateTime` string, google-datetime: Output only. The creation timestamp of the source resource.
    - `resource` string: Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance").
    - `resourceType` string: Required. Immutable. Resource type of workload on which backupplan is applied
    - `rulesConfigInfo` RuleConfigInfo[]: Output only. The config info related to backup rules.
      - `lastBackupError` Status: The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
        - `code` integer: The status code, which should be an enum value of google.rpc.Code.
        - `details` object[]: A list of messages that carry the error details. There is a common set of message types for APIs to use.
        - `message` string: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
      - `lastBackupState` 'LAST_BACKUP_STATE_UNSPECIFIED' | 'FIRST_BACKUP_PENDING' | 'PERMISSION_DENIED' | 'SUCCEEDED' | 'FAILED': Output only. The last backup state for rule.
      - `lastSuccessfulBackupConsistencyTime` string, google-datetime: Output only. The point in time when the last successful backup was captured from the source.
      - `ruleId` string: Output only. Backup Rule id fetched from backup plan.
    - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'INACTIVE' | 'UPDATING' | 'PAUSED': Output only. The BackupPlanAssociation resource state.
    - `updateTime` string, google-datetime: Output only. The time when the instance was updated.
  - `nextPageToken` string: A token identifying a page of results the server should return.
  - `unreachable` string[]: Locations that could not be reached.

## Changes

- **2026-11-05** `da857420b4f6`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`
- **2026-10-29** `3244196e66b0`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-backupdr` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/backupdr/changes/v1/projects/:projectsId/locations/:locationsId/backupPlanAssociations/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)