google-cloud-gke_backup-v1 0.8.0 → 0.9.0

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

@@ -82,15 +82,15 @@ module Google
         #     Format: `projects/*/locations/*`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The target number of results to return in a single response.
+        #     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 inclue a partial list and a caller should
+        #     Note that the response may include a partial list and a caller should
         #     only rely on the response's
         #     {::Google::Cloud::GkeBackup::V1::ListBackupPlansResponse#next_page_token next_page_token}
         #     to determine if there are more instances left to be queried.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The value of
+        #     Optional. The value of
         #     {::Google::Cloud::GkeBackup::V1::ListBackupPlansResponse#next_page_token next_page_token}
         #     received from a previous `ListBackupPlans` call.
         #     Provide this to retrieve the subsequent page in a multi-page list of
@@ -98,10 +98,10 @@ module Google
         #     `ListBackupPlans` must match the call that provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Field match expression used to filter the results.
+        #     Optional. Field match expression used to filter the results.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Field by which to sort the results.
+        #     Optional. Field by which to sort the results.
         class ListBackupPlansRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -143,7 +143,7 @@ module Google
         #     fields. This may be sparsely populated if an `update_mask` is provided.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     This is used to specify the fields to be overwritten in the
+        #     Optional. This is used to specify the fields to be overwritten in the
         #     BackupPlan targeted for update. The values for each of these
         #     updated fields will be taken from the `backup_plan` provided
         #     with this request. Field names are relative to the root of the resource
@@ -164,7 +164,7 @@ module Google
         #     Format: `projects/*/locations/*/backupPlans/*`
         # @!attribute [rw] etag
         #   @return [::String]
-        #     If provided, this value must match the current value of the
+        #     Optional. If provided, this value must match the current value of the
         #     target BackupPlan's {::Google::Cloud::GkeBackup::V1::BackupPlan#etag etag} field
         #     or the request is rejected.
         class DeleteBackupPlanRequest
@@ -179,10 +179,10 @@ module Google
         #     Format: `projects/*/locations/*/backupPlans/*`
         # @!attribute [rw] backup
         #   @return [::Google::Cloud::GkeBackup::V1::Backup]
-        #     The Backup resource to create.
+        #     Optional. The Backup resource to create.
         # @!attribute [rw] backup_id
         #   @return [::String]
-        #     The client-provided short name for the Backup resource.
+        #     Optional. The client-provided short name for the Backup resource.
         #     This name must:
         #
         #     - be between 1 and 63 characters long (inclusive)
@@ -202,15 +202,15 @@ module Google
         #     Format: `projects/*/locations/*/backupPlans/*`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The target number of results to return in a single response.
+        #     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 inclue a partial list and a caller should
+        #     Note that the response may include a partial list and a caller should
         #     only rely on the response's
         #     {::Google::Cloud::GkeBackup::V1::ListBackupsResponse#next_page_token next_page_token}
         #     to determine if there are more instances left to be queried.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The value of
+        #     Optional. The value of
         #     {::Google::Cloud::GkeBackup::V1::ListBackupsResponse#next_page_token next_page_token}
         #     received from a previous `ListBackups` call.
         #     Provide this to retrieve the subsequent page in a multi-page list of
@@ -218,10 +218,10 @@ module Google
         #     `ListBackups` must match the call that provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Field match expression used to filter the results.
+        #     Optional. Field match expression used to filter the results.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Field by which to sort the results.
+        #     Optional. Field by which to sort the results.
         class ListBackupsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -259,7 +259,7 @@ module Google
         #     fields. This may be sparsely populated if an `update_mask` is provided.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     This is used to specify the fields to be overwritten in the
+        #     Optional. This is used to specify the fields to be overwritten in the
         #     Backup targeted for update. The values for each of these
         #     updated fields will be taken from the `backup_plan` provided
         #     with this request. Field names are relative to the root of the resource.
@@ -279,13 +279,13 @@ module Google
         #     Format: `projects/*/locations/*/backupPlans/*/backups/*`
         # @!attribute [rw] etag
         #   @return [::String]
