google-api-client 0.43.0 → 0.48.0

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

@@ -46,6 +46,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CancelOperationRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Date
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -218,6 +224,12 @@ module Google
         end
       end
       
+      class CancelOperationRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Date
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -395,6 +407,7 @@ module Google
           property :deletion_time, as: 'deletionTime'
           property :description, as: 'description'
           property :last_modification_time, as: 'lastModificationTime'
+          property :latest_operation_name, as: 'latestOperationName'
           property :name, as: 'name'
           property :notification_config, as: 'notificationConfig', class: Google::Apis::StoragetransferV1::NotificationConfig, decorator: Google::Apis::StoragetransferV1::NotificationConfig::Representation
       

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

@@ -48,17 +48,16 @@ module Google
           @batch_path = 'batch'
         end
         
-        # 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.
+        # 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.
         # @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 Platform Console 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
@@ -118,7 +117,7 @@ module Google
         
         # Gets a transfer job.
         # @param [String] job_name
-        #   Required. The job to get.
+        #   Required. " The job to get.
         # @param [String] project_id
         #   Required. The ID of the Google Cloud Platform Console project that owns the
         #   job.
@@ -139,7 +138,7 @@ module Google
         # @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_transfer_job(job_name, project_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def get_transfer_job(job_name, project_id, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+jobName}', options)
           command.response_representation = Google::Apis::StoragetransferV1::TransferJob::Representation
           command.response_class = Google::Apis::StoragetransferV1::TransferJob
@@ -152,17 +151,12 @@ module Google
         
         # Lists transfer jobs.
         # @param [String] filter
-        #   Required. A list of query parameters specified as JSON text in the form of:
-        #   `"project<span>_</span>id":"my_project_id",
-        #   "job_names":["jobid1","jobid2",...],
-        #   "job_statuses":["status1","status2",...]`.
-        #   Since `job_names` and `job_statuses` support multiple values, their values
-        #   must be specified with array notation. `project`<span>`_`</span>`id` is
-        #   required.  `job_names` and `job_statuses` are optional.  The valid values
-        #   for `job_statuses` are case-insensitive:
-        #   ENABLED,
-        #   DISABLED, and
-        #   DELETED.
+        #   Required. A list of query parameters specified as JSON text in the form of: ``"
+        #   projectId":"my_project_id", "jobNames":["jobid1","jobid2",...], "jobStatuses":[
+        #   "status1","status2",...]`` Since `jobNames` and `jobStatuses` support multiple
+        #   values, their values must be specified with array notation. `projectId` is
+        #   required. `jobNames` and `jobStatuses` are optional. The valid values for `
+        #   jobStatuses` are case-insensitive: ENABLED, DISABLED, and DELETED.
         # @param [Fixnum] page_size
         #   The list page size. The max allowed value is 256.
         # @param [String] page_token
@@ -184,7 +178,7 @@ module Google
         # @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_transfer_jobs(filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_transfer_jobs(filter, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/transferJobs', options)
           command.response_representation = Google::Apis::StoragetransferV1::ListTransferJobsResponse::Representation
           command.response_class = Google::Apis::StoragetransferV1::ListTransferJobsResponse
@@ -197,13 +191,9 @@ module Google
         end
         
         # Updates a transfer job. Updating a job's transfer spec does not affect
-        # transfer operations that are running already. Updating a job's schedule
-        # is not allowed.
-        # **Note:** The job's status field can be modified
-        # using this RPC (for example, to set a job's status to
-        # DELETED,
-        # DISABLED, or
-        # ENABLED).
+        # transfer operations that are running already. Updating a job's schedule is not
+        # allowed. **Note:** The job's status field can be modified using this RPC (for
+        # example, to set a job's status to DELETED, DISABLED, or ENABLED).
         # @param [String] job_name
         #   Required. The name of job to update.
         # @param [Google::Apis::StoragetransferV1::UpdateTransferJobRequest] update_transfer_job_request_object
