--- title: "GET /v1/projects/{projectsId}/locations/{locationsId}/backupVaults/{backupVaultsId}/dataSources" method: GET path: "/v1/projects/{projectsId}/locations/{locationsId}/backupVaults/{backupVaultsId}/dataSources" tags: ["projects"] --- # GET /v1/projects/{projectsId}/locations/{locationsId}/backupVaults/{backupVaultsId}/dataSources `GET /v1/projects/{projectsId}/locations/{locationsId}/backupVaults/{backupVaultsId}/dataSources` ## Request - Base URL: `https://backupdr.googleapis.com` - URL: `https://backupdr.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/backupVaults/{backupVaultsId}/dataSources` - 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 DataSources in a given project and location. ## Path parameters - `projectsId` string, required - `locationsId` string, required - `backupVaultsId` string, required ## Query parameters - `filter` string - `orderBy` string - `pageSize` integer - `pageToken` string ## Response `200` Successful response - ListDataSourcesResponse: Response message for listing DataSources. - `dataSources` DataSource[]: The list of DataSource instances 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 data sources in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations. - `backupBlockedByVaultAccessRestriction` boolean: Output only. This field is set to true if the backup is blocked by vault access restriction. - `backupConfigInfo` BackupConfigInfo: BackupConfigInfo has information about how the resource is configured for Backup and about the most recent backup to this vault. - `backupApplianceBackupConfig` BackupApplianceBackupConfig: BackupApplianceBackupConfig captures the backup configuration for applications that are protected by Backup Appliances. - `applicationName` string: The name of the application. - `backupApplianceId` string, int64: The ID of the backup appliance. - `backupApplianceName` string: The name of the backup appliance. - `hostName` string: The name of the host where the application is running. - `slaId` string, int64: The ID of the SLA of this application. - `slpName` string: The name of the SLP associated with the application. - `sltName` string: The name of the SLT associated with the application. - `gcpBackupConfig` GcpBackupConfig: GcpBackupConfig captures the Backup configuration details for Google Cloud resources. All Google Cloud resources regardless of type are protected with backup plan associations. - `autoProtectionPolicyBinding` string: Output only. The resource name of the `AutoProtectionPolicyBinding` that manages this datasource, if any. Format: `projects/{project}/locations/{location}/autoProtectionPolicies/{policy}/bindings/{binding}`. - `backupPlan` string: The name of the backup plan. - `backupPlanAssociation` string: The name of the backup plan association. - `backupPlanDescription` string: The description of the backup plan. - `backupPlanRevisionId` string: The user friendly id of the backup plan revision. E.g. v0, v1 etc. - `backupPlanRevisionName` string: The name of the backup plan revision. - `backupPlanRules` string[]: The names of the backup plan rules which point to this backupvault - `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' | 'SUCCEEDED' | 'FAILED' | 'PERMISSION_DENIED': Output only. The status of the last backup to this BackupVault - `lastSuccessfulBackupConsistencyTime` string, google-datetime: Output only. If the last backup were successful, this field has the consistency date. - `backupCount` string, int64: Number of backups in the data source. - `configState` 'BACKUP_CONFIG_STATE_UNSPECIFIED' | 'ACTIVE' | 'PASSIVE' | 'PAUSED': Output only. The backup configuration state. - `createTime` string, google-datetime: Output only. The time when the instance was created. - `dataSourceBackupApplianceApplication` DataSourceBackupApplianceApplication: BackupApplianceApplication describes a Source Resource when it is an application backed up by a BackupAppliance. - `applianceId` string, int64: Appliance Id of the Backup Appliance. - `applicationId` string, int64: The appid field of the application within the Backup Appliance. - `applicationName` string: The name of the Application as known to the Backup Appliance. - `backupAppliance` string: Appliance name. - `hostId` string, int64: Hostid of the application host. - `hostname` string: Hostname of the host where the application is running. - `type` string: The type of the application. e.g. VMBackup - `dataSourceGcpResource` DataSourceGcpResource: DataSourceGcpResource is used for protected resources that are Google Cloud Resources. This name is easeier to understand than GcpResourceDataSource or GcpDataSourceResource - `alloyDbClusterDatasourceProperties` AlloyDBClusterDataSourceProperties: AlloyDBClusterDataSourceProperties represents the properties of a AlloyDB cluster resource that are stored in the DataSource. . - `clusterUid` string: Output only. The cluster UID of the AlloyDB cluster backed up by the datasource. - `name` string: Output only. Name of the AlloyDB cluster backed up by the datasource. - `pitrWindows` AlloyDbPitrWindow[]: Output only. Point in time recovery windows. The order is guaranteed to be ascending by start time. - `endTime` string, google-datetime: Output only. The end time of the PITR window. It is not set if the corresponding Backup Plan Association is active. - `logRetentionDays` string, int64: Output only. Log retention days for the PITR window. - `startTime` string, google-datetime: Output only. The start time of the PITR window. - `cloudSqlInstanceDatasourceProperties` CloudSqlInstanceDataSourceProperties: CloudSqlInstanceDataSourceProperties represents the properties of a Cloud SQL resource that are stored in the DataSource. - `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} - `computeInstanceDatasourceProperties` ComputeInstanceDataSourceProperties: ComputeInstanceDataSourceProperties represents the properties of a ComputeEngine resource that are stored in the DataSource. - `description` string: The description of the Compute Engine instance. - `machineType` string: The machine type of the instance. - `name` string: Name of the compute instance backed up by the datasource. - `totalDiskCount` string, int64: The total number of disks attached to the Instance. - `totalDiskSizeGb` string, int64: The sum of all the disk sizes. - `diskDatasourceProperties` DiskDataSourceProperties: DiskDataSourceProperties represents the properties of a Disk resource that are stored in the DataSource. . - `description` string: The description of the disk. - `name` string: Name of the disk backed up by the datasource. - `sizeGb` string, int64: The size of the disk in GB. - `type` string: The type of the disk. - `filestoreInstanceDatasourceProperties` FilestoreInstanceDataSourceProperties: FilestoreInstanceDataSourceProperties represents the properties of a Filestore resource that are stored in the DataSource. . - `instanceCreateTime` string, google-datetime: Output only. The instance creation timestamp. - `name` string: Output only. Name of the Filestore instance backed up by the datasource. - `gcpResourcename` string: Output only. Full resource pathname URL of the source Google Cloud resource. - `location` string: Location of the resource: //"global"/"unspecified". - `netappVolumeDatasourceProperties` NetAppVolumeDataSourceProperties: NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . - `sourceResource` string: Output only. The source volume represented by this DataSource. - `sourceResourceCreateTime` string, google-datetime: Output only. The volume creation timestamp. - `type` string: The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. - `etag` string: Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. - `labels` object: Optional. Resource labels to represent user provided metadata. No labels currently defined: - `name` string: Output only. Identifier. Name of the datasource to create. It must have the format`"projects/{project}/locations/{location}/backupVaults/{backupvault}/dataSources/{datasource}"`. `{datasource}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the backup vault. - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'ERROR': Output only. The DataSource resource instance state. - `totalStoredBytes` string, int64: The number of bytes (metadata and data) stored in this datasource. - `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/backupVaults/:backupVaultsId/dataSources/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)