-        #     If provided, this value must match the current value of the
+        #     Optional. If provided, this value must match the current value of the
         #     target Backup's {::Google::Cloud::GkeBackup::V1::Backup#etag etag} field or the
         #     request is rejected.
         # @!attribute [rw] force
         #   @return [::Boolean]
-        #     If set to true, any VolumeBackups below this Backup will also be deleted.
-        #     Otherwise, the request will only succeed if the Backup has no
+        #     Optional. If set to true, any VolumeBackups below this Backup will also be
+        #     deleted. Otherwise, the request will only succeed if the Backup has no
         #     VolumeBackups.
         class DeleteBackupRequest
           include ::Google::Protobuf::MessageExts
@@ -299,15 +299,15 @@ module Google
         #     Format: `projects/*/locations/*/backupPlans/*/backups/*`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The target number of results to return in a single response.
+        #     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 inclue a partial list and a caller should
+        #     Note that the response may include a partial list and a caller should
         #     only rely on the response's
         #     {::Google::Cloud::GkeBackup::V1::ListVolumeBackupsResponse#next_page_token next_page_token}
         #     to determine if there are more instances left to be queried.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The value of
+        #     Optional. The value of
         #     {::Google::Cloud::GkeBackup::V1::ListVolumeBackupsResponse#next_page_token next_page_token}
         #     received from a previous `ListVolumeBackups` call.
         #     Provide this to retrieve the subsequent page in a multi-page list of
@@ -315,10 +315,10 @@ module Google
         #     `ListVolumeBackups` must match the call that provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Field match expression used to filter the results.
+        #     Optional. Field match expression used to filter the results.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Field by which to sort the results.
+        #     Optional. Field by which to sort the results.
         class ListVolumeBackupsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -380,15 +380,15 @@ module Google
         #     Format: `projects/*/locations/*`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The target number of results to return in a single response.
+        #     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 inclue a partial list and a caller should
+        #     Note that the response may include a partial list and a caller should
         #     only rely on the response's
         #     {::Google::Cloud::GkeBackup::V1::ListRestorePlansResponse#next_page_token next_page_token}
         #     to determine if there are more instances left to be queried.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The value of
+        #     Optional. The value of
         #     {::Google::Cloud::GkeBackup::V1::ListRestorePlansResponse#next_page_token next_page_token}
         #     received from a previous `ListRestorePlans` call.
         #     Provide this to retrieve the subsequent page in a multi-page list of
@@ -396,10 +396,10 @@ module Google
         #     `ListRestorePlans` must match the call that provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Field match expression used to filter the results.
+        #     Optional. Field match expression used to filter the results.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Field by which to sort the results.
+        #     Optional. Field by which to sort the results.
         class ListRestorePlansRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -441,7 +441,7 @@ module Google
         #     fields. This may be sparsely populated if an `update_mask` is provided.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     This is used to specify the fields to be overwritten in the
+        #     Optional. This is used to specify the fields to be overwritten in the
         #     RestorePlan targeted for update. The values for each of these
         #     updated fields will be taken from the `restore_plan` provided
         #     with this request. Field names are relative to the root of the resource.
@@ -461,13 +461,13 @@ module Google
         #     Format: `projects/*/locations/*/restorePlans/*`
         # @!attribute [rw] etag
         #   @return [::String]
-        #     If provided, this value must match the current value of the
+        #     Optional. If provided, this value must match the current value of the
         #     target RestorePlan's {::Google::Cloud::GkeBackup::V1::RestorePlan#etag etag}
         #     field or the request is rejected.
         # @!attribute [rw] force
         #   @return [::Boolean]
-        #     If set to true, any Restores below this RestorePlan will also be deleted.
-        #     Otherwise, the request will only succeed if the RestorePlan has no
+        #     Optional. If set to true, any Restores below this RestorePlan will also be
+        #     deleted. Otherwise, the request will only succeed if the RestorePlan has no
         #     Restores.
         class DeleteRestorePlanRequest
           include ::Google::Protobuf::MessageExts
@@ -504,15 +504,15 @@ module Google
         #     Format: `projects/*/locations/*/restorePlans/*`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The target number of results to return in a single response.
+        #     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 inclue a partial list and a caller should
+        #     Note that the response may include a partial list and a caller should
         #     only rely on the response's
         #     {::Google::Cloud::GkeBackup::V1::ListRestoresResponse#next_page_token next_page_token}
         #     to determine if there are more instances left to be queried.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The value of
