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

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

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

## Request

- Base URL: `https://backupdr.googleapis.com`
- URL: `https://backupdr.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/dataSourceReferences`
- 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 DataSourceReferences for 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

- ListDataSourceReferencesResponse: Response for the ListDataSourceReferences method.
  - `dataSourceReferences` DataSourceReference[]: The DataSourceReferences from the specified parent.
    - `createTime` string, google-datetime: Output only. The time when the DataSourceReference was created.
    - `dataSource` string: Output only. The resource name of the DataSource. Format: projects/{project}/locations/{location}/backupVaults/{backupVault}/dataSources/{dataSource}
    - `dataSourceBackupConfigInfo` DataSourceBackupConfigInfo: Information of backup configuration on the DataSource.
      - `lastBackupState` 'LAST_BACKUP_STATE_UNSPECIFIED' | 'FIRST_BACKUP_PENDING' | 'SUCCEEDED' | 'FAILED' | 'PERMISSION_DENIED': Output only. The status of the last backup in this DataSource
      - `lastSuccessfulBackupConsistencyTime` string, google-datetime: Output only. Timestamp of the last successful backup to this DataSource.
    - `dataSourceBackupConfigState` 'BACKUP_CONFIG_STATE_UNSPECIFIED' | 'ACTIVE' | 'PASSIVE' | 'PAUSED': Output only. The backup configuration state of the DataSource.
    - `dataSourceBackupCount` string, int64: Output only. Number of backups in the DataSource.
    - `dataSourceGcpResourceInfo` DataSourceGcpResourceInfo: The Google Cloud resource that the DataSource is associated with.
      - `alloyDbClusterProperties` AlloyDBClusterDataSourceReferenceProperties: AlloyDBClusterDataSourceReferenceProperties represents the properties of an AlloyDB cluster that are stored in the DataSourceReference.
        - `name` string: Output only. Name of the AlloyDB cluster backed up by the datasource. Format: projects/{project}/locations/{location}/clusters/{cluster}
      - `cloudSqlInstanceProperties` CloudSqlInstanceDataSourceReferenceProperties: CloudSqlInstanceDataSourceReferenceProperties represents the properties of a Cloud SQL resource that are stored in the DataSourceReference.
        - `databaseInstalledVersion` string: Output only. The installed database version of the Cloud SQL instance.
        - `instanceCreateTime` string, google-datetime: Output only. The instance creation timestamp.
        - `instanceTier` string: Output only. The tier (or machine type) for this instance. Example: `db-custom-1-3840`
        - `name` string: Output only. Name of the Cloud SQL instance backed up by the datasource. Format: projects/{project}/instances/{instance}
      - `filestoreInstanceProperties` FilestoreInstanceDataSourceReferenceProperties: FilestoreInstanceDataSourceReferenceProperties represents the properties of a Filestore resource that are stored in the DataSourceReference. .
        - `instanceCreateTime` string, google-datetime: Output only. The instance creation timestamp.
        - `name` string: Output only. Name of the Filestore instance backed up by the datasource. Format: projects/{project}/instances/{instance}
      - `gcpResourcename` string: Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance}
      - `location` string: Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified"
      - `netappVolumeProperties` NetAppVolumeDataSourceReferenceProperties: NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. .
        - `sourceResource` string: Output only. The source volume represented by this DataSourceReference.
        - `sourceResourceCreateTime` string, google-datetime: Output only. The volume creation timestamp.
      - `type` string: Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance
    - `name` string: Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference}
    - `totalStoredBytes` string, int64: Output only. Total size of the storage used by all backup resources for the referenced datasource.
  - `nextPageToken` string: A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `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/dataSourceReferences/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)