google-apis-storagetransfer_v1 0.15.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aaf5f19eaeed582465b6c5731652816d1aa449310dd54aaf94b3e046eb7cb585
-  data.tar.gz: 706993d4d3f82b2ca63d516825538ceb8dd8cf7fa58935c86e3029cc67eade70
+  metadata.gz: 62a3e076f2a4f7e850ab3c1540cc4d37f1c431aab1e16cb49b1822256b9a770e
+  data.tar.gz: 24ea9d15dae7a9da467922ef3d63e58aff37f7933c0459425ef8c838f4aa738a
 SHA512:
-  metadata.gz: 9955efc018150ff22b5bd04be0f9a3b2d2e445cf4fd7c2fc9ccde7081a6da03bcbb5e5c14907c5daf7be791c1196d6ba9beb1ce8bae2aa34784f12739e52c7a6
-  data.tar.gz: cb6efab3cdd02c96b51e6f4d291d0287a52ad2f074ad7647f1e7a79871c59fdb4f638439522509d58cdf3f79eb03b2d047b9fe048da8e153a9cbe4e28029d4e8
+  metadata.gz: 820b951951ee2a7be4c5dedb005ab47dc25d2e91c48dbbefa0a7520b7a3c1a127cddbfa7284abf20d5a3fc18c840e546b3cdf6ea9b713267e88d7dfe830d7d4e
+  data.tar.gz: 46813972c1c50fa0c429a9811567b1f0b0c55788793642e4632911b8a24b91e4dc00f6c83571505bbcece29ea54b088110e07ac6ed8789d2cfbed87ceb577f1f

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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
+
+### v0.17.0 (2021-11-06)
+
+* Regenerated from discovery document revision 20211105
+
+### v0.16.0 (2021-10-20)
+
+* Regenerated from discovery document revision 20211018
+
 ### v0.15.0 (2021-09-21)
 
 * Regenerated from discovery document revision 20210918

data/OVERVIEW.md

@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Storagetransfer service in particular.)
 

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

@@ -22,6 +22,44 @@ module Google
   module Apis
     module StoragetransferV1
       
+      # Represents an On-Premises Agent pool.
+      class AgentPool
+        include Google::Apis::Core::Hashable
+      
+        # Specifies a bandwidth limit for an agent pool.
+        # Corresponds to the JSON property `bandwidthLimit`
+        # @return [Google::Apis::StoragetransferV1::BandwidthLimit]
+        attr_accessor :bandwidth_limit
+      
+        # Specifies the client-specified AgentPool description.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Required. Specifies a unique string that identifies the agent pool. Format: `
+        # projects/`project_id`/agentPools/`agent_pool_id``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. Specifies the state of the AgentPool.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bandwidth_limit = args[:bandwidth_limit] if args.key?(:bandwidth_limit)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @name = args[:name] if args.key?(:name)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
       # AWS access key (see [AWS Security Credentials](https://docs.aws.amazon.com/
       # general/latest/gr/aws-security-credentials.html)). For information on our data
       # retention policy for user credentials, see [User credentials](/storage-
@@ -152,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
@@ -172,6 +208,26 @@ module Google
         end
       end
       
+      # Specifies a bandwidth limit for an agent pool.
+      class BandwidthLimit
+        include Google::Apis::Core::Hashable
+      
+        # Bandwidth rate in megabytes per second, distributed across all the agents in
+        # the pool.
+        # Corresponds to the JSON property `limitMbps`
+        # @return [Fixnum]
+        attr_accessor :limit_mbps
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @limit_mbps = args[:limit_mbps] if args.key?(:limit_mbps)
+        end
+      end
+      
       # The request message for Operations.CancelOperation.
       class CancelOperationRequest
         include Google::Apis::Core::Hashable
@@ -399,6 +455,31 @@ module Google
         end
       end
       
+      # Response from ListAgentPools.
+      class ListAgentPoolsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of agent pools.
+        # Corresponds to the JSON property `agentPools`
+        # @return [Array<Google::Apis::StoragetransferV1::AgentPool>]
+        attr_accessor :agent_pools
+      
+        # The list next page token.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @agent_pools = args[:agent_pools] if args.key?(:agent_pools)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response message for Operations.ListOperations.
       class ListOperationsResponse
         include Google::Apis::Core::Hashable