+        #     Optional. The value of
         #     {::Google::Cloud::GkeBackup::V1::ListRestoresResponse#next_page_token next_page_token}
         #     received from a previous `ListRestores` call.
         #     Provide this to retrieve the subsequent page in a multi-page list of
@@ -520,10 +520,10 @@ module Google
         #     must match the call that provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Field match expression used to filter the results.
+        #     Optional. Field match expression used to filter the results.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Field by which to sort the results.
+        #     Optional. Field by which to sort the results.
         class ListRestoresRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -564,7 +564,7 @@ module Google
         #     fields. This may be sparsely populated if an `update_mask` is provided.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     This is used to specify the fields to be overwritten in the
+        #     Optional. This is used to specify the fields to be overwritten in the
         #     Restore targeted for update. The values for each of these
         #     updated fields will be taken from the `restore` provided
         #     with this request. Field names are relative to the root of the resource.
@@ -584,13 +584,13 @@ module Google
         #     Format: `projects/*/locations/*/restorePlans/*/restores/*`
         # @!attribute [rw] etag
         #   @return [::String]
-        #     If provided, this value must match the current value of the
+        #     Optional. If provided, this value must match the current value of the
         #     target Restore's {::Google::Cloud::GkeBackup::V1::Restore#etag etag} field or
         #     the request is rejected.
         # @!attribute [rw] force
         #   @return [::Boolean]
-        #     If set to true, any VolumeRestores below this restore will also be deleted.
-        #     Otherwise, the request will only succeed if the restore has no
+        #     Optional. If set to true, any VolumeRestores below this restore will also
+        #     be deleted. Otherwise, the request will only succeed if the restore has no
         #     VolumeRestores.
         class DeleteRestoreRequest
           include ::Google::Protobuf::MessageExts
@@ -604,15 +604,15 @@ module Google
         #     Format: `projects/*/locations/*/restorePlans/*/restores/*`
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     The target number of results to return in a single response.
+        #     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 inclue a partial list and a caller should
+        #     Note that the response may include a partial list and a caller should
         #     only rely on the response's
         #     {::Google::Cloud::GkeBackup::V1::ListVolumeRestoresResponse#next_page_token next_page_token}
         #     to determine if there are more instances left to be queried.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     The value of
+        #     Optional. The value of
         #     {::Google::Cloud::GkeBackup::V1::ListVolumeRestoresResponse#next_page_token next_page_token}
         #     received from a previous `ListVolumeRestores` call.
         #     Provide this to retrieve the subsequent page in a multi-page list of
@@ -620,10 +620,10 @@ module Google
         #     `ListVolumeRestores` must match the call that provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Field match expression used to filter the results.
+        #     Optional. Field match expression used to filter the results.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Field by which to sort the results.
+        #     Optional. Field by which to sort the results.
         class ListVolumeRestoresRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -654,6 +654,25 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message for GetBackupIndexDownloadUrl.
+        # @!attribute [rw] backup
+        #   @return [::String]
+        #     Required. Full name of Backup resource.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/backupPlans/\\{backup_plan}/backups/\\{backup}
+        class GetBackupIndexDownloadUrlRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for GetBackupIndexDownloadUrl.
+        # @!attribute [rw] signed_url
+        #   @return [::String]
+        class GetBackupIndexDownloadUrlResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -23,7 +23,6 @@ module Google
       module V1
         # Represents both a request to Restore some portion of a Backup into
         # a target GKE cluster and a record of the restore operation itself.
-        # Next id: 18
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The full name of the Restore resource.
@@ -140,28 +139,29 @@ module Google
         end
 
         # Configuration of a restore.
-        # Next id: 12
         # @!attribute [rw] volume_data_restore_policy
         #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig::VolumeDataRestorePolicy]
-        #     Specifies the mechanism to be used to restore volume data.
+        #     Optional. Specifies the mechanism to be used to restore volume data.
         #     Default: VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED (will be treated as
         #     NO_VOLUME_DATA_RESTORATION).
         # @!attribute [rw] cluster_resource_conflict_policy
         #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig::ClusterResourceConflictPolicy]
