google-cloud-storage_transfer-v1 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40ca77c02f4a6e403441548a57d2b36cf900798b38104168c38523a31b5c8c48
-  data.tar.gz: 979478a9632e396f100c6c3baae7dcee3f66cfc5d8bd0f798b868089d5a3cbcf
+  metadata.gz: d082cb15d9669c1bb4a18633141a5dd569dcab740075396ad9092ad689f6e4db
+  data.tar.gz: a445a078f7f51d8ff050876ff0f82a534d7bb65104b238b9bce5ca09f012d6df
 SHA512:
-  metadata.gz: 5cc2ee55f3a694c9adeb843b4faea81709760989df0b9c2898ea751fee1d1f99c4e2ba6b560c875497d5f1d7ddc40f91dd2230b2910d5b9d2604a27f1128f185
-  data.tar.gz: ff5dfdfeb9851fd8cf177f9162c1b5dbe5eef038ca8e8fc37957f5c6b6a0aac96fc4e45fbf8f00472101862da32bb5a73ecf620ad3f45970108e2a8044991b2f
+  metadata.gz: 7aa91d27442401c1a4129d8a94f08624c7f21a6a09f9402e098aebd106b28b059031b41cf677a0bbfc646defd154c7a7d9d4facd18aa24127b93c6446a225c76
+  data.tar.gz: 5d6340e368c2551d93faf0269bade410aff705a123e0586c5d43f16e3ae10ed9fd5eb2ca3bde0f1084f2cd224cef254da087db4127fb4b3436ae3dfe236b6062

data/AUTHENTICATION.md

@@ -112,7 +112,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/lib/google/cloud/storage_transfer/v1/storage_transfer_service/client.rb

@@ -66,7 +66,12 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
-                default_config.timeout = 30.0
+                default_config.timeout = 60.0
+                default_config.retry_policy = {
+                  initial_delay: 1.0, max_delay: 60.0, multiplier: 2, retry_codes: [14]
+                }
+
+                default_config.rpcs.create_transfer_job.timeout = 60.0
 
                 default_config
               end
@@ -371,7 +376,7 @@ module Google
             #     other fields are rejected with the error
             #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT}. Updating a job status
             #     to {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DELETED DELETED} requires
-            #     `storagetransfer.jobs.delete` permissions.
+            #     `storagetransfer.jobs.delete` permission.
             #   @param update_transfer_job_field_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     The field mask of the fields in `transferJob` that are to be updated in
             #     this request.  Fields in `transferJob` that can be updated are:
@@ -903,6 +908,95 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Deletes a transfer job. Deleting a transfer job sets its status to
+            # {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DELETED DELETED}.
+            #
+            # @overload delete_transfer_job(request, options = nil)
+            #   Pass arguments to `delete_transfer_job` via a request object, either of type
+            #   {::Google::Cloud::StorageTransfer::V1::DeleteTransferJobRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::StorageTransfer::V1::DeleteTransferJobRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload delete_transfer_job(job_name: nil, project_id: nil)
+            #   Pass arguments to `delete_transfer_job` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param job_name [::String]
+            #     Required. The job to delete.
+            #   @param project_id [::String]
+            #     Required. The ID of the Google Cloud project that owns the
+            #     job.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Protobuf::Empty]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Protobuf::Empty]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/storage_transfer/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::StorageTransfer::V1::StorageTransferService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::StorageTransfer::V1::DeleteTransferJobRequest.new
+            #
+            #   # Call the delete_transfer_job method.
+            #   result = client.delete_transfer_job request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
+            def delete_transfer_job request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::StorageTransfer::V1::DeleteTransferJobRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.delete_transfer_job.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::StorageTransfer::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.job_name
+                header_params["job_name"] = request.job_name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.delete_transfer_job.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.delete_transfer_job.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @storage_transfer_service_stub.call_rpc :delete_transfer_job, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Creates an agent pool resource.
             #
@@ -1559,6 +1653,11 @@ module Google
                 #
                 attr_reader :run_transfer_job
                 ##
+                # RPC-specific configuration for `delete_transfer_job`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :delete_transfer_job
+                ##
                 # RPC-specific configuration for `create_agent_pool`
                 # @return [::Gapic::Config::Method]
                 #
@@ -1602,6 +1701,8 @@ module Google
                   @resume_transfer_operation = ::Gapic::Config::Method.new resume_transfer_operation_config
                   run_transfer_job_config = parent_rpcs.run_transfer_job if parent_rpcs.respond_to? :run_transfer_job
                   @run_transfer_job = ::Gapic::Config::Method.new run_transfer_job_config
