google-apis-composer_v1 0.30.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33bbca7f55439980009cd098e7731acefa3905adebb7c0e03dde30d4514f0469
-  data.tar.gz: d6ebfd962e988c9b529ac7cce9dac6ad155e7c0832ccce237880d114272147a8
+  metadata.gz: 0f3bc8686dfaf866127fd9235bbe26a59d0f1825f6f79a74fb64646ac8af17f0
+  data.tar.gz: 0ce14360ebc31e3d767740087b49fd525e7b92ff6309f0554af6565a05de5ff9
 SHA512:
-  metadata.gz: 7e92469198ef38ec05c390a96c5c6db14651bce3a5e04f81794b040dffe04c47cdba02d6f9e749a089c63fc7f2a8bf1070cadc106bb7082fe57f5016cb8ccc2b
-  data.tar.gz: f67f8cc9fa049ab47112e27cf3fff8c70b6f7f69a6325860f867ab9f8ba75f938cc22d767e6f58a7b6dff273477a90a7d49b33d307dfd4da4fe31814c99f1fb5
+  metadata.gz: 446a1cf9f994c6f2870fe3b5905f886d1b6b7de226df782b090119802d3ca738242a863c3b7a0cee889f8a927d3af97ef798c4764ed8e56dbabed12809040899
+  data.tar.gz: 52c6c7ca5068d1fb50d0f02ab05caa63bee6d3a2e6c8ba630f9204307f3ae6faac629414e7d2bb46f45b31596a54dbe2d4bc68314ca978987ac19d7dc07fc80d

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-composer_v1
 
+### v0.31.0 (2022-12-04)
+
+* Regenerated from discovery document revision 20221130
+
 ### v0.30.0 (2022-10-28)
 
 * Regenerated from discovery document revision 20221012

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

@@ -367,6 +367,11 @@ module Google
         # @return [Google::Apis::ComposerV1::PrivateEnvironmentConfig]
         attr_accessor :private_environment_config
       
+        # The Recovery settings of an environment.
+        # Corresponds to the JSON property `recoveryConfig`
+        # @return [Google::Apis::ComposerV1::RecoveryConfig]
+        attr_accessor :recovery_config
+      
         # Specifies the selection and configuration of software inside the environment.
         # Corresponds to the JSON property `softwareConfig`
         # @return [Google::Apis::ComposerV1::SoftwareConfig]
@@ -408,6 +413,7 @@ module Google
           @node_config = args[:node_config] if args.key?(:node_config)
           @node_count = args[:node_count] if args.key?(:node_count)
           @private_environment_config = args[:private_environment_config] if args.key?(:private_environment_config)
+          @recovery_config = args[:recovery_config] if args.key?(:recovery_config)
           @software_config = args[:software_config] if args.key?(:software_config)
           @web_server_config = args[:web_server_config] if args.key?(:web_server_config)
           @web_server_network_access_control = args[:web_server_network_access_control] if args.key?(:web_server_network_access_control)
@@ -619,6 +625,58 @@ module Google
         end
       end
       
+      # Request to load a snapshot into a Cloud Composer environment.
+      class LoadSnapshotRequest
+        include Google::Apis::Core::Hashable
+      
+        # Whether or not to skip setting Airflow overrides when loading the environment'
+        # s state.
+        # Corresponds to the JSON property `skipAirflowOverridesSetting`
+        # @return [Boolean]
+        attr_accessor :skip_airflow_overrides_setting
+        alias_method :skip_airflow_overrides_setting?, :skip_airflow_overrides_setting
+      
+        # Whether or not to skip setting environment variables when loading the
+        # environment's state.
+        # Corresponds to the JSON property `skipEnvironmentVariablesSetting`
+        # @return [Boolean]
+        attr_accessor :skip_environment_variables_setting
+        alias_method :skip_environment_variables_setting?, :skip_environment_variables_setting
+      
+        # Whether or not to skip copying Cloud Storage data when loading the environment'
+        # s state.
+        # Corresponds to the JSON property `skipGcsDataCopying`
+        # @return [Boolean]
+        attr_accessor :skip_gcs_data_copying
+        alias_method :skip_gcs_data_copying?, :skip_gcs_data_copying
+      
+        # Whether or not to skip installing Pypi packages when loading the environment's
+        # state.
+        # Corresponds to the JSON property `skipPypiPackagesInstallation`
+        # @return [Boolean]
+        attr_accessor :skip_pypi_packages_installation
+        alias_method :skip_pypi_packages_installation?, :skip_pypi_packages_installation
+      
+        # A Cloud Storage path to a snapshot to load, e.g.: "gs://my-bucket/snapshots/
+        # project_location_environment_timestamp".
+        # Corresponds to the JSON property `snapshotPath`
+        # @return [String]
+        attr_accessor :snapshot_path
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @skip_airflow_overrides_setting = args[:skip_airflow_overrides_setting] if args.key?(:skip_airflow_overrides_setting)
+          @skip_environment_variables_setting = args[:skip_environment_variables_setting] if args.key?(:skip_environment_variables_setting)
+          @skip_gcs_data_copying = args[:skip_gcs_data_copying] if args.key?(:skip_gcs_data_copying)
+          @skip_pypi_packages_installation = args[:skip_pypi_packages_installation] if args.key?(:skip_pypi_packages_installation)
+          @snapshot_path = args[:snapshot_path] if args.key?(:snapshot_path)
+        end
+      end
+      
       # Response to LoadSnapshotRequest.
       class LoadSnapshotResponse
         include Google::Apis::Core::Hashable
