Method: transferJobs.list

列出移轉工作。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
filter

string

這是必要旗標，以 JSON 文字格式指定的查詢參數清單，格式如下：

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

範例中的 JSON 格式僅供顯示；請提供不含空格或換行符號的查詢參數。

  • 「projectId」為必填欄位。
  • jobNames 和 jobStatuses 支援多個值，因此必須使用陣列符號指定其值。jobNames 和 jobStatuses 為選用欄位。有效值不區分大小寫：
  • 指定 "dataBackend":"QUERY_REPLICATION_CONFIGS" 即可傳回跨值區複製作業清單。
  • 使用 sourceBucket 和/或 sinkBucket 限制結果，只顯示特定分桶的工作。

授權需要指定資源 filter 的下列 IAM 權限：

  • storagetransfer.jobs.list
pageSize

integer

清單頁面大小。允許的最大值為 256。
pageToken

string

清單頁面憑證。

要求主體

要求主體必須為空白。

回應主體

來自 transferJobs.list 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "transferJobs": [
    {
      object (TransferJob)
    }
  ],
  "nextPageToken": string
}
欄位
transferJobs[]

object (TransferJob)

移轉工作的清單。
nextPageToken

string

清單下一頁憑證。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 Authentication Overview。