google-cloud-gke_backup-v1 0.4.0 → 0.5.1

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

@@ -27,7 +27,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The full name of the Restore resource.
-        #     Format: projects/*/locations/*/restorePlans/*/restores/*
+        #     Format: `projects/*/locations/*/restorePlans/*/restores/*`
         # @!attribute [r] uid
         #   @return [::String]
         #     Output only. Server generated global unique identifier of
@@ -44,22 +44,26 @@ module Google
         #     User specified descriptive string for this Restore.
         # @!attribute [rw] backup
         #   @return [::String]
-        #     Required. Immutable. A reference to the {::Google::Cloud::GkeBackup::V1::Backup Backup} used as the source from which this Restore
-        #     will restore. Note that this Backup must be a sub-resource of the
-        #     RestorePlan's {::Google::Cloud::GkeBackup::V1::RestorePlan#backup_plan backup_plan}.
-        #     Format: projects/*/locations/*/backupPlans/*/backups/*.
+        #     Required. Immutable. A reference to the
+        #     {::Google::Cloud::GkeBackup::V1::Backup Backup} used as the source from which
+        #     this Restore will restore. Note that this Backup must be a sub-resource of
+        #     the RestorePlan's
+        #     {::Google::Cloud::GkeBackup::V1::RestorePlan#backup_plan backup_plan}. Format:
+        #     `projects/*/locations/*/backupPlans/*/backups/*`.
         # @!attribute [r] cluster
         #   @return [::String]
         #     Output only. The target cluster into which this Restore will restore data.
         #     Valid formats:
         #
-        #       - projects/*/locations/*/clusters/*
-        #       - projects/*/zones/*/clusters/*
+        #       - `projects/*/locations/*/clusters/*`
+        #       - `projects/*/zones/*/clusters/*`
         #
-        #     Inherited from parent RestorePlan's {::Google::Cloud::GkeBackup::V1::RestorePlan#cluster cluster} value.
+        #     Inherited from parent RestorePlan's
+        #     {::Google::Cloud::GkeBackup::V1::RestorePlan#cluster cluster} value.
         # @!attribute [r] restore_config
         #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig]
-        #     Output only. Configuration of the Restore.  Inherited from parent RestorePlan's
+        #     Output only. Configuration of the Restore.  Inherited from parent
+        #     RestorePlan's
         #     {::Google::Cloud::GkeBackup::V1::RestorePlan#restore_config restore_config}.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
@@ -69,7 +73,8 @@ module Google
         #     Output only. The current state of the Restore.
         # @!attribute [r] state_reason
         #   @return [::String]
-        #     Output only. Human-readable description of why the Restore is in its current state.
+        #     Output only. Human-readable description of why the Restore is in its
+        #     current state.
         # @!attribute [r] complete_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Timestamp of when the restore operation completed.
@@ -81,15 +86,15 @@ module Google
         #     Output only. Number of resources excluded during the restore execution.
         # @!attribute [r] resources_failed_count
         #   @return [::Integer]
-        #     Output only. Number of resources that failed to be restored during the restore
-        #     execution.
+        #     Output only. Number of resources that failed to be restored during the
+        #     restore execution.
         # @!attribute [r] volumes_restored_count
         #   @return [::Integer]
         #     Output only. Number of volumes restored during the restore execution.
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. `etag` is used for optimistic concurrency control as a way to help
-        #     prevent simultaneous updates of a restore from overwriting each other.
+        #     Output only. `etag` is used for optimistic concurrency control as a way to
+        #     help prevent simultaneous updates of a restore from overwriting each other.
         #     It is strongly suggested that systems make use of the `etag` in the
         #     read-modify-write cycle to perform restore updates in order to avoid
         #     race conditions: An `etag` is returned in the response to `GetRestore`,
@@ -135,7 +140,7 @@ module Google
         end
 
         # Configuration of a restore.
-        # Next id: 9
+        # 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.
@@ -146,7 +151,8 @@ module Google
         #     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.
+        #     {::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
@@ -169,6 +175,14 @@ module Google
         #     A list of selected ProtectedApplications to restore. The listed
         #     ProtectedApplications and all the resources to which they refer will be
         #     restored.
