google-cloud-gke_backup-v1 1.0.0 → 1.1.0

data/proto_docs/google/cloud/gkebackup/v1/gkebackup.rb

@@ -41,9 +41,10 @@ module Google
         #   @return [::Boolean]
         #     Output only. Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
-        #     have [Operation.error][] value with a
-        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
-        #     `Code.CANCELLED`.
+        #     have
+        #     {::Google::Longrunning::Operation#error google.longrunning.Operation.error}
+        #     value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
+        #     corresponding to `Code.CANCELLED`.
         # @!attribute [r] api_version
         #   @return [::String]
         #     Output only. API version used to start the operation.
@@ -172,6 +173,196 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for CreateBackupChannel.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location within which to create the BackupChannel.
+        #     Format: `projects/*/locations/*`
+        # @!attribute [rw] backup_channel
+        #   @return [::Google::Cloud::GkeBackup::V1::BackupChannel]
+        #     Required. The BackupChannel resource object to create.
+        # @!attribute [rw] backup_channel_id
+        #   @return [::String]
+        #     Optional. The client-provided short name for the BackupChannel resource.
+        #     This name must:
+        #
+        #     - be between 1 and 63 characters long (inclusive)
+        #     - consist of only lower-case ASCII letters, numbers, and dashes
+        #     - start with a lower-case letter
+        #     - end with a lower-case letter or number
+        #     - be unique within the set of BackupChannels in this location
+        #     If the user does not provide a name, a uuid will be used as the name.
+        class CreateBackupChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListBackupChannels.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location that contains the BackupChannels to list.
+        #     Format: `projects/*/locations/*`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The target number of results to return in a single response.
+        #     If not specified, a default value will be chosen by the service.
+        #     Note that the response may include a partial list and a caller should
+        #     only rely on the response's
+        #     {::Google::Cloud::GkeBackup::V1::ListBackupChannelsResponse#next_page_token next_page_token}
+        #     to determine if there are more instances left to be queried.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The value of
+        #     {::Google::Cloud::GkeBackup::V1::ListBackupChannelsResponse#next_page_token next_page_token}
+        #     received from a previous `ListBackupChannels` call.
+        #     Provide this to retrieve the subsequent page in a multi-page list of
+        #     results. When paginating, all other parameters provided to
+        #     `ListBackupChannels` must match the call that provided the page
+        #     token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Field match expression used to filter the results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Field by which to sort the results.
+        class ListBackupChannelsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListBackupChannels.
+        # @!attribute [rw] backup_channels
+        #   @return [::Array<::Google::Cloud::GkeBackup::V1::BackupChannel>]
+        #     The list of BackupChannels matching the given criteria.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token which may be sent as
+        #     {::Google::Cloud::GkeBackup::V1::ListBackupChannelsRequest#page_token page_token}
+        #     in a subsequent `ListBackupChannels` call to retrieve the next page of
+        #     results. If this field is omitted or empty, then there are no more results
+        #     to return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListBackupChannelsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for GetBackupChannel.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Fully qualified BackupChannel name.
+        #     Format: `projects/*/locations/*/backupChannels/*`
+        class GetBackupChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for UpdateBackupChannel.
+        # @!attribute [rw] backup_channel
+        #   @return [::Google::Cloud::GkeBackup::V1::BackupChannel]
+        #     Required. A new version of the BackupChannel resource that contains updated
+        #     fields. This may be sparsely populated if an `update_mask` is provided.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. This is used to specify the fields to be overwritten in the
+        #     BackupChannel targeted for update. The values for each of these
+        #     updated fields will be taken from the `backup_channel` provided
+        #     with this request. Field names are relative to the root of the resource
+        #     (e.g., `description`, `labels`, etc.)
+        #     If no `update_mask` is provided, all fields in `backup_channel` will
+        #     be written to the target BackupChannel resource. Note that
+        #     OUTPUT_ONLY and IMMUTABLE fields in `backup_channel` are ignored and
+        #     are not used to update the target BackupChannel.
+        class UpdateBackupChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for DeleteBackupChannel.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Fully qualified BackupChannel name.
+        #     Format: `projects/*/locations/*/backupChannels/*`
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. If provided, this value must match the current value of the
+        #     target BackupChannel's {::Google::Cloud::GkeBackup::V1::BackupChannel#etag etag}
+        #     field or the request is rejected.
+        # @!attribute [rw] force
+        #   @return [::Boolean]
+        #     Optional. If set to true, any BackupPlanAssociations below this
+        #     BackupChannel will also be deleted. Otherwise, the request will only
+        #     succeed if the BackupChannel has no BackupPlanAssociations.
+        class DeleteBackupChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListBackupPlanBindings.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The BackupChannel that contains the BackupPlanBindings to list.
+        #     Format: `projects/*/locations/*/backupChannels/*`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The target number of results to return in a single response.
+        #     If not specified, a default value will be chosen by the service.
+        #     Note that the response may include a partial list and a caller should
+        #     only rely on the response's
+        #     {::Google::Cloud::GkeBackup::V1::ListBackupPlanBindingsResponse#next_page_token next_page_token}
+        #     to determine if there are more instances left to be queried.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The value of
+        #     {::Google::Cloud::GkeBackup::V1::ListBackupPlanBindingsResponse#next_page_token next_page_token}
+        #     received from a previous `ListBackupPlanBindings` call.
+        #     Provide this to retrieve the subsequent page in a multi-page list of
+        #     results. When paginating, all other parameters provided to
+        #     `ListBackupPlanBindings` must match the call that provided the page
+        #     token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Field match expression used to filter the results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Field by which to sort the results.
+        class ListBackupPlanBindingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListBackupPlanBindings.
+        # @!attribute [rw] backup_plan_bindings
+        #   @return [::Array<::Google::Cloud::GkeBackup::V1::BackupPlanBinding>]
+        #     The list of BackupPlanBindings matching the given criteria.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token which may be sent as
+        #     {::Google::Cloud::GkeBackup::V1::ListBackupPlanBindingsRequest#page_token page_token}
+        #     in a subsequent `ListBackupPlanBindingss` call to retrieve the next page of
+        #     results. If this field is omitted or empty, then there are no more results
+        #     to return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListBackupPlanBindingsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for GetBackupPlanBinding.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Fully qualified BackupPlanBinding name.
+        #     Format:
+        #     `projects/*/locations/*/backupChannels/*/backupPlanBindings/*`
+        class GetBackupPlanBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for CreateBackup.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -222,6 +413,10 @@ module Google
         # @!attribute [rw] order_by
         #   @return [::String]
         #     Optional. Field by which to sort the results.