@@ -449,18 +530,37 @@ 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. 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
+      
+        # 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
+      
         def initialize(**args)
            update!(**args)
         end
@@ -468,6 +568,53 @@ module Google
         # Update properties of this object
         def update!(**args)
           @enable_onprem_gcs_transfer_logs = args[:enable_onprem_gcs_transfer_logs] if args.key?(:enable_onprem_gcs_transfer_logs)
+          @log_action_states = args[:log_action_states] if args.key?(:log_action_states)
+          @log_actions = args[:log_actions] if args.key?(:log_actions)
+        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
       
@@ -518,8 +665,8 @@ module Google
       # refers to the time of the last change to the object's content or metadata —
       # specifically, this is the `updated` property of Cloud Storage objects, the `
       # LastModified` field of S3 objects, and the `Last-Modified` header of Azure
-      # blobs. Transfers that use PosixFilesystem and have a Cloud Storage source don'
-      # t support `ObjectConditions`.
+      # blobs. Transfers with a PosixFilesystem source or destination don't support `
+      # ObjectConditions`.
       class ObjectConditions
         include Google::Apis::Core::Hashable
       
@@ -583,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
@@ -722,8 +875,7 @@ module Google
       class RunTransferJobRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The ID of the Google Cloud Platform Console project that owns the
-        # transfer job.
+        # Required. The ID of the Google Cloud project that owns the transfer job.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -949,6 +1101,16 @@ module Google
         # @return [Fixnum]
         attr_accessor :directories_successfully_listed_from_source
       
+        # Number of successfully cleaned up intermediate objects.
+        # Corresponds to the JSON property `intermediateObjectsCleanedUp`
+        # @return [Fixnum]
+        attr_accessor :intermediate_objects_cleaned_up
+      
+        # Number of intermediate objects failed cleaned up.
+        # Corresponds to the JSON property `intermediateObjectsFailedCleanedUp`
+        # @return [Fixnum]
+        attr_accessor :intermediate_objects_failed_cleaned_up
+      
         # Objects that are copied to the data sink.
         # Corresponds to the JSON property `objectsCopiedToSink`
         # @return [Fixnum]
@@ -1010,6 +1172,8 @@ module Google
           @directories_failed_to_list_from_source = args[:directories_failed_to_list_from_source] if args.key?(:directories_failed_to_list_from_source)
           @directories_found_from_source = args[:directories_found_from_source] if args.key?(:directories_found_from_source)
           @directories_successfully_listed_from_source = args[:directories_successfully_listed_from_source] if args.key?(:directories_successfully_listed_from_source)
+          @intermediate_objects_cleaned_up = args[:intermediate_objects_cleaned_up] if args.key?(:intermediate_objects_cleaned_up)
+          @intermediate_objects_failed_cleaned_up = args[:intermediate_objects_failed_cleaned_up] if args.key?(:intermediate_objects_failed_cleaned_up)
           @objects_copied_to_sink = args[:objects_copied_to_sink] if args.key?(:objects_copied_to_sink)
           @objects_deleted_from_sink = args[:objects_deleted_from_sink] if args.key?(:objects_deleted_from_sink)
           @objects_deleted_from_source = args[:objects_deleted_from_source] if args.key?(:objects_deleted_from_source)
@@ -1053,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
@@ -1088,7 +1258,7 @@ module Google
         # @return [Google::Apis::StoragetransferV1::NotificationConfig]
         attr_accessor :notification_config
       
-        # The ID of the Google Cloud Platform Project that owns the job.
+        # The ID of the Google Cloud project that owns the job.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -1133,6 +1303,27 @@ module Google
         end
       end
       
+      # Specifies where the manifest is located.
+      class TransferManifest
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the path to the manifest in Cloud Storage. The Google-managed
+        # service account for the transfer must have `storage.objects.get` permission
+        # for this object. An example path is `gs://bucket_name/path/manifest.csv`.
+        # Corresponds to the JSON property `location`
+        # @return [String]
+        attr_accessor :location
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @location = args[:location] if args.key?(:location)
+        end
+      end
+      
       # A description of the execution of a transfer.
       class TransferOperation
         include Google::Apis::Core::Hashable
