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

# Options
<a name="API_Options"></a>

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](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).

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

## Daftar Isi
<a name="API_Options_Contents"></a>

 ** Atime **   <a name="DataSync-Type-Options-Atime"></a>
Menentukan apakah untuk mempertahankan metadata yang menunjukkan terakhir kali file dibaca atau ditulis ke.  
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` langkah-langkah pelaksanaan tugas). Opsi ini direkomendasikan.
+  `NONE`- Mengabaikan. `Atime`
Jika `Atime` diatur ke`BEST_EFFORT`, `Mtime` harus diatur ke`PRESERVE`.   
Jika `Atime` diatur ke`NONE`, `Mtime` harus juga`NONE`. 
Tipe: String  
Nilai yang Valid: `NONE | BEST_EFFORT`   
Wajib: Tidak

 ** BytesPerSecond **   <a name="DataSync-Type-Options-BytesPerSecond"></a>
Membatasi bandwidth yang digunakan oleh DataSync tugas. Misalnya, jika Anda mau DataSync untuk menggunakan maksimal 1 MB, atur nilai ini ke `1048576` (`=1024*1024`).  
Tipe: Long  
Rentang yang Valid: Nilai minimum -1.  
Wajib: Tidak

 ** Gid **   <a name="DataSync-Type-Options-Gid"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
Tipe: String  
Nilai yang Valid: `NONE | INT_VALUE | NAME | BOTH`   
Wajib: Tidak

 ** LogLevel **   <a name="DataSync-Type-Options-LogLevel"></a>
Menentukan jenis log yang DataSync diterbitkan ke grup CloudWatch log Amazon Logs. Untuk menentukan grup log, lihat [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-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 diterbitkan.
Tipe: String  
Nilai yang Valid: `OFF | BASIC | TRANSFER`   
Wajib: Tidak

 ** Mtime **   <a name="DataSync-Type-Options-Mtime"></a>
Menentukan apakah akan mempertahankan metadata yang menunjukkan terakhir kali file ditulis sebelum `PREPARING` langkah pelaksanaan tugas Anda. Opsi ini diperlukan ketika Anda perlu menjalankan tugas lebih dari sekali.  
+  `PRESERVE`(default) - Mempertahankan asli`Mtime`, yang direkomendasikan.
+  `NONE`- Mengabaikan. `Mtime`
Jika `Mtime` diatur ke`PRESERVE`, `Atime` harus diatur ke`BEST_EFFORT`.  
Jika `Mtime` diatur ke`NONE`, juga `Atime` harus diatur ke`NONE`. 
Tipe: String  
Nilai yang Valid: `NONE | PRESERVE`   
Wajib: Tidak

 ** ObjectTags **   <a name="DataSync-Type-Options-ObjectTags"></a>
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.  
Tipe: String  
Nilai yang Valid: `PRESERVE | NONE`   
Wajib: Tidak

 ** OverwriteMode **   <a name="DataSync-Type-Options-OverwriteMode"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `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.
Tipe: String  
Nilai yang Valid: `ALWAYS | NEVER`   
Wajib: Tidak

 ** PosixPermissions **   <a name="DataSync-Type-Options-PosixPermissions"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `PRESERVE`(default) - Mempertahankan izin gaya POSIX, yang direkomendasikan.
+  `NONE`- Mengabaikan izin gaya POSIX. 
DataSync dapat mempertahankan izin yang masih ada dari lokasi sumber.
Tipe: String  
Nilai yang Valid: `NONE | PRESERVE`   
Wajib: Tidak

 ** PreserveDeletedFiles **   <a name="DataSync-Type-Options-PreserveDeletedFiles"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) di. DataSync  
+  `PRESERVE`(default) - Mengabaikan file tujuan tersebut, yang direkomendasikan. 
+  `REMOVE`- Menghapus file tujuan yang tidak ada di sumber.
Jika Anda menyetel parameter ini`REMOVE`, Anda tidak dapat mengatur `TransferMode` ke`ALL`. Ketika Anda mentransfer semua data, DataSync tidak memindai lokasi tujuan Anda dan tidak tahu apa yang harus dihapus.
Tipe: String  
Nilai yang Valid: `PRESERVE | REMOVE`   
Wajib: Tidak

 ** PreserveDevices **   <a name="DataSync-Type-Options-PreserveDevices"></a>
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.  
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.
Tipe: String  
Nilai yang Valid: `NONE | PRESERVE`   
Wajib: Tidak

 ** SecurityDescriptorCopyFlags **   <a name="DataSync-Type-Options-SecurityDescriptorCopyFlags"></a>
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 FSx untuk lokasi Windows File Server. Untuk informasi selengkapnya, lihat [Memahami cara DataSync menangani metadata file dan objek](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `OWNER_DACL`(default) - Untuk setiap objek yang disalin, salin DataSync metadata berikut:
  + Pemilik objek.
  + Daftar kontrol akses diskresioner NTFS (DACLs), yang menentukan apakah akan memberikan akses ke objek.

    DataSync tidak akan menyalin daftar kontrol akses sistem NTFS (SACLs) dengan opsi ini.
+  `OWNER_DACL_SACL`- Untuk setiap objek yang disalin, salin DataSync metadata berikut:
  + Pemilik objek.
  + Daftar kontrol akses diskresioner NTFS (DACLs), yang menentukan apakah akan memberikan akses ke objek.
  + SACLs, yang digunakan oleh administrator untuk mencatat upaya untuk mengakses objek aman.

    Menyalin SACLs 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx untuk Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions), atau [FSx untuk ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (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. 
Tipe: String  
Nilai yang Valid: `NONE | OWNER_DACL | OWNER_DACL_SACL`   
Wajib: Tidak

 ** TaskQueueing **   <a name="DataSync-Type-Options-TaskQueueing"></a>
Menentukan apakah tugas transfer Anda harus dimasukkan ke dalam antrian selama skenario tertentu saat [menjalankan beberapa](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks) tugas. Ini secara `ENABLED` default.  
Tipe: String  
Nilai yang Valid: `ENABLED | DISABLED`   
Wajib: Tidak

 ** TransferMode **   <a name="DataSync-Type-Options-TransferMode"></a>
Menentukan apakah DataSync transfer hanya data (termasuk metadata) yang berbeda antara lokasi setelah salinan awal atau mentransfer semua data setiap kali Anda menjalankan tugas. Jika Anda berencana melakukan transfer berulang, Anda mungkin hanya ingin mentransfer apa yang telah diubah sejak eksekusi tugas sebelumnya.  
+  `CHANGED`(default) - Setelah transfer penuh awal Anda, DataSync salin hanya data dan metadata yang berbeda antara lokasi sumber dan tujuan.
+  `ALL`- DataSync menyalin semua yang ada di sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.
Tipe: String  
Nilai yang Valid: `CHANGED | ALL`   
Wajib: Tidak

 ** Uid **   <a name="DataSync-Type-Options-Uid"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied) oleh. DataSync  
Tipe: String  
Nilai yang Valid: `NONE | INT_VALUE | NAME | BOTH`   
Wajib: Tidak

 ** VerifyMode **   <a name="DataSync-Type-Options-VerifyMode"></a>
Menentukan apakah dan bagaimana DataSync memeriksa integritas data Anda di akhir transfer Anda.  
+  `ONLY_FILES_TRANSFERRED`(disarankan) - DataSync menghitung checksum data yang ditransfer (termasuk metadata) di lokasi sumber. Pada akhir transfer, DataSync kemudian membandingkan checksum ini dengan checksum yang dihitung pada data di tujuan.
**catatan**  
Ini adalah opsi default untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

  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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `POINT_IN_TIME_CONSISTENT`- Di akhir transfer, DataSync periksa seluruh sumber dan tujuan untuk memverifikasi bahwa kedua lokasi disinkronkan sepenuhnya.
**catatan**  
Ini adalah opsi default untuk [tugas mode Dasar](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) dan saat ini tidak didukung dengan tugas mode yang Ditingkatkan.

  Jika Anda menggunakan [manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NONE`- DataSync melakukan pemeriksaan integritas data hanya selama transfer Anda. Tidak seperti opsi lain, tidak ada verifikasi tambahan di akhir transfer Anda.
Tipe: String  
Nilai yang Valid: `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE`   
Wajib: Tidak

## Lihat Juga
<a name="API_Options_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options)