google-apis-gkebackup_v1 0.17.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c472371d302703c8366079e78b298c106a581a4251d3f1ece2b26bc1d05b0e73
-  data.tar.gz: c6fb4fd7cf5633cfad4d64b2710b761e70efa6d958b40990fc7546c4289b563f
+  metadata.gz: e75c3c51954f5f624bffec48912a1834cb97d56cd3aed93b821df688249813ed
+  data.tar.gz: a3307d035c82e135ff0989f24cf91029cd2ededd1dfaf7cfe3571817deb93fe5
 SHA512:
-  metadata.gz: a1d35a068de59a51fbb5198cf0734be7a02c38d89603c7aca9d4be3d044431d851e1b44e11ed00b95665e84b1696795cb619691a14588cfe9d6e83f7bfcd4ee7
-  data.tar.gz: 91ae05a1299c9fac32628e2e94696f4fc400923559cd4eeececb03d1146e5c251a262e1a4359d3c9b4281eab78ed8fef70604107a5ead5913e4bb01bb254cf32
+  metadata.gz: 85d3121baa916c59f7cd01c8dd52f0024fba43e023dd8d82d08b257fd0241b640033c230da92fb7ce8b16974bf639e0a5adebe99777865ff9d48aaa46c00194f
+  data.tar.gz: 1d25276aad0f89d309b649ba1cdea53d820e6c2803e1a7abb671e71026a12699f001138083fa23f1ba5e5db68f930d65bbd8c4a9d5efe80bc9e9407d0bd469c0

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-gkebackup_v1
 
+### v0.19.0 (2023-07-16)
+
+* Regenerated from discovery document revision 20230705
+
+### v0.18.0 (2023-06-18)
+
+* Regenerated from discovery document revision 20230609
+
 ### v0.17.0 (2023-05-14)
 
 * Regenerated from discovery document revision 20230503

data/lib/google/apis/gkebackup_v1/classes.rb

@@ -96,7 +96,7 @@ module Google
       # Represents a request to perform a single point-in-time capture of some portion
       # of the state of a GKE cluster, the record of the backup operation itself, and
       # an anchor for the underlying artifacts that comprise the Backup (the config
-      # backup and VolumeBackups). Next id: 28
+      # backup and VolumeBackups). Next id: 29
       class Backup
         include Google::Apis::Core::Hashable
       
@@ -365,8 +365,8 @@ module Google
         # @return [Google::Apis::GkebackupV1::BackupConfig]
         attr_accessor :backup_config
       
-        # Schedule defines scheduling parameters for automatically creating Backups via
-        # this BackupPlan.
+        # Defines scheduling parameters for automatically creating Backups via this
+        # BackupPlan.
         # Corresponds to the JSON property `backupSchedule`
         # @return [Google::Apis::GkebackupV1::Schedule]
         attr_accessor :backup_schedule
@@ -432,6 +432,19 @@ module Google
         # @return [Google::Apis::GkebackupV1::RetentionPolicy]
         attr_accessor :retention_policy
       
+        # Output only. State of the BackupPlan. This State field reflects the various
+        # stages a BackupPlan can be in during the Create operation. It will be set to "
+        # DEACTIVATED" if the BackupPlan is deactivated on an Update
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Output only. Human-readable description of why BackupPlan is in the current `
+        # state`
+        # Corresponds to the JSON property `stateReason`
+        # @return [String]
+        attr_accessor :state_reason
+      
         # Output only. Server generated global unique identifier of [UUID](https://en.
         # wikipedia.org/wiki/Universally_unique_identifier) format.
         # Corresponds to the JSON property `uid`
@@ -460,6 +473,8 @@ module Google
           @name = args[:name] if args.key?(:name)
           @protected_pod_count = args[:protected_pod_count] if args.key?(:protected_pod_count)
           @retention_policy = args[:retention_policy] if args.key?(:retention_policy)
+          @state = args[:state] if args.key?(:state)
+          @state_reason = args[:state_reason] if args.key?(:state_reason)
           @uid = args[:uid] if args.key?(:uid)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
@@ -598,6 +613,29 @@ module Google
       class ClusterResourceRestoreScope
         include Google::Apis::Core::Hashable
       
