Method: transferJobs.list

Muestra una lista de los trabajos de transferencia.

Solicitud HTTP

GET https://storagetransfer.googleapis.com/v1/transferJobs

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
filter

string

Obligatorio. Una lista de parámetros de consulta especificados como texto JSON con el siguiente formato:

{
  "projectId":"my_project_id",
  "jobNames":["jobid1","jobid2",...],
  "jobStatuses":["status1","status2",...],
  "dataBackend":"QUERY_REPLICATION_CONFIGS",
  "sourceBucket":"source-bucket-name",
  "sinkBucket":"sink-bucket-name",
}

El formato JSON del ejemplo es solo para mostrarlo. Proporciona los parámetros de consulta sin espacios ni saltos de línea.

  • El campo projectId es obligatorio.
  • Dado que jobNames y jobStatuses admiten varios valores, sus valores deben especificarse con notación de array. jobNames y jobStatuses son opcionales. Los valores válidos no distinguen mayúsculas de minúsculas:
  • Especifica "dataBackend":"QUERY_REPLICATION_CONFIGS" para mostrar una lista de trabajos de replicación entre buckets.
  • Limita los resultados a trabajos de un bucket en particular con sourceBucket o a un bucket en particular con sinkBucket.

La autorización requiere el siguiente permiso IAM en el recurso especificado filter:

  • storagetransfer.jobs.list
pageSize

integer

Es el tamaño de página de la lista. El valor máximo permitido es 256.

pageToken

string

El token de página de lista.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta de transferJobs.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "transferJobs": [
    {
      object (TransferJob)
    }
  ],
  "nextPageToken": string
}
Campos
transferJobs[]

object (TransferJob)

Una lista de trabajos de transferencia.

nextPageToken

string

El token de página siguiente de la lista.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Authentication Overview.