Mengelola transfer

Halaman ini menunjukkan cara mengelola tugas dan operasi transfer yang ada.

Untuk membuat tugas transfer baru, lihat Membuat transfer.

Mengedit konfigurasi transfer

Anda dapat mengedit properti transfer yang ada berikut:

• Deskripsi tugas transfer
• Kredensial sumber Microsoft Azure Blob Storage atau Amazon S3
• Filter apa pun yang diterapkan ke tugas transfer
• Opsi untuk mengganti atau menghapus file

• Jadwal tugas transfer

gcloud CLI

Untuk mengedit konfigurasi transfer yang ada, gunakan perintah gcloud transfer jobs update.

gcloud transfer jobs update \
  JOB_NAME \
  [options]

Variabelnya adalah sebagai berikut:

• JOB_NAME adalah nama unik tugas yang akan diperbarui.

• Opsi yang dapat diperbarui dicantumkan dengan menjalankan gcloud transfer jobs update --help.

Misalnya, untuk memperbarui sumber dan tujuan tugas, serta menghapus deskripsinya, jalankan perintah berikut:

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

Google Cloud Konsol

Untuk mengedit tugas transfer, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

3. Klik Configuration. Konfigurasi tugas transfer akan ditampilkan.

4. Untuk mengubah item, klik Edit di samping item.

5. Untuk memulai tugas dengan hasil edit, klik Start a run.

REST

Untuk mengedit konfigurasi transfer, gunakan metode transferJobs.patch.

Menjalankan tugas transfer dari konfigurasi yang ada

Anda dapat menjalankan tugas transfer yang ada. Hal ini memungkinkan Anda memulai tugas yang tidak memiliki jadwal, atau memulai tugas di luar jadwalnya.

gcloud CLI

Untuk menjalankan transfer dari konfigurasi yang ada, gunakan gcloud transfer jobs run:

gcloud transfer jobs run JOB_NAME

Flag --no-async opsional dapat ditentukan untuk memblokir tugas lain di terminal Anda hingga operasi transfer selesai.

Google Cloud Konsol

Untuk menjalankan transfer dari konfigurasi yang ada, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

3. Untuk memulai tugas transfer, klik Start a run.

REST

Untuk menjalankan tugas transfer, gunakan transferJobs.run metode.

Memantau tugas transfer

gcloud CLI

Untuk memantau progres tugas secara real time, gunakan gcloud transfer jobs monitor.

gcloud transfer jobs monitor JOB_NAME

Respons menunjukkan operasi saat ini, waktu mulai tugas, dan jumlah data yang ditransfer. Byte dan error yang dilewati juga dihitung.

Cloud Monitoring

Lihat Memantau tugas transfer untuk mengetahui detail tentang cara menggunakan Cloud Monitoring dengan Storage Transfer Service.

Melihat detail tugas transfer

gcloud CLI

Untuk melihat detail tugas transfer, gunakan gcloud transfer jobs describe:

gcloud transfer jobs describe JOB_NAME

Untuk melihat operasi terbaru tugas ini, teruskan nilai latestOperationName ke perintah operations describe:

gcloud transfer operations describe OPERATION_NAME

Untuk mencantumkan semua operasi transfer tugas, gunakan perintah gcloud transfer operations list:

gcloud transfer operations list --job-names=JOB_NAME

Anda dapat melihat operasi untuk beberapa tugas dengan mencantumkannya, dipisahkan koma, sebagai nilai --job-names. Hapus --job-names untuk melihat operasi untuk semua tugas.

Google Cloud Konsol

Anda dapat melihat detail tugas berikut dari Google Cloud konsol:

• Deskripsi dan nama tugas
• Jenis dan lokasi sumber
• Lokasi tujuan
• Frekuensi tugas
• Statistik tugas

Untuk melihat detail tugas transfer, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

Untuk menampilkan detail operasi tertentu, klik Start time untuk operasi tugas. Informasi tugas berikut tersedia:

• Status transfer
• Waktu mulai dan berhenti
• Durasi
• Progres
• Data yang ditransfer
• Jumlah error
• Data yang dilewati
• Perkiraan kecepatan rata-rata

REST

Untuk melihat detail tugas transfer, gunakan metode transferJobs.get untuk menampilkan informasi tentang tugas transfer tertentu seperti ID operasinya.

Library klien

Resource TransferJob akan ditampilkan saat Anda menggunakan transferJobs.create.

Anda dapat memeriksa status transfer setelah membuat tugas menggunakan transferJobs.get. Jika operasi tugas transfer telah dimulai, perintah ini akan menampilkan TransferJob yang berisi kolom latestOperationName yang terisi. Jika tidak, jika operasi tugas transfer belum dimulai, kolom latestOperationName akan kosong.

Untuk memeriksa status tugas transfer

REST

Meminta menggunakan 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"
	ctx := context.Background()
	client, err := storagetransfer.NewClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("storagetransfer.NewClient: %w", err)
	}
	defer client.Close()

	job, err := client.GetTransferJob(ctx, &storagetransferpb.GetTransferJobRequest{
		JobName:   jobName,
		ProjectId: projectID,
	})
	if err != nil {
		return nil, fmt.Errorf("failed to get transfer job: %w", err)
	}

	latestOpName := job.LatestOperationName
	if latestOpName != "" {
		lro, err := client.LROClient.GetOperation(ctx, &longrunningpb.GetOperationRequest{
			Name: latestOpName,
		})
		if err != nil {
			return nil, fmt.Errorf("failed to get transfer operation: %w", err)
		}
		latestOp := &storagetransferpb.TransferOperation{}
		lro.Metadata.UnmarshalTo(latestOp)

		fmt.Fprintf(w, "the latest transfer operation for job %q is: \n%v", jobName, latestOp)
		return latestOp, nil
	} else {
		fmt.Fprintf(w, "Transfer job %q hasn't run yet, try again later", jobName)
		return nil, nil
	}
}

Java

Mencari contoh yang lebih lama? Lihat Panduan Migrasi Storage Transfer Service.

import com.google.longrunning.Operation;
import com.google.storagetransfer.v1.proto.StorageTransferServiceClient;
import com.google.storagetransfer.v1.proto.TransferProto.GetTransferJobRequest;
import com.google.storagetransfer.v1.proto.TransferTypes.TransferJob;
import com.google.storagetransfer.v1.proto.TransferTypes.TransferOperation;
import java.io.IOException;

public class CheckLatestTransferOperation {

  // Gets the requested transfer job and checks its latest operation
  public static void checkLatestTransferOperation(String projectId, String jobName)
      throws IOException {
    // Your Google Cloud Project ID
    // String projectId = "your-project-id";

    // The name of the job to check
    // String jobName = "myJob/1234567890";

    StorageTransferServiceClient storageTransfer = StorageTransferServiceClient.create();

    // Get transfer job and check latest operation
    TransferJob transferJob =
        storageTransfer.getTransferJob(
            GetTransferJobRequest.newBuilder().setJobName(jobName).setProjectId(projectId).build());
    String latestOperationName = transferJob.getLatestOperationName();

    if (!latestOperationName.isEmpty()) {
      Operation operation = storageTransfer.getOperationsClient().getOperation(latestOperationName);
      TransferOperation latestOperation =
          TransferOperation.parseFrom(operation.getMetadata().getValue());

      System.out.println("The latest operation for transfer job " + jobName + " is:");
      System.out.println(latestOperation.toString());

    } else {
      System.out.println(
          "Transfer job "
              + jobName
              + " hasn't run yet,"
              + " try again once the job starts running.");
    }
  }
}

Node.js

// Imports the Google Cloud client library
const {
  StorageTransferServiceClient,
} = require('@google-cloud/storage-transfer');

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// The ID of the Google Cloud Platform Project that owns the job
// projectId = 'my-project-id'

// Storage Transfer Service job name
// jobName = 'transferJobs/1234567890'

// Creates a client
const client = new StorageTransferServiceClient();

/**
 * Checks the latest transfer operation for a given transfer job.
 */
async function checkLatestTransferOperation() {
  const [transferJob] = await client.getTransferJob({projectId, jobName});

  if (transferJob.latestOperationName) {
    const [transferOperation] = await client.operationsClient.getOperation({
      name: transferJob.latestOperationName,
    });

    const operation = JSON.stringify(transferOperation, null, 2);

    console.log(`Latest transfer operation for '${jobName}': ${operation}`);
  } else {
    console.log(`Transfer job '${jobName}' has not ran yet.`);
  }
}

checkLatestTransferOperation();

Python

Mencari contoh yang lebih lama? Lihat Panduan Migrasi Storage Transfer Service.

from google.cloud import storage_transfer


def check_latest_transfer_operation(project_id: str, job_name: str):
    """Checks the latest transfer operation for a given transfer job."""

    client = storage_transfer.StorageTransferServiceClient()

    # The ID of the Google Cloud Platform Project that owns the job
    # project_id = 'my-project-id'

    # Storage Transfer Service job name
    # job_name = 'transferJobs/1234567890'

    transfer_job = client.get_transfer_job(
        {
            "project_id": project_id,
            "job_name": job_name,
        }
    )

    if transfer_job.latest_operation_name:
        response = client.transport.operations_client.get_operation(
            transfer_job.latest_operation_name
        )
        operation = storage_transfer.TransferOperation.deserialize(
            response.metadata.value
        )

        print(f"Latest transfer operation for `{job_name}`: {operation}")
    else:
        print(f"Transfer job {job_name} has not ran yet.")

Menjeda tugas transfer

Anda dapat menjeda transfer yang sedang berlangsung. Saat Anda menjeda transfer, status tugas akan dipertahankan, dan Anda dapat melanjutkannya nanti. Saat transfer dijeda, jadwal tidak akan memicu tugas untuk dijalankan lagi.

gcloud CLI

Untuk menjeda tugas transfer, teruskan nama operasi tugas saat ini ke gcloud transfer operations pause.

gcloud transfer operations pause OPERATION_NAME

Untuk melanjutkan tugas transfer yang sebelumnya dijeda, yang akan memulai ulang tugas di tempat yang sama saat dijeda, gunakan gcloud transfer operations resume.

gcloud transfer operations resume OPERATION_NAME

Google Cloud Konsol

Untuk menjeda tugas transfer, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

3. Klik Pause run. Status untuk operasi saat ini akan ditampilkan sebagai Paused.

Untuk melanjutkan tugas transfer yang sebelumnya dijeda, yang akan memulai ulang tugas di tempat yang sama saat dijeda, ikuti langkah-langkah berikut.

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

3. Klik Resume run.

   Status untuk operasi saat ini akan ditampilkan sebagai In progress.

REST

Untuk menjeda tugas transfer, gunakan transferOperations.pause metode.

Menonaktifkan tugas transfer

Menonaktifkan tugas transfer akan mencegah tugas transfer memulai operasi terjadwal lebih lanjut, atau operasi yang dimulai secara manual dari konsol. Tindakan ini tidak mencegah tugas dimulai secara manual dengan API atau dengan perintah gcloud jobs run.

gcloud CLI

Untuk menonaktifkan tugas transfer, perbarui status tugas menjadi disabled.

gcloud transfer jobs update JOB_NAME --status=disabled

Untuk mengaktifkan kembali tugas, tetapkan --status=enabled.

Google Cloud Konsol

Untuk menonaktifkan tugas transfer, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

3. Klik Disable job. Dialog Disable transfer job? akan ditampilkan.

4. Baca dialog, lalu konfirmasi penonaktifan tugas dengan mengklik Confirm.

   Pemberitahuan di bagian atas halaman Job details akan ditampilkan, yang mengingatkan Anda bahwa tugas dinonaktifkan.

REST

Gunakan metode transferJobs.patch untuk menetapkan status tugas transfer ke DISABLED.

Menghapus tugas transfer

Anda dapat menghapus tugas transfer yang tidak lagi diperlukan. Menghapus tugas akan melakukan hal berikut:

• Menghentikan transfer yang ada yang merupakan bagian dari tugas.
• Menghentikan transfer berulang yang merupakan bagian dari tugas.
• Menghapus detail konfigurasi tugas.

Menghapus tugas bersifat permanen. Setelah Anda menghapus tugas transfer, tugas tersebut akan dihapus dari daftar tugas transfer. Informasi tugas transfer akan sepenuhnya dihapus dari Storage Transfer Service setelah 30 hari.

Atau, Anda dapat menonaktifkan tugas transfer, yang akan mempertahankan tugas yang tercantum di halaman Jobs dan memungkinkan Anda mengaktifkan kembali atau mengubah tugas.

gcloud CLI

Untuk menghapus tugas transfer, gunakan gcloud transfer jobs delete.

gcloud transfer jobs delete JOB_NAME

Google Cloud Konsol

Untuk menghapus tugas transfer, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Centang kotak di samping tugas transfer yang ingin Anda hapus.

3. Klik Delete job.

   Dialog Delete transfer job? akan ditampilkan.

4. Baca dialog, lalu konfirmasi penghapusan tugas dengan mengetik nama tugas yang ditetapkan secara otomatis di kolom dan klik Delete.

   Tugas akan dihapus dari halaman Jobs.

REST

Untuk menghapus tugas transfer menggunakan REST API, lihat transferJobs.delete referensi.

Melihat detail error

Jika Anda mengalami error selama operasi transfer, Anda dapat melihat detail error untuk membantu memecahkan masalah error.

Untuk melihat detail error operasi tugas transfer, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman Storage Transfer Service.

   Buka Storage Transfer Service

2. Klik deskripsi tugas transfer. Halaman Job details akan ditampilkan.

3. Lakukan salah satu hal berikut untuk menampilkan detail tugas:

   • Operasi tugas terbaru: Klik tombol See error details atau link View error details. Halaman Error details akan ditampilkan.

   • Operasi tugas historis:

     1. Klik Start time operasi tugas.

        Halaman Run details akan ditampilkan.

     2. Klik link View error details.

        Halaman Error details akan ditampilkan.

4. Untuk menampilkan detail tambahan tentang setiap error yang ditampilkan, klik Expand more.

5. Untuk memfilter error, masukkan properti yang akan difilter di kolom Enter property name or value.

   Saat Anda menempatkan kursor di kolom, menu dropdown dengan opsi yang relevan akan ditampilkan untuk membantu Anda membuat filter.