-        #     Defines the behavior for handling the situation where cluster-scoped
-        #     resources being restored already exist in the target cluster. This MUST be
-        #     set to a value other than CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if
+        #     Optional. Defines the behavior for handling the situation where
+        #     cluster-scoped resources being restored already exist in the target
+        #     cluster. This MUST be set to a value other than
+        #     CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if
         #     {::Google::Cloud::GkeBackup::V1::RestoreConfig#cluster_resource_restore_scope cluster_resource_restore_scope}
         #     is not empty.
         # @!attribute [rw] namespaced_resource_restore_mode
         #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig::NamespacedResourceRestoreMode]
-        #     Defines the behavior for handling the situation where sets of namespaced
-        #     resources being restored already exist in the target cluster. This MUST be
-        #     set to a value other than NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED.
+        #     Optional. Defines the behavior for handling the situation where sets of
+        #     namespaced resources being restored already exist in the target cluster.
+        #     This MUST be set to a value other than
+        #     NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED.
         # @!attribute [rw] cluster_resource_restore_scope
         #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig::ClusterResourceRestoreScope]
-        #     Identifies the cluster-scoped resources to restore from the Backup.
-        #     Not specifying it means NO cluster resource will be restored.
+        #     Optional. Identifies the cluster-scoped resources to restore from the
+        #     Backup. Not specifying it means NO cluster resource will be restored.
         # @!attribute [rw] all_namespaces
         #   @return [::Boolean]
         #     Restore all namespaced resources in the Backup if set to "True".
@@ -185,17 +185,17 @@ module Google
         #     namespaces except those in this list will be restored.
         # @!attribute [rw] substitution_rules
         #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::SubstitutionRule>]
-        #     A list of transformation rules to be applied against Kubernetes resources
-        #     as they are selected for restoration from a Backup. Rules are executed in
-        #     order defined - this order matters, as changes made by a rule may impact
-        #     the filtering logic of subsequent rules. An empty list means no
+        #     Optional. A list of transformation rules to be applied against Kubernetes
+        #     resources as they are selected for restoration from a Backup. Rules are
+        #     executed in order defined - this order matters, as changes made by a rule
+        #     may impact the filtering logic of subsequent rules. An empty list means no
         #     substitution will occur.
         # @!attribute [rw] transformation_rules
         #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::TransformationRule>]
-        #     A list of transformation rules to be applied against Kubernetes resources
-        #     as they are selected for restoration from a Backup. Rules are executed in
-        #     order defined - this order matters, as changes made by a rule may impact
-        #     the filtering logic of subsequent rules. An empty list means no
+        #     Optional. A list of transformation rules to be applied against Kubernetes
+        #     resources as they are selected for restoration from a Backup. Rules are
+        #     executed in order defined - this order matters, as changes made by a rule
+        #     may impact the filtering logic of subsequent rules. An empty list means no
         #     transformation will occur.
         class RestoreConfig
           include ::Google::Protobuf::MessageExts
@@ -206,13 +206,14 @@ module Google
           # and is used for identifying specific "types" of resources to restore.
           # @!attribute [rw] resource_group
           #   @return [::String]
-          #     API group string of a Kubernetes resource, e.g.
+          #     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
           # @!attribute [rw] resource_kind
           #   @return [::String]
-          #     Kind of a Kubernetes resource, e.g.
-          #     "CustomResourceDefinition", "StorageClass", etc.
+          #     Optional. Kind of a Kubernetes resource, must be in UpperCamelCase
+          #     (PascalCase) and singular form. E.g. "CustomResourceDefinition",
+          #     "StorageClass", etc.
           class GroupKind
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -238,22 +239,22 @@ module Google
           # - PersistentVolume
           # @!attribute [rw] selected_group_kinds
           #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::GroupKind>]
-          #     A list of cluster-scoped resource group kinds to restore from the
-          #     backup. If specified, only the selected resources will be restored.
+          #     Optional. A list of cluster-scoped resource group kinds to restore from
+          #     the backup. If specified, only the selected resources will be restored.
           #     Mutually exclusive to any other field in the message.
           # @!attribute [rw] excluded_group_kinds
           #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::GroupKind>]
