feat(gkebackup): added new restore scope options (#8176)

- [ ] Regenerate this pull request now.

feat: added transformation rules for restore
feat: added BackupPlan and RestorePlan state information

These features aim to do the following:
1. Improve flexibility of restore with new options to define new kinds of scope configurations.
2. Improve flexibility of restore by supporting Transformation Rules, which enable the removal and addition of spec fields of restored resources prior to their creation.
3. Improve observability by revealing the state information of BackupPlan and RestorePlan.

PiperOrigin-RevId: 543605700

Source-Link: https://togithub.com/googleapis/googleapis/commit/d39c91b3ac0abec1490ef00010107355a4dae317

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/0cf7f93d4a60fae7fbd1a9ab03f7da4c62fb1bd2
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGNmN2Y5M2Q0YTYwZmFlN2ZiZDFhOWFiMDNmN2RhNGM2MmZiMWJkMiJ9
BEGIN_NESTED_COMMIT
feat(storagetransfer): add event driven transfer configuration
PiperOrigin-RevId: 543540202

Source-Link: https://togithub.com/googleapis/googleapis/commit/48e47e82d76801d617c17e331f0639d8804c7b91

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/66b276eda2f701eb12805750c2755163f0bb8c76
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNjZiMjc2ZWRhMmY3MDFlYjEyODA1NzUwYzI3NTUxNjNmMGJiOGM3NiJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
docs(servicemanagement): update docs to existing services
PiperOrigin-RevId: 543515380

Source-Link: https://togithub.com/googleapis/googleapis/commit/16df59535457c3f3e6900d75050371609b74175f

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/d059689d626da251efa3d5e1e1c4d21c9299c02c
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZDA1OTY4OWQ2MjZkYTI1MWVmYTNkNWUxZTFjNGQyMWM5Mjk5YzAyYyJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
docs(pubsub): tightened requirements on cloud storage subscription filename suffixes
PiperOrigin-RevId: 543503563

Source-Link: https://togithub.com/googleapis/googleapis/commit/212ecef96e3ea7c67465ff3f52680301ad0ea1f9

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/532d27eea6ff128fdcbb3332176e894e76dcc685
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTMyZDI3ZWVhNmZmMTI4ZmRjYmIzMzMyMTc2ZTg5NGU3NmRjYzY4NSJ9
END_NESTED_COMMIT

internal/.repo-metadata-full.json

@@ -655,7 +655,7 @@
     "description": "Container Analysis API",
     "language": "go",
     "client_library_type": "generated",
-    "client_documentation": "https://cloud.google.com/go/docs/reference/cloud.google.com/go/latest/containeranalysis/apiv1beta1",
+    "client_documentation": "https://cloud.google.com/go/docs/reference/cloud.google.com/go/containeranalysis/latest/apiv1beta1",
     "release_level": "preview",
     "library_type": "GAPIC_AUTO"
   },

internal/generated/snippets/accessapproval/apiv1/snippet_metadata.google.cloud.accessapproval.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/accessapproval/apiv1",
-    "version": "1.7.0",
+    "version": "1.7.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/accesscontextmanager/apiv1/snippet_metadata.google.identity.accesscontextmanager.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/accesscontextmanager/apiv1",
-    "version": "1.8.0",
+    "version": "1.8.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/advisorynotifications/apiv1/snippet_metadata.google.cloud.advisorynotifications.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/advisorynotifications/apiv1",
-    "version": "0.3.0",
+    "version": "0.3.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/aiplatform/apiv1/snippet_metadata.google.cloud.aiplatform.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/aiplatform/apiv1",
-    "version": "1.44.0",
+    "version": "1.45.0",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/aiplatform/apiv1beta1/snippet_metadata.google.cloud.aiplatform.v1beta1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/aiplatform/apiv1beta1",
-    "version": "1.44.0",
+    "version": "1.45.0",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/alloydb/apiv1/snippet_metadata.google.cloud.alloydb.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/alloydb/apiv1",
-    "version": "1.2.0",
+    "version": "1.2.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/alloydb/apiv1alpha/snippet_metadata.google.cloud.alloydb.v1alpha.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/alloydb/apiv1alpha",
-    "version": "1.2.0",
+    "version": "1.2.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/alloydb/apiv1beta/snippet_metadata.google.cloud.alloydb.v1beta.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/alloydb/apiv1beta",
-    "version": "1.2.0",
+    "version": "1.2.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/analytics/admin/apiv1alpha/snippet_metadata.google.analytics.admin.v1alpha.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/analytics/admin/apiv1alpha",
-    "version": "0.21.0",
+    "version": "0.21.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/apigateway/apiv1/snippet_metadata.google.cloud.apigateway.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/apigateway/apiv1",
-    "version": "1.6.0",
+    "version": "1.6.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/apigeeconnect/apiv1/snippet_metadata.google.cloud.apigeeconnect.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/apigeeconnect/apiv1",
-    "version": "1.6.0",
+    "version": "1.6.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/apigeeregistry/apiv1/snippet_metadata.google.cloud.apigeeregistry.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/apigeeregistry/apiv1",
-    "version": "0.7.0",
+    "version": "0.7.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/apikeys/apiv2/snippet_metadata.google.api.apikeys.v2.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/apikeys/apiv2",
-    "version": "1.1.0",
+    "version": "1.1.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/appengine/apiv1/snippet_metadata.google.appengine.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/appengine/apiv1",
-    "version": "1.8.0",
+    "version": "1.8.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/area120/tables/apiv1alpha1/snippet_metadata.google.area120.tables.v1alpha1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/area120/tables/apiv1alpha1",
-    "version": "0.8.0",
+    "version": "0.8.1",
     "language": "GO",
     "apis": [
       {

internal/generated/snippets/artifactregistry/apiv1/snippet_metadata.google.devtools.artifactregistry.v1.json

@@ -1,7 +1,7 @@
 {
   "clientLibrary": {
     "name": "cloud.google.com/go/artifactregistry/apiv1",
-    "version": "1.14.0",
+    "version": "1.14.1",
     "language": "GO",
     "apis": [
       {