+        # @!attribute [rw] return_partial_success
+        #   @return [::Boolean]
+        #     Optional. If set to true, the response will return partial results when
+        #     some regions are unreachable and the unreachable field will be populated.
         class ListBackupsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -237,6 +432,9 @@ module Google
         #     {::Google::Cloud::GkeBackup::V1::ListBackupsRequest#page_token page_token} in a
         #     subsequent `ListBackups` call to retrieve the next page of results. If this
         #     field is omitted or empty, then there are no more results to return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
         class ListBackupsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -474,6 +672,193 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for CreateRestoreChannel.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location within which to create the RestoreChannel.
+        #     Format: `projects/*/locations/*`
+        # @!attribute [rw] restore_channel
+        #   @return [::Google::Cloud::GkeBackup::V1::RestoreChannel]
+        #     Required. The RestoreChannel resource object to create.
+        # @!attribute [rw] restore_channel_id
+        #   @return [::String]
+        #     Optional. The client-provided short name for the RestoreChannel resource.
+        #     This name must:
+        #
+        #     - be between 1 and 63 characters long (inclusive)
+        #     - consist of only lower-case ASCII letters, numbers, and dashes
+        #     - start with a lower-case letter
+        #     - end with a lower-case letter or number
+        #     - be unique within the set of RestoreChannels in this location
+        #     If the user does not provide a name, a uuid will be used as the name.
+        class CreateRestoreChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListRestoreChannels.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location that contains the RestoreChannels to list.
+        #     Format: `projects/*/locations/*`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The target number of results to return in a single response.
+        #     If not specified, a default value will be chosen by the service.
+        #     Note that the response may include a partial list and a caller should
+        #     only rely on the response's
+        #     {::Google::Cloud::GkeBackup::V1::ListRestoreChannelsResponse#next_page_token next_page_token}
+        #     to determine if there are more instances left to be queried.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The value of
+        #     {::Google::Cloud::GkeBackup::V1::ListRestoreChannelsResponse#next_page_token next_page_token}
+        #     received from a previous `ListRestoreChannels` call.
+        #     Provide this to retrieve the subsequent page in a multi-page list of
+        #     results. When paginating, all other parameters provided to
+        #     `ListRestoreChannels` must match the call that provided the page
+        #     token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Field match expression used to filter the results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Field by which to sort the results.
+        class ListRestoreChannelsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListRestoreChannels.
+        # @!attribute [rw] restore_channels
+        #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreChannel>]
+        #     The list of RestoreChannels matching the given criteria.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token which may be sent as
+        #     {::Google::Cloud::GkeBackup::V1::ListRestoreChannelsRequest#page_token page_token}
+        #     in a subsequent `ListRestoreChannels` call to retrieve the next page of
+        #     results. If this field is omitted or empty, then there are no more results
+        #     to return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListRestoreChannelsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for GetRestoreChannel.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Fully qualified RestoreChannel name.
+        #     Format: `projects/*/locations/*/restoreChannels/*`
+        class GetRestoreChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for UpdateRestoreChannel.
+        # @!attribute [rw] restore_channel
+        #   @return [::Google::Cloud::GkeBackup::V1::RestoreChannel]
+        #     Required. A new version of the RestoreChannel resource that contains
+        #     updated fields. This may be sparsely populated if an `update_mask` is
+        #     provided.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. This is used to specify the fields to be overwritten in the
+        #     RestoreChannel targeted for update. The values for each of these
+        #     updated fields will be taken from the `restore_channel` provided
+        #     with this request. Field names are relative to the root of the resource
+        #     (e.g., `description`, `destination_project_id`, etc.)
+        #     If no `update_mask` is provided, all fields in `restore_channel` will
+        #     be written to the target RestoreChannel resource. Note that
+        #     OUTPUT_ONLY and IMMUTABLE fields in `restore_channel` are ignored and
+        #     are not used to update the target RestoreChannel.
+        class UpdateRestoreChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for DeleteRestoreChannel.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Fully qualified RestoreChannel name.
+        #     Format: `projects/*/locations/*/restoreChannels/*`
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. If provided, this value must match the current value of the
+        #     target RestoreChannel's
+        #     {::Google::Cloud::GkeBackup::V1::RestoreChannel#etag etag} field or the request
+        #     is rejected.
+        class DeleteRestoreChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for ListRestorePlanBindings.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The RestoreChannel that contains the ListRestorePlanBindings to
+        #     list. Format: `projects/*/locations/*/restoreChannels/*`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The target number of results to return in a single response.
+        #     If not specified, a default value will be chosen by the service.
+        #     Note that the response may include a partial list and a caller should
+        #     only rely on the response's
+        #     {::Google::Cloud::GkeBackup::V1::ListRestorePlanBindingsResponse#next_page_token next_page_token}
+        #     to determine if there are more instances left to be queried.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The value of
+        #     {::Google::Cloud::GkeBackup::V1::ListRestorePlanBindingsResponse#next_page_token next_page_token}
+        #     received from a previous `ListRestorePlanBindings` call.
+        #     Provide this to retrieve the subsequent page in a multi-page list of
+        #     results. When paginating, all other parameters provided to
+        #     `ListRestorePlanBindings` must match the call that provided the page
+        #     token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Field match expression used to filter the results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Field by which to sort the results.
+        class ListRestorePlanBindingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for ListRestorePlanBindings.
+        # @!attribute [rw] restore_plan_bindings
+        #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestorePlanBinding>]
+        #     The list of RestorePlanBindings matching the given criteria.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token which may be sent as
+        #     {::Google::Cloud::GkeBackup::V1::ListRestorePlanBindingsRequest#page_token page_token}
+        #     in a subsequent `ListRestorePlanBindings` call to retrieve the next page of
+        #     results. If this field is omitted or empty, then there are no more results
+        #     to return.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Unordered list. Locations that could not be reached.
+        class ListRestorePlanBindingsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for GetRestorePlanBinding.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Fully qualified RestorePlanBinding name.
+        #     Format:
+        #     `projects/*/locations/*/restoreChannels/*/restorePlanBindings/*`
+        class GetRestorePlanBindingRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for CreateRestore.
         # @!attribute [rw] parent
         #   @return [::String]
