Method: transferJobs.list

Lista jobs de transferência.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
filter

string

Obrigatório. Uma lista de parâmetros de consulta especificados como texto JSON no formato:

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

A formatação JSON no exemplo é apenas para exibição. Forneça os parâmetros de consulta sem espaços ou quebras de linha.

  • projectId é obrigatório.
  • Como jobNames e jobStatuses aceitam vários valores, eles precisam ser especificados com a notação de matriz. jobNames e jobStatuses são opcionais. Os valores válidos não diferenciam maiúsculas de minúsculas:
  • Especifique "dataBackend":"QUERY_REPLICATION_CONFIGS" para retornar uma lista de jobs de replicação entre buckets.
  • Limite os resultados a jobs de um bucket específico com sourceBucket e/ou a um bucket específico com sinkBucket.

A autorização requer a seguinte permissão do IAM no recurso especificado filter:

  • storagetransfer.jobs.list
pageSize

integer

O tamanho da página da lista. O valor máximo permitido é 256.
pageToken

string

O token da página de lista.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta de transferJobs.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "transferJobs": [
    {
      object (TransferJob)
    }
  ],
  "nextPageToken": string
}
Campos
transferJobs[]

object (TransferJob)

Uma lista de jobs de transferência.
nextPageToken

string

O token da próxima página da lista.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.