@@ -236,34 +226,26 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Cancels a transfer. Use the
-        # transferOperations.get method to
-        # check if the cancellation succeeded or if the operation completed despite
-        # the `cancel` request.
-        # When you cancel an operation, the currently running transfer is
-        # interrupted.  For recurring transfer jobs, the next instance of the transfer
-        # job
-        # will still run.  For example, if your job is configured to run every day
-        # at 1pm and you cancel Monday's operation at 1:05pm, Monday's transfer
-        # will stop. However, a transfer job will still be attempted on Tuesday.
-        # This applies only to currently running operations. If an operation is
-        # not currently running, `cancel` does nothing.
-        # <aside class="caution">
-        # <b>Caution:</b> Canceling a transfer job can leave your data in an unknown
-        # state. We recommend that you restore the state at both the destination and the
-        # source after the `cancel` request completes so that your data is in a
-        # consistent
-        # state.
-        # </aside>
-        # When you cancel a job, the next job computes a delta of files and may repair
-        # any
-        # inconsistent state. For instance, if you run a job every day, and today's job
-        # found 10 new files and transferred five files before you canceled the job,
-        # tomorrow's transfer operation will compute a new delta with the five files
-        # that
-        # were not copied today plus any new files discovered tomorrow.
+        # Cancels a transfer. Use the transferOperations.get method to check if the
+        # cancellation succeeded or if the operation completed despite the `cancel`
+        # request. When you cancel an operation, the currently running transfer is
+        # interrupted. For recurring transfer jobs, the next instance of the transfer
+        # job will still run. For example, if your job is configured to run every day at
+        # 1pm and you cancel Monday's operation at 1:05pm, Monday's transfer will stop.
+        # However, a transfer job will still be attempted on Tuesday. This applies only
+        # to currently running operations. If an operation is not currently running, `
+        # cancel` does nothing. *Caution:* Canceling a transfer job can leave your data
+        # in an unknown state. We recommend that you restore the state at both the
+        # destination and the source after the `cancel` request completes so that your
+        # data is in a consistent state. When you cancel a job, the next job computes a
+        # delta of files and may repair any inconsistent state. For instance, if you run
+        # a job every day, and today's job found 10 new files and transferred five files
+        # before you canceled the job, tomorrow's transfer operation will compute a new
+        # delta with the five files that were not copied today plus any new files
+        # discovered tomorrow.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
+        # @param [Google::Apis::StoragetransferV1::CancelOperationRequest] cancel_operation_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -281,8 +263,10 @@ module Google
         # @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 cancel_transfer_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+        def cancel_transfer_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::StoragetransferV1::CancelOperationRequest::Representation
+          command.request_object = cancel_operation_request_object
           command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
           command.response_class = Google::Apis::StoragetransferV1::Empty
           command.params['name'] = name unless name.nil?
@@ -291,9 +275,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -327,16 +310,14 @@ module Google
         # @param [String] name
         #   Required. The value `transferOperations`.
         # @param [String] filter
-        #   Required. A list of query parameters specified as JSON text in the form of: `"
-        #   project<span>_</span>id":"my_project_id",
-        #   "job_names":["jobid1","jobid2",...],
-        #   "operation_names":["opid1","opid2",...],
-        #   "transfer_statuses":["status1","status2",...]`.
-        #   Since `job_names`, `operation_names`, and `transfer_statuses` support multiple
-        #   values, they must be specified with array notation. `project`<span>`_`</span>`
-        #   id` is required. `job_names`, `operation_names`, and `transfer_statuses` are
-        #   optional. The valid values for `transfer_statuses` are case-insensitive:
-        #   IN_PROGRESS, PAUSED, SUCCESS, FAILED, and ABORTED.
+        #   Required. A list of query parameters specified as JSON text in the form of: ``"
+        #   projectId":"my_project_id", "jobNames":["jobid1","jobid2",...], "
+        #   operationNames":["opid1","opid2",...], "transferStatuses":["status1","status2",
+        #   ...]`` Since `jobNames`, `operationNames`, and `transferStatuses` support
+        #   multiple values, they must be specified with array notation. `projectId` is
+        #   required. `jobNames`, `operationNames`, and `transferStatuses` are optional.
+        #   The valid values for `transferStatuses` are case-insensitive: IN_PROGRESS,
+        #   PAUSED, SUCCESS, FAILED, and ABORTED.
         # @param [Fixnum] page_size
         #   The list page size. The max allowed value is 256.
         # @param [String] page_token
@@ -358,7 +339,7 @@ module Google
         # @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_transfer_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_transfer_operations(name, filter, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::StoragetransferV1::ListOperationsResponse::Representation
           command.response_class = Google::Apis::StoragetransferV1::ListOperationsResponse

data/generated/google/apis/storagetransfer_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/storage-transfer/docs
     module StoragetransferV1
       VERSION = 'V1'
-      REVISION = '20200730'
+      REVISION = '20201027'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'