+        # @!attribute [rw] no_namespaces
+        #   @return [::Boolean]
+        #     Do not restore any namespaced resources if set to "True".
+        #     Specifying this field to "False" is not allowed.
+        # @!attribute [rw] excluded_namespaces
+        #   @return [::Google::Cloud::GkeBackup::V1::Namespaces]
+        #     A list of selected namespaces excluded from restoration. All
+        #     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
@@ -176,6 +190,13 @@ module Google
         #     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
+        #     transformation will occur.
         class RestoreConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -197,13 +218,44 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Identifies the cluster-scoped resources to restore from the Backup.
+          # Defines the scope of cluster-scoped resources to restore.
+          #
+          # 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.
+          # - 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
+          #
+          # Some group kinds are driven by restore configuration elsewhere,
+          # and will cause an error if selected here.
+          # - Namespace
+          # - PersistentVolume
           # @!attribute [rw] selected_group_kinds
           #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::GroupKind>]
-          #     A list of "types" of cluster-scoped resources to be restored from the
-          #     Backup.  An empty list means that NO cluster-scoped resources will be
-          #     restored. Note that Namespaces and PersistentVolume restoration is
-          #     handled separately and is not governed by this field.
+          #     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
+          #     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.
+          #     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.
+          #     This has the same restore scope as if the message is not defined.
+          #     Mutually exclusive to any other field in the message.
           class ClusterResourceRestoreScope
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -247,7 +299,7 @@ module Google
           #     value does not match this expression. If this field is NOT specified,
           #     then ALL fields matched by the target_json_path expression will undergo
           #     substitution. Note that an empty (e.g., "", rather than unspecified)
-          #     value for for this field will only match empty fields.
+          #     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
@@ -258,22 +310,135 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Defines how volume data should be restored
+          # TransformationRuleAction defines a TransformationRule action based on the
+          # JSON Patch RFC (https://www.rfc-editor.org/rfc/rfc6902)
+          # @!attribute [rw] op
+          #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig::TransformationRuleAction::Op]
+          #     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.
+          # @!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.
+          # @!attribute [rw] value
+          #   @return [::String]
+          #     A string that specifies the desired value in string format to
+          #     use for transformation.
+          class TransformationRuleAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Possible values for operations of a transformation rule action.
+            module Op
+              # Unspecified operation
+              OP_UNSPECIFIED = 0
+
+              # The "remove" operation removes the value at the target location.
+              REMOVE = 1
+
+              # The "move" operation removes the value at a specified location and
+              # adds it to the target location.
+              MOVE = 2
+
+              # The "copy" operation copies the value at a specified location to the
+              # target location.
+              COPY = 3
+
+              # The "add" operation performs one of the following functions,
+              # depending upon what the target location references:
+              # 1. If the target location specifies an array index, a new value is
+              # inserted into the array at the specified index.
+              # 2. If the target location specifies an object member that does not
+              # already exist, a new member is added to the object.
+              # 3. If the target location specifies an object member that does exist,
+              # that member's value is replaced.
+              ADD = 4
+
+              # The "test" operation tests that a value at the target location is
+              # equal to a specified value.
+              TEST = 5
+
+              # The "replace" operation replaces the value at the target location
+              # with a new value.  The operation object MUST contain a "value" member
+              # whose content specifies the replacement value.
+              REPLACE = 6
+            end
+          end
+
+          # ResourceFilter specifies matching criteria to limit the scope of a
+          # change to a specific set of kubernetes resources that are selected for
+          # 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.
+          # @!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).
+          # @!attribute [rw] json_path
+          #   @return [::String]
+          #     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
+          #     are not matched with this expression will not be candidates for
+          #     transformation).
+          class ResourceFilter
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A transformation rule to be applied against Kubernetes resources as they
+          # are selected for restoration from a Backup. A rule contains both filtering
+          # logic (which resources are subject to transform) and transformation logic.
+          # @!attribute [rw] field_actions
+          #   @return [::Array<::Google::Cloud::GkeBackup::V1::RestoreConfig::TransformationRuleAction>]
+          #     Required. A list of transformation rule actions to take against candidate
+          #     resources. Actions are executed in order defined - this order matters, as
+          #     they could potentially interfere with each other and the first operation
+          #     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.
+          # @!attribute [rw] description
+          #   @return [::String]
+          #     The description is a user specified string description of the
+          #     transformation rule.
+          class TransformationRule
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Defines how volume data should be restored.
           module VolumeDataRestorePolicy
             # Unspecified (illegal).
             VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED = 0
 