@@ -669,6 +1054,7 @@ module Google
         # Response message for GetBackupIndexDownloadUrl.
         # @!attribute [rw] signed_url
         #   @return [::String]
+        #     Required. The signed URL for downloading the backup index.
         class GetBackupIndexDownloadUrlResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/gkebackup/v1/restore.rb

@@ -40,7 +40,7 @@ module Google
         #     updated.
         # @!attribute [rw] description
         #   @return [::String]
-        #     User specified descriptive string for this Restore.
+        #     Optional. User specified descriptive string for this Restore.
         # @!attribute [rw] backup
         #   @return [::String]
         #     Required. Immutable. A reference to the
@@ -73,7 +73,9 @@ module Google
         # @!attribute [r] state_reason
         #   @return [::String]
         #     Output only. Human-readable description of why the Restore is in its
-        #     current state.
+        #     current state. This field is only meant for human readability and should
+        #     not be used programmatically as this field is not guaranteed to be
+        #     consistent.
         # @!attribute [r] complete_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Timestamp of when the restore operation completed.
@@ -104,8 +106,8 @@ module Google
         #   @return [::Google::Cloud::GkeBackup::V1::Restore::Filter]
         #     Optional. Immutable. Filters resources for `Restore`. If not specified, the
         #     scope of the restore will remain the same as defined in the `RestorePlan`.
