google-apis-storagetransfer_v1 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65b607b8f7d0e8a8b327553107169710f0d052c05241bc4ccacbc13632b69b26
-  data.tar.gz: 8e12775f35686fbad11c420670cc1d9961523e5cd6a57627db9f52f4f0d87b64
+  metadata.gz: 62a3e076f2a4f7e850ab3c1540cc4d37f1c431aab1e16cb49b1822256b9a770e
+  data.tar.gz: 24ea9d15dae7a9da467922ef3d63e58aff37f7933c0459425ef8c838f4aa738a
 SHA512:
-  metadata.gz: ac42f9213be2551d265851a962243f25986667e638727f9648f5e559f8645399ff50c7b934623fefa873a40fc9b0223067a0be108b0ca7f84b8084f2c637d8b6
-  data.tar.gz: 20dc341becc0aa928e7e03b9b5318e42bf9c92197162b165264c144d2f21bb0566cf3731f84247e92d36f3bdbff0bcf12a1036a1d567fb73e247af8556898d8b
+  metadata.gz: 820b951951ee2a7be4c5dedb005ab47dc25d2e91c48dbbefa0a7520b7a3c1a127cddbfa7284abf20d5a3fc18c840e546b3cdf6ea9b713267e88d7dfe830d7d4e
+  data.tar.gz: 46813972c1c50fa0c429a9811567b1f0b0c55788793642e4632911b8a24b91e4dc00f6c83571505bbcece29ea54b088110e07ac6ed8789d2cfbed87ceb577f1f

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-storagetransfer_v1
 
+### v0.19.0 (2021-12-11)
+
+* Regenerated from discovery document revision 20211210
+
 ### v0.18.0 (2021-12-02)
 
 * Regenerated from discovery document revision 20211130

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

@@ -190,12 +190,10 @@ module Google
       class AzureCredentials
         include Google::Apis::Core::Hashable
       
-        # Required. Azure shared access signature (SAS). *Note:*Copying data from Azure
-        # Data Lake Storage (ADLS) Gen 2 is in [Preview](/products/#product-launch-
-        # stages). During Preview, if you are copying data from ADLS Gen 2, you must use
-        # an account SAS. For more information about SAS, see [Grant limited access to
-        # Azure Storage resources using shared access signatures (SAS)](https://docs.
-        # microsoft.com/en-us/azure/storage/common/storage-sas-overview).
+        # Required. Azure shared access signature (SAS). For more information about SAS,
+        # see [Grant limited access to Azure Storage resources using shared access
+        # signatures (SAS)](https://docs.microsoft.com/en-us/azure/storage/common/
+        # storage-sas-overview).
         # Corresponds to the JSON property `sasToken`
         # @return [String]
         attr_accessor :sas_token
@@ -532,26 +530,33 @@ module Google
         end
       end
       
-      # Logging configuration.
+      # Specifies the logging behavior for transfer operations. For cloud-to-cloud
+      # transfers, logs are sent to Cloud Logging. See [Read transfer logs](https://
+      # cloud.google.com/storage-transfer/docs/read-transfer-logs) for details. For
+      # transfers to or from a POSIX file system, logs are stored in the Cloud Storage
+      # bucket that is the source or sink of the transfer. See [Managing Transfer for
+      # on-premises jobs] (https://cloud.google.com/storage-transfer/docs/managing-on-
+      # prem-jobs#viewing-logs) for details.
       class LoggingConfig
         include Google::Apis::Core::Hashable
       
-        # Enables the Cloud Storage transfer logs for this transfer. This is only
-        # supported for transfer jobs with PosixFilesystem sources. The default is that
-        # logs are not generated for this transfer.
+        # For transfers with a PosixFilesystem source, this option enables the Cloud
+        # Storage transfer logs for this transfer.
         # Corresponds to the JSON property `enableOnpremGcsTransferLogs`
         # @return [Boolean]
         attr_accessor :enable_onprem_gcs_transfer_logs
         alias_method :enable_onprem_gcs_transfer_logs?, :enable_onprem_gcs_transfer_logs
       
-        # States in which `log_actions` are logged. If empty, no logs are generated.
-        # This is not yet supported for transfers with PosixFilesystem data sources.
+        # States in which `log_actions` are logged. If empty, no logs are generated. Not
+        # supported for transfers with PosixFilesystem data sources; use
+        # enable_onprem_gcs_transfer_logs instead.
         # Corresponds to the JSON property `logActionStates`
         # @return [Array<String>]
         attr_accessor :log_action_states
       
-        # Actions to be logged. If empty, no logs are generated. This is not yet
-        # supported for transfers with PosixFilesystem data sources.
+        # Specifies the actions to be logged. If empty, no logs are generated. Not
+        # supported for transfers with PosixFilesystem data sources; use
+        # enable_onprem_gcs_transfer_logs instead.
         # Corresponds to the JSON property `logActions`
         # @return [Array<String>]
         attr_accessor :log_actions
