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。