feat(spanner): Add resource reference annotation to backup schedules

Google APIs · copybara-github · commit 96facece981f · 2024-08-13T00:31:07.000-07:00
docs(spanner): Add an example to filter backups based on schedule name

PiperOrigin-RevId: 662402292
diff --git a/google/spanner/admin/database/v1/backup.proto b/google/spanner/admin/database/v1/backup.proto
@@ -184,8 +184,12 @@ message Backup {
   // the list of all backup schedule URIs that are associated with creating
   // this backup. If collapsing is not done, then this field captures the
   // single backup schedule URI associated with creating this backup.
-  repeated string backup_schedules = 14
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+  repeated string backup_schedules = 14 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/BackupSchedule"
+    }
+  ];
 
   // Output only. Populated only for backups in an incremental backup chain.
   // Backups share the same chain id if and only if they belong to the same
@@ -426,6 +430,7 @@ message ListBackupsRequest {
   //   * `expire_time`  (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
   //   * `version_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
   //   * `size_bytes`
+  //   * `backup_schedules`
   //
   // You can combine multiple expressions by enclosing each expression in
   // parentheses. By default, expressions are combined with AND logic, but
@@ -444,6 +449,8 @@ message ListBackupsRequest {
   //   * `expire_time < \"2018-03-28T14:50:00Z\"`
   //          - The backup `expire_time` is before 2018-03-28T14:50:00Z.
   //   * `size_bytes > 10000000000` - The backup's size is greater than 10GB
+  //   * `backup_schedules:daily`
+  //          - The backup is created from a schedule with "daily" in its name.
   string filter = 2;
 
   // Number of backups to be returned in the response. If 0 or