@@ -1098,6 +1156,45 @@ module Google
         end
       end
       
+      # The Recovery settings of an environment.
+      class RecoveryConfig
+        include Google::Apis::Core::Hashable
+      
+        # The configuration for scheduled snapshot creation mechanism.
+        # Corresponds to the JSON property `scheduledSnapshotsConfig`
+        # @return [Google::Apis::ComposerV1::ScheduledSnapshotsConfig]
+        attr_accessor :scheduled_snapshots_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @scheduled_snapshots_config = args[:scheduled_snapshots_config] if args.key?(:scheduled_snapshots_config)
+        end
+      end
+      
+      # Request to create a snapshot of a Cloud Composer environment.
+      class SaveSnapshotRequest
+        include Google::Apis::Core::Hashable
+      
+        # Location in a Cloud Storage where the snapshot is going to be stored, e.g.: "
+        # gs://my-bucket/snapshots".
+        # Corresponds to the JSON property `snapshotLocation`
+        # @return [String]
+        attr_accessor :snapshot_location
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @snapshot_location = args[:snapshot_location] if args.key?(:snapshot_location)
+        end
+      end
+      
       # Response to SaveSnapshotRequest.
       class SaveSnapshotResponse
         include Google::Apis::Core::Hashable
@@ -1119,6 +1216,48 @@ module Google
         end
       end
       
+      # The configuration for scheduled snapshot creation mechanism.
+      class ScheduledSnapshotsConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Whether scheduled snapshots creation is enabled.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # Optional. The cron expression representing the time when snapshots creation
+        # mechanism runs. This field is subject to additional validation around
+        # frequency of execution.
+        # Corresponds to the JSON property `snapshotCreationSchedule`
+        # @return [String]
+        attr_accessor :snapshot_creation_schedule
+      
+        # Optional. The Cloud Storage location for storing automatically created
+        # snapshots.
+        # Corresponds to the JSON property `snapshotLocation`
+        # @return [String]
+        attr_accessor :snapshot_location
+      
+        # Optional. Time zone that sets the context to interpret
+        # snapshot_creation_schedule.
+        # Corresponds to the JSON property `timeZone`
+        # @return [String]
+        attr_accessor :time_zone
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @snapshot_creation_schedule = args[:snapshot_creation_schedule] if args.key?(:snapshot_creation_schedule)
+          @snapshot_location = args[:snapshot_location] if args.key?(:snapshot_location)
+          @time_zone = args[:time_zone] if args.key?(:time_zone)
+        end
+      end
+      
       # Configuration for resources used by Airflow schedulers.
       class SchedulerResource
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module ComposerV1
       # Version of the google-apis-composer_v1 gem
-      GEM_VERSION = "0.30.0"
+      GEM_VERSION = "0.31.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.11.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20221012"
+      REVISION = "20221130"
     end
   end
 end

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

@@ -106,6 +106,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LoadSnapshotRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class LoadSnapshotResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -160,12 +166,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RecoveryConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class SaveSnapshotRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SaveSnapshotResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ScheduledSnapshotsConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SchedulerResource
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -304,6 +328,8 @@ module Google
           property :node_count, as: 'nodeCount'
           property :private_environment_config, as: 'privateEnvironmentConfig', class: Google::Apis::ComposerV1::PrivateEnvironmentConfig, decorator: Google::Apis::ComposerV1::PrivateEnvironmentConfig::Representation
       