+                  delete_transfer_job_config = parent_rpcs.delete_transfer_job if parent_rpcs.respond_to? :delete_transfer_job
+                  @delete_transfer_job = ::Gapic::Config::Method.new delete_transfer_job_config
                   create_agent_pool_config = parent_rpcs.create_agent_pool if parent_rpcs.respond_to? :create_agent_pool
                   @create_agent_pool = ::Gapic::Config::Method.new create_agent_pool_config
                   update_agent_pool_config = parent_rpcs.update_agent_pool if parent_rpcs.respond_to? :update_agent_pool

data/lib/google/cloud/storage_transfer/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module StorageTransfer
       module V1
-        VERSION = "0.3.0"
+        VERSION = "0.4.0"
       end
     end
   end

data/lib/google/storagetransfer/v1/transfer_pb.rb

@@ -29,6 +29,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :job_name, :string, 1
       optional :project_id, :string, 2
     end
+    add_message "google.storagetransfer.v1.DeleteTransferJobRequest" do
+      optional :job_name, :string, 1
+      optional :project_id, :string, 2
+    end
     add_message "google.storagetransfer.v1.ListTransferJobsRequest" do
       optional :filter, :string, 1
       optional :page_size, :int32, 4
@@ -84,6 +88,7 @@ module Google
         CreateTransferJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.CreateTransferJobRequest").msgclass
         UpdateTransferJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.UpdateTransferJobRequest").msgclass
         GetTransferJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.GetTransferJobRequest").msgclass
+        DeleteTransferJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.DeleteTransferJobRequest").msgclass
         ListTransferJobsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.ListTransferJobsRequest").msgclass
         ListTransferJobsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.ListTransferJobsResponse").msgclass
         PauseTransferOperationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.PauseTransferOperationRequest").msgclass

data/lib/google/storagetransfer/v1/transfer_services_pb.rb

@@ -67,6 +67,9 @@ module Google
             # TransferJob has a maximum of one active TransferOperation. If this method
             # is called while a TransferOperation is active, an error will be returned.
             rpc :RunTransferJob, ::Google::Cloud::StorageTransfer::V1::RunTransferJobRequest, ::Google::Longrunning::Operation
+            # Deletes a transfer job. Deleting a transfer job sets its status to
+            # [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED].
+            rpc :DeleteTransferJob, ::Google::Cloud::StorageTransfer::V1::DeleteTransferJobRequest, ::Google::Protobuf::Empty
             # Creates an agent pool resource.
             rpc :CreateAgentPool, ::Google::Cloud::StorageTransfer::V1::CreateAgentPoolRequest, ::Google::Cloud::StorageTransfer::V1::AgentPool
             # Updates an existing agent pool resource.

data/lib/google/storagetransfer/v1/transfer_types_pb.rb

@@ -54,6 +54,41 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.storagetransfer.v1.PosixFilesystem" do
       optional :root_directory, :string, 1
     end
+    add_message "google.storagetransfer.v1.AwsS3CompatibleData" do
+      optional :bucket_name, :string, 1
+      optional :path, :string, 2
+      optional :endpoint, :string, 3
+      optional :region, :string, 5
+      oneof :data_provider do
+        optional :s3_metadata, :message, 4, "google.storagetransfer.v1.S3CompatibleMetadata"
+      end
+    end
+    add_message "google.storagetransfer.v1.S3CompatibleMetadata" do
+      optional :auth_method, :enum, 1, "google.storagetransfer.v1.S3CompatibleMetadata.AuthMethod"
+      optional :request_model, :enum, 2, "google.storagetransfer.v1.S3CompatibleMetadata.RequestModel"
+      optional :protocol, :enum, 3, "google.storagetransfer.v1.S3CompatibleMetadata.NetworkProtocol"
+      optional :list_api, :enum, 4, "google.storagetransfer.v1.S3CompatibleMetadata.ListApi"
+    end
+    add_enum "google.storagetransfer.v1.S3CompatibleMetadata.AuthMethod" do
+      value :AUTH_METHOD_UNSPECIFIED, 0
+      value :AUTH_METHOD_AWS_SIGNATURE_V4, 1
+      value :AUTH_METHOD_AWS_SIGNATURE_V2, 2
+    end
+    add_enum "google.storagetransfer.v1.S3CompatibleMetadata.RequestModel" do
+      value :REQUEST_MODEL_UNSPECIFIED, 0
+      value :REQUEST_MODEL_VIRTUAL_HOSTED_STYLE, 1
+      value :REQUEST_MODEL_PATH_STYLE, 2
+    end
+    add_enum "google.storagetransfer.v1.S3CompatibleMetadata.NetworkProtocol" do
+      value :NETWORK_PROTOCOL_UNSPECIFIED, 0
+      value :NETWORK_PROTOCOL_HTTPS, 1
+      value :NETWORK_PROTOCOL_HTTP, 2
+    end
+    add_enum "google.storagetransfer.v1.S3CompatibleMetadata.ListApi" do
+      value :LIST_API_UNSPECIFIED, 0
+      value :LIST_OBJECTS_V2, 1
+      value :LIST_OBJECTS, 2
+    end
     add_message "google.storagetransfer.v1.AgentPool" do
       optional :name, :string, 2
       optional :display_name, :string, 3