-            # For each PVC to be restored, will create a new underlying volume (and PV)
+            # For each PVC to be restored, create a new underlying volume and PV
             # from the corresponding VolumeBackup contained within the Backup.
             RESTORE_VOLUME_DATA_FROM_BACKUP = 1
 
             # For each PVC to be restored, attempt to reuse the original PV contained
-            # in the Backup (with its original underlying volume).  Note that option
+            # in the Backup (with its original underlying volume). This option
             # is likely only usable when restoring a workload to its original cluster.
             REUSE_VOLUME_HANDLE_FROM_BACKUP = 2
 
-            # For each PVC to be restored, PVCs will be created without any particular
-            # action to restore data.  In this case, the normal Kubernetes provisioning
+            # For each PVC to be restored, create PVC without any particular
+            # action to restore data. In this case, the normal Kubernetes provisioning
             # logic would kick in, and this would likely result in either dynamically
             # provisioning blank PVs or binding to statically provisioned PVs.
             NO_VOLUME_DATA_RESTORATION = 3
@@ -290,8 +455,8 @@ module Google
             USE_EXISTING_VERSION = 1
 
             # Delete the existing version before re-creating it from the Backup.
-            # Note that this is a dangerous option which could cause unintentional
-            # data loss if used inappropriately - for example, deleting a CRD will
+            # This is a dangerous option which could cause unintentional
+            # data loss if used inappropriately. For example, deleting a CRD will
             # cause Kubernetes to delete all CRs of that type.
             USE_BACKUP_VERSION = 2
           end

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

@@ -23,11 +23,11 @@ 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: 11
+        # Next id: 13
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The full name of the RestorePlan resource.
-        #     Format: projects/*/locations/*/restorePlans/*.
+        #     Format: `projects/*/locations/*/restorePlans/*`.
         # @!attribute [r] uid
         #   @return [::String]
         #     Output only. Server generated global unique identifier of
@@ -45,18 +45,18 @@ module Google
         #     User specified descriptive string for this RestorePlan.
         # @!attribute [rw] backup_plan
         #   @return [::String]
-        #     Required. Immutable. A reference to the {::Google::Cloud::GkeBackup::V1::BackupPlan BackupPlan} from which Backups may be used as the
-        #     source for Restores created via this RestorePlan.
-        #     Format: projects/*/locations/*/backupPlans/*.
+        #     Required. Immutable. A reference to the
+        #     {::Google::Cloud::GkeBackup::V1::BackupPlan BackupPlan} from which Backups may
+        #     be used as the source for Restores created via this RestorePlan. Format:
+        #     `projects/*/locations/*/backupPlans/*`.
         # @!attribute [rw] cluster
         #   @return [::String]
-        #     Required. Immutable. The target cluster into which Restores created via this RestorePlan
-        #     will restore data. NOTE: the cluster's region must be the same as the
-        #     RestorePlan.
-        #     Valid formats:
+        #     Required. Immutable. The target cluster into which Restores created via
+        #     this RestorePlan will restore data. NOTE: the cluster's region must be the
+        #     same as the RestorePlan. Valid formats:
         #
-        #       - projects/*/locations/*/clusters/*
-        #       - projects/*/zones/*/clusters/*
+        #       - `projects/*/locations/*/clusters/*`
+        #       - `projects/*/zones/*/clusters/*`
         # @!attribute [rw] restore_config
         #   @return [::Google::Cloud::GkeBackup::V1::RestoreConfig]
         #     Required. Configuration of Restores created via this RestorePlan.
@@ -65,14 +65,23 @@ module Google
         #     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 help