@@ -1170,7 +1361,7 @@ module Google
         # @return [Google::Apis::StoragetransferV1::NotificationConfig]
         attr_accessor :notification_config
       
-        # The ID of the Google Cloud Platform Project that owns the operation.
+        # The ID of the Google Cloud project that owns the operation.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -1233,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
@@ -1250,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
@@ -1291,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"
@@ -1321,17 +1526,39 @@ module Google
         # refers to the time of the last change to the object's content or metadata —
         # specifically, this is the `updated` property of Cloud Storage objects, the `
         # LastModified` field of S3 objects, and the `Last-Modified` header of Azure
-        # blobs. Transfers that use PosixFilesystem and have a Cloud Storage source don'
-        # t support `ObjectConditions`.
+        # blobs. Transfers with a PosixFilesystem source or destination don't support `
+        # ObjectConditions`.
         # Corresponds to the JSON property `objectConditions`
         # @return [Google::Apis::StoragetransferV1::ObjectConditions]
         attr_accessor :object_conditions
       
+        # A POSIX filesystem resource.
+        # Corresponds to the JSON property `posixDataSink`
+        # @return [Google::Apis::StoragetransferV1::PosixFilesystem]
+        attr_accessor :posix_data_sink
+      
         # A POSIX filesystem resource.
         # Corresponds to the JSON property `posixDataSource`
         # @return [Google::Apis::StoragetransferV1::PosixFilesystem]
         attr_accessor :posix_data_source
       
+        # Specifies the agent pool name associated with the posix data sink. When
+        # unspecified, the default name is used.
+        # Corresponds to the JSON property `sinkAgentPoolName`
+        # @return [String]
+        attr_accessor :sink_agent_pool_name
+      
+        # Specifies the agent pool name associated with the posix data source. When
+        # unspecified, the default name is used.
+        # Corresponds to the JSON property `sourceAgentPoolName`
+        # @return [String]
+        attr_accessor :source_agent_pool_name
+      
+        # Specifies where the manifest is located.
+        # Corresponds to the JSON property `transferManifest`
+        # @return [Google::Apis::StoragetransferV1::TransferManifest]
+        attr_accessor :transfer_manifest
+      
         # TransferOptions define the actions to be performed on objects in a transfer.
         # Corresponds to the JSON property `transferOptions`
         # @return [Google::Apis::StoragetransferV1::TransferOptions]
@@ -1347,9 +1574,14 @@ 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)
           @posix_data_source = args[:posix_data_source] if args.key?(:posix_data_source)
+          @sink_agent_pool_name = args[:sink_agent_pool_name] if args.key?(:sink_agent_pool_name)
+          @source_agent_pool_name = args[:source_agent_pool_name] if args.key?(:source_agent_pool_name)
+          @transfer_manifest = args[:transfer_manifest] if args.key?(:transfer_manifest)
           @transfer_options = args[:transfer_options] if args.key?(:transfer_options)
         end
       end
@@ -1358,8 +1590,7 @@ module Google
       class UpdateTransferJobRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The ID of the Google Cloud Platform Console project that owns the
-        # job.
+        # Required. The ID of the Google Cloud project that owns the job.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id

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.15.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 = "20210918"
+      REVISION = "20211210"
     end
   end
 end

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

@@ -22,6 +22,12 @@ module Google
   module Apis
     module StoragetransferV1
       
+      class AgentPool
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AwsAccessKey
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -46,6 +52,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BandwidthLimit
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CancelOperationRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -94,6 +106,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListAgentPoolsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListOperationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -112,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
       
@@ -184,6 +208,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TransferManifest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TransferOperation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -208,6 +238,17 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AgentPool
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :bandwidth_limit, as: 'bandwidthLimit', class: Google::Apis::StoragetransferV1::BandwidthLimit, decorator: Google::Apis::StoragetransferV1::BandwidthLimit::Representation
+      
+          property :display_name, as: 'displayName'
+          property :name, as: 'name'
+          property :state, as: 'state'
+        end
+      end
+      
       class AwsAccessKey
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -245,6 +286,13 @@ module Google
         end
       end
       
+      class BandwidthLimit
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :limit_mbps, :numeric_string => true, as: 'limitMbps'
+        end
+      end
+      
       class CancelOperationRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -307,6 +355,15 @@ module Google
         end
       end
       
