Halaman ini menunjukkan cara membuat dan memulai tugas transfer.
Untuk mengetahui apakah sumber dan tujuan (juga dikenal sebagai sink) Anda didukung oleh Storage Transfer Service, lihat Sumber dan sink yang didukung.
Agen dan kumpulan agen
Bergantung pada sumber dan tujuan, Anda mungkin perlu membuat dan mengonfigurasi kumpulan agen serta menginstal agen di mesin dengan akses ke sumber atau tujuan Anda.
Transfer dari Amazon S3, Microsoft Azure, daftar URL, atau Cloud Storage ke Cloud Storage tidak memerlukan agen dan kumpulan agen.
Transfer yang sumber dan/atau tujuannya adalah sistem file, atau dari penyimpanan yang kompatibel dengan S3, memerlukan agen dan kumpulan agen. Lihat bagian Mengelola kumpulan agen untuk mengetahui petunjuknya.
Sebelum memulai
Sebelum mengonfigurasi transfer, pastikan Anda telah mengonfigurasi akses:
- Untuk pengguna dan akun layanan:
- Ke data sumber dan tujuan Anda.
Jika Anda menggunakan perintah gcloud
,
instal gcloud CLI.
Buat transfer
Jangan sertakan informasi sensitif seperti informasi identitas pribadi (PII) atau data keamanan dalam nama tugas transfer Anda. Nama resource dapat disalurkan ke nama resource Google Cloud lain dan dapat diekspos ke sistem internal Google di luar project Anda.
Google Cloud console
Buka halaman Storage Transfer Service di konsol Google Cloud .
Klik Buat tugas transfer. Halaman Buat tugas transfer akan ditampilkan.
Pilih sumber:
Cloud Storage
Akun pengguna Anda harus memiliki izin storage.buckets.get untuk memilih bucket sumber dan tujuan. Atau, Anda dapat mengetik nama bucket secara langsung. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah akses.
Di bagian Source type, pilih Cloud Storage.
Pilih Jenis tujuan.
Jika tujuan Anda adalah Cloud Storage, pilih Scheduling mode. Transfer batch dieksekusi secara satu kali atau terjadwal. Transfer yang didorong peristiwa terus-menerus memantau sumber dan mentransfer data saat ditambahkan atau diubah.
Untuk mengonfigurasi transfer yang didorong peristiwa, ikuti petunjuk di Transfer yang didorong peristiwa.
Klik Next step.
Pilih bucket dan (opsional) folder di bucket tersebut dengan melakukan salah satu tindakan berikut:
Masukkan nama dan jalur bucket Cloud Storage yang ada di kolom Bucket atau folder tanpa awalan
gs://
. Contohnya,my-test-bucket/path/to/files
Untuk menentukan bucket Cloud Storage dari project lain, ketik nama bucket persis di kolom Bucket name.Pilih daftar bucket yang ada di project Anda dengan mengklik Jelajahi, lalu memilih bucket.
Saat mengklik Jelajahi, Anda dapat memilih bucket di project lain dengan mengklik Project ID, lalu memilih Project ID dan bucket baru.
Untuk membuat bucket baru, klik
Buat bucket baru.
Jika ini adalah transfer yang didorong peristiwa, masukkan nama langganan Pub/Sub, yang menggunakan format berikut:
projects/PROJECT_NAME/subscriptions/SUBSCRIPTION_ID
- Secara opsional, pilih untuk
memfilter objek menurut awalan
atau menurut tanggal terakhir diubah. Jika Anda menentukan folder sebagai lokasi sumber, filter awalan
bersifat relatif terhadap folder tersebut. Misalnya, jika sumber Anda adalah
my-test-bucket/path/
, filter sertakanfile
akan menyertakan semua file yang diawali denganmy-test-bucket/path/file
. Klik Next step.
Amazon S3
Penyimpanan yang kompatibel dengan S3
Lihat Transfer dari penyimpanan yang kompatibel dengan S3 ke Cloud Storage.
Microsoft Azure Blob Storage
Di bagian Jenis sumber, pilih Azure Blob Storage atau Data Lake Storage Gen2.
Klik Next step.
Tentukan nilai berikut:
Nama akun penyimpanan — nama akun Microsoft Azure Storage sumber.
Nama akun penyimpanan ditampilkan di portal Microsoft Azure Storage di bagian All services > Storage > Storage accounts.
Nama container — nama container Microsoft Azure Storage.
Nama container ditampilkan di portal Microsoft Azure Storage di bagian Storage explorer > Blob containers.
Tanda tangan akses bersama (SAS) — token SAS Microsoft Azure Storage yang dibuat dari kebijakan akses tersimpan. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses terbatas ke resource Azure Storage menggunakan tanda tangan akses bersama (SAS).
Waktu habis masa berlaku default untuk token SAS adalah 8 jam. Saat membuat token SAS, pastikan untuk menetapkan waktu habis masa berlaku yang wajar sehingga Anda dapat menyelesaikan transfer dengan berhasil.
- Secara opsional, pilih untuk
memfilter objek menurut awalan
atau menurut tanggal terakhir diubah. Jika Anda menentukan folder sebagai lokasi sumber, filter awalan
bersifat relatif terhadap folder tersebut. Misalnya, jika sumber Anda adalah
my-test-bucket/path/
, filter sertakanfile
akan menyertakan semua file yang diawali denganmy-test-bucket/path/file
. Klik Next step.
Sistem file
Di bagian Source type, pilih POSIX file system.
Pilih Jenis tujuan dan klik Langkah berikutnya.
Pilih kumpulan agen yang ada, atau pilih Buat kumpulan agen dan ikuti petunjuk untuk membuat kumpulan baru.
Tentukan jalur yang sepenuhnya memenuhi syarat dari direktori sistem file.
Klik Next step.
HDFS
Daftar URL
Di bagian Jenis sumber, pilih Daftar URL, lalu klik Langkah berikutnya.
Di bagian URL file TSV, berikan URL ke file nilai yang dipisahkan tab (TSV). Lihat Membuat Daftar URL untuk mengetahui detail tentang cara membuat file TSV.
- Secara opsional, pilih untuk
memfilter objek menurut awalan
atau menurut tanggal terakhir diubah. Jika Anda menentukan folder sebagai lokasi sumber, filter awalan
bersifat relatif terhadap folder tersebut. Misalnya, jika sumber Anda adalah
my-test-bucket/path/
, filter sertakanfile
akan menyertakan semua file yang diawali denganmy-test-bucket/path/file
. Klik Next step.
Pilih tujuan:
Cloud Storage
Di kolom Bucket atau folder, masukkan bucket tujuan dan (opsional) nama folder, atau klik Jelajahi untuk memilih bucket dari daftar bucket yang ada di project saat ini. Untuk membuat bucket baru, klik
Buat bucket baru.
Klik Next step.
Pilih opsi penjadwalan Anda:
Dari menu drop-down Jalankan sekali, pilih salah satu opsi berikut:
Jalankan sekali: Menjalankan satu transfer, dimulai pada waktu yang Anda pilih.
Jalankan setiap hari: Menjalankan transfer setiap hari, dimulai pada waktu yang Anda pilih.
Anda dapat memasukkan Tanggal akhir opsional, atau membiarkan Tanggal akhir kosong agar pengalihan berjalan terus-menerus.
Jalankan setiap minggu: Menjalankan transfer setiap minggu, dimulai pada waktu yang Anda pilih.
Jalankan dengan frekuensi khusus: Menjalankan transfer dengan frekuensi yang Anda pilih. Anda dapat memilih untuk mengulangi transfer pada interval reguler Jam, Hari, atau Minggu.
Anda dapat memasukkan Tanggal akhir opsional, atau membiarkan Tanggal akhir kosong agar pengalihan berjalan terus-menerus.
Dari menu drop-down Mulai sekarang, pilih salah satu opsi berikut:
Mulai sekarang: Memulai transfer setelah Anda mengklik Buat.
Mulai pada: Memulai transfer pada tanggal dan waktu yang Anda pilih. Klik Kalender untuk menampilkan kalender guna memilih tanggal mulai.
Klik Next step.
Pilih setelan untuk tugas transfer. Beberapa opsi hanya tersedia untuk kombinasi sumber/tujuan tertentu.
Di kolom Deskripsi, masukkan deskripsi transfer. Sebagai praktik terbaik, masukkan deskripsi yang bermakna dan unik agar Anda dapat membedakan tugas.
Di bagian Opsi metadata, pilih untuk menggunakan opsi default, atau klik Lihat dan pilih opsi untuk menentukan nilai bagi semua metadata yang didukung. Lihat Penyimpanan metadata untuk mengetahui detailnya.
Di bagian Kapan menimpa, pilih salah satu opsi berikut:
Jika berbeda: Menimpa file tujuan jika file sumber dengan nama yang sama memiliki nilai ETag atau checksum yang berbeda.
Selalu: Selalu menimpa file tujuan saat file sumber memiliki nama yang sama, meskipun keduanya identik.
Di bagian Kapan harus dihapus, pilih salah satu opsi berikut:
Jangan pernah: Jangan pernah menghapus file dari sumber atau tujuan.
Hapus file dari sumber setelah ditransfer: Hapus file dari sumber setelah ditransfer ke tujuan. Jika file sumber tidak ditransfer, misalnya karena sudah ada di tujuan, file sumber tidak akan dihapus.
Hapus file dari tujuan jika di sumbernya tidak ada: Jika file di bucket Cloud Storage tujuan tidak ada di sumber, maka hapus file dari bucket Cloud Storage.
Opsi ini memastikan bahwa bucket Cloud Storage tujuan sama persis dengan sumber Anda.
Untuk transfer antar-bucket Cloud Storage, pilih apakah akan mentransfer folder terkelola.
Aktifkan atau nonaktifkan Logging for Storage Transfer Service.
Di bagian Opsi notifikasi, pilih topik Pub/Sub dan peristiwa yang akan diberi notifikasi. Lihat notifikasi Pub/Sub untuk mengetahui detail selengkapnya.
Jika Anda mendelegasikan izin agen layanan ke akun layanan yang dikelola pengguna, pilih opsi tersebut dan masukkan alamat email akun layanan dalam format
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
.Klik Buat.
Sistem file
Pilih kumpulan agen yang ada, atau pilih Buat kumpulan agen dan ikuti petunjuk untuk membuat kumpulan baru.
Tentukan jalur direktori tujuan yang sepenuhnya memenuhi syarat.
Klik Next step.
Pilih opsi penjadwalan Anda:
Dari menu drop-down Jalankan sekali, pilih salah satu opsi berikut:
Jalankan sekali: Menjalankan satu transfer, dimulai pada waktu yang Anda pilih.
Jalankan setiap hari: Menjalankan transfer setiap hari, dimulai pada waktu yang Anda pilih.
Anda dapat memasukkan Tanggal akhir opsional, atau membiarkan Tanggal akhir kosong agar pengalihan berjalan terus-menerus.
Jalankan setiap minggu: Menjalankan transfer setiap minggu, dimulai pada waktu yang Anda pilih.
Jalankan dengan frekuensi khusus: Menjalankan transfer dengan frekuensi yang Anda pilih. Anda dapat memilih untuk mengulangi transfer pada interval reguler Jam, Hari, atau Minggu.
Anda dapat memasukkan Tanggal akhir opsional, atau membiarkan Tanggal akhir kosong agar pengalihan berjalan terus-menerus.
Dari menu drop-down Mulai sekarang, pilih salah satu opsi berikut:
Mulai sekarang: Memulai transfer setelah Anda mengklik Buat.
Mulai pada: Memulai transfer pada tanggal dan waktu yang Anda pilih. Klik Kalender untuk menampilkan kalender guna memilih tanggal mulai.
Klik Next step.
Tentukan apakah akan menggunakan file manifes.
Pilih apakah akan mempertahankan metadata; kapan akan menimpa; dan kapan akan menghapus file di sumber atau tujuan.
Pilih opsi logging Anda.
Di bagian Opsi notifikasi, pilih topik Pub/Sub dan peristiwa yang akan diberi notifikasi. Lihat notifikasi Pub/Sub untuk mengetahui detail selengkapnya.
Jika Anda mendelegasikan izin agen layanan ke akun layanan yang dikelola pengguna, pilih opsi tersebut dan masukkan alamat email akun layanan dalam format
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
.Untuk membuat tugas transfer, klik Buat.
gcloud CLI
Untuk membuat tugas transfer baru, gunakan perintah gcloud transfer jobs create
. Membuat tugas baru akan memulai transfer yang ditentukan, kecuali jika jadwal atau --do-not-run
ditentukan.
gcloud transfer jobs create \
SOURCE DESTINATION
Dengan:
SOURCE adalah sumber data untuk transfer ini. Format untuk setiap sumber adalah:
- Cloud Storage:
gs://BUCKET_NAME
. Untuk mentransfer dari folder tertentu, tentukangs://BUCKET_NAME/FOLDER_PATH/
, termasuk garis miring penutup. - Amazon S3:
s3://BUCKET_NAME/FOLDER_PATH
- Penyimpanan yang kompatibel dengan S3:
s3://BUCKET_NAME
. Nama bucket relatif terhadap endpoint. Misalnya, jika data Anda berada dihttps://us-east-1.example.com/folder1/bucket_a
, masukkans3://folder1/bucket_a
. - Microsoft Azure Storage:
https://myaccount.blob.core.windows.net/CONTAINER_NAME
- Daftar URL:
https://PATH_TO_URL_LIST
atauhttp://PATH_TO_URL_LIST
- Sistem file POSIX:
posix:///PATH
. Jalur ini harus berupa jalur absolut dari root mesin host agen. - HDFS:
hdfs:///PATH
- Cloud Storage:
DESTINATION adalah salah satu dari:
- Cloud Storage:
gs://BUCKET_NAME
. Untuk mentransfer ke direktori tertentu, tentukangs://BUCKET_NAME/FOLDER_PATH/
, termasuk garis miring penutup. - Sistem file POSIX:
posix:///PATH
. Nilai ini harus berupa jalur absolut dari root mesin host agen.
- Cloud Storage:
Jika transfer memerlukan agen transfer, opsi berikut tersedia:
--source-agent-pool
menentukan kumpulan agen sumber yang akan digunakan untuk transfer ini. Diperlukan untuk transfer yang berasal dari sistem file.--destination-agent-pool
menentukan kumpulan agen tujuan yang akan digunakan untuk transfer ini. Diperlukan untuk transfer ke sistem file.--intermediate-storage-path
adalah jalur ke bucket Cloud Storage, dalam bentukgs://my-intermediary-bucket
. Diperlukan untuk transfer antara dua sistem file. Lihat Membuat bucket Cloud Storage sebagai perantara untuk mengetahui detail tentang cara membuat bucket perantara.
Opsi tambahan mencakup:
--source-creds-file
menentukan jalur relatif ke file lokal di komputer Anda yang mencakup kredensial AWS atau Azure untuk sumber transfer. Untuk mengetahui informasi pemformatan file kredensial, lihat referensi TransferSpec.--do-not-run
mencegah Storage Transfer Service menjalankan tugas setelah perintah dikirimkan. Untuk menjalankan tugas, perbarui tugas tersebut untuk menambahkan jadwal, atau gunakanjobs run
untuk memulainya secara manual.--manifest-file
menentukan jalur ke file CSV di Cloud Storage yang berisi daftar file yang akan ditransfer dari sumber Anda. Untuk pemformatan file manifes, lihat Mentransfer file atau objek tertentu menggunakan manifes.Informasi pekerjaan: Anda dapat menentukan
--name
,--description
, dan--source-creds-file
.Jadwal: Tentukan
--schedule-starts
,--schedule-repeats-every
, dan--schedule-repeats-until
, atau--do-not-run
.Kondisi objek: Gunakan kondisi untuk menentukan objek mana yang akan ditransfer. Hal ini mencakup
--include-prefixes
dan--exclude-prefixes
, serta kondisi berbasis waktu di--include-modified-[before | after]-[absolute | relative]
. Jika Anda menentukan folder dengan sumber, filter awalan bersifat relatif terhadap folder tersebut. Lihat Memfilter objek sumber menurut awalan untuk mengetahui informasi selengkapnya.Kondisi objek tidak didukung untuk transfer yang melibatkan sistem file.
Opsi transfer: Tentukan apakah akan mengganti file tujuan (
--overwrite-when=different
ataualways
) dan apakah akan menghapus file tertentu selama atau setelah transfer (--delete-from=destination-if-unique
atausource-after-transfer
); tentukan nilai metadata yang akan dipertahankan (--preserve-metadata
); dan secara opsional tetapkan class penyimpanan pada objek yang ditransfer (--custom-storage-class
).Notifikasi: Konfigurasi notifikasi Pub/Sub untuk transfer dengan
--notification-pubsub-topic
,--notification-event-types
, dan--notification-payload-format
.Cloud Logging: Aktifkan Cloud Logging untuk transfer tanpa agen, atau transfer dari sumber yang kompatibel dengan S3, dengan
--log-actions
dan--log-action-states
. Lihat Cloud Logging untuk Storage Transfer Service untuk mengetahui detailnya.
Transfer dari sumber yang kompatibel dengan S3 juga menggunakan opsi berikut:
--source-endpoint
(wajib) menentukan endpoint sistem penyimpanan Anda. Contoh,s3.example.com
. Hubungi penyedia Anda untuk mengetahui format yang benar. Jangan tentukan protokol (http://
atauhttps://
).--source-signing-region
menentukan region untuk menandatangani permintaan. Hapus tanda ini jika penyedia penyimpanan Anda tidak memerlukan wilayah penandatanganan.--source-auth-method
menentukan metode autentikasi yang akan digunakan. Nilai yang valid adalahAWS_SIGNATURE_V2
atauAWS_SIGNATURE_V4
. Lihat dokumentasi SigV4 dan SigV2 Amazon untuk mengetahui informasi selengkapnya.--source-request-model
menentukan gaya penentuan alamat yang akan digunakan. Nilai yang valid adalahPATH_STYLE
atauVIRTUAL_HOSTED_STYLE
. Gaya jalur menggunakan formathttps://s3.example.com/BUCKET_NAME/KEY_NAME
. Gaya yang dihosting virtual menggunakan format `https://BUCKET_NAME.s3.example.com/KEY_NAME.--source-network-protocol
menentukan protokol jaringan yang harus digunakan agen untuk tugas ini. Nilai yang valid adalahHTTP
atauHTTPS
.--source-list-api
menentukan versi S3 Listing API untuk menampilkan objek dari bucket. Nilai yang valid adalahLIST_OBJECTS
atauLIST_OBJECTS_V2
. Lihat dokumentasi ListObjectsV2 dan ListObjects Amazon untuk mengetahui informasi selengkapnya.
Untuk melihat semua opsi, jalankan gcloud transfer jobs create --help
atau lihat
dokumentasi referensi gcloud
.
Contoh
Amazon S3 ke Cloud Storage
Lihat Mentransfer dari Amazon S3 ke Cloud Storage.
Penyimpanan yang kompatibel dengan S3 ke Cloud Storage
Lihat Mentransfer dari penyimpanan yang kompatibel dengan S3 ke Cloud Storage.
Sistem file ke Cloud Storage
Lihat Mentransfer dari sistem file ke Cloud Storage.
Cloud Storage ke sistem file
Untuk mentransfer dari bucket Cloud Storage ke sistem file, tentukan berikut.
gcloud transfer jobs create \
gs://my-storage-bucket posix:///tmp/destination \
--destination-agent-pool=my-destination-agent-pool
Sistem file ke sistem file
Untuk mentransfer antara dua sistem file, Anda harus menentukan kumpulan agen sumber, kumpulan agen tujuan, dan bucket Cloud Storage perantara yang akan dilewati data.
Lihat Membuat bucket Cloud Storage sebagai perantara untuk mengetahui detail tentang bucket perantara.
Kemudian, tentukan 3 resource ini saat memanggil transfer jobs create
:
gcloud transfer jobs create \
posix:///tmp/source/on/systemA posix:///tmp/destination/on/systemB \
--source-agent-pool=source_agent_pool \
--destination-agent-pool=destination_agent_pool \
--intermediate-storage-path=gs://my-intermediary-bucket
REST
Contoh berikut menunjukkan cara menggunakan Storage Transfer Service melalui REST API.
Saat mengonfigurasi atau mengedit tugas transfer menggunakan Storage Transfer Service API, waktu harus dalam UTC. Untuk mengetahui informasi selengkapnya tentang cara menentukan jadwal tugas transfer, lihat Jadwalkan.
Melakukan transfer antar bucket Cloud Storage
Dalam contoh ini, Anda akan mempelajari cara memindahkan file dari satu bucket Cloud Storage ke bucket lainnya. Misalnya, Anda dapat memindahkan data ke bucket di lokasi lain.
Permintaan menggunakan transferJobs create:
POST https://storagetransfer.googleapis.com/v1/transferJobs { "description": "YOUR DESCRIPTION", "status": "ENABLED", "projectId": "PROJECT_ID", "schedule": { "scheduleStartDate": { "day": 1, "month": 1, "year": 2015 }, "startTimeOfDay": { "hours": 1, "minutes": 1 } }, "transferSpec": { "gcsDataSource": { "bucketName": "GCS_SOURCE_NAME" }, "gcsDataSink": { "bucketName": "GCS_SINK_NAME" }, "transferOptions": { "deleteObjectsFromSourceAfterTransfer": true } } }
200 OK { "transferJob": [ { "creationTime": "2015-01-01T01:01:00.000000000Z", "description": "YOUR DESCRIPTION", "name": "transferJobs/JOB_ID", "status": "ENABLED", "lastModificationTime": "2015-01-01T01:01:00.000000000Z", "projectId": "PROJECT_ID", "schedule": { "scheduleStartDate": { "day": 1, "month": 1, "year": 2015 }, "startTimeOfDay": { "hours": 1, "minutes": 1 } }, "transferSpec": { "gcsDataSource": { "bucketName": "GCS_SOURCE_NAME", }, "gcsDataSink": { "bucketName": "GCS_NEARLINE_SINK_NAME" }, "objectConditions": { "minTimeElapsedSinceLastModification": "2592000.000s" }, "transferOptions": { "deleteObjectsFromSourceAfterTransfer": true } } } ] }
Transfer dari Amazon S3 ke Cloud Storage
Lihat Mentransfer dari Amazon S3 ke Cloud Storage.
Mentransfer data antara Microsoft Azure Blob Storage dan Cloud Storage
Dalam contoh ini, Anda akan mempelajari cara memindahkan file dari Microsoft Azure Storage ke bucket Cloud Storage, menggunakan token tanda tangan akses bersama (SAS) Microsoft Azure Storage.
Untuk mengetahui informasi selengkapnya tentang SAS Microsoft Azure Storage, lihat Memberikan akses terbatas ke resource Azure Storage menggunakan tanda tangan akses bersama (SAS).
Sebelum memulai, tinjau Mengonfigurasi akses ke Microsoft Azure Storage dan Harga untuk memahami implikasi pemindahan data dari Microsoft Azure Storage ke Cloud Storage.
Permintaan menggunakan transferJobs create:
POST https://storagetransfer.googleapis.com/v1/transferJobs { "description": "YOUR DESCRIPTION", "status": "ENABLED", "projectId": "PROJECT_ID", "schedule": { "scheduleStartDate": { "day": 14, "month": 2, "year": 2020 }, "scheduleEndDate": { "day": 14 "month": 2, "year": 2020 }, "startTimeOfDay": { "hours": 1, "minutes": 1 } }, "transferSpec": { "azureBlobStorageDataSource": { "storageAccount": "AZURE_SOURCE_NAME", "azureCredentials": { "sasToken": "AZURE_SAS_TOKEN", }, "container": "AZURE_CONTAINER", }, "gcsDataSink": { "bucketName": "GCS_SINK_NAME" } } }
200 OK { "transferJob": [ { "creationTime": "2020-02-14T01:01:00.000000000Z", "description": "YOUR DESCRIPTION", "name": "transferJobs/JOB_ID", "status": "ENABLED", "lastModificationTime": "2020-02-14T01:01:00.000000000Z", "projectId": "PROJECT_ID", "schedule": { "scheduleStartDate": { "day": 14 "month": 2, "year": 2020 }, "scheduleEndDate": { "day": 14, "month": 2, "year": 2020 }, "startTimeOfDay": { "hours": 1, "minutes": 1 } }, "transferSpec": { "azureBlobStorageDataSource": { "storageAccount": "AZURE_SOURCE_NAME", "azureCredentials": { "sasToken": "AZURE_SAS_TOKEN", }, "container": "AZURE_CONTAINER", }, "objectConditions": {}, "transferOptions": {} } } ] }
Mentransfer dari sistem file
Lihat Mentransfer dari sistem file ke Cloud Storage.
Menentukan jalur sumber dan tujuan
Jalur sumber dan tujuan memungkinkan Anda menentukan direktori sumber dan tujuan saat mentransfer data ke bucket Cloud Storage. Misalnya, Anda memiliki file file1.txt
dan file2.txt
serta bucket Cloud Storage bernama B
. Jika Anda menetapkan jalur tujuan bernama
my-stuff
, maka setelah transfer selesai, file Anda akan berada di
gs://B/my-stuff/file1.txt
dan gs://B/my-stuff/file2.txt
.
Menentukan jalur sumber
Untuk menentukan jalur sumber saat membuat tugas transfer, tambahkan kolom path
ke
kolom gcsDataSource
dalam spesifikasi
TransferSpec
Anda:
{ gcsDataSource: { bucketName: "SOURCE_BUCKET", path: "SOURCE_PATH/", }, }
Dalam contoh ini:
- SOURCE_BUCKET: Bucket Cloud Storage sumber.
- SOURCE_PATH: Jalur Cloud Storage sumber.
Menentukan jalur tujuan
Untuk menentukan folder tujuan saat Anda membuat tugas transfer, tambahkan kolom path
ke kolom gcsDataSink
dalam spesifikasi
TransferSpec
Anda:
{ gcsDataSink: { bucketName: "DESTINATION_BUCKET", path: "DESTINATION_PATH/", }, }
Dalam contoh ini:
- DESTINATION_BUCKET: Bucket Cloud Storage tujuan.
- DESTINATION_PATH: Jalur Cloud Storage tujuan.
Contoh permintaan lengkap
Berikut adalah contoh permintaan lengkap:
POST https://storagetransfer.googleapis.com/v1/transferJobs { "description": "YOUR DESCRIPTION", "status": "ENABLED", "projectId": "PROJECT_ID", "schedule": { "scheduleStartDate": { "day": 1, "month": 1, "year": 2015 }, "startTimeOfDay": { "hours": 1, "minutes": 1 } }, "transferSpec": { "gcsDataSource": { "bucketName": "GCS_SOURCE_NAME", "path": "GCS_SOURCE_PATH", }, "gcsDataSink": { "bucketName": "GCS_SINK_NAME", "path": "GCS_SINK_PATH", }, "objectConditions": { "minTimeElapsedSinceLastModification": "2592000s" }, "transferOptions": { "deleteObjectsFromSourceAfterTransfer": true } } }
Library klien
Contoh berikut menunjukkan cara menggunakan Storage Transfer Service secara terprogram dengan Go, Java, Node.js, dan Python.
Saat Anda mengonfigurasi atau mengedit tugas transfer secara terprogram, waktu harus dalam UTC. Untuk mengetahui informasi selengkapnya tentang cara menentukan jadwal tugas transfer, lihat Jadwalkan.
Untuk mengetahui informasi selengkapnya tentang library klien Storage Transfer Service, lihat Mulai menggunakan library klien Storage Transfer Service.
Melakukan transfer antar bucket Cloud Storage
Dalam contoh ini, Anda akan mempelajari cara memindahkan file dari satu bucket Cloud Storage ke bucket lainnya. Misalnya, Anda dapat memindahkan data ke bucket di lokasi lain.
Go
Java
Mencari contoh yang lebih lama? Lihat Panduan Migrasi Storage Transfer Service.
Node.js
Python
Mencari contoh yang lebih lama? Lihat Panduan Migrasi Storage Transfer Service.
Transfer dari Amazon S3 ke Cloud Storage
Lihat Mentransfer dari Amazon S3 ke Cloud Storage.
Mentransfer data antara Microsoft Azure Blob Storage dan Cloud Storage
Dalam contoh ini, Anda akan mempelajari cara memindahkan file dari Microsoft Azure Storage ke bucket Cloud Storage, menggunakan token tanda tangan akses bersama (SAS) Microsoft Azure Storage.
Untuk mengetahui informasi selengkapnya tentang SAS Microsoft Azure Storage, lihat Memberikan akses terbatas ke resource Azure Storage menggunakan tanda tangan akses bersama (SAS).
Sebelum memulai, tinjau Mengonfigurasi akses ke Microsoft Azure Storage dan Harga untuk memahami implikasi pemindahan data dari Microsoft Azure Storage ke Cloud Storage.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Storage Transfer Service, lihat library klien Storage Transfer Service. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Storage Transfer Service.
Untuk melakukan autentikasi ke Storage Transfer Service, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Storage Transfer Service, lihat library klien Storage Transfer Service. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Storage Transfer Service.
Untuk melakukan autentikasi ke Storage Transfer Service, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Storage Transfer Service, lihat library klien Storage Transfer Service. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Storage Transfer Service.
Untuk melakukan autentikasi ke Storage Transfer Service, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Storage Transfer Service, lihat library klien Storage Transfer Service. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Storage Transfer Service.
Untuk melakukan autentikasi ke Storage Transfer Service, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.