@@ -98,6 +133,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :http_data_source, :message, 3, "google.storagetransfer.v1.HttpData"
         optional :posix_data_source, :message, 14, "google.storagetransfer.v1.PosixFilesystem"
         optional :azure_blob_storage_data_source, :message, 8, "google.storagetransfer.v1.AzureBlobStorageData"
+        optional :aws_s3_compatible_data_source, :message, 19, "google.storagetransfer.v1.AwsS3CompatibleData"
       end
       oneof :intermediate_data_location do
         optional :gcs_intermediate_data_location, :message, 16, "google.storagetransfer.v1.GcsData"
@@ -294,6 +330,12 @@ module Google
         AzureBlobStorageData = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.AzureBlobStorageData").msgclass
         HttpData = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.HttpData").msgclass
         PosixFilesystem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.PosixFilesystem").msgclass
+        AwsS3CompatibleData = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.AwsS3CompatibleData").msgclass
+        S3CompatibleMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.S3CompatibleMetadata").msgclass
+        S3CompatibleMetadata::AuthMethod = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.S3CompatibleMetadata.AuthMethod").enummodule
+        S3CompatibleMetadata::RequestModel = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.S3CompatibleMetadata.RequestModel").enummodule
+        S3CompatibleMetadata::NetworkProtocol = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.S3CompatibleMetadata.NetworkProtocol").enummodule
+        S3CompatibleMetadata::ListApi = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.S3CompatibleMetadata.ListApi").enummodule
         AgentPool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.AgentPool").msgclass
         AgentPool::BandwidthLimit = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.AgentPool.BandwidthLimit").msgclass
         AgentPool::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.storagetransfer.v1.AgentPool.State").enummodule

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/storagetransfer/v1/transfer.rb

@@ -59,7 +59,7 @@ module Google
         #     other fields are rejected with the error
         #     {::Google::Rpc::Code::INVALID_ARGUMENT INVALID_ARGUMENT}. Updating a job status
         #     to {::Google::Cloud::StorageTransfer::V1::TransferJob::Status::DELETED DELETED} requires
-        #     `storagetransfer.jobs.delete` permissions.
+        #     `storagetransfer.jobs.delete` permission.
         # @!attribute [rw] update_transfer_job_field_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     The field mask of the fields in `transferJob` that are to be updated in
@@ -90,6 +90,19 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request passed to DeleteTransferJob.
+        # @!attribute [rw] job_name
+        #   @return [::String]
+        #     Required. The job to delete.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Required. The ID of the Google Cloud project that owns the
+        #     job.
+        class DeleteTransferJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # `projectId`, `jobNames`, and `jobStatuses` are query parameters that can
         # be specified when listing transfer jobs.
         # @!attribute [rw] filter

data/proto_docs/google/storagetransfer/v1/transfer_types.rb