+      class ListAgentPoolsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :agent_pools, as: 'agentPools', class: Google::Apis::StoragetransferV1::AgentPool, decorator: Google::Apis::StoragetransferV1::AgentPool::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListOperationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -329,6 +386,18 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :enable_onprem_gcs_transfer_logs, as: 'enableOnpremGcsTransferLogs'
+          collection :log_action_states, as: 'logActionStates'
+          collection :log_actions, as: 'logActions'
+        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
       
@@ -439,6 +508,8 @@ module Google
           property :directories_failed_to_list_from_source, :numeric_string => true, as: 'directoriesFailedToListFromSource'
           property :directories_found_from_source, :numeric_string => true, as: 'directoriesFoundFromSource'
           property :directories_successfully_listed_from_source, :numeric_string => true, as: 'directoriesSuccessfullyListedFromSource'
+          property :intermediate_objects_cleaned_up, :numeric_string => true, as: 'intermediateObjectsCleanedUp'
+          property :intermediate_objects_failed_cleaned_up, :numeric_string => true, as: 'intermediateObjectsFailedCleanedUp'
           property :objects_copied_to_sink, :numeric_string => true, as: 'objectsCopiedToSink'
           property :objects_deleted_from_sink, :numeric_string => true, as: 'objectsDeletedFromSink'
           property :objects_deleted_from_source, :numeric_string => true, as: 'objectsDeletedFromSource'
@@ -472,6 +543,13 @@ module Google
         end
       end
       
+      class TransferManifest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :location, as: 'location'
+        end
+      end
+      
       class TransferOperation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -497,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
@@ -512,12 +592,20 @@ 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
       
+          property :posix_data_sink, as: 'posixDataSink', class: Google::Apis::StoragetransferV1::PosixFilesystem, decorator: Google::Apis::StoragetransferV1::PosixFilesystem::Representation
+      
           property :posix_data_source, as: 'posixDataSource', class: Google::Apis::StoragetransferV1::PosixFilesystem, decorator: Google::Apis::StoragetransferV1::PosixFilesystem::Representation
       
+          property :sink_agent_pool_name, as: 'sinkAgentPoolName'
+          property :source_agent_pool_name, as: 'sourceAgentPoolName'
+          property :transfer_manifest, as: 'transferManifest', class: Google::Apis::StoragetransferV1::TransferManifest, decorator: Google::Apis::StoragetransferV1::TransferManifest::Representation
+      
           property :transfer_options, as: 'transferOptions', class: Google::Apis::StoragetransferV1::TransferOptions, decorator: Google::Apis::StoragetransferV1::TransferOptions::Representation
       
         end

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

@@ -52,14 +52,14 @@ module Google
         
         # Returns the Google service account that is used by Storage Transfer Service to
         # access buckets in the project where transfers run or in other projects. Each
-        # Google service account is associated with one Google Cloud Platform Console
-        # project. Users should add this service account to the Google Cloud Storage
-        # bucket ACLs to grant access to Storage Transfer Service. This service account
-        # is created and owned by Storage Transfer Service and can only be used by
-        # Storage Transfer Service.
+        # Google service account is associated with one Google Cloud project. Users
+        # should add this service account to the Google Cloud Storage bucket ACLs to
+        # grant access to Storage Transfer Service. This service account is created and
+        # owned by Storage Transfer Service and can only be used by Storage Transfer
+        # Service.
         # @param [String] project_id