+        # If True, all valid cluster-scoped resources will be restored. Mutually
+        # exclusive to any other field in the message.
+        # Corresponds to the JSON property `allGroupKinds`
+        # @return [Boolean]
+        attr_accessor :all_group_kinds
+        alias_method :all_group_kinds?, :all_group_kinds
+      
+        # 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.
+        # Corresponds to the JSON property `excludedGroupKinds`
+        # @return [Array<Google::Apis::GkebackupV1::GroupKind>]
+        attr_accessor :excluded_group_kinds
+      
+        # 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.
+        # Corresponds to the JSON property `noGroupKinds`
+        # @return [Boolean]
+        attr_accessor :no_group_kinds
+        alias_method :no_group_kinds?, :no_group_kinds
+      
         # 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.
@@ -611,6 +649,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @all_group_kinds = args[:all_group_kinds] if args.key?(:all_group_kinds)
+          @excluded_group_kinds = args[:excluded_group_kinds] if args.key?(:excluded_group_kinds)
+          @no_group_kinds = args[:no_group_kinds] if args.key?(:no_group_kinds)
           @selected_group_kinds = args[:selected_group_kinds] if args.key?(:selected_group_kinds)
         end
       end
@@ -1343,6 +1384,50 @@ module Google
         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.
+      class ResourceFilter
+        include Google::Apis::Core::Hashable
+      
+        # (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).
+        # Corresponds to the JSON property `groupKinds`
+        # @return [Array<Google::Apis::GkebackupV1::GroupKind>]
+        attr_accessor :group_kinds
+      
+        # 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).
+        # Corresponds to the JSON property `jsonPath`
+        # @return [String]
+        attr_accessor :json_path
+      
+        # (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.
+        # Corresponds to the JSON property `namespaces`
+        # @return [Array<String>]
+        attr_accessor :namespaces
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @group_kinds = args[:group_kinds] if args.key?(:group_kinds)
+          @json_path = args[:json_path] if args.key?(:json_path)
+          @namespaces = args[:namespaces] if args.key?(:namespaces)
+        end
+      end
+      
       # 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
       class Restore
@@ -1506,6 +1591,11 @@ module Google
         # @return [Google::Apis::GkebackupV1::ClusterResourceRestoreScope]
         attr_accessor :cluster_resource_restore_scope
       
+        # A list of Kubernetes Namespaces
+        # Corresponds to the JSON property `excludedNamespaces`
+        # @return [Google::Apis::GkebackupV1::Namespaces]
+        attr_accessor :excluded_namespaces
+      
         # 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.
@@ -1513,6 +1603,13 @@ module Google
         # @return [String]
         attr_accessor :namespaced_resource_restore_mode
       
+        # Do not restore any namespaced resources if set to "True". Specifying this
+        # field to "False" is not allowed.
+        # Corresponds to the JSON property `noNamespaces`
+        # @return [Boolean]
+        attr_accessor :no_namespaces
+        alias_method :no_namespaces?, :no_namespaces
+      
         # A list of namespaced Kubernetes resources.
         # Corresponds to the JSON property `selectedApplications`
         # @return [Google::Apis::GkebackupV1::NamespacedNames]
@@ -1532,6 +1629,15 @@ module Google
         # @return [Array<Google::Apis::GkebackupV1::SubstitutionRule>]
         attr_accessor :substitution_rules
       
+        # 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.
+        # Corresponds to the JSON property `transformationRules`
+        # @return [Array<Google::Apis::GkebackupV1::TransformationRule>]
+        attr_accessor :transformation_rules
+      
         # Specifies the mechanism to be used to restore volume data. Default:
         # VOLUME_DATA_RESTORE_POLICY_UNSPECIFIED (will be treated as
         # NO_VOLUME_DATA_RESTORATION).
@@ -1548,10 +1654,13 @@ module Google
           @all_namespaces = args[:all_namespaces] if args.key?(:all_namespaces)
           @cluster_resource_conflict_policy = args[:cluster_resource_conflict_policy] if args.key?(:cluster_resource_conflict_policy)
           @cluster_resource_restore_scope = args[:cluster_resource_restore_scope] if args.key?(:cluster_resource_restore_scope)
+          @excluded_namespaces = args[:excluded_namespaces] if args.key?(:excluded_namespaces)
           @namespaced_resource_restore_mode = args[:namespaced_resource_restore_mode] if args.key?(:namespaced_resource_restore_mode)
+          @no_namespaces = args[:no_namespaces] if args.key?(:no_namespaces)
           @selected_applications = args[:selected_applications] if args.key?(:selected_applications)
           @selected_namespaces = args[:selected_namespaces] if args.key?(:selected_namespaces)
           @substitution_rules = args[:substitution_rules] if args.key?(:substitution_rules)