@@ -568,6 +573,51 @@ module Google
         end
       end
       
+      # Specifies the metadata options for running a transfer.
+      class MetadataOptions
+        include Google::Apis::Core::Hashable
+      
+        # Specifies how each file's GID attribute should be handled by the transfer. If
+        # unspecified, the default behavior is the same as GID_SKIP when the source is a
+        # POSIX file system.
+        # Corresponds to the JSON property `gid`
+        # @return [String]
+        attr_accessor :gid
+      
+        # Specifies how each file's mode attribute should be handled by the transfer. If
+        # unspecified, the default behavior is the same as MODE_SKIP when the source is
+        # a POSIX file system.
+        # Corresponds to the JSON property `mode`
+        # @return [String]
+        attr_accessor :mode
+      
+        # Specifies how symlinks should be handled by the transfer. If unspecified, the
+        # default behavior is the same as SYMLINK_SKIP when the source is a POSIX file
+        # system.
+        # Corresponds to the JSON property `symlink`
+        # @return [String]
+        attr_accessor :symlink
+      
+        # Specifies how each file's UID attribute should be handled by the transfer. If
+        # unspecified, the default behavior is the same as UID_SKIP when the source is a
+        # POSIX file system.
+        # Corresponds to the JSON property `uid`
+        # @return [String]
+        attr_accessor :uid
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @gid = args[:gid] if args.key?(:gid)
+          @mode = args[:mode] if args.key?(:mode)
+          @symlink = args[:symlink] if args.key?(:symlink)
+          @uid = args[:uid] if args.key?(:uid)
+        end
+      end
+      
       # Specification to configure notifications published to Pub/Sub. Notifications
       # are published to the customer-provided topic using the following `
       # PubsubMessage.attributes`: * `"eventType"`: one of the EventType values * `"
@@ -680,18 +730,24 @@ module Google
         # @return [String]
         attr_accessor :last_modified_since
       
-        # If specified, only objects with a "last modification time" on or after `NOW` -
-        # `max_time_elapsed_since_last_modification` and objects that don't have a "last
-        # modification time" are transferred. For each TransferOperation started by this
-        # TransferJob, `NOW` refers to the start_time of the `TransferOperation`.
+        # Ensures that objects are not transferred if a specific maximum time has
+        # elapsed since the "last modification time". When a TransferOperation begins,
+        # objects with a "last modification time" are transferred only if the elapsed
+        # time between the start_time of the `TransferOperation`and the "last
+        # modification time" of the object is less than the value of
+        # max_time_elapsed_since_last_modification`. Objects that do not have a "last
+        # modification time" are also transferred.
         # Corresponds to the JSON property `maxTimeElapsedSinceLastModification`
         # @return [String]
         attr_accessor :max_time_elapsed_since_last_modification
       
-        # If specified, only objects with a "last modification time" before `NOW` - `
-        # min_time_elapsed_since_last_modification` and objects that don't have a "last
-        # modification time" are transferred. For each TransferOperation started by this
-        # TransferJob, `NOW` refers to the start_time of the `TransferOperation`.
+        # Ensures that objects are not transferred until a specific minimum time has
+        # elapsed after the "last modification time". When a TransferOperation begins,
+        # objects with a "last modification time" are transferred only if the elapsed
+        # time between the start_time of the `TransferOperation` and the "last
+        # modification time" of the object is equal to or greater than the value of
+        # min_time_elapsed_since_last_modification`. Objects that do not have a "last
+        # modification time" are also transferred.
         # Corresponds to the JSON property `minTimeElapsedSinceLastModification`
         # @return [String]
         attr_accessor :min_time_elapsed_since_last_modification
@@ -1161,7 +1217,13 @@ module Google
         # @return [String]
         attr_accessor :latest_operation_name
       
-        # Logging configuration.
+        # Specifies the logging behavior for transfer operations. For cloud-to-cloud
+        # transfers, logs are sent to Cloud Logging. See [Read transfer logs](https://
+        # cloud.google.com/storage-transfer/docs/read-transfer-logs) for details. For
+        # transfers to or from a POSIX file system, logs are stored in the Cloud Storage
+        # bucket that is the source or sink of the transfer. See [Managing Transfer for
+        # on-premises jobs] (https://cloud.google.com/storage-transfer/docs/managing-on-
+        # prem-jobs#viewing-logs) for details.
         # Corresponds to the JSON property `loggingConfig`
         # @return [Google::Apis::StoragetransferV1::LoggingConfig]
         attr_accessor :logging_config
@@ -1362,6 +1424,11 @@ module Google
         attr_accessor :delete_objects_unique_in_sink
         alias_method :delete_objects_unique_in_sink?, :delete_objects_unique_in_sink
       