-        #     prevent simultaneous updates of a restore from overwriting each other.
+        #     Output only. `etag` is used for optimistic concurrency control as a way to
+        #     help prevent simultaneous updates of a restore from overwriting each other.
         #     It is strongly suggested that systems make use of the `etag` in the
         #     read-modify-write cycle to perform restore updates in order to avoid
         #     race conditions: An `etag` is returned in the response to `GetRestorePlan`,
         #     and systems are expected to put that etag in the request to
         #     `UpdateRestorePlan` or `DeleteRestorePlan` to ensure that their change
         #     will be applied to the same version of the resource.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::GkeBackup::V1::RestorePlan::State]
+        #     Output only. State of the RestorePlan. This State field reflects the
+        #     various stages a RestorePlan can be in
+        #     during the Create operation.
+        # @!attribute [r] state_reason
+        #   @return [::String]
+        #     Output only. Human-readable description of why RestorePlan is in the
+        #     current `state`
         class RestorePlan
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -85,6 +94,24 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # State
+          module State
+            # Default first value for Enums.
+            STATE_UNSPECIFIED = 0
+
+            # Waiting for cluster state to be RUNNING.
+            CLUSTER_PENDING = 1
+
+            # The RestorePlan has successfully been created and is ready for Restores.
+            READY = 2
+
+            # RestorePlan creation has failed.
+            FAILED = 3
+
+            # The RestorePlan is in the process of being deleted.
+            DELETING = 4
+          end
         end
       end
     end

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

@@ -28,7 +28,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The full name of the VolumeBackup resource.
-        #     Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*.
+        #     Format: `projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*`.
         # @!attribute [r] uid
         #   @return [::String]
         #     Output only. Server generated global unique identifier of
@@ -43,24 +43,26 @@ module Google
         #     updated.
         # @!attribute [r] source_pvc
         #   @return [::Google::Cloud::GkeBackup::V1::NamespacedName]
-        #     Output only. A reference to the source Kubernetes PVC from which this VolumeBackup
-        #     was created.
+        #     Output only. A reference to the source Kubernetes PVC from which this
+        #     VolumeBackup was created.
         # @!attribute [r] volume_backup_handle
         #   @return [::String]
-        #     Output only. A storage system-specific opaque handle to the underlying volume backup.
+        #     Output only. A storage system-specific opaque handle to the underlying
+        #     volume backup.
         # @!attribute [r] format
         #   @return [::Google::Cloud::GkeBackup::V1::VolumeBackup::VolumeBackupFormat]
         #     Output only. The format used for the volume backup.
         # @!attribute [r] storage_bytes
         #   @return [::Integer]
-        #     Output only. The aggregate size of the underlying artifacts associated with this
-        #     VolumeBackup in the backup storage. This may change over time when
+        #     Output only. The aggregate size of the underlying artifacts associated with
+        #     this VolumeBackup in the backup storage. This may change over time when
         #     multiple backups of the same volume share the same backup storage
         #     location. In particular, this is likely to increase in size when
         #     the immediately preceding backup of the same volume is deleted.
         # @!attribute [r] disk_size_bytes
         #   @return [::Integer]
-        #     Output only. The minimum size of the disk to which this VolumeBackup can be restored.
+        #     Output only. The minimum size of the disk to which this VolumeBackup can be
+        #     restored.
         # @!attribute [r] complete_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The timestamp when the associated underlying volume backup
@@ -70,12 +72,12 @@ module Google
         #     Output only. The current state of this VolumeBackup.
         # @!attribute [r] state_message
         #   @return [::String]
-        #     Output only. A human readable message explaining why the VolumeBackup is in its current
-        #     state.
+        #     Output only. A human readable message explaining why the VolumeBackup is in
+        #     its current state.
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. `etag` is used for optimistic concurrency control as a way to help
-        #     prevent simultaneous updates of a volume backup from overwriting each
+        #     Output only. `etag` is used for optimistic concurrency control as a way to
+        #     help prevent simultaneous updates of a volume backup from overwriting each
         #     other. It is strongly suggested that systems make use of the `etag` in the
         #     read-modify-write cycle to perform volume backup updates in order to avoid
         #     race conditions.