-        #     If this is specified, and no resources are matched by the
-        #     `inclusion_filters` or everyting is excluded by the `exclusion_filters`,
+        #     If this is specified and no resources are matched by the
+        #     `inclusion_filters` or everything is excluded by the `exclusion_filters`,
         #     nothing will be restored. This filter can only be specified if the value of
         #     {::Google::Cloud::GkeBackup::V1::RestoreConfig#namespaced_resource_restore_mode namespaced_resource_restore_mode}
         #     is set to `MERGE_SKIP_ON_CONFLICT`, `MERGE_REPLACE_VOLUME_ON_CONFLICT` or
@@ -170,6 +172,10 @@ module Google
 
             # This Restore resource is in the process of being deleted.
             DELETING = 5
+
+            # The Kubernetes resources created by this Restore are being
+            # validated.
+            VALIDATING = 6
           end
         end
 
@@ -261,7 +267,7 @@ module Google
           #   @return [::String]
           #     Optional. API group string of a Kubernetes resource, e.g.
           #     "apiextensions.k8s.io", "storage.k8s.io", etc.
-          #     Note: use empty string for core API group
+          #     Note: use empty string for core API group.
           # @!attribute [rw] resource_kind
           #   @return [::String]
           #     Optional. Kind of a Kubernetes resource, must be in UpperCamelCase
@@ -277,14 +283,16 @@ module Google
           # Some group kinds are not reasonable choices for a restore, and will cause
           # an error if selected here. Any scope selection that would restore
           # "all valid" resources automatically excludes these group kinds.
+          # - Node
+          # - ComponentStatus
           # - gkebackup.gke.io/BackupJob
           # - gkebackup.gke.io/RestoreJob
           # - metrics.k8s.io/NodeMetrics
           # - migration.k8s.io/StorageState
           # - migration.k8s.io/StorageVersionMigration
-          # - Node
           # - snapshot.storage.k8s.io/VolumeSnapshotContent
           # - storage.k8s.io/CSINode
+          # - storage.k8s.io/VolumeAttachment
           #
           # Some group kinds are driven by restore configuration elsewhere,
           # and will cause an error if selected here.