+          @transformation_rules = args[:transformation_rules] if args.key?(:transformation_rules)
           @volume_data_restore_policy = args[:volume_data_restore_policy] if args.key?(:volume_data_restore_policy)
         end
       end
@@ -1614,6 +1723,18 @@ module Google
         # @return [Google::Apis::GkebackupV1::RestoreConfig]
         attr_accessor :restore_config
       
+        # Output only. State of the RestorePlan. This State field reflects the various
+        # stages a RestorePlan can be in during the Create operation.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Output only. Human-readable description of why RestorePlan is in the current `
+        # state`
+        # Corresponds to the JSON property `stateReason`
+        # @return [String]
+        attr_accessor :state_reason
+      
         # Output only. Server generated global unique identifier of [UUID](https://en.
         # wikipedia.org/wiki/Universally_unique_identifier) format.
         # Corresponds to the JSON property `uid`
@@ -1639,6 +1760,8 @@ module Google
           @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
           @restore_config = args[:restore_config] if args.key?(:restore_config)
+          @state = args[:state] if args.key?(:state)
+          @state_reason = args[:state_reason] if args.key?(:state_reason)
           @uid = args[:uid] if args.key?(:uid)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
@@ -1691,15 +1814,16 @@ module Google
         end
       end
       
-      # Schedule defines scheduling parameters for automatically creating Backups via
-      # this BackupPlan.
+      # Defines scheduling parameters for automatically creating Backups via this
+      # BackupPlan.
       class Schedule
         include Google::Apis::Core::Hashable
       
         # A standard [cron](https://wikipedia.com/wiki/cron) string that defines a
-        # repeating schedule for creating Backups via this BackupPlan. If this is
-        # defined, then backup_retain_days must also be defined. Default (empty): no
-        # automatic backup creation will occur.
+        # repeating schedule for creating Backups via this BackupPlan. This is mutually
+        # exclusive with the rpo_config field since at most one schedule can be defined
+        # for a BackupPlan. If this is defined, then backup_retain_days must also be
+        # defined. Default (empty): no automatic backup creation will occur.
         # Corresponds to the JSON property `cronSchedule`
         # @return [String]
         attr_accessor :cron_schedule
@@ -1882,6 +2006,86 @@ module Google
         end
       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.
+      class TransformationRule
+        include Google::Apis::Core::Hashable
+      
+        # The description is a user specified string description of the transformation
+        # rule.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # 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.
+        # Corresponds to the JSON property `fieldActions`
+        # @return [Array<Google::Apis::GkebackupV1::TransformationRuleAction>]
+        attr_accessor :field_actions
+      
+        # 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.
+        # Corresponds to the JSON property `resourceFilter`
+        # @return [Google::Apis::GkebackupV1::ResourceFilter]
+        attr_accessor :resource_filter
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @field_actions = args[:field_actions] if args.key?(:field_actions)
+          @resource_filter = args[:resource_filter] if args.key?(:resource_filter)
+        end
+      end
+      
+      # TransformationRuleAction defines a TransformationRule action based on the JSON
+      # Patch RFC (https://www.rfc-editor.org/rfc/rfc6902)
+      class TransformationRuleAction
+        include Google::Apis::Core::Hashable
+      
+        # A string containing a JSON Pointer value that references the location in the
+        # target document to move the value from.
+        # Corresponds to the JSON property `fromPath`
+        # @return [String]
+        attr_accessor :from_path
+      
+        # Required. op specifies the operation to perform.
+        # Corresponds to the JSON property `op`
+        # @return [String]
+        attr_accessor :op
+      
+        # A string containing a JSON-Pointer value that references a location within the
+        # target document where the operation is performed.
+        # Corresponds to the JSON property `path`
+        # @return [String]
+        attr_accessor :path
+      
+        # A string that specifies the desired value in string format to use for
+        # transformation.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @from_path = args[:from_path] if args.key?(:from_path)
+          @op = args[:op] if args.key?(:op)
+          @path = args[:path] if args.key?(:path)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # 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

data/lib/google/apis/gkebackup_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module GkebackupV1
       # Version of the google-apis-gkebackup_v1 gem
-      GEM_VERSION = "0.17.0"
+      GEM_VERSION = "0.19.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230503"
+      REVISION = "20230705"
     end
   end
 end

data/lib/google/apis/gkebackup_v1/representations.rb

@@ -196,6 +196,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ResourceFilter
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Restore
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -250,6 +256,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TransformationRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TransformationRuleAction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class VolumeBackup
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -348,6 +366,8 @@ module Google
           property :protected_pod_count, as: 'protectedPodCount'
           property :retention_policy, as: 'retentionPolicy', class: Google::Apis::GkebackupV1::RetentionPolicy, decorator: Google::Apis::GkebackupV1::RetentionPolicy::Representation
       