+        # Specifies the metadata options for running a transfer.
+        # Corresponds to the JSON property `metadataOptions`
+        # @return [Google::Apis::StoragetransferV1::MetadataOptions]
+        attr_accessor :metadata_options
+      
         # When to overwrite objects that already exist in the sink. The default is that
         # only objects that are different from the source are ovewritten. If true, all
         # objects in the sink whose name matches an object in the source are overwritten
@@ -1379,6 +1446,7 @@ module Google
         def update!(**args)
           @delete_objects_from_source_after_transfer = args[:delete_objects_from_source_after_transfer] if args.key?(:delete_objects_from_source_after_transfer)
           @delete_objects_unique_in_sink = args[:delete_objects_unique_in_sink] if args.key?(:delete_objects_unique_in_sink)
+          @metadata_options = args[:metadata_options] if args.key?(:metadata_options)
           @overwrite_objects_already_existing_in_sink = args[:overwrite_objects_already_existing_in_sink] if args.key?(:overwrite_objects_already_existing_in_sink)
         end
       end
@@ -1420,6 +1488,14 @@ module Google
         # @return [Google::Apis::StoragetransferV1::GcsData]
         attr_accessor :gcs_data_source
       
+        # In a GcsData resource, an object's name is the Cloud Storage object's name and
+        # its "last modification time" refers to the object's `updated` property of
+        # Cloud Storage objects, which changes when the content or the metadata of the
+        # object is updated.
+        # Corresponds to the JSON property `gcsIntermediateDataLocation`
+        # @return [Google::Apis::StoragetransferV1::GcsData]
+        attr_accessor :gcs_intermediate_data_location
+      
         # An HttpData resource specifies a list of objects on the web to be transferred
         # over HTTP. The information of the objects to be transferred is contained in a
         # file referenced by a URL. The first line in the file must be `"TsvHttpData-1.0"
@@ -1498,6 +1574,7 @@ module Google
           @azure_blob_storage_data_source = args[:azure_blob_storage_data_source] if args.key?(:azure_blob_storage_data_source)
           @gcs_data_sink = args[:gcs_data_sink] if args.key?(:gcs_data_sink)
           @gcs_data_source = args[:gcs_data_source] if args.key?(:gcs_data_source)
+          @gcs_intermediate_data_location = args[:gcs_intermediate_data_location] if args.key?(:gcs_intermediate_data_location)
           @http_data_source = args[:http_data_source] if args.key?(:http_data_source)
           @object_conditions = args[:object_conditions] if args.key?(:object_conditions)
           @posix_data_sink = args[:posix_data_sink] if args.key?(:posix_data_sink)

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module StoragetransferV1
       # Version of the google-apis-storagetransfer_v1 gem
-      GEM_VERSION = "0.18.0"
+      GEM_VERSION = "0.19.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20211130"
+      REVISION = "20211210"
     end
   end
 end

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

@@ -130,6 +130,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class MetadataOptions
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class NotificationConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -385,6 +391,16 @@ module Google
         end
       end
       
+      class MetadataOptions
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :gid, as: 'gid'
+          property :mode, as: 'mode'
+          property :symlink, as: 'symlink'
+          property :uid, as: 'uid'
+        end
+      end
+      
       class NotificationConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -559,6 +575,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :delete_objects_from_source_after_transfer, as: 'deleteObjectsFromSourceAfterTransfer'
           property :delete_objects_unique_in_sink, as: 'deleteObjectsUniqueInSink'
+          property :metadata_options, as: 'metadataOptions', class: Google::Apis::StoragetransferV1::MetadataOptions, decorator: Google::Apis::StoragetransferV1::MetadataOptions::Representation
+      
           property :overwrite_objects_already_existing_in_sink, as: 'overwriteObjectsAlreadyExistingInSink'
         end
       end
@@ -574,6 +592,8 @@ module Google
       
           property :gcs_data_source, as: 'gcsDataSource', class: Google::Apis::StoragetransferV1::GcsData, decorator: Google::Apis::StoragetransferV1::GcsData::Representation
       
+          property :gcs_intermediate_data_location, as: 'gcsIntermediateDataLocation', class: Google::Apis::StoragetransferV1::GcsData, decorator: Google::Apis::StoragetransferV1::GcsData::Representation
+      
           property :http_data_source, as: 'httpDataSource', class: Google::Apis::StoragetransferV1::HttpData, decorator: Google::Apis::StoragetransferV1::HttpData::Representation
       
           property :object_conditions, as: 'objectConditions', class: Google::Apis::StoragetransferV1::ObjectConditions, decorator: Google::Apis::StoragetransferV1::ObjectConditions::Representation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-storagetransfer_v1
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-06 00:00:00.000000000 Z
+date: 2021-12-13 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-storagetransfer_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-storagetransfer_v1/v0.18.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-storagetransfer_v1/v0.19.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storagetransfer_v1
 post_install_message: 
 rdoc_options: []