-          #     A list of cluster-scoped resource group kinds to NOT restore from the
-          #     backup. If specified, all valid cluster-scoped resources will be
+          #     Optional. A list of cluster-scoped resource group kinds to NOT restore
+          #     from the backup. If specified, all valid cluster-scoped resources will be
           #     restored except for those specified in the list.
           #     Mutually exclusive to any other field in the message.
           # @!attribute [rw] all_group_kinds
           #   @return [::Boolean]
-          #     If True, all valid cluster-scoped resources will be restored.
+          #     Optional. If True, all valid cluster-scoped resources will be restored.
           #     Mutually exclusive to any other field in the message.
           # @!attribute [rw] no_group_kinds
           #   @return [::Boolean]
-          #     If True, no cluster-scoped resources will be restored.
+          #     Optional. If True, no cluster-scoped resources will be restored.
           #     This has the same restore scope as if the message is not defined.
           #     Mutually exclusive to any other field in the message.
           class ClusterResourceRestoreScope
@@ -266,8 +267,8 @@ module Google
           # logic (which resources are subject to substitution) and substitution logic.
           # @!attribute [rw] target_namespaces
           #   @return [::Array<::String>]
-          #     (Filtering parameter) Any resource subject to substitution must be
-          #     contained within one of the listed Kubernetes Namespace in the Backup.
+          #     Optional. (Filtering parameter) Any resource subject to substitution must
+          #     be contained within one of the listed Kubernetes Namespace in the Backup.
           #     If this field is not provided, no namespace filtering will be performed
           #     (all resources in all Namespaces, including all cluster-scoped resources,
           #     will be candidates for substitution).
@@ -275,11 +276,10 @@ module Google
           #     empty string ("") as one of the target namespaces.
           # @!attribute [rw] target_group_kinds
           #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::GroupKind>]
-          #     (Filtering parameter) Any resource subject to substitution must belong to
-          #     one of the listed "types".
-          #     If this field is not provided, no type filtering will be performed (all
-          #     resources of all types matching previous filtering parameters will be
-          #     candidates for substitution).
+          #     Optional. (Filtering parameter) Any resource subject to substitution must
+          #     belong to one of the listed "types". If this field is not provided, no
+          #     type filtering will be performed (all resources of all types matching
+          #     previous filtering parameters will be candidates for substitution).
           # @!attribute [rw] target_json_path
           #   @return [::String]
           #     Required. This is a [JSONPath]
@@ -291,7 +291,7 @@ module Google
           #     fields out of the candidate resources will be modified).
           # @!attribute [rw] original_value_pattern
           #   @return [::String]
-          #     (Filtering parameter) This is a [regular expression]
+          #     Optional. (Filtering parameter) This is a [regular expression]
           #     (https://en.wikipedia.org/wiki/Regular_expression)
           #     that is compared against the fields matched by the target_json_path
           #     expression (and must also have passed the previous filters).
@@ -302,9 +302,10 @@ module Google
           #     value for this field will only match empty fields.
           # @!attribute [rw] new_value
           #   @return [::String]
-          #     This is the new value to set for any fields that pass the filtering and
-          #     selection criteria. To remove a value from a Kubernetes resource, either
-          #     leave this field unspecified, or set it to the empty string ("").
+          #     Optional. This is the new value to set for any fields that pass the
+          #     filtering and selection criteria. To remove a value from a Kubernetes
+          #     resource, either leave this field unspecified, or set it to the empty
+          #     string ("").
           class SubstitutionRule
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -317,15 +318,15 @@ module Google
           #     Required. op specifies the operation to perform.
           # @!attribute [rw] from_path
           #   @return [::String]
-          #     A string containing a JSON Pointer value that references the location in
-          #     the target document to move the value from.
+          #     Optional. A string containing a JSON Pointer value that references the
+          #     location in the target document to move the value from.
           # @!attribute [rw] path
           #   @return [::String]
-          #     A string containing a JSON-Pointer value that references a location
-          #     within the target document where the operation is performed.
+          #     Optional. A string containing a JSON-Pointer value that references a
+          #     location within the target document where the operation is performed.
           # @!attribute [rw] value
           #   @return [::String]
