Method: transferOperations.list

Lists transfer operations. Operations are ordered by their creation time in reverse chronological order.

HTTP request

GET https://storagetransfer.googleapis.com/v1/{name}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the type being listed; must be transferOperations.

Query parameters

Parameters
filter

string

Required. A list of query parameters specified as JSON text in the form of: {"projectId":"my_project_id", "jobNames":["jobid1","jobid2",...], "jobNamePattern": "job_name_pattern", "operationNames":["opid1","opid2",...], "operationNamePattern": "operation_name_pattern", "minCreationTime": "min_creation_time", "maxCreationTime": "max_creation_time", "transferStatuses":["status1","status2",...]}

Since jobNames, operationNames, and transferStatuses support multiple values, they must be specified with array notation. projectId is the only argument that is required. If specified, jobNamePattern and operationNamePattern must match the full job or operation name respectively. '*' is a wildcard matching 0 or more characters. minCreationTime and maxCreationTime should be timestamps encoded as a string in the RFC 3339 format. The valid values for transferStatuses are case-insensitive: IN_PROGRESS, PAUSED, SUCCESS, FAILED, and ABORTED.
pageSize

integer

The list page size. The max allowed value is 256.
pageToken

string

The list page token.

Request body

The request body must be empty.

Response body

The response message for Operations.ListOperations.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "operations": [
    {
      object (Operation)
    }
  ],
  "nextPageToken": string
}
Fields
operations[]

object (Operation)

A list of operations that matches the specified filter in the request.
nextPageToken

string

The standard List next-page token.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.