+          property :recovery_config, as: 'recoveryConfig', class: Google::Apis::ComposerV1::RecoveryConfig, decorator: Google::Apis::ComposerV1::RecoveryConfig::Representation
+      
           property :software_config, as: 'softwareConfig', class: Google::Apis::ComposerV1::SoftwareConfig, decorator: Google::Apis::ComposerV1::SoftwareConfig::Representation
       
           property :web_server_config, as: 'webServerConfig', class: Google::Apis::ComposerV1::WebServerConfig, decorator: Google::Apis::ComposerV1::WebServerConfig::Representation
@@ -366,6 +392,17 @@ module Google
         end
       end
       
+      class LoadSnapshotRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :skip_airflow_overrides_setting, as: 'skipAirflowOverridesSetting'
+          property :skip_environment_variables_setting, as: 'skipEnvironmentVariablesSetting'
+          property :skip_gcs_data_copying, as: 'skipGcsDataCopying'
+          property :skip_pypi_packages_installation, as: 'skipPypiPackagesInstallation'
+          property :snapshot_path, as: 'snapshotPath'
+        end
+      end
+      
       class LoadSnapshotResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -465,6 +502,21 @@ module Google
         end
       end
       
+      class RecoveryConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :scheduled_snapshots_config, as: 'scheduledSnapshotsConfig', class: Google::Apis::ComposerV1::ScheduledSnapshotsConfig, decorator: Google::Apis::ComposerV1::ScheduledSnapshotsConfig::Representation
+      
+        end
+      end
+      
+      class SaveSnapshotRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :snapshot_location, as: 'snapshotLocation'
+        end
+      end
+      
       class SaveSnapshotResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -472,6 +524,16 @@ module Google
         end
       end
       
+      class ScheduledSnapshotsConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :enabled, as: 'enabled'
+          property :snapshot_creation_schedule, as: 'snapshotCreationSchedule'
+          property :snapshot_location, as: 'snapshotLocation'
+          property :time_zone, as: 'timeZone'
+        end
+      end
+      
       class SchedulerResource
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/composer_v1/service.rb

@@ -181,6 +181,42 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Loads a snapshot of a Cloud Composer environment. As a result of this
+        # operation, a snapshot of environment's specified in LoadSnapshotRequest is
+        # loaded into the environment.
+        # @param [String] environment
+        #   The resource name of the target environment in the form: "projects/`projectId`/
+        #   locations/`locationId`/environments/`environmentId`"
+        # @param [Google::Apis::ComposerV1::LoadSnapshotRequest] load_snapshot_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComposerV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComposerV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def load_environment_snapshot(environment, load_snapshot_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+environment}:loadSnapshot', options)
+          command.request_representation = Google::Apis::ComposerV1::LoadSnapshotRequest::Representation
+          command.request_object = load_snapshot_request_object
+          command.response_representation = Google::Apis::ComposerV1::Operation::Representation
+          command.response_class = Google::Apis::ComposerV1::Operation
+          command.params['environment'] = environment unless environment.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Update an environment.
         # @param [String] name
         #   The relative resource name of the environment to update, in the form: "
@@ -286,6 +322,42 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a snapshots of a Cloud Composer environment. As a result of this
+        # operation, snapshot of environment's state is stored in a location specified
+        # in the SaveSnapshotRequest.
+        # @param [String] environment
+        #   The resource name of the source environment in the form: "projects/`projectId`/
+        #   locations/`locationId`/environments/`environmentId`"
+        # @param [Google::Apis::ComposerV1::SaveSnapshotRequest] save_snapshot_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComposerV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComposerV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def save_environment_snapshot(environment, save_snapshot_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+environment}:saveSnapshot', options)
+          command.request_representation = Google::Apis::ComposerV1::SaveSnapshotRequest::Representation
+          command.request_object = save_snapshot_request_object
+          command.response_representation = Google::Apis::ComposerV1::Operation::Representation
+          command.response_class = Google::Apis::ComposerV1::Operation
+          command.params['environment'] = environment unless environment.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # List ImageVersions for provided location.
         # @param [String] parent
         #   List ImageVersions in the given project and location, in the form: "projects/`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-composer_v1
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-31 00:00:00.000000000 Z
+date: 2022-12-12 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-composer_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-composer_v1/v0.30.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-composer_v1/v0.31.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-composer_v1
 post_install_message: 
 rdoc_options: []