-          #     A string that specifies the desired value in string format to
+          #     Optional. A string that specifies the desired value in string format to
           #     use for transformation.
           class TransformationRuleAction
             include ::Google::Protobuf::MessageExts
@@ -373,22 +374,20 @@ module Google
           # restoration from a backup.
           # @!attribute [rw] namespaces
           #   @return [::Array<::String>]
-          #     (Filtering parameter) Any resource subject to transformation must be
-          #     contained within one of the listed Kubernetes Namespace in the Backup.
-          #     If this field is not provided, no namespace filtering will be performed
-          #     (all resources in all Namespaces, including all cluster-scoped resources,
-          #     will be candidates for transformation).
-          #     To mix cluster-scoped and namespaced resources in the same rule, use an
-          #     empty string ("") as one of the target namespaces.
+          #     Optional. (Filtering parameter) Any resource subject to transformation
+          #     must be contained within one of the listed Kubernetes Namespace in the
+          #     Backup. If this field is not provided, no namespace filtering will be
+          #     performed (all resources in all Namespaces, including all cluster-scoped
+          #     resources, will be candidates for transformation).
           # @!attribute [rw] group_kinds
           #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::GroupKind>]
-          #     (Filtering parameter) Any resource subject to transformation must belong
-          #     to one of the listed "types". If this field is not provided, no type
-          #     filtering will be performed (all resources of all types matching previous
-          #     filtering parameters will be candidates for transformation).
+          #     Optional. (Filtering parameter) Any resource subject to transformation
+          #     must belong to one of the listed "types". If this field is not provided,
+          #     no type filtering will be performed (all resources of all types matching
+          #     previous filtering parameters will be candidates for transformation).
           # @!attribute [rw] json_path
           #   @return [::String]
-          #     This is a [JSONPath]
+          #     Optional. This is a [JSONPath]
           #     (https://github.com/json-path/JsonPath/blob/master/README.md)
           #     expression that matches specific fields of candidate
           #     resources and it operates as a filtering parameter (resources that
@@ -410,13 +409,13 @@ module Google
           #     could affect the outcome of the second operation.
           # @!attribute [rw] resource_filter
           #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig::ResourceFilter]
-          #     This field is used to specify a set of fields that should be used to
-          #     determine which resources in backup should be acted upon by the supplied
-          #     transformation rule actions, and this will ensure that only specific
-          #     resources are affected by transformation rule actions.
+          #     Optional. This field is used to specify a set of fields that should be
+          #     used to determine which resources in backup should be acted upon by the
+          #     supplied transformation rule actions, and this will ensure that only
+          #     specific resources are affected by transformation rule actions.
           # @!attribute [rw] description
           #   @return [::String]
-          #     The description is a user specified string description of the
+          #     Optional. The description is a user specified string description of the
           #     transformation rule.
           class TransformationRule
             include ::Google::Protobuf::MessageExts

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

@@ -23,7 +23,6 @@ module Google
       module V1
         # The configuration of a potential series of Restore operations to be performed
         # against Backups belong to a particular BackupPlan.
-        # Next id: 13
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The full name of the RestorePlan resource.
@@ -42,7 +41,7 @@ module Google
         #     updated.
         # @!attribute [rw] description
         #   @return [::String]
-        #     User specified descriptive string for this RestorePlan.
+        #     Optional. User specified descriptive string for this RestorePlan.
         # @!attribute [rw] backup_plan
         #   @return [::String]
         #     Required. Immutable. A reference to the
@@ -62,7 +61,7 @@ module Google
         #     Required. Configuration of Restores created via this RestorePlan.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     A set of custom labels supplied by user.
+        #     Optional. A set of custom labels supplied by user.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. `etag` is used for optimistic concurrency control as a way to

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

@@ -24,7 +24,6 @@ module Google
         # Represents the backup of a specific persistent volume as a component of a
         # Backup - both the record of the operation and a pointer to the underlying
         # storage-specific artifacts.
-        # Next id: 14
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The full name of the VolumeBackup resource.
@@ -126,7 +125,6 @@ module Google
         end
 
         # Represents the operation of restoring a volume from a VolumeBackup.
-        # Next id: 13
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. Full name of the VolumeRestore resource.