-        #   Required. The ID of the Google Cloud Platform Console project that the Google
-        #   service account is associated with.
+        #   Required. The ID of the Google Cloud project that the Google service account
+        #   is associated with.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -87,6 +87,191 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates an agent pool resource.
+        # @param [String] project_id
+        #   Required. The ID of the Google Cloud project that owns the agent pool.
+        # @param [Google::Apis::StoragetransferV1::AgentPool] agent_pool_object
+        # @param [String] agent_pool_id
+        #   Required. The ID of the agent pool to create. The `agent_pool_id` must meet
+        #   the following requirements: * Length of 128 characters or less. * Not start
+        #   with the string `goog`. * Start with a lowercase ASCII character, followed by:
+        #   * Zero or more: lowercase Latin alphabet characters, numerals, hyphens (`-`),
+        #   periods (`.`), underscores (`_`), or tildes (`~`). * One or more numerals or
+        #   lowercase ASCII characters. As expressed by the regular expression: `^(?!goog)[
+        #   a-z]([a-z0-9-._~]*[a-z0-9])?$`.
+        # @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::StoragetransferV1::AgentPool] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StoragetransferV1::AgentPool]
+        #
+        # @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 create_project_agent_pool(project_id, agent_pool_object = nil, agent_pool_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/projects/{+projectId}/agentPools', options)
+          command.request_representation = Google::Apis::StoragetransferV1::AgentPool::Representation
+          command.request_object = agent_pool_object
+          command.response_representation = Google::Apis::StoragetransferV1::AgentPool::Representation
+          command.response_class = Google::Apis::StoragetransferV1::AgentPool
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['agentPoolId'] = agent_pool_id unless agent_pool_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes an agent pool.
+        # @param [String] name
+        #   Required. The name of the agent pool to delete.
+        # @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::StoragetransferV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StoragetransferV1::Empty]
+        #
+        # @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 delete_project_agent_pool(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
+          command.response_class = Google::Apis::StoragetransferV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets an agent pool.
+        # @param [String] name
+        #   Required. The name of the agent pool to get.
+        # @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::StoragetransferV1::AgentPool] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StoragetransferV1::AgentPool]
+        #
+        # @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 get_project_agent_pool(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::StoragetransferV1::AgentPool::Representation
+          command.response_class = Google::Apis::StoragetransferV1::AgentPool
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists agent pools.
+        # @param [String] project_id
+        #   Required. The ID of the Google Cloud project that owns the job.
+        # @param [String] filter
+        #   An optional list of query parameters specified as JSON text in the form of: ``"
+        #   agentPoolNames":["agentpool1","agentpool2",...]`` Since `agentPoolNames`
+        #   support multiple values, its values must be specified with array notation.
+        #   When the filter is either empty or not provided, the list returns all agent
+        #   pools for the project.
+        # @param [Fixnum] page_size
+        #   The list page size. The max allowed value is `256`.
+        # @param [String] page_token
+        #   The list page token.
+        # @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::StoragetransferV1::ListAgentPoolsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StoragetransferV1::ListAgentPoolsResponse]
+        #
+        # @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 list_project_agent_pools(project_id, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/projects/{+projectId}/agentPools', options)
+          command.response_representation = Google::Apis::StoragetransferV1::ListAgentPoolsResponse::Representation
+          command.response_class = Google::Apis::StoragetransferV1::ListAgentPoolsResponse
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates an existing agent pool resource.
+        # @param [String] name
+        #   Required. Specifies a unique string that identifies the agent pool. Format: `
+        #   projects/`project_id`/agentPools/`agent_pool_id``
+        # @param [Google::Apis::StoragetransferV1::AgentPool] agent_pool_object
+        # @param [String] update_mask
+        #   The [field mask] (https://developers.google.com/protocol-buffers/docs/
+        #   reference/google.protobuf) of the fields in `agentPool` to update in this
+        #   request. The following `agentPool` fields can be updated: * display_name *
+        #   bandwidth_limit
+        # @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::StoragetransferV1::AgentPool] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StoragetransferV1::AgentPool]
+        #
+        # @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 patch_project_agent_pool(name, agent_pool_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::StoragetransferV1::AgentPool::Representation
+          command.request_object = agent_pool_object
+          command.response_representation = Google::Apis::StoragetransferV1::AgentPool::Representation
+          command.response_class = Google::Apis::StoragetransferV1::AgentPool
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a transfer job that runs periodically.
         # @param [Google::Apis::StoragetransferV1::TransferJob] transfer_job_object
         # @param [String] fields
@@ -121,8 +306,7 @@ module Google
         # @param [String] job_name
         #   Required. The job to get.
         # @param [String] project_id
-        #   Required. The ID of the Google Cloud Platform Console project that owns the
-        #   job.
+        #   Required. The ID of the Google Cloud project that owns the job.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-storagetransfer_v1
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-22 00:00:00.000000000 Z
+date: 2021-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-storagetransfer_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-storagetransfer_v1/v0.15.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-storagetransfer_v1
+  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.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: []
 require_paths: