Options - AWS DataSync
Daftar IsiLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Options

Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.

Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon StartTaskExecution.

Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin LogLevel menyesuaikan eksekusi individual.

Daftar Isi

Atime

Menentukan apakah untuk melestarikan metadata yang menunjukkan terakhir kali file dibaca atau ditulis ke.

catatan

Perilaku Atime tidak sepenuhnya standar di seluruh platform, jadi hanya DataSync dapat melakukan ini dengan upaya terbaik.

  • BEST_EFFORT(default) - DataSync upaya untuk mempertahankan Atime atribut asli pada semua file sumber (yaitu, versi sebelum PREPARING fase eksekusi tugas). Opsi ini direkomendasikan.

  • NONE- Mengabaikan. Atime

catatan

Jika Atime diatur keBEST_EFFORT, Mtime harus disetel kePRESERVE.

Jika Atime diatur keNONE, Mtime harus jugaNONE.

Jenis: String

Nilai yang Valid: NONE | BEST_EFFORT

Wajib: Tidak

BytesPerSecond

Membatasi bandwidth yang digunakan oleh DataSync tugas. Misalnya, jika Anda DataSync ingin menggunakan maksimum 1 MB, atur nilai ini ke 1048576 (=1024*1024).

Tipe: Long

Rentang yang Valid: Nilai minimum -1.

Wajib: Tidak

Gid

Menentukan POSIX grup ID (GID) dari pemilik file.

  • INT_VALUE(default) - Mempertahankan nilai integer ID pengguna (UID) dan GID, yang direkomendasikan.

  • NONE- Mengabaikan UID dan GID.

Untuk informasi selengkapnya, lihat Memahami cara DataSync menangani metadata file dan objek.

Jenis: String

Nilai yang Valid: NONE | INT_VALUE | NAME | BOTH

Wajib: Tidak

LogLevel

Menentukan jenis log yang DataSync diterbitkan ke grup CloudWatch log Amazon Logs. Untuk menentukan grup log, lihat CloudWatchLogGroupArn.

  • BASIC- Menerbitkan log dengan hanya informasi dasar (seperti kesalahan transfer).

  • TRANSFER- Menerbitkan log untuk semua file atau objek yang ditransfer DataSync tugas Anda dan melakukan pemeriksaan integritas data.

  • OFF- Tidak ada log yang dipublikasikan.

Jenis: String

Nilai yang Valid: OFF | BASIC | TRANSFER

Wajib: Tidak

Mtime

Menentukan apakah akan mempertahankan metadata yang menunjukkan terakhir kali file ditulis sebelum PREPARING fase pelaksanaan tugas Anda. Opsi ini diperlukan ketika Anda perlu menjalankan tugas lebih dari sekali.

  • PRESERVE(default) - Mempertahankan asliMtime, yang direkomendasikan.

  • NONE- Mengabaikan. Mtime

catatan

Jika Mtime diatur kePRESERVE, Atime harus disetel keBEST_EFFORT.

Jika Mtime diatur keNONE, juga Atime harus disetel keNONE.

Jenis: String

Nilai yang Valid: NONE | PRESERVE

Wajib: Tidak

ObjectTags

Menentukan apakah Anda DataSync ingin PRESERVE objek tag (perilaku default) ketika mentransfer antara sistem penyimpanan objek. Jika Anda ingin DataSync tugas Anda mengabaikan tag objek, tentukan NONE nilainya.

Jenis: String

Nilai yang Valid: PRESERVE | NONE

Wajib: Tidak

OverwriteMode

Menentukan apakah DataSync harus memodifikasi atau melestarikan data di lokasi tujuan.

  • ALWAYS(default) - DataSync memodifikasi data di lokasi tujuan ketika data sumber (termasuk metadata) telah berubah.

    Jika DataSync menimpa objek, Anda mungkin dikenakan biaya tambahan untuk kelas penyimpanan Amazon S3 tertentu (misalnya, untuk pengambilan atau penghapusan awal). Untuk informasi selengkapnya, lihat Pertimbangan kelas penyimpanan dengan transfer Amazon S3.

  • NEVER- DataSync tidak menimpa data di lokasi tujuan meskipun data sumber telah berubah. Anda dapat menggunakan opsi ini untuk melindungi terhadap perubahan timpa yang dibuat pada file atau objek di tujuan.

Jenis: String

Nilai yang Valid: ALWAYS | NEVER

Wajib: Tidak

PosixPermissions

Menentukan pengguna atau grup mana yang dapat mengakses file untuk tujuan tertentu seperti membaca, menulis, atau mengeksekusi file.

Untuk informasi selengkapnya, lihat Memahami cara DataSync menangani metadata file dan objek.

  • PRESERVE(default) - Mempertahankan izin gaya POSIX, yang direkomendasikan.

  • NONE- Mengabaikan izin gaya POSIX.

catatan

DataSync dapat mempertahankan izin yang masih ada dari lokasi sumber.

Jenis: String

Nilai yang Valid: NONE | PRESERVE

Wajib: Tidak

PreserveDeletedFiles

Menentukan apakah file di lokasi tujuan yang tidak ada di sumber harus dipertahankan. Opsi ini dapat memengaruhi biaya penyimpanan Amazon S3 Anda. Jika tugas Anda menghapus objek, Anda mungkin dikenakan biaya durasi penyimpanan minimum untuk kelas penyimpanan tertentu. Untuk informasi selengkapnya, lihat Pertimbangan saat bekerja dengan kelas penyimpanan Amazon S3 di. DataSync

  • PRESERVE(default) - Mengabaikan file tujuan tersebut, yang direkomendasikan.

  • REMOVE- Menghapus file tujuan yang tidak ada di sumber.

catatan

Jika Anda menyetel parameter iniREMOVE, Anda tidak dapat mengatur TransferMode keALL. Ketika Anda mentransfer semua data, DataSync tidak memindai lokasi tujuan Anda dan tidak tahu apa yang harus dihapus.

Jenis: String

Nilai yang Valid: PRESERVE | REMOVE

Wajib: Tidak

PreserveDevices

Menentukan apakah DataSync harus mempertahankan metadata perangkat blok dan karakter di lokasi sumber dan membuat ulang file dengan nama perangkat dan metadata di tujuan. DataSync hanya menyalin nama dan metadata perangkat tersebut.

catatan

DataSync tidak dapat menyalin konten sebenarnya dari perangkat ini karena mereka nonterminal dan tidak mengembalikan penanda end-of-file (EOF).

  • NONE(default) - Mengabaikan perangkat khusus (disarankan).

  • PRESERVE- Mempertahankan karakter dan memblokir metadata perangkat. Opsi ini saat ini tidak didukung untuk Amazon EFS.

Jenis: String

Nilai yang Valid: NONE | PRESERVE

Wajib: Tidak

SecurityDescriptorCopyFlags

Menentukan komponen deskriptor keamanan SMB yang disalin dari sumber ke objek tujuan.

Nilai ini hanya digunakan untuk transfer antara SMB dan Amazon FSx untuk lokasi Windows File Server atau antara dua lokasi FSx for Windows File Server. Untuk informasi selengkapnya, lihat Memahami cara DataSync menangani metadata file dan objek.

  • OWNER_DACL(default) - Untuk setiap objek yang disalin, salin DataSync metadata berikut:

    • Pemilik objek.

    • Daftar kontrol akses diskresi NTFS (DACLs), yang menentukan akan memberikan akses ke objek atau tidak.

      DataSync tidak akan menyalin daftar kontrol akses sistem NTFS (SACL) dengan opsi ini.

  • OWNER_DACL_SACL- Untuk setiap objek yang disalin, salin DataSync metadata berikut:

    • Pemilik objek.

    • Daftar kontrol akses diskresi NTFS (DACLs), yang menentukan akan memberikan akses ke objek atau tidak.

    • SACL, yang digunakan oleh administrator untuk mencatat upaya untuk mengakses objek aman.

      Menyalin SACL memerlukan pemberian izin tambahan kepada pengguna Windows yang DataSync menggunakan untuk mengakses lokasi SMB Anda. Untuk informasi tentang memilih pengguna dengan izin yang tepat, lihat izin yang diperlukan untuk SMB, FSx for Windows File Server, atau FSx untuk ONTAP (tergantung pada jenis lokasi dalam transfer Anda).

  • NONE- Tidak ada komponen deskriptor keamanan SMB yang disalin. Objek tujuan dimiliki oleh pengguna yang disediakan untuk mengakses lokasi tujuan. DACLs dan SACLs diatur berdasarkan konfigurasi server tujuan.

Jenis: String

Nilai yang Valid: NONE | OWNER_DACL | OWNER_DACL_SACL

Wajib: Tidak

TaskQueueing

Menentukan apakah tugas transfer Anda harus dimasukkan ke dalam antrian selama skenario tertentu saat menjalankan beberapa tugas. Ini secara ENABLED default.

Jenis: String

Nilai yang Valid: ENABLED | DISABLED

Wajib: Tidak

TransferMode

Menentukan apakah hanya DataSync mentransfer data dan metadata yang berbeda antara sumber dan lokasi tujuan atau mentransfer semua konten dari sumber (tanpa membandingkan apa yang ada di tujuan).

  • CHANGED(default) - DataSync menyalin hanya data atau metadata yang baru atau berbeda dari lokasi sumber ke lokasi tujuan.

  • ALL- DataSync menyalin semua yang ada di sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.

Jenis: String

Nilai yang Valid: CHANGED | ALL

Wajib: Tidak

Uid

Menentukan POSIX user ID (UID) dari pemilik file.

  • INT_VALUE(default) - Mempertahankan nilai integer UID dan ID grup (GID), yang direkomendasikan.

  • NONE- Mengabaikan UID dan GID.

Untuk informasi selengkapnya, lihat Metadata yang disalin oleh. DataSync

Jenis: String

Nilai yang Valid: NONE | INT_VALUE | NAME | BOTH

Wajib: Tidak

VerifyMode

Menentukan bagaimana dan kapan DataSync memeriksa integritas data Anda selama transfer.

  • ONLY_FILES_TRANSFERRED(disarankan) - DataSync menghitung checksum file yang ditransfer dan metadata di lokasi sumber. Pada akhir transfer, DataSync kemudian membandingkan checksum ini dengan checksum yang dihitung pada file-file di tujuan.

    Kami merekomendasikan opsi ini saat mentransfer ke kelas penyimpanan S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive. Untuk informasi selengkapnya, lihat Pertimbangan kelas penyimpanan dengan lokasi Amazon S3.

  • POINT_IN_TIME_CONSISTENT(default) - Pada akhir transfer, DataSync memindai seluruh sumber dan tujuan untuk memverifikasi bahwa kedua lokasi sepenuhnya disinkronkan.

    Jika Anda menggunakan manifes, DataSync hanya memindai dan memverifikasi apa yang tercantum dalam manifes.

    Anda tidak dapat menggunakan opsi ini saat mentransfer ke kelas penyimpanan S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive. Untuk informasi selengkapnya, lihat Pertimbangan kelas penyimpanan dengan lokasi Amazon S3.

  • NONE- DataSync tidak menjalankan verifikasi tambahan di akhir transfer. Semua transmisi data masih diperiksa integritasnya dengan verifikasi checksum selama proses transfer.

Jenis: String

Nilai yang Valid: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

Wajib: Tidak

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: