管理转移作业

本页面介绍如何管理现有转移作业和操作。

如需创建新的转移作业,请参阅创建转移作业

修改转移作业配置

您可以修改现有转移作业的以下属性:

  • 转移作业的说明
  • Microsoft Azure Blob Storage 或 Amazon S3 数据源凭据
  • 应用于转移作业的任何过滤条件
  • 用于覆盖或删除文件的选项
  • 转移作业的时间表

gcloud CLI

如需修改现有转移作业配置,请使用 gcloud transfer jobs update 命令。

gcloud transfer jobs update \
  JOB_NAME \
  [options]

变量如下:

  • JOB_NAME 是要更新的作业的唯一名称。

  • 通过运行 gcloud transfer jobs update --help 列出可更新的选项。

例如,如需更新作业的来源和目标并移除其说明,请运行以下命令:

gcloud transfer jobs update \
  JOB_NAME \
  --source=gs://new-bucket-1 \
  --destination=gs://new-bucket-2 \
  --clear-description

Google Cloud 控制台

如需修改转移作业,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往 Storage Transfer Service 页面。

    转到 Storage Transfer Service

  2. 点击转移作业的说明。 此时系统会显示作业详情页面。

  3. 点击配置。 此时系统会显示转移作业配置。

  4. 如需更改某个项,请点击该项旁边的 修改

  5. 如需启动包含修改的作业,请点击启动运行作业

REST

如需修改转移作业配置,请使用 transferJobs.patch 方法。

从现有配置运行转移作业

您可以运行现有转移作业。在这种情况下,您可以启动无时间表的作业,或启动超出时间表范围的作业。

gcloud CLI

如需从现有配置运行转移作业,请使用 gcloud transfer jobs run

gcloud transfer jobs run JOB_NAME

您可以指定可选 --no-async 标志以阻止终端中的其他任务,直到转移操作完成。

Google Cloud 控制台

如需从现有配置运行转移作业,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往 Storage Transfer Service 页面。

    转到 Storage Transfer Service

  2. 点击转移作业的说明。 此时系统会显示作业详情页面。

  3. 如需启动转移作业,请点击启动运行

REST

如需运行转移作业,请使用 transferJobs.run 方法。

监控转移作业

gcloud CLI

如需实时监控作业进度,请使用 gcloud transfer jobs monitor

gcloud transfer jobs monitor JOB_NAME

该响应会显示当前操作、作业开始时间和转移的数据量。跳过的字节数和错误数也会计算在内。

Cloud Monitoring

如需详细了解如何将 Cloud Monitoring 与 Storage Transfer Service 搭配使用,请参阅监控转移作业

查看转移作业详情

gcloud CLI

如需查看转移作业详情,请使用 gcloud transfer jobs describe

gcloud transfer jobs describe JOB_NAME

如需查看此作业的最新操作,请将 latestOperationName 的值传递给 operations describe 命令:

gcloud transfer operations describe OPERATION_NAME

如需列出作业的所有转移操作,请使用 gcloud transfer operations list 命令:

gcloud transfer operations list --job-names=JOB_NAME

您可以通过列出多个作业(以英文逗号分隔)作为 --job-names 的值来查看多个作业的操作。省略 --job-names 可查看所有作业的操作。

Google Cloud 控制台

您可以通过 Google Cloud 控制台查看以下作业详情:

  • 作业说明和名称
  • 数据源类型和位置
  • 目标位置
  • 作业频率
  • 作业统计信息

如需查看转移作业详情,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往 Storage Transfer Service 页面。

    转到 Storage Transfer Service

  2. 点击转移作业的说明。 此时系统会显示作业详情页面。

如需显示特定运行的详细信息,请点击作业运行的开始时间。 以下作业信息可用:

  • 传输状态
  • 开始和停止时间
  • 时长
  • 进度
  • 转移的数据
  • 错误数量
  • 跳过的数据
  • 估算的平均速度

REST

如需查看转移作业的详细信息,请使用 transferJobs.get 方法返回有关特定转移作业的信息,例如其操作 ID。

客户端库

当您使用 transferJobs.create 时,将返回 TransferJob 资源。

您可以在使用 transferJobs.get 创建作业后检查转移状态。如果转移作业的操作已开始,则会返回包含已填充的 latestOperationName 字段的 TransferJob。相反,如果转移作业的操作尚未启动,则 latestOperationName 字段为空。

查看转移作业的状态

REST

使用 transferJobs get 发出请求:
GET https://storagetransfer.googleapis.com/v1/{jobName="name"}

Go

import (
	"context"
	"fmt"
	"io"

	"cloud.google.com/go/longrunning/autogen/longrunningpb"
	storagetransfer "cloud.google.com/go/storagetransfer/apiv1"
	"cloud.google.com/go/storagetransfer/apiv1/storagetransferpb"
)

func checkLatestTransferOperation(w io.Writer, projectID string, jobName string) (*storagetransferpb.TransferOperation, error) {
	// Your Google Cloud Project ID
	// projectID := "my-project-id"

	// The name of the job whose latest operation to check
	// jobName := "transferJobs/1234567890"