Method: transferJobs.patch

Updates a transfer job. Updating a job's transfer spec does not affect transfer operations that are running already.

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).

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The name of job to update.

Authorization requires the following IAM permission on the specified resource jobName:


Request body

The request body contains data with the following structure:

JSON representation
  "projectId": string,
  "transferJob": {
    object (TransferJob)
  "updateTransferJobFieldMask": string


Required. The ID of the Google Cloud project that owns the job.


object (TransferJob)

Required. The job to update. transferJob is expected to specify one or more of five fields: description, transferSpec, notificationConfig, loggingConfig, and status. An UpdateTransferJobRequest that specifies other fields are rejected with the error INVALID_ARGUMENT. Updating a job status to DELETED requires permission.


string (FieldMask format)

The field mask of the fields in transferJob that are to be updated in this request. Fields in transferJob that can be updated are: description, transferSpec, notificationConfig, loggingConfig, and status. To update the transferSpec of the job, a complete transfer specification must be provided. An incomplete specification missing any required fields is rejected with the error INVALID_ARGUMENT.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Response body

If successful, the response body contains an instance of TransferJob.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.