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

* feat(spanner): add edition field to the instance proto

PiperOrigin-RevId: 662226829

Source-Link: googleapis/googleapis@eb87f47

Source-Link: googleapis/googleapis-gen@0fb784e
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGZiNzg0ZTgyNjdmMDkzMWQyNGYxNTJlYzVmNjZlODA5YzJhMmVmYiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat(spanner): Add resource reference annotation to backup schedules
docs(spanner): Add an example to filter backups based on schedule name

PiperOrigin-RevId: 662402292

Source-Link: googleapis/googleapis@96facec

Source-Link: googleapis/googleapis-gen@fe33f1c
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmUzM2YxYzYxNDE1YWVmNGU3MGY0OTFkZmI4Nzg5YTY4ZThkOTA4MyJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

.gitignore

@@ -12,4 +12,3 @@ system-test/*key.json
 .DS_Store
 package-lock.json
 __pycache__
-.vscode

protos/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

protos/google/spanner/admin/instance/v1/spanner_instance_admin.proto

@@ -3073,6 +3073,7 @@ export class DatabaseAdminClient {
    *     * `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
@@ -3091,6 +3092,8 @@ export class DatabaseAdminClient {
    *     * `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.
    * @param {number} request.pageSize
    *   Number of backups to be returned in the response. If 0 or
    *   less, defaults to the server's maximum allowed page size.
@@ -3214,6 +3217,7 @@ export class DatabaseAdminClient {
    *     * `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
@@ -3232,6 +3236,8 @@ export class DatabaseAdminClient {
    *     * `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.
    * @param {number} request.pageSize
    *   Number of backups to be returned in the response. If 0 or
    *   less, defaults to the server's maximum allowed page size.
@@ -3303,6 +3309,7 @@ export class DatabaseAdminClient {
    *     * `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
@@ -3321,6 +3328,8 @@ export class DatabaseAdminClient {
    *     * `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.
    * @param {number} request.pageSize
    *   Number of backups to be returned in the response. If 0 or
    *   less, defaults to the server's maximum allowed page size.