@@ -332,6 +332,109 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # An AwsS3CompatibleData resource.
+        # @!attribute [rw] bucket_name
+        #   @return [::String]
+        #     Required. Specifies the name of the bucket.
+        # @!attribute [rw] path
+        #   @return [::String]
+        #     Specifies the root path to transfer objects.
+        #
+        #     Must be an empty string or full path name that ends with a '/'. This
+        #     field is treated as an object prefix. As such, it should generally not
+        #     begin with a '/'.
+        # @!attribute [rw] endpoint
+        #   @return [::String]
+        #     Required. Specifies the endpoint of the storage service.
+        # @!attribute [rw] region
+        #   @return [::String]
+        #     Specifies the region to sign requests with. This can be left blank if
+        #     requests should be signed with an empty region.
+        # @!attribute [rw] s3_metadata
+        #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata]
+        #     A S3 compatible metadata.
+        class AwsS3CompatibleData
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # S3CompatibleMetadata contains the metadata fields that apply to the basic
+        # types of S3-compatible data providers.
+        # @!attribute [rw] auth_method
+        #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::AuthMethod]
+        #     Specifies the authentication and authorization method used by the storage
+        #     service. When not specified, Transfer Service will attempt to determine
+        #     right auth method to use.
+        # @!attribute [rw] request_model
+        #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::RequestModel]
+        #     Specifies the API request model used to call the storage service. When not
+        #     specified, the default value of RequestModel
+        #     REQUEST_MODEL_VIRTUAL_HOSTED_STYLE is used.
+        # @!attribute [rw] protocol
+        #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::NetworkProtocol]
+        #     Specifies the network protocol of the agent. When not specified, the
+        #     default value of NetworkProtocol NETWORK_PROTOCOL_HTTPS is used.
+        # @!attribute [rw] list_api
+        #   @return [::Google::Cloud::StorageTransfer::V1::S3CompatibleMetadata::ListApi]
+        #     The Listing API to use for discovering objects. When not specified,
+        #     Transfer Service will attempt to determine the right API to use.
+        class S3CompatibleMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The authentication and authorization method used by the storage service.
+          module AuthMethod
+            # AuthMethod is not specified.
+            AUTH_METHOD_UNSPECIFIED = 0
+
+            # Auth requests with AWS SigV4.
+            AUTH_METHOD_AWS_SIGNATURE_V4 = 1
+
+            # Auth requests with AWS SigV2.
+            AUTH_METHOD_AWS_SIGNATURE_V2 = 2
+          end
+
+          # The request model of the API.
+          module RequestModel
+            # RequestModel is not specified.
+            REQUEST_MODEL_UNSPECIFIED = 0
+
+            # Perform requests using Virtual Hosted Style.
+            # Example: https://bucket-name.s3.region.amazonaws.com/key-name
+            REQUEST_MODEL_VIRTUAL_HOSTED_STYLE = 1
+
+            # Perform requests using Path Style.
+            # Example: https://s3.region.amazonaws.com/bucket-name/key-name
+            REQUEST_MODEL_PATH_STYLE = 2
+          end
+
+          # The agent network protocol to access the storage service.
+          module NetworkProtocol
+            # NetworkProtocol is not specified.
+            NETWORK_PROTOCOL_UNSPECIFIED = 0
+
+            # Perform requests using HTTPS.
+            NETWORK_PROTOCOL_HTTPS = 1
+
+            # Not recommended: This sends data in clear-text. This is only
+            # appropriate within a closed network or for publicly available data.
+            # Perform requests using HTTP.
+            NETWORK_PROTOCOL_HTTP = 2
+          end
+
+          # The Listing API to use for discovering objects.
+          module ListApi
+            # ListApi is not specified.
+            LIST_API_UNSPECIFIED = 0
+
+            # Perform listing using ListObjectsV2 API.
+            LIST_OBJECTS_V2 = 1
+
+            # Legacy ListObjects API.
+            LIST_OBJECTS = 2
+          end
+        end
+
         # Represents an On-Premises Agent pool.
         # @!attribute [rw] name
         #   @return [::String]
@@ -403,13 +506,12 @@ module Google
         #     exclusive.
         # @!attribute [rw] overwrite_when
         #   @return [::Google::Cloud::StorageTransfer::V1::TransferOptions::OverwriteWhen]
-        #     When to overwrite objects that already exist in the sink. If not set
+        #     When to overwrite objects that already exist in the sink. If not set,
         #     overwrite behavior is determined by
         #     {::Google::Cloud::StorageTransfer::V1::TransferOptions#overwrite_objects_already_existing_in_sink overwrite_objects_already_existing_in_sink}.
         # @!attribute [rw] metadata_options
         #   @return [::Google::Cloud::StorageTransfer::V1::MetadataOptions]
-        #     Represents the selected metadata options for a transfer job. This feature
-        #     is in Preview.
+        #     Represents the selected metadata options for a transfer job.
         class TransferOptions
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -417,17 +519,19 @@ module Google
           # Specifies when to overwrite an object in the sink when an object with
           # matching name is found in the source.
           module OverwriteWhen
-            # Indicate the option is not set.
+            # Overwrite behavior is unspecified.
             OVERWRITE_WHEN_UNSPECIFIED = 0
 
-            # Overwrite destination object with source if the two objects are
-            # different.
+            # Overwrites destination objects with the source objects, only if the
+            # objects have the same name but different HTTP ETags or checksum values.
             DIFFERENT = 1
 
-            # Never overwrite destination object.
+            # Never overwrites a destination object if a source object has the
+            # same name. In this case, the source object is not transferred.
             NEVER = 2
 
-            # Always overwrite destination object.
+            # Always overwrite the destination object with the source object, even if
+            # the HTTP Etags or checksum values are the same.
             ALWAYS = 3
           end
         end
@@ -454,6 +558,9 @@ module Google
         # @!attribute [rw] azure_blob_storage_data_source
         #   @return [::Google::Cloud::StorageTransfer::V1::AzureBlobStorageData]
         #     An Azure Blob Storage data source.
+        # @!attribute [rw] aws_s3_compatible_data_source
+        #   @return [::Google::Cloud::StorageTransfer::V1::AwsS3CompatibleData]
+        #     An AWS S3 compatible data source.
         # @!attribute [rw] gcs_intermediate_data_location
         #   @return [::Google::Cloud::StorageTransfer::V1::GcsData]
         #     Cloud Storage intermediate data location.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-storage_transfer-v1
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-08 00:00:00.000000000 Z
+date: 2022-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common