data/proto_docs/google/cloud/gkebackup/v1/restore_channel.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module GkeBackup
+      module V1
+        # A RestoreChannel imposes constraints on where backups can be restored.
+        # The RestoreChannel should be in the same project and region
+        # as the backups. The backups can only be restored in the
+        # `destination_project`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The fully qualified name of the RestoreChannel.
+        #     `projects/*/locations/*/restoreChannels/*`
+        # @!attribute [rw] destination_project
+        #   @return [::String]
+        #     Required. Immutable. The project into which the backups will be restored.
+        #     The format is `projects/{project}`.
+        #     Currently, \\{project} can only be the project number. Support for project
+        #     IDs will be added in the future.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. Server generated global unique identifier of
+        #     [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when this RestoreChannel was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when this RestoreChannel was last updated.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. A set of custom labels supplied by user.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. User specified descriptive string for this RestoreChannel.
+        # @!attribute [r] etag
+        #   @return [::String]
+        #     Output only. `etag` is used for optimistic concurrency control as a way to
+        #     help prevent simultaneous updates of a RestoreChannel from overwriting each
+        #     other. It is strongly suggested that systems make use of the 'etag' in the
+        #     read-modify-write cycle to perform RestoreChannel updates in order to
+        #     avoid race conditions: An `etag` is returned in the response to
+        #     `GetRestoreChannel`, and systems are expected to put that etag in the
+        #     request to `UpdateRestoreChannel` or `DeleteRestoreChannel` to
+        #     ensure that their change will be applied to the same version of the
+        #     resource.
+        # @!attribute [r] destination_project_id
+        #   @return [::String]
+        #     Output only. The project_id where backups will be restored.
+        #     Example Project ID: "my-project-id".
+        #     This will be an OUTPUT_ONLY field to return the project_id of the
+        #     destination project.
+        class RestoreChannel
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/gkebackup/v1/restore_plan.rb

@@ -80,7 +80,9 @@ module Google
         # @!attribute [r] state_reason
         #   @return [::String]
         #     Output only. Human-readable description of why RestorePlan is in the
-        #     current `state`
+        #     current `state`. This field is only meant for human readability and should
+        #     not be used programmatically as this field is not guaranteed to be
+        #     consistent.
         class RestorePlan
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/gkebackup/v1/restore_plan_binding.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module GkeBackup
+      module V1
+        # A RestorePlanBinding binds a RestorePlan with a RestoreChannel.
+        # This resource is created automatically when a RestorePlan is created using a
+        # RestoreChannel. This also serves as a holder for cross-project fields
+        # that need to be displayed in the current project.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. The fully qualified name of the RestorePlanBinding.
+        #     `projects/*/locations/*/restoreChannels/*/restorePlanBindings/*`
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. Server generated global unique identifier of
+        #     [UUID4](https://en.wikipedia.org/wiki/Universally_unique_identifier)
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when this binding was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when this binding was created.
+        # @!attribute [r] restore_plan
+        #   @return [::String]
+        #     Output only. The fully qualified name of the RestorePlan bound to this
+        #     RestoreChannel. `projects/*/locations/*/restorePlans/{restore_plan}`
+        # @!attribute [r] etag
+        #   @return [::String]
+        #     Output only. `etag` is used for optimistic concurrency control as a way to
+        #     help prevent simultaneous updates of a RestorePlanBinding from overwriting
+        #     each other. It is strongly suggested that systems make use of the 'etag' in
+        #     the read-modify-write cycle to perform RestorePlanBinding updates in
+        #     order to avoid race conditions: An `etag` is returned in the response to
+        #     `GetRestorePlanBinding`, and systems are expected to put that etag in
+        #     the request to `UpdateRestorePlanBinding` or
+        #     `DeleteRestorePlanBinding` to ensure that their change will be applied
+        #     to the same version of the resource.
+        # @!attribute [r] backup_plan
+        #   @return [::String]
+        #     Output only. The fully qualified name of the BackupPlan bound to the
+        #     specified RestorePlan. `projects/*/locations/*/backukpPlans/{backup_plan}`
+        class RestorePlanBinding
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end