+          property :state, as: 'state'
+          property :state_reason, as: 'stateReason'
           property :uid, as: 'uid'
           property :update_time, as: 'updateTime'
         end
@@ -377,6 +397,10 @@ module Google
       class ClusterResourceRestoreScope
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :all_group_kinds, as: 'allGroupKinds'
+          collection :excluded_group_kinds, as: 'excludedGroupKinds', class: Google::Apis::GkebackupV1::GroupKind, decorator: Google::Apis::GkebackupV1::GroupKind::Representation
+      
+          property :no_group_kinds, as: 'noGroupKinds'
           collection :selected_group_kinds, as: 'selectedGroupKinds', class: Google::Apis::GkebackupV1::GroupKind, decorator: Google::Apis::GkebackupV1::GroupKind::Representation
       
         end
@@ -574,6 +598,16 @@ module Google
         end
       end
       
+      class ResourceFilter
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :group_kinds, as: 'groupKinds', class: Google::Apis::GkebackupV1::GroupKind, decorator: Google::Apis::GkebackupV1::GroupKind::Representation
+      
+          property :json_path, as: 'jsonPath'
+          collection :namespaces, as: 'namespaces'
+        end
+      end
+      
       class Restore
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -605,13 +639,18 @@ module Google
           property :cluster_resource_conflict_policy, as: 'clusterResourceConflictPolicy'
           property :cluster_resource_restore_scope, as: 'clusterResourceRestoreScope', class: Google::Apis::GkebackupV1::ClusterResourceRestoreScope, decorator: Google::Apis::GkebackupV1::ClusterResourceRestoreScope::Representation
       
+          property :excluded_namespaces, as: 'excludedNamespaces', class: Google::Apis::GkebackupV1::Namespaces, decorator: Google::Apis::GkebackupV1::Namespaces::Representation
+      
           property :namespaced_resource_restore_mode, as: 'namespacedResourceRestoreMode'
+          property :no_namespaces, as: 'noNamespaces'
           property :selected_applications, as: 'selectedApplications', class: Google::Apis::GkebackupV1::NamespacedNames, decorator: Google::Apis::GkebackupV1::NamespacedNames::Representation
       
           property :selected_namespaces, as: 'selectedNamespaces', class: Google::Apis::GkebackupV1::Namespaces, decorator: Google::Apis::GkebackupV1::Namespaces::Representation
       
           collection :substitution_rules, as: 'substitutionRules', class: Google::Apis::GkebackupV1::SubstitutionRule, decorator: Google::Apis::GkebackupV1::SubstitutionRule::Representation
       
+          collection :transformation_rules, as: 'transformationRules', class: Google::Apis::GkebackupV1::TransformationRule, decorator: Google::Apis::GkebackupV1::TransformationRule::Representation
+      
           property :volume_data_restore_policy, as: 'volumeDataRestorePolicy'
         end
       end
@@ -628,6 +667,8 @@ module Google
           property :name, as: 'name'
           property :restore_config, as: 'restoreConfig', class: Google::Apis::GkebackupV1::RestoreConfig, decorator: Google::Apis::GkebackupV1::RestoreConfig::Representation
       
+          property :state, as: 'state'
+          property :state_reason, as: 'stateReason'
           property :uid, as: 'uid'
           property :update_time, as: 'updateTime'
         end
@@ -685,6 +726,27 @@ module Google
         end
       end
       
+      class TransformationRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          collection :field_actions, as: 'fieldActions', class: Google::Apis::GkebackupV1::TransformationRuleAction, decorator: Google::Apis::GkebackupV1::TransformationRuleAction::Representation
+      
+          property :resource_filter, as: 'resourceFilter', class: Google::Apis::GkebackupV1::ResourceFilter, decorator: Google::Apis::GkebackupV1::ResourceFilter::Representation
+      
+        end
+      end
+      
+      class TransformationRuleAction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :from_path, as: 'fromPath'
+          property :op, as: 'op'
+          property :path, as: 'path'
+          property :value, as: 'value'
+        end
+      end
+      
       class VolumeBackup
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-gkebackup_v1
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-14 00:00:00.000000000 Z
+date: 2023-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkebackup_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-gkebackup_v1/v0.17.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-gkebackup_v1/v0.19.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-gkebackup_v1
 post_install_message: 
 rdoc_options: []