@@ -128,7 +130,7 @@ module Google
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. Full name of the VolumeRestore resource.
-        #     Format: projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*.
+        #     Format: `projects/*/locations/*/restorePlans/*/restores/*/volumeRestores/*`
         # @!attribute [r] uid
         #   @return [::String]
         #     Output only. Server generated global unique identifier of
@@ -143,15 +145,16 @@ module Google
         #     updated.
         # @!attribute [r] volume_backup
         #   @return [::String]
-        #     Output only. The full name of the VolumeBackup from which the volume will be restored.
-        #     Format: projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*.
+        #     Output only. The full name of the VolumeBackup from which the volume will
+        #     be restored. Format:
+        #     `projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*`.
         # @!attribute [r] target_pvc
         #   @return [::Google::Cloud::GkeBackup::V1::NamespacedName]
         #     Output only. The reference to the target Kubernetes PVC to be restored.
         # @!attribute [r] volume_handle
         #   @return [::String]
-        #     Output only. A storage system-specific opaque handler to the underlying volume created
-        #     for the target PVC from the volume backup.
+        #     Output only. A storage system-specific opaque handler to the underlying
+        #     volume created for the target PVC from the volume backup.
         # @!attribute [r] volume_type
         #   @return [::Google::Cloud::GkeBackup::V1::VolumeRestore::VolumeType]
         #     Output only. The type of volume provisioned
@@ -164,12 +167,12 @@ module Google
         #     Output only. The current state of this VolumeRestore.
         # @!attribute [r] state_message
         #   @return [::String]
-        #     Output only. A human readable message explaining why the VolumeRestore is in its
-        #     current state.
+        #     Output only. A human readable message explaining why the VolumeRestore is
+        #     in its current state.
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. `etag` is used for optimistic concurrency control as a way to help
-        #     prevent simultaneous updates of a volume restore from overwriting each
+        #     Output only. `etag` is used for optimistic concurrency control as a way to
+        #     help prevent simultaneous updates of a volume restore from overwriting each
         #     other. It is strongly suggested that systems make use of the `etag` in the
         #     read-modify-write cycle to perform volume restore updates in order to avoid
         #     race conditions.

data/proto_docs/google/type/expr.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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 Type
+    # Represents a textual expression in the Common Expression Language (CEL)
+    # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+    # are documented at https://github.com/google/cel-spec.
+    #
+    # Example (Comparison):
+    #
+    #     title: "Summary size limit"
+    #     description: "Determines if a summary is less than 100 chars"
+    #     expression: "document.summary.size() < 100"
+    #
+    # Example (Equality):
+    #
+    #     title: "Requestor is owner"
+    #     description: "Determines if requestor is the document owner"
+    #     expression: "document.owner == request.auth.claims.email"
+    #
+    # Example (Logic):
+    #
+    #     title: "Public documents"
+    #     description: "Determine whether the document should be publicly visible"
+    #     expression: "document.type != 'private' && document.type != 'internal'"
+    #
+    # Example (Data Manipulation):
+    #
+    #     title: "Notification string"
+    #     description: "Create a notification string with a timestamp."
+    #     expression: "'New message received at ' + string(document.create_time)"
+    #
+    # The exact variables and functions that may be referenced within an expression
+    # are determined by the service that evaluates it. See the service
+    # documentation for additional information.
+    # @!attribute [rw] expression
+    #   @return [::String]
+    #     Textual representation of an expression in Common Expression Language
+    #     syntax.
+    # @!attribute [rw] title
+    #   @return [::String]
+    #     Optional. Title for the expression, i.e. a short string describing
+    #     its purpose. This can be used e.g. in UIs which allow to enter the
+    #     expression.
+    # @!attribute [rw] description
+    #   @return [::String]
+    #     Optional. Description of the expression. This is a longer text which
+    #     describes the expression, e.g. when hovered over it in a UI.
+    # @!attribute [rw] location
+    #   @return [::String]
+    #     Optional. String indicating the location of the expression for error
+    #     reporting, e.g. a file name and a position in the file.
+    class Expr
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end