Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat tugas untuk mentransfer data Anda
Sebuah *tugas* menjelaskan di mana dan bagaimana AWS DataSync mentransfer data. Tugas terdiri dari yang berikut:
+ [**Lokasi sumber**](working-with-locations.md) — Sistem penyimpanan atau layanan tempat DataSync mentransfer data.
+ [**Lokasi tujuan**](working-with-locations.md) — Sistem penyimpanan atau layanan tempat DataSync mentransfer data ke.
+ [**Opsi tugas**](task-options.md) — Pengaturan seperti file apa yang akan ditransfer, bagaimana data diverifikasi, kapan tugas berjalan, dan banyak lagi.
+ [**Eksekusi tugas**](run-task.md) — Ketika Anda menjalankan tugas, itu disebut *eksekusi tugas*.
## Membuat tugas Anda
Saat Anda membuat DataSync tugas, Anda menentukan lokasi sumber dan tujuan Anda. Anda juga dapat menyesuaikan tugas Anda dengan memilih file mana yang akan ditransfer, bagaimana metadata ditangani, menyiapkan jadwal, dan banyak lagi.
Sebelum Anda membuat tugas, pastikan Anda memahami [cara kerja DataSync transfer](how-datasync-transfer-works.md#transferring-files) dan tinjau [kuota tugas](datasync-limits.md#task-hard-limits).
**penting**
Jika Anda berencana untuk mentransfer data ke atau dari lokasi Amazon S3, tinjau [bagaimana DataSync dapat memengaruhi biaya permintaan S3 Anda](create-s3-location.md#create-s3-location-s3-requests) dan [halaman DataSync harga sebelum memulai](https://aws.amazon.com/datasync/pricing/).
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Pastikan Anda berada di salah satu Wilayah AWS tempat Anda berencana untuk mentransfer data.
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Pada halaman **Konfigurasi lokasi sumber**, [buat](transferring-data-datasync.md) atau pilih lokasi sumber, lalu pilih **Berikutnya**.
1. Pada halaman **Konfigurasi lokasi tujuan**, [buat](transferring-data-datasync.md) atau pilih lokasi tujuan, lalu pilih **Berikutnya**.
1. (Disarankan) Pada halaman **Konfigurasi pengaturan**, berikan tugas Anda nama yang dapat Anda ingat.
1. Saat masih berada di halaman **Konfigurasi pengaturan**, pilih opsi tugas Anda atau gunakan pengaturan default.
Anda mungkin tertarik dengan beberapa opsi berikut:
+ Tentukan [mode tugas](choosing-task-mode.md) yang ingin Anda gunakan.
+ Tentukan data apa yang akan ditransfer dengan menggunakan [manifes](transferring-with-manifest.md) atau [filter](filtering.md).
+ Konfigurasikan cara [menangani metadata file](configure-metadata.md) dan [memverifikasi integritas data](configure-data-verification-options.md).
+ Pantau transfer Anda dengan [laporan tugas](task-reports.md) atau [Amazon CloudWatch](monitor-datasync.md). Sebaiknya siapkan semacam pemantauan untuk tugas Anda.
Setelah selesai, pilih **Berikutnya**.
1. Tinjau konfigurasi tugas Anda, lalu pilih **Buat tugas**.
Anda siap untuk [memulai tugas Anda](run-task.md).
### Menggunakan AWS CLI
Setelah [Anda membuat lokasi DataSync sumber dan tujuan](transferring-data-datasync.md), Anda dapat membuat tugas Anda.
1. Di AWS CLI pengaturan Anda, pastikan Anda menggunakan salah satu Wilayah AWS tempat yang Anda rencanakan untuk mentransfer data.
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name"
```
1. Untuk`--source-location-arn`, tentukan Nama Sumber Daya Amazon (ARN) dari lokasi sumber Anda.
1. Untuk`--destination-location-arn`, tentukan ARN lokasi tujuan Anda.
Jika Anda mentransfer lintas Wilayah AWS atau akun, pastikan ARN menyertakan Wilayah atau ID akun lainnya.
1. (Disarankan) Untuk`--name`, tentukan nama untuk tugas Anda yang dapat Anda ingat.
1. Tentukan opsi tugas lain sesuai kebutuhan. Anda mungkin tertarik dengan beberapa opsi berikut:
+ Tentukan data apa yang akan ditransfer dengan menggunakan [manifes](transferring-with-manifest.md) atau [filter](filtering.md).
+ Konfigurasikan cara [menangani metadata file](configure-metadata.md) dan [memverifikasi integritas data](configure-data-verification-options.md).
+ Pantau transfer Anda dengan [laporan tugas](task-reports.md) atau [Amazon CloudWatch](monitor-datasync.md). Sebaiknya siapkan semacam pemantauan untuk tugas Anda.
Untuk opsi lainnya, lihat [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Berikut adalah contoh `create-task` perintah yang menentukan beberapa pilihan:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--cloud-watch-log-group-arn "arn:aws:logs:region:account-id" \
--name "task-name" \
--options VerifyMode=NONE,OverwriteMode=NEVER,Atime=BEST_EFFORT,Mtime=PRESERVE,Uid=INT_VALUE,Gid=INT_VALUE,PreserveDevices=PRESERVE,PosixPermissions=PRESERVE,PreserveDeletedFiles=PRESERVE,TaskQueueing=ENABLED,LogLevel=TRANSFER
```
1. Jalankan perintah `create-task`.
Jika perintah berhasil, Anda mendapatkan respons yang menunjukkan ARN dari tugas yang Anda buat. Contoh:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Anda siap untuk [memulai tugas Anda](run-task.md).
## Status tugas
Saat membuat DataSync tugas, Anda dapat memeriksa statusnya untuk melihat apakah tugas tersebut siap dijalankan.
| Status konsol | Status API | Deskripsi |
| --- | --- | --- |
| Available | `AVAILABLE` | Tugas siap untuk mulai mentransfer data. |
| Berjalan | `RUNNING` | Eksekusi tugas sedang berlangsung. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](run-task.md#understand-task-execution-statuses). |
| Tidak tersedia | `UNAVAILABLE` | DataSync Agen yang digunakan oleh tugas sedang offline. Untuk informasi selengkapnya, lihat [Apa yang harus saya lakukan jika agen saya offline?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline) |
| Antre | `QUEUED` | Eksekusi tugas lain yang menggunakan DataSync agen yang sama sedang berlangsung. Untuk informasi selengkapnya, lihat [Mengetahui kapan tugas Anda antri](run-task.md#queue-task-execution). |
## Mempartisi kumpulan data besar dengan banyak tugas
Jika Anda mentransfer kumpulan data besar, seperti [memigrasikan](datasync-large-migration.md) jutaan file atau objek, sebaiknya gunakan mode DataSync Enhanced untuk transfer Anda, yang dapat mentransfer kumpulan data dengan jumlah file yang hampir tidak terbatas. Untuk kumpulan data yang sangat besar, dengan miliaran file, Anda harus mempertimbangkan untuk mempartisi kumpulan data Anda dengan banyak tugas. DataSync Mempartisi data Anda di beberapa tugas (dan mungkin [agen](do-i-need-datasync-agent.md#multiple-agents), tergantung pada lokasi Anda) membantu mengurangi waktu yang diperlukan DataSync untuk mempersiapkan dan mentransfer data Anda.
Pertimbangkan beberapa cara Anda dapat mempartisi kumpulan data besar di beberapa DataSync tugas:
+ Buat tugas yang mentransfer folder terpisah. Misalnya, Anda dapat membuat dua tugas yang menargetkan `/FolderA` dan`/FolderB`, masing-masing, di penyimpanan sumber Anda.
+ Buat tugas yang mentransfer subset file, objek, dan folder dengan menggunakan [manifes](transferring-with-manifest.md) atau [filter](filtering.md).
Berhati-hatilah bahwa pendekatan ini dapat meningkatkan I/O operasi pada penyimpanan Anda dan memengaruhi bandwidth jaringan Anda. Untuk informasi selengkapnya, lihat blog tentang [Cara mempercepat transfer data Anda dengan DataSync skala arsitektur](https://aws.amazon.com/blogs/storage/how-to-accelerate-your-data-transfers-with-aws-datasync-scale-out-architectures/).
## Segmentasi data yang ditransfer dengan banyak tugas
Jika Anda mentransfer kumpulan data yang berbeda ke tujuan yang sama, Anda dapat membuat beberapa tugas untuk membantu mengelompokkan data yang Anda transfer.
Misalnya, jika Anda mentransfer ke bucket S3 yang sama dengan nama`MyBucket`, Anda dapat membuat awalan berbeda di bucket yang sesuai dengan setiap tugas. Pendekatan ini mencegah konflik nama file kumpulan data dan memungkinkan Anda untuk mengatur izin yang berbeda untuk setiap awalan. Inilah cara Anda mengatur ini:
1. Buat tiga awalan di tujuan `MyBucket` bernama`task1`,`task2`, dan: `task3`
+ `s3://MyBucket/task1`
+ `s3://MyBucket/task2`
+ `s3://MyBucket/task3`
1. Buat tiga DataSync tugas bernama`task1`,`task2`, dan `task3` transfer ke awalan yang sesuai di`MyBucket`.
# Memilih mode tugas untuk transfer data Anda
AWS DataSync Tugas Anda dapat berjalan dalam salah satu mode berikut:
+ **Mode yang disempurnakan** — Transfer file atau objek dalam jumlah yang hampir tidak terbatas dengan kinerja lebih tinggi daripada mode Dasar. Tugas mode yang disempurnakan mengoptimalkan proses transfer data dengan mencantumkan, menyiapkan, mentransfer, dan memverifikasi data secara paralel. Mode yang disempurnakan saat ini tersedia untuk transfer antara lokasi Amazon S3, transfer antara Azure Blob dan Amazon S3 tanpa agen, transfer antara cloud lain dan Amazon S3 tanpa agen, dan transfer antara server file NFS atau SMB dan Amazon S3 menggunakan agen mode yang Ditingkatkan.
+ **Mode dasar** — Transfer file atau objek antara AWS penyimpanan dan semua DataSync lokasi lain yang didukung. Tugas mode dasar tunduk pada [kuota](datasync-limits.md) pada jumlah file, objek, dan direktori dalam kumpulan data. Mode dasar secara berurutan menyiapkan, mentransfer, dan memverifikasi data, membuatnya lebih lambat dari mode Enhanced untuk sebagian besar beban kerja.
## Memahami perbedaan mode tugas
Informasi berikut dapat membantu Anda menentukan mode tugas mana yang akan digunakan.
| Kemampuan | Perilaku mode yang ditingkatkan | Perilaku mode dasar |
| --- | --- | --- |
| [Performa](how-datasync-transfer-works.md#transferring-files) | DataSync daftar, menyiapkan, mentransfer, dan memverifikasi data Anda secara paralel. Memberikan kinerja yang lebih tinggi daripada mode Dasar untuk sebagian besar beban kerja (seperti mentransfer objek besar) | DataSync menyiapkan, mentransfer, dan memverifikasi data Anda secara berurutan. Performa lebih lambat dari mode Enhanced untuk sebagian besar beban kerja |
| Jumlah item dalam kumpulan data yang DataSync dapat bekerja dengan per eksekusi tugas | Jumlah objek yang hampir tidak terbatas | [Kuota berlaku](datasync-limits.md#task-hard-limits) |
| [Penghitung](transfer-performance-counters.md) [dan metrik transfer data](monitor-datasync.md) | Lebih banyak penghitung dan metrik daripada mode Dasar, seperti jumlah objek yang DataSync ditemukan di lokasi sumber Anda, berapa banyak objek yang disiapkan selama setiap eksekusi tugas, dan penghitung folder yang mirip dengan penghitung file dan objek | Penghitung dan metrik lebih sedikit dari mode yang Ditingkatkan |
| [Pencatatan log](configure-logging.md) | Log terstruktur (format JSON) | Log tidak terstruktur |
| [Lokasi yang didukung](working-with-locations.md) | Saat ini untuk transfer antara lokasi Amazon S3, transfer antara Azure Blob dan Amazon S3 tanpa agen, transfer antara cloud lain dan Amazon S3 tanpa agen, dan transfer antara server file NFS atau SMB dan Amazon S3 menggunakan agen mode yang Ditingkatkan. | Untuk transfer antar semua lokasi yang DataSync mendukung |
| [Opsi verifikasi data](configure-data-verification-options.md) | DataSync memverifikasi hanya data yang ditransfer | DataSync memverifikasi semua data secara default |
| Biaya | Untuk informasi lebih lanjut, lihat halaman [DataSync harga](https://aws.amazon.com/datasync/pricing) | Untuk informasi lebih lanjut, lihat halaman [DataSync harga](https://aws.amazon.com/datasync/pricing) |
| Penanganan kegagalan untuk tag objek yang tidak didukung | Untuk transfer penyimpanan cloud ke atau dari lokasi yang tidak mendukung penandaan objek, eksekusi tugas akan segera gagal jika ObjectTags opsi tidak didesain atau disetel ke. PRESERVE | Untuk transfer penyimpanan cloud ke atau dari lokasi yang tidak mendukung penandaan objek, eksekusi tugas akan berjalan normal, tetapi akan melaporkan kegagalan per objek untuk objek yang diberi tag jika ObjectTags opsi tidak ditentukan atau disetel ke. PRESERVE |
## Memilih mode tugas
Anda dapat memilih mode yang Ditingkatkan hanya untuk transfer antara lokasi Amazon S3, transfer antara Azure Blob dan Amazon S3 tanpa agen, transfer antara cloud lain dan Amazon S3 tanpa agen, dan transfer antara server file NFS atau SMB dan Amazon S3 menggunakan agen mode yang Ditingkatkan. Jika tidak, Anda harus menggunakan mode Dasar. Misalnya, transfer dari lokasi [HDFS lokal ke lokasi](create-hdfs-location.md) S3 memerlukan mode Dasar.
Opsi tugas dan kinerja Anda mungkin bervariasi tergantung pada mode tugas yang Anda pilih. Setelah Anda membuat tugas Anda, Anda tidak dapat mengubah mode tugas.
**Izin yang diperlukan**
Untuk membuat tugas mode Peningkatan, peran IAM yang Anda gunakan DataSync harus memiliki `iam:CreateServiceLinkedRole` izin.
Untuk izin DataSync pengguna Anda, pertimbangkan untuk menggunakan [AWSDataSyncFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-awsdatasyncfullaccess). Ini adalah kebijakan AWS terkelola yang memberikan akses penuh kepada pengguna DataSync dan akses minimal ke dependensinya.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Untuk **mode Tugas**, pilih salah satu opsi berikut:
+ **Ditingkatkan**
+ **Basic**
Untuk informasi selengkapnya, lihat [Memahami perbedaan mode tugas](#task-mode-differences).
1. Saat masih berada di halaman **Konfigurasi pengaturan**, pilih opsi tugas lain atau gunakan pengaturan default.
Anda mungkin tertarik dengan beberapa opsi berikut:
+ Tentukan data apa yang akan ditransfer dengan menggunakan [manifes](transferring-with-manifest.md) atau [filter](filtering.md).
+ Konfigurasikan cara [menangani metadata file](configure-metadata.md) dan [memverifikasi integritas data](configure-data-verification-options.md).
+ Pantau transfer Anda dengan [laporan tugas](task-reports.md) atau [ CloudWatch Log Amazon](monitor-datasync.md).
Setelah selesai, pilih **Berikutnya**.
1. Tinjau konfigurasi tugas Anda, lalu pilih **Buat tugas**.
### Menggunakan AWS CLI
1. Di AWS CLI pengaturan Anda, pastikan Anda menggunakan salah satu Wilayah AWS tempat yang Anda rencanakan untuk mentransfer data.
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--task-mode "ENHANCED-or-BASIC"
```
1. Untuk`--source-location-arn`, tentukan Nama Sumber Daya Amazon (ARN) dari lokasi sumber Anda.
1. Untuk`--destination-location-arn`, tentukan ARN lokasi tujuan Anda.
Jika Anda mentransfer lintas Wilayah AWS atau akun, pastikan ARN menyertakan Wilayah atau ID akun lainnya.
1. Untuk`--task-mode`, tentukan `ENHANCED` atau`BASIC`.
Untuk informasi selengkapnya, lihat [Memahami perbedaan mode tugas](#task-mode-differences).
1. Tentukan opsi tugas lain sesuai kebutuhan. Anda mungkin tertarik dengan beberapa opsi berikut:
+ Tentukan data apa yang akan ditransfer dengan menggunakan [manifes](transferring-with-manifest.md) atau [filter](filtering.md).
+ Konfigurasikan cara [menangani metadata file](configure-metadata.md) dan [memverifikasi integritas data](configure-data-verification-options.md).
+ Pantau transfer Anda dengan [laporan tugas](task-reports.md) atau [ CloudWatch Log Amazon](monitor-datasync.md).
Untuk opsi lainnya, lihat [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). Berikut adalah contoh `create-task` perintah yang menentukan mode Enhanced dan beberapa opsi lainnya:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name" \
--task-mode "ENHANCED" \
--options TransferMode=CHANGED,VerifyMode=ONLY_FILES_TRANSFERRED,ObjectTags=PRESERVE,LogLevel=TRANSFER
```
1. Jalankan perintah `create-task`.
Jika perintah berhasil, Anda mendapatkan respons yang menunjukkan ARN dari tugas yang Anda buat. Contoh:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
### Menggunakan DataSync API
Anda dapat menentukan mode DataSync tugas dengan mengonfigurasi `TaskMode` parameter dalam [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)operasi.
# Memilih AWS DataSync transfer apa
AWS DataSync memungkinkan Anda memilih apa yang akan ditransfer dan bagaimana Anda ingin data Anda ditangani. Beberapa opsi meliputi:
+ Mentransfer daftar file atau objek yang tepat dengan menggunakan manifes.
+ Termasuk atau tidak termasuk jenis data tertentu dalam transfer Anda dengan menggunakan filter.
+ Untuk transfer berulang, hanya memindahkan data yang diubah sejak transfer terakhir
+ Menimpa data di lokasi tujuan agar sesuai dengan apa yang ada di lokasi sumber.
+ Memilih metadata file atau objek mana yang akan disimpan di antara lokasi penyimpanan Anda.
**Topics**
+ [Mentransfer file atau objek tertentu dengan menggunakan manifes](transferring-with-manifest.md)
+ [Mentransfer file, objek, dan folder tertentu dengan menggunakan filter](filtering.md)
+ [Memahami cara DataSync menangani metadata file dan objek](metadata-copied.md)
+ [Tautan dan direktori disalin oleh AWS DataSync](special-files-copied.md)
+ [Mengkonfigurasi cara menangani file, objek, dan metadata](configure-metadata.md)
# Mentransfer file atau objek tertentu dengan menggunakan manifes
*Manifes* adalah daftar file atau objek yang AWS DataSync ingin Anda transfer. Misalnya, alih-alih harus mentransfer semuanya dalam bucket S3 dengan jutaan objek yang berpotensi, hanya DataSync mentransfer objek yang Anda daftarkan dalam manifes Anda.
Manifes mirip dengan [filter](filtering.md) tetapi memungkinkan Anda mengidentifikasi dengan tepat file atau objek mana yang akan ditransfer alih-alih data yang cocok dengan pola filter.
**catatan**
Ukuran maksimum yang diijinkan untuk file manifes dengan tugas mode yang Ditingkatkan adalah 20 GB.
## Membuat manifes Anda
Manifes adalah file berformat nilai dipisahkan koma (CSV) yang mencantumkan file atau objek di lokasi sumber yang ingin Anda transfer. DataSync Jika sumber Anda adalah bucket S3, Anda juga dapat menyertakan versi objek mana yang akan ditransfer.
**Topics**
+ [Pedoman](#transferring-with-manifest-guidelines)
+ [Contoh manifes](#manifest-examples)
### Pedoman
Gunakan panduan ini untuk membantu Anda membuat manifes yang berfungsi DataSync.
------
#### [ Do ]
+ Tentukan jalur lengkap setiap file atau objek yang ingin Anda transfer.
Anda tidak dapat menentukan hanya direktori atau folder dengan maksud mentransfer semua isinya. Untuk situasi ini, pertimbangkan untuk menggunakan [filter include](filtering.md) alih-alih manifes.
+ Pastikan bahwa setiap file atau path objek relatif terhadap jalur mount, folder, direktori, atau awalan yang Anda tentukan saat mengonfigurasi lokasi DataSync sumber Anda.
Misalnya, katakanlah Anda [mengonfigurasi lokasi S3](create-s3-location.md#create-s3-location-how-to) dengan awalan bernama. `photos` Awalan itu mencakup objek `my-picture.png` yang ingin Anda transfer. Dalam manifes, Anda hanya perlu menentukan objek (`my-picture.png`) alih-alih awalan dan objek (`photos/my-picture.png`).
+ Untuk menentukan versi objek Amazon S3 IDs, pisahkan path objek dan ID versi dengan menggunakan koma.
Contoh berikut menunjukkan entri manifes dengan dua bidang. Bidang pertama mencakup objek bernama`picture1.png`. Bidang kedua dipisahkan oleh koma dan menyertakan ID versi`111111`:
```
picture1.png,111111
```
+ Gunakan tanda kutip dalam situasi berikut:
+ Ketika jalur berisi karakter khusus (koma, tanda kutip, dan akhiran baris):
`"filename,with,commas.txt"`
+ Saat jalur mencakup beberapa baris:
```
"this
is
a
filename.txt"
```
+ Ketika sebuah jalur menyertakan tanda kutip:
`filename""with""quotes.txt`
Ini mewakili jalur bernama`filename"with"quotes.txt`.
Aturan kutipan ini juga berlaku untuk bidang ID versi. Secara umum, jika bidang manifes memiliki kutipan, Anda harus menghindarinya dengan kutipan lain.
+ Pisahkan setiap entri file atau objek dengan baris baru.
Anda dapat memisahkan baris dengan menggunakan Linux (line feed atau carriage return) atau Windows (carriage return diikuti oleh line feed) style line break.
+ Simpan manifes Anda (misalnya, `my-manifest.csv` atau`my-manifest.txt`).
+ Unggah manifes ke bucket S3 yang [DataSync dapat diakses](#transferring-with-manifest-access).
Bucket ini tidak harus berada di akun yang sama Wilayah AWS atau di mana Anda menggunakan DataSync.
------
#### [ Don't ]
+ Tentukan hanya direktori atau folder dengan maksud mentransfer semua isinya.
Manifes hanya dapat menyertakan jalur lengkap ke file atau objek yang ingin Anda transfer. Jika Anda mengonfigurasi lokasi sumber untuk menggunakan jalur pemasangan, folder, direktori, atau awalan tertentu, Anda tidak perlu menyertakannya dalam manifes Anda.
+ Tentukan jalur file atau objek yang melebihi 4.096 karakter.
+ Tentukan jalur file, jalur objek, atau ID versi objek Amazon S3 yang melebihi 1.024 byte.
+ Tentukan file duplikat atau jalur objek.
+ Sertakan ID versi objek jika lokasi sumber Anda bukan bucket S3.
+ Sertakan lebih dari dua bidang dalam entri manifes.
Entri hanya dapat menyertakan file atau jalur objek dan (jika ada) ID versi objek Amazon S3.
+ Sertakan karakter yang tidak sesuai dengan pengkodean UTF-8.
+ Sertakan spasi yang tidak disengaja di bidang entri Anda di luar tanda kutip.
------
### Contoh manifes
Gunakan contoh ini untuk membantu Anda membuat manifes yang berfungsi DataSync.
**Manifestasi dengan jalur file atau objek lengkap**
Contoh berikut menunjukkan manifes dengan file lengkap atau jalur objek untuk mentransfer.
```
photos/picture1.png
photos/picture2.png
photos/picture3.png
```
**Manifestasi hanya dengan kunci objek**
Contoh berikut menunjukkan manifes dengan objek yang akan ditransfer dari lokasi sumber Amazon S3. Karena [lokasi dikonfigurasi](create-s3-location.md#create-s3-location-how-to) dengan awalan`photos`, hanya kunci objek yang ditentukan.
```
picture1.png
picture2.png
picture3.png
```
**Manifestasi dengan jalur objek dan versi IDs**
Dua entri pertama dalam contoh manifes berikut menyertakan versi objek Amazon S3 tertentu untuk ditransfer.
```
photos/picture1.png,111111
photos/picture2.png,121212
photos/picture3.png
```
**Manifestasi dengan karakter UTF-8**
Contoh berikut menunjukkan manifes dengan file yang menyertakan karakter UTF-8.
```
documents/résumé1.pdf
documents/résumé2.pdf
documents/résumé3.pdf
```
## Menyediakan DataSync akses ke manifes Anda
Anda memerlukan peran AWS Identity and Access Management (IAM) yang memberikan DataSync akses ke manifes Anda di bucket S3-nya. Peran ini harus menyertakan izin berikut:
+ `s3:GetObject`
+ `s3:GetObjectVersion`
Anda dapat menghasilkan peran ini secara otomatis di DataSync konsol atau membuat peran sendiri.
**catatan**
Jika manifes Anda berbeda Akun AWS, Anda harus membuat peran ini secara manual.
### Membuat peran IAM secara otomatis
Saat membuat atau memulai tugas transfer di konsol, DataSync dapat membuat peran IAM untuk Anda dengan `s3:GetObjectVersion` izin `s3:GetObject` dan yang Anda perlukan untuk mengakses manifes Anda.
**Izin yang diperlukan untuk membuat peran secara otomatis**
Untuk membuat peran secara otomatis, pastikan peran yang Anda gunakan untuk mengakses DataSync konsol memiliki izin berikut:
+ `iam:CreateRole`
+ `iam:CreatePolicy`
+ `iam:AttachRolePolicy`
### Membuat peran IAM (akun yang sama)
Anda dapat membuat peran IAM secara manual yang DataSync perlu mengakses manifes Anda. Instruksi berikut mengasumsikan bahwa Anda berada di tempat yang sama dengan Akun AWS tempat yang Anda gunakan DataSync dan bucket S3 manifes Anda berada.
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di panel navigasi kiri, di bawah **Manajemen akses**, pilih **Peran**, lalu pilih **Buat peran**.
1. Pada halaman **Pilih entitas tepercaya**, untuk **jenis entitas Tepercaya**, pilih **Layanan AWS**.
1. Untuk **kasus Penggunaan**, pilih **DataSync**di daftar dropdown dan pilih. **DataSync** Pilih **Berikutnya**.
1. Pada halaman **Tambahkan izin**, pilih **Berikutnya**. Beri nama peran Anda dan pilih **Buat peran**.
1. Pada halaman **Peran**, cari peran yang baru saja Anda buat dan pilih namanya.
1. Pada halaman detail peran, pilih tab **Izin**. Pilih **Tambahkan izin** lalu **Buat kebijakan sebaris**.
1. Pilih tab **JSON** dan tempelkan kebijakan sampel berikut ke editor kebijakan:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. Dalam kebijakan sampel yang baru saja Anda tempelkan, ganti nilai berikut dengan milik Anda sendiri:
1. Ganti `amzn-s3-demo-bucket` dengan nama bucket S3 yang menghosting manifes Anda.
1. Ganti `my-manifest.csv` dengan nama file manifes Anda.
1. Pilih **Berikutnya**. Beri nama kebijakan Anda dan pilih **Buat kebijakan**.
1. (Disarankan) Untuk mencegah [masalah wakil lintas layanan yang membingungkan](cross-service-confused-deputy-prevention.md), lakukan hal berikut:
1. Pada halaman detail peran, pilih tab **Trust relationship**. Pilih **Edit kebijakan kepercayaan**.
1. Perbarui kebijakan kepercayaan dengan menggunakan contoh berikut, yang mencakup kunci konteks kondisi `aws:SourceAccount` global `aws:SourceArn` dan global:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "555555555555"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*"
}
}
}
]
}
```
------
+ Ganti setiap instance `account-id` dengan Akun AWS ID tempat Anda menggunakan DataSync.
+ Ganti `region` dengan Wilayah AWS tempat yang Anda gunakan DataSync.
1. Pilih **Perbarui kebijakan**.
Anda telah membuat peran IAM yang memungkinkan DataSync untuk mengakses manifes Anda. Tentukan peran ini saat [membuat](#manifest-creating-task) atau [memulai](#manifest-starting-task) tugas Anda.
### Membuat peran IAM (akun berbeda)
Jika manifes Anda berada di bucket S3 milik yang berbeda Akun AWS, Anda harus membuat peran IAM yang DataSync digunakan secara manual untuk mengakses manifes. Kemudian, di Akun AWS tempat manifes Anda berada, Anda harus menyertakan peran tersebut dalam kebijakan bucket S3.
#### Menciptakan peran
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di panel navigasi kiri, di bawah **Manajemen akses**, pilih **Peran**, lalu pilih **Buat peran**.
1. Pada halaman **Pilih entitas tepercaya**, untuk **jenis entitas Tepercaya**, pilih **Layanan AWS**.
1. Untuk **kasus Penggunaan**, pilih **DataSync**di daftar dropdown dan pilih. **DataSync** Pilih **Berikutnya**.
1. Pada halaman **Tambahkan izin**, pilih **Berikutnya**. Beri nama peran Anda dan pilih **Buat peran**.
1. Pada halaman **Peran**, cari peran yang baru saja Anda buat dan pilih namanya.
1. Pada halaman detail peran, pilih tab **Izin**. Pilih **Tambahkan izin** lalu **Buat kebijakan sebaris**.
1. Pilih tab **JSON** dan tempelkan kebijakan sampel berikut ke editor kebijakan:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. Dalam kebijakan sampel yang baru saja Anda tempelkan, ganti nilai berikut dengan milik Anda sendiri:
1. Ganti `amzn-s3-demo-bucket` dengan nama bucket S3 yang menghosting manifes Anda.
1. Ganti `my-manifest.csv` dengan nama file manifes Anda.
1. Pilih **Berikutnya**. Beri nama kebijakan Anda dan pilih **Buat kebijakan**.
1. (Disarankan) Untuk mencegah [masalah wakil lintas layanan yang membingungkan](cross-service-confused-deputy-prevention.md), lakukan hal berikut:
1. Pada halaman detail peran, pilih tab **Trust relationship**. Pilih **Edit kebijakan kepercayaan**.
1. Perbarui kebijakan kepercayaan dengan menggunakan contoh berikut, yang mencakup kunci konteks kondisi `aws:SourceAccount` global `aws:SourceArn` dan global:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "000000000000"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*"
}
}
}
]
}
```
------
+ Ganti setiap instance `account-id` dengan Akun AWS ID tempat Anda menggunakan DataSync.
+ Ganti `region` dengan Wilayah AWS tempat yang Anda gunakan DataSync.
1. Pilih **Perbarui kebijakan**.
Anda membuat peran IAM yang dapat Anda sertakan dalam kebijakan bucket S3 Anda.
#### Memperbarui kebijakan bucket S3 Anda dengan peran
Setelah membuat peran IAM, Anda harus menambahkannya ke kebijakan bucket S3 di bagian lain Akun AWS tempat manifes Anda berada.
1. Di dalam Konsol Manajemen AWS, alihkan ke akun dengan ember S3 manfiest Anda.
1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Pada halaman detail bucket, pilih tab **Izin**.
1. Di bawah **kebijakan Bucket**, pilih **Edit** dan lakukan hal berikut untuk mengubah kebijakan bucket S3 Anda:
1. Perbarui apa yang ada di editor untuk menyertakan pernyataan kebijakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DataSyncAccessManifestBucket",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket"
}
]
}
```
------
1. Ganti `account-id` dengan Akun AWS ID untuk akun yang Anda gunakan DataSync .
1. Ganti `datasync-role` dengan peran IAM yang baru saja Anda buat yang memungkinkan DataSync untuk mengakses manifes Anda.
1. Ganti `amzn-s3-demo-bucket` dengan nama bucket S3 yang menghosting manifes Anda di bucket lainnya Akun AWS.
1. Pilih **Simpan perubahan**.
Anda telah membuat peran IAM yang memungkinkan DataSync untuk mengakses manifes Anda di akun lain. Tentukan peran ini saat [membuat](#manifest-creating-task) atau [memulai](#manifest-starting-task) tugas Anda.
## Menentukan manifes Anda saat membuat tugas
Anda dapat menentukan manifes yang DataSync ingin Anda gunakan saat membuat tugas.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. **Agar Konten dapat dipindai**, pilih **File, objek, dan folder tertentu**, lalu pilih **Menggunakan manifes**.
1. Untuk **URI S3**, pilih manifes yang di-host di bucket S3.
Atau, Anda dapat memasukkan URI (misalnya,`s3://bucket/prefix/my-manifest.csv`).
1. Untuk **versi Object**, pilih versi manifes yang DataSync ingin Anda gunakan.
Secara default, DataSync menggunakan versi terbaru dari objek.
1. Untuk **peran akses Manifest**, lakukan salah satu hal berikut:
+ Pilih **Autogenerate** DataSync untuk membuat peran IAM secara otomatis dengan izin yang diperlukan untuk mengakses manifes Anda di bucket S3-nya.
+ Pilih peran IAM yang ada yang dapat mengakses manifes Anda.
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke manifes Anda](#transferring-with-manifest-access).
1. Konfigurasikan pengaturan tugas lain yang Anda butuhkan, lalu pilih **Berikutnya**.
1. Pilih **Buat tugas**.
### Menggunakan AWS CLI
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. Untuk `--source-location-arn` parameter, tentukan Nama Sumber Daya Amazon (ARN) dari lokasi tempat Anda mentransfer data.
1. Untuk `--destination-location-arn` parameternya, tentukan ARN dari lokasi tempat Anda mentransfer data.
1. Untuk `--manifest-config` parameter, lakukan hal berikut:
+ `ManifestObjectPath`— Tentukan kunci objek S3 dari manifes Anda.
+ `BucketAccessRoleArn`— Tentukan peran IAM yang memungkinkan DataSync untuk mengakses manifes Anda di bucket S3-nya.
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke manifes Anda](#transferring-with-manifest-access).
+ `S3BucketArn`— Tentukan ARN bucket S3 yang menghosting manifes Anda.
+ `ManifestObjectVersionId`— Tentukan versi manifes yang DataSync ingin Anda gunakan.
Secara default, DataSync menggunakan versi terbaru dari objek.
1. Jalankan `create-task` perintah untuk membuat tugas Anda.
Ketika Anda siap, Anda dapat [memulai tugas transfer Anda](run-task.md).
## Menentukan manifes Anda saat memulai tugas
Anda dapat menentukan manifes yang DataSync ingin Anda gunakan saat menjalankan tugas.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, pilih **Tugas**, lalu pilih tugas yang ingin Anda mulai.
1. Di halaman ikhtisar tugas, pilih **Mulai**, lalu pilih **Mulai dengan opsi utama**.
1. **Agar Konten dapat dipindai**, pilih **File, objek, dan folder tertentu**, lalu pilih **Menggunakan manifes**.
1. Untuk **URI S3**, pilih manifes yang di-host di bucket S3.
Atau, Anda dapat memasukkan URI (misalnya,`s3://bucket/prefix/my-manifest.csv`).
1. Untuk **versi Object**, pilih versi manifes yang DataSync ingin Anda gunakan.
Secara default, DataSync menggunakan versi terbaru dari objek.
1. Untuk **peran akses Manifest**, lakukan salah satu hal berikut:
+ Pilih **Autogenerate** DataSync untuk membuat peran IAM secara otomatis untuk mengakses manifes Anda di bucket S3-nya.
+ Pilih peran IAM yang ada yang dapat mengakses manifes Anda.
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke manifes Anda](#transferring-with-manifest-access).
1. Pilih **Mulai** untuk memulai transfer Anda.
### Menggunakan AWS CLI
1. Salin `start-task-execution` perintah berikut:
```
aws datasync start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. Untuk `--task-arn` parameter, tentukan Nama Sumber Daya Amazon (ARN) tugas yang Anda mulai.
1. Untuk `--manifest-config` parameter, lakukan hal berikut:
+ `ManifestObjectPath`— Tentukan kunci objek S3 dari manifes Anda.
+ `BucketAccessRoleArn`— Tentukan peran IAM yang memungkinkan DataSync untuk mengakses manifes Anda di bucket S3-nya.
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke manifes Anda](#transferring-with-manifest-access).
+ `S3BucketArn`— Tentukan ARN bucket S3 yang menghosting manifes Anda.
+ `ManifestObjectVersionId`— Tentukan versi manifes yang DataSync ingin Anda gunakan.
Secara default, DataSync menggunakan versi terbaru dari objek.
1. Jalankan `start-task-execution` perintah untuk memulai transfer Anda.
## Batasan
+ Anda tidak dapat menggunakan manifes bersama dengan [filter](filtering.md).
+ Anda tidak dapat menentukan hanya direktori atau folder dengan maksud mentransfer semua isinya. Untuk situasi ini, pertimbangkan untuk menggunakan [filter include](filtering.md) alih-alih manifes.
+ Anda tidak dapat menggunakan opsi tugas **Simpan file yang dihapus** (`PreserveDeletedFiles`di [API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)) untuk [memelihara file atau objek di tujuan yang tidak ada di sumbernya](configure-metadata.md). DataSync hanya mentransfer apa yang tercantum dalam manifes Anda dan tidak menghapus apa pun di tujuan.
## Pemecahan masalah
**Kesalahan yang berkaitan dengan `HeadObject` atau `GetObjectTagging`**
Jika Anda mentransfer objek dengan versi tertentu IDs dari bucket S3, Anda mungkin melihat kesalahan terkait `HeadObject` dengan atau. `GetObjectTagging` Misalnya, berikut adalah kesalahan yang terkait dengan`GetObjectTagging`:
```
[WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed
[ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied,
msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml,
date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked,
x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723
```
Jika Anda melihat salah satu kesalahan ini, validasi bahwa peran IAM yang DataSync digunakan untuk mengakses lokasi sumber S3 Anda memiliki izin berikut:
+ `s3:GetObjectVersion`
+ `s3:GetObjectVersionTagging`
Jika Anda perlu memperbarui peran Anda dengan izin ini, lihat[Membuat peran IAM DataSync untuk mengakses lokasi Amazon S3 Anda](create-s3-location.md#create-role-manually).
**Kesalahan: `ManifestFileDoesNotExist`**
Kesalahan ini menunjukkan bahwa file dalam manifes tidak ditemukan di sumbernya. Tinjau [pedoman](#transferring-with-manifest-guidelines) untuk membuat manifes.
## Langkah selanjutnya
Jika Anda belum melakukannya, [mulailah tugas Anda](run-task.md). Jika tidak, [pantau aktivitas tugas Anda](monitoring-overview.md).
# Mentransfer file, objek, dan folder tertentu dengan menggunakan filter
AWS DataSync memungkinkan Anda menerapkan filter untuk menyertakan atau mengecualikan data dari lokasi sumber Anda dalam transfer. Misalnya, jika Anda tidak ingin mentransfer file sementara yang diakhiri dengan`.tmp`, Anda dapat membuat filter pengecualian sehingga file-file ini tidak sampai ke lokasi tujuan Anda.
Anda dapat menggunakan kombinasi pengecualian dan menyertakan filter dalam tugas transfer yang sama. Jika Anda memodifikasi filter tugas, perubahan tersebut akan diterapkan saat berikutnya Anda menjalankan tugas.
## Memfilter istilah, ketentuan, dan sintaks
Biasakan diri Anda dengan konsep yang terkait dengan DataSync penyaringan:
**Filter **
Seluruh string yang membentuk filter tertentu (misalnya, `*.tmp` `|` `*.temp` atau`/folderA|/folderB`).
Filter terdiri dari pola yang dibatasi dengan menggunakan pipa (\$1). Anda tidak memerlukan pembatas saat menambahkan pola di DataSync konsol karena Anda menambahkan setiap pola secara terpisah.
Filter peka huruf besar/kecil. Misalnya, filter `/folderA` tidak akan cocok`/FolderA`.
**Pola**
Sebuah pola di dalam filter. Misalnya, `*.tmp` adalah pola yang merupakan bagian dari `*.tmp` `|` `*.temp` filter. Jika filter Anda memiliki beberapa pola, Anda membatasi setiap pola dengan menggunakan pipa (\$1).
**Folder**
+ Semua filter adalah relatif terhadap jalur lokasi sumber. Misalnya, misalkan Anda menentukan `/my_source/` sebagai jalur sumber saat Anda membuat lokasi dan tugas sumber Anda dan tentukan filter sertakan`/transfer_this/`. Dalam hal ini, DataSync transfer hanya direktori `/my_source/transfer_this/` dan isinya.
+ Untuk menentukan folder langsung di bawah lokasi sumber, sertakan garis miring (/) di depan nama folder. Dalam contoh sebelumnya, pola menggunakan `/transfer_this`, bukan `transfer_this`.
+ DataSync menafsirkan pola berikut dengan cara yang sama dan cocok dengan folder dan isinya.
`/dir`
`/dir/`
+ Saat Anda mentransfer data dari atau ke bucket Amazon S3 DataSync, memperlakukan `/` karakter dalam kunci objek sebagai setara dengan folder pada sistem file.
**Karakter-karakter khusus**
Berikut ini adalah karakter khusus untuk digunakan dengan pemfilteran.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/filtering.html)
## Contoh filter
Contoh berikut menunjukkan filter umum yang dapat Anda gunakan DataSync.
**catatan**
Ada batasan berapa banyak karakter yang dapat Anda gunakan dalam filter. Untuk informasi selengkapnya, lihat [DataSync kuota](datasync-limits.md#task-hard-limits).
**Kecualikan beberapa folder dari lokasi sumber Anda**
Dalam beberapa kasus, Anda ingin mengecualikan folder di lokasi sumber Anda untuk tidak menyalinnya ke lokasi tujuan Anda. Misalnya, jika Anda memiliki work-in-progress folder sementara, Anda dapat menggunakan sesuatu seperti filter berikut:
`*/.temp`
Untuk mengecualikan folder dengan konten serupa (seperti `/reports2021` dan`/reports2022)`), Anda dapat menggunakan filter pengecualian seperti berikut:
`/reports*`
Untuk mengecualikan folder di tingkat mana pun dalam hierarki file, Anda dapat menggunakan filter pengecualian seperti berikut ini.
`*/folder-to-exclude-1`\$1`*/folder-to-exclude-2`
Untuk mengecualikan folder di tingkat atas lokasi sumber, Anda dapat menggunakan filter pengecualian seperti berikut ini.
`/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2`
**Sertakan subset folder di lokasi sumber Anda**
Dalam beberapa kasus, lokasi sumber Anda mungkin merupakan bagian yang besar dan Anda perlu mentransfer subset folder di bawah root. Untuk menyertakan folder tertentu, mulai eksekusi tugas dengan filter penyertaan seperti berikut.
`/folder-to-transfer/*`
**Kecualikan tipe file tertentu**
Untuk mengecualikan tipe file tertentu dari transfer, Anda dapat membuat eksekusi tugas dengan filter pengecualian seperti `*.temp`.
**Transfer file individual yang Anda tentukan**
Untuk mentransfer daftar file individual, mulai eksekusi tugas dengan menyertakan filter seperti berikut: "`/folder/subfolder/file1.txt`\$1`/folder/subfolder/file2.txt`\$1`/folder/subfolder/file2.txt`"
## Membuat filter termasuk
Sertakan filter menentukan file, objek, dan folder yang DataSync ingin Anda transfer. Anda dapat mengonfigurasi filter sertakan saat membuat, mengedit, atau memulai tugas.
DataSync memindai dan mentransfer hanya file dan folder yang cocok dengan filter include. Misalnya, untuk menyertakan subset folder sumber Anda, Anda dapat menentukan `/important_folder_1` \$1`/important_folder_2`.
**catatan**
Sertakan filter yang mendukung karakter wildcard (\$1) hanya sebagai karakter paling kanan dalam suatu pola. Misalnya, `/documents*` \$1 `/code*` didukung, tetapi `*.txt` tidak.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. **Agar Konten dapat dipindai**, pilih **File, objek, dan folder tertentu**, lalu pilih **Menggunakan filter**.
1. Untuk **Termasuk**, masukkan filter Anda (misalnya, `/important_folders` untuk menyertakan direktori penting), lalu pilih **Tambah pola**.
1. Tambahkan filter sertakan lainnya sesuai kebutuhan.
### Menggunakan AWS CLI
Saat menggunakan AWS CLI, Anda harus menggunakan tanda kutip tunggal (`'`) di sekitar filter dan \$1 (pipa) sebagai pembatas jika Anda memiliki lebih dari satu filter.
Contoh berikut menentukan dua termasuk filter `/important_folder1` dan `/important_folder2` ketika menjalankan `create-task` perintah.
```
aws datasync create-task
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
```
## Membuat filter pengecualian
Kecualikan filter menentukan file, objek, dan folder di lokasi sumber yang tidak DataSync ingin Anda transfer. Anda dapat mengonfigurasi filter ini saat membuat, mengedit, atau memulai tugas.
**Topics**
+ [Data dikecualikan secara default](#directories-ignored-during-transfers)
### Data dikecualikan secara default
DataSync secara otomatis mengecualikan beberapa data agar tidak ditransfer:
+ `.snapshot`— DataSync mengabaikan jalur yang diakhiri dengan`.snapshot`, yang biasanya digunakan untuk point-in-time snapshot file atau direktori sistem penyimpanan.
+ `/.aws-datasync`dan `/.awssync` — DataSync membuat folder ini di lokasi Anda untuk membantu memfasilitasi transfer Anda.
+ `/.zfs`— Anda mungkin melihat folder ini dengan Amazon FSx untuk lokasi OpenZFS.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Untuk **Excludes**, masukkan filter Anda (misalnya, `*/temp` untuk mengecualikan folder sementara), lalu pilih **Tambah pola**.
1. Tambahkan filter pengecualian lainnya sesuai kebutuhan.
1. Jika perlu, tambahkan [filter sertakan](#include-filters).
### Menggunakan AWS CLI
Saat menggunakan AWS CLI, Anda harus menggunakan tanda kutip tunggal (`'`) di sekitar filter dan \$1 (pipa) sebagai pembatas jika Anda memiliki lebih dari satu filter.
Contoh berikut menentukan dua mengecualikan filter `*/temp` dan `*/tmp` ketika menjalankan `create-task` perintah.
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'
```
# Memahami cara DataSync menangani metadata file dan objek
AWS DataSync dapat melestarikan file atau objek metadata Anda selama transfer data. Cara metadata Anda disalin tergantung pada lokasi transfer Anda dan jika lokasi tersebut menggunakan jenis metadata yang serupa.
## Metadata tingkat sistem
Secara umum, DataSync tidak menyalin metadata tingkat sistem. Misalnya, saat mentransfer dari server file SMB, izin yang Anda konfigurasikan di tingkat sistem file tidak disalin ke sistem penyimpanan tujuan.
Ada pengecualian. Saat mentransfer antara Amazon S3 dan penyimpanan objek lainnya DataSync , menyalin [beberapa metadata objek yang ditentukan sistem](#metadata-copied-between-object-s3).
## Metadata disalin dalam transfer Amazon S3
Tabel berikut menjelaskan metadata apa yang DataSync dapat disalin saat transfer melibatkan lokasi Amazon S3.
**Topics**
+ [Ke Amazon S3](#metadata-copied-to-s3)
+ [Antara Amazon S3 dan penyimpanan objek lainnya](#metadata-copied-between-object-s3)
+ [Antara Amazon S3 dan HDFS](#metadata-copied-between-hdfs-s3)
### Ke Amazon S3
| Saat menyalin dari salah satu lokasi ini | Ke lokasi ini | DataSync dapat menyalin |
| --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | Berikut ini sebagai metadata pengguna Amazon S3: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) Metadata file yang disimpan dalam metadata pengguna Amazon S3 dapat dioperasikan dengan berbagi NFS di gateway file yang menggunakan. AWS Storage Gateway Gateway file memungkinkan akses latensi rendah dari jaringan lokal ke data yang disalin ke Amazon S3 oleh. DataSync Metadata ini juga dapat dioperasikan dengan for Lustre. FSx Saat DataSync menyalin objek yang berisi metadata ini kembali ke server NFS, metadata file dipulihkan. Memulihkan metadata membutuhkan pemberian izin yang lebih tinggi ke server NFS. Untuk informasi selengkapnya, lihat [Mengkonfigurasi AWS DataSync transfer dengan server file NFS](create-nfs-location.md). |
### Antara Amazon S3 dan penyimpanan objek lainnya
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html)
### Antara Amazon S3 dan HDFS
| Saat menyalin di antara lokasi-lokasi ini | DataSync dapat menyalin |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | Berikut ini sebagai metadata pengguna Amazon S3:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html)HDFS menggunakan string untuk menyimpan file dan folder pengguna dan kepemilikan grup, bukan pengidentifikasi numerik, seperti dan. UIDs GIDs |
## Metadata disalin dalam transfer NFS
Tabel berikut menjelaskan metadata apa yang DataSync dapat menyalin antara lokasi yang menggunakan Network File System (NFS).
| Saat menyalin di antara lokasi-lokasi ini | DataSync dapat menyalin |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) |
## Metadata disalin dalam transfer SMB
Tabel berikut menjelaskan metadata apa yang DataSync dapat menyalin antara lokasi yang menggunakan Server Message Block (SMB).
| Saat menyalin di antara lokasi-lokasi ini | DataSync dapat menyalin |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) |
## Metadata disalin dalam skenario transfer lainnya
DataSync menangani metadata dengan cara berikut saat menyalin antara sistem penyimpanan ini (sebagian besar memiliki struktur metadata yang berbeda).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html)
## Memahami kapan dan bagaimana DataSync menerapkan metadata POSIX default
DataSync menerapkan metadata POSIX default dalam situasi berikut:
+ Bila lokasi sumber dan tujuan transfer Anda tidak memiliki struktur metadata yang serupa
+ Ketika metadata hilang dari lokasi sumber
Tabel berikut menjelaskan bagaimana DataSync menerapkan metadata POSIX default selama jenis transfer ini:
| Sumber | Destinasi | Izin file | Izin folder | UID | GID |
| --- | --- | --- | --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | 0755 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
1 Dalam kasus di mana objek tidak memiliki metadata yang sebelumnya diterapkan oleh. DataSync
# Tautan dan direktori disalin oleh AWS DataSync
AWS DataSync menangani hard link, tautan simbolik, dan direktori secara berbeda tergantung pada lokasi penyimpanan yang terlibat dalam transfer Anda.
## Tautan keras
Berikut cara DataSync menangani hard link dalam beberapa skenario transfer umum:
+ **Saat mentransfer antara server file NFS, FSx untuk Lustre, untuk OpenZFS, FSx FSx untuk ONTAP (menggunakan NFS), dan Amazon EFS, tautan keras dipertahankan**.
+ **Saat mentransfer ke Amazon** S3, setiap file yang mendasari yang direferensikan oleh tautan keras ditransfer hanya sekali. Selama transfer inkremental, objek terpisah dibuat di bucket S3 Anda. Jika hard link tidak berubah di Amazon S3, itu dipulihkan dengan benar saat ditransfer ke server file NFS, untuk Lustre FSx , untuk OpenZFS FSx , untuk ONTAP (menggunakan NFS) FSx , atau sistem file Amazon EFS.
+ **Saat mentransfer ke Microsoft Azure Blob Storage**, setiap file yang mendasari yang direferensikan oleh tautan keras ditransfer hanya sekali. Selama transfer inkremental, objek terpisah dibuat di penyimpanan gumpalan Anda jika ada referensi baru di sumbernya. Saat mentransfer dariAzure Blob Storage, DataSync mentransfer tautan keras seolah-olah itu adalah file individual.
+ **Saat mentransfer antara server file SMB, FSx untuk Windows File Server, dan FSx untuk ONTAP (menggunakan SMB)**, hard link tidak didukung. Jika DataSync menemukan hard link dalam situasi ini, tugas transfer selesai dengan kesalahan. Untuk mempelajari lebih lanjut, periksa CloudWatch log Anda.
+ **Saat mentransfer ke HDFS**, hard link tidak didukung. CloudWatch log menunjukkan tautan ini sebagai dilewati.
## Tautan simbolik
Berikut cara DataSync menangani tautan simbolik dalam beberapa skenario transfer umum:
+ **Saat mentransfer antara server file NFS, FSx untuk Lustre, untuk OpenZFS, FSx FSx untuk ONTAP (menggunakan NFS), dan Amazon EFS, tautan simbolis** dipertahankan.
+ **Saat mentransfer ke Amazon** S3, jalur target tautan disimpan di objek Amazon S3. Tautan dipulihkan dengan benar saat ditransfer ke server file NFS, FSx untuk Lustre, untuk OpenZFS, FSx untuk FSx ONTAP, atau sistem file Amazon EFS.
+ **Saat mentransfer ke Azure Blob Storage**, tautan simbolik tidak didukung. CloudWatch log menunjukkan tautan ini sebagai dilewati.
+ **Saat mentransfer antara server file SMB, FSx untuk Windows File Server, dan FSx untuk ONTAP (menggunakan SMB)**, tautan simbolis tidak didukung. DataSync tidak mentransfer tautan simbolis itu sendiri melainkan file yang direferensikan oleh tautan simbolis. Untuk mengenali file duplikat dan menghapus duplikat dengan tautan simbolik, Anda harus mengonfigurasi deduplikasi pada sistem file tujuan Anda.
+ **Saat mentransfer ke HDFS**, tautan simbolis tidak didukung. CloudWatch log menunjukkan tautan ini sebagai dilewati.
## Direktori
Secara umum, DataSync mempertahankan direktori saat mentransfer antar sistem penyimpanan. Ini tidak terjadi dalam situasi berikut:
+ **Saat mentransfer ke Amazon** S3, direktori direpresentasikan sebagai objek kosong yang memiliki awalan dan diakhiri dengan garis miring (). `/`
+ **Saat mentransfer ke Azure Blob Storage tanpa namespace hierarkis**, direktori tidak ada. Apa yang tampak seperti direktori hanyalah bagian dari nama objek.
# Mengkonfigurasi cara menangani file, objek, dan metadata
Anda dapat mengonfigurasi cara AWS DataSync menangani file, objek, dan metadata terkait saat mentransfer antar lokasi.
Misalnya, dengan transfer berulang, Anda mungkin ingin menimpa file di tujuan dengan perubahan sumber agar lokasi tetap sinkron. Anda dapat menyalin properti seperti izin POSIX untuk file dan folder, tag yang terkait dengan objek, dan daftar kontrol akses ()ACLs.
## Opsi mode transfer
Anda dapat mengonfigurasi apakah hanya DataSync mentransfer data (termasuk metadata) yang diubah setelah salinan awal atau 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.
| Opsi di konsol | Opsi di API | Deskripsi |
| --- | --- | --- |
| **Transfer hanya data yang telah berubah** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)disetel ke `CHANGED` | Setelah transfer penuh awal Anda, DataSync salin hanya data dan metadata yang berbeda antara lokasi sumber dan tujuan. |
| **Transfer semua data** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)disetel ke `ALL` | DataSync menyalin semua yang ada di sumber ke tujuan tanpa membandingkan perbedaan antar lokasi. |
## Opsi penanganan file dan objek
Anda dapat mengontrol beberapa aspek bagaimana DataSync memperlakukan file atau objek Anda di lokasi tujuan. Misalnya, DataSync dapat menghapus file di tujuan yang tidak ada di sumbernya.
| Opsi di konsol | Opsi di API | Deskripsi |
| --- | --- | --- |
| **Simpan file yang dihapus** | [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) | Menentukan apakah DataSync memelihara file atau objek di lokasi tujuan yang tidak ada di sumber. Jika mengonfigurasi tugas untuk menghapus objek dari bucket Amazon S3, Anda mungkin dikenakan biaya durasi penyimpanan minimum untuk kelas penyimpanan tertentu. Untuk detail informasi, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](create-s3-location.md#using-storage-classes). Anda tidak dapat mengonfigurasi tugas Anda untuk menghapus data di tujuan dan juga [mentransfer semua data](#task-option-transfer-mode). Ketika Anda mentransfer semua data, DataSync tidak memindai lokasi tujuan Anda dan tidak tahu apa yang harus dihapus. |
| **Menimpa file** | [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) | Menentukan apakah DataSync memodifikasi data di lokasi tujuan ketika data sumber atau metadata telah berubah. Jika Anda tidak mengonfigurasi tugas untuk menimpa data, data tujuan tidak akan ditimpa meskipun data sumbernya berbeda. Jika tugas Anda menimpa objek, Anda mungkin dikenakan biaya tambahan untuk kelas penyimpanan tertentu (misalnya, untuk pengambilan atau penghapusan awal). Untuk detail informasi, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](create-s3-location.md#using-storage-classes). |
## Opsi penanganan metadata
DataSync dapat melestarikan metadata file dan objek selama transfer. Metadata yang DataSync dapat dipertahankan tergantung pada sistem penyimpanan yang terlibat dan apakah sistem tersebut menggunakan struktur metadata yang serupa.
Sebelum mengonfigurasi tugas Anda, pastikan Anda memahami cara DataSync menangani [metadata](metadata-copied.md) dan [file khusus](special-files-copied.md) saat mentransfer antara lokasi sumber dan tujuan.
**penting**
DataSync mendukung transfer ke dan dari sistem penyimpanan cloud pihak ketiga tertentu, seperti Google Cloud Storage dan IBM Cloud Object Storage, yang menangani metadata sistem dengan cara yang tidak sepenuhnya kompatibel dengan S3. Untuk transfer ini, DataSync upaya untuk menyalin atribut metadata seperti`ContentType`,, `ContentEncoding``ContentLanguage`, dan `CacheControl` atas dasar upaya terbaik. Jika sistem penyimpanan tujuan tidak menerapkan atribut ini, atribut tersebut akan diabaikan selama verifikasi tugas.
| Opsi di konsol | Opsi di API | Deskripsi |
| --- | --- | --- |
| **Salin kepemilikan** | [Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) dan [Uid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Uid) | Menentukan apakah DataSync salinan POSIX file dan kepemilikan folder, seperti ID grup pemilik file dan ID pengguna dari pemilik file. |
| **Salin izin** | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) | Menentukan apakah DataSync salinan izin POSIX untuk file dan folder dari sumber ke tujuan. |
| Salin stempel waktu | [https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime) | Menentukan apakah DataSync menyalin metadata timestamp dari sumber ke tujuan. Diperlukan saat Anda perlu menjalankan tugas lebih dari sekali. |
| Salin tag objek | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) | Menentukan apakah DataSync mempertahankan tag yang terkait dengan objek Anda saat mentransfer antara sistem penyimpanan objek. |
| Kepemilikan salinan, DACLs, dan SACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)disetel ke OWNER\$1DACL\$1SACL | DataSync menyalin yang berikut ini: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/configure-metadata.html) |
| Salin kepemilikan dan DACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)disetel ke OWNER\$1DACL | DataSync menyalin yang berikut ini: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/configure-metadata.html) DataSync tidak akan menyalin SACLs ketika Anda memilih opsi ini. |
| Jangan menyalin kepemilikan atau ACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags)disetel ke NONE | DataSync tidak menyalin data kepemilikan atau izin apa pun. Objek yang DataSync menulis ke lokasi tujuan Anda dimiliki oleh pengguna yang kredensialnya disediakan DataSync untuk mengakses tujuan. Izin objek tujuan ditentukan berdasarkan izin yang dikonfigurasi di server tujuan. |
## Mengkonfigurasi opsi penanganan file, objek, dan metadata
Anda dapat mengonfigurasi cara DataSync menangani file, objek, dan metadata saat membuat, mengedit, atau memulai tugas transfer Anda.
### Menggunakan DataSync konsol
Petunjuk berikut menjelaskan cara mengonfigurasi opsi penanganan file, objek, dan metadata saat membuat tugas.
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Untuk **mode Transfer**, pilih salah satu opsi berikut:
+ **Transfer hanya data yang telah berubah**
+ **Transfer semua data**
Untuk informasi selengkapnya tentang opsi ini, lihat [Opsi mode transfer](#task-option-transfer-mode).
1. Pilih **Simpan file yang dihapus** jika Anda DataSync ingin mempertahankan file atau objek di lokasi tujuan yang tidak ada di sumber.
Jika Anda tidak memilih opsi ini dan tugas Anda menghapus objek dari bucket Amazon S3, Anda mungkin dikenakan biaya durasi penyimpanan minimum untuk kelas penyimpanan tertentu. Untuk detail informasi, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](create-s3-location.md#using-storage-classes).
**Awas**
Anda tidak dapat membatalkan pilihan ini dan mengaktifkan **Transfer semua data**. Ketika Anda mentransfer semua data, DataSync tidak memindai lokasi tujuan Anda dan tidak tahu apa yang harus dihapus.
1. Pilih **Timpa file** jika Anda DataSync ingin mengubah data di lokasi tujuan saat data sumber atau metadata telah berubah.
Jika tugas Anda menimpa objek, Anda mungkin dikenakan biaya tambahan untuk kelas penyimpanan tertentu (misalnya, untuk pengambilan atau penghapusan awal). Untuk detail informasi, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](create-s3-location.md#using-storage-classes).
Jika Anda tidak memilih opsi ini, data tujuan tidak akan ditimpa meskipun data sumbernya berbeda.
1. Di bawah **Opsi transfer**, pilih cara Anda DataSync ingin menangani metadata. Untuk informasi lebih lanjut tentang opsi, lihat [Opsi penanganan metadata](#task-option-metadata-handling).
**penting**
Opsi yang Anda lihat di konsol bergantung pada lokasi sumber dan tujuan tugas Anda. Anda mungkin harus memperluas **Pengaturan tambahan** untuk melihat beberapa opsi ini.
+ **Salin kepemilikan**
+ **Salin izin**
+ **Salin stempel waktu**
+ **Salin tag objek**
+ **Kepemilikan salinan, DACLs, dan SACLs**
+ **Salin kepemilikan dan DACLs**
+ **Jangan menyalin kepemilikan atau ACLs**
### Menggunakan DataSync API
Anda dapat mengonfigurasi opsi penanganan file, objek, dan metadata dengan menggunakan `Options` parameter dengan salah satu operasi berikut:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
# Mengkonfigurasi cara AWS DataSync memverifikasi integritas data
Selama transfer, AWS DataSync gunakan verifikasi checksum untuk memverifikasi integritas data yang Anda salin antar lokasi. Anda juga dapat mengonfigurasi DataSync untuk melakukan verifikasi tambahan di akhir transfer Anda.
## Opsi verifikasi data
Gunakan informasi berikut untuk membantu Anda memutuskan apakah dan bagaimana Anda DataSync ingin melakukan pemeriksaan tambahan ini.
| Opsi konsol | Opsi API | Deskripsi |
| --- | --- | --- |
| **Verifikasi hanya data yang ditransfer** (disarankan) | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)diatur ke `ONLY_FILES_TRANSFERRED` | DataSync menghitung checksum data yang ditransfer (termasuk metadata) di lokasi sumber. Di akhir transfer Anda, DataSync bandingkan checksum ini dengan checksum yang dihitung pada data yang sama 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 transfer Amazon S3](create-s3-location.md#using-storage-classes). |
| **Verifikasi semua data** | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)diatur ke `POINT_IN_TIME_CONSISTENT` | Di akhir transfer Anda, DataSync periksa seluruh sumber dan tujuan untuk memverifikasi bahwa kedua lokasi disinkronkan sepenuhnya. Tidak didukung saat tugas Anda menggunakan [mode Enhanced](choosing-task-mode.md). Jika Anda menggunakan [manifes](transferring-with-manifest.md), 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 transfer Amazon S3](create-s3-location.md#using-storage-classes). |
| Jangan verifikasi data setelah transfer | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode)diatur ke `NONE` | DataSync melakukan pemeriksaan integritas data hanya selama transfer Anda. Tidak seperti opsi lain, tidak ada verifikasi tambahan di akhir transfer Anda. |
## Mengkonfigurasi verifikasi data
Anda dapat mengonfigurasi opsi verifikasi data saat membuat tugas, memperbarui tugas, atau memulai eksekusi tugas.
### Menggunakan DataSync konsol
Petunjuk berikut menjelaskan cara mengonfigurasi opsi verifikasi data saat membuat tugas.
**Untuk mengonfigurasi verifikasi data dengan menggunakan konsol**
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Untuk **Verifikasi**, pilih salah satu dari berikut ini:
+ **Verifikasi hanya data yang ditransfer** (disarankan)
+ **Verifikasi semua data**
+ **Jangan verifikasi data setelah transfer**
### Menggunakan DataSync API
Anda dapat mengonfigurasi cara DataSync memverifikasi data dengan menggunakan `VerifyMode` parameter dengan salah satu operasi berikut:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
# Menetapkan batas bandwidth untuk AWS DataSync tugas Anda
Anda dapat mengonfigurasi batas bandwidth jaringan untuk AWS DataSync tugas Anda dan setiap pelaksanaannya.
## Membatasi bandwidth untuk suatu tugas
Tetapkan batas bandwidth saat membuat, mengedit, atau memulai tugas.
### Menggunakan DataSync konsol
Petunjuk berikut menjelaskan cara mengonfigurasi batas bandwidth untuk tugas Anda saat Anda membuatnya.
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Untuk **batas Bandwidth**, pilih salah satu dari berikut ini:
+ Pilih **Gunakan tersedia** untuk menggunakan semua bandwidth jaringan yang tersedia untuk setiap eksekusi tugas.
+ Pilih **Setel batas bandwidth (MIB/s)** dan masukkan bandwidth maksimum yang ingin Anda gunakan DataSync untuk setiap eksekusi tugas.
### Menggunakan DataSync API
Anda dapat mengonfigurasi batas bandwidth tugas dengan menggunakan `BytesPerSecond` parameter dengan salah satu operasi berikut:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
## Membatasi bandwidth untuk eksekusi tugas
Anda dapat memodifikasi batas bandwidth untuk eksekusi tugas yang berjalan atau antrian.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi, perluas **Transfer data.** lalu pilih **Tugas**.
1. Pilih tugas dan kemudian pilih **Riwayat** untuk melihat eksekusi tugas.
1. Pilih eksekusi tugas yang ingin Anda modifikasi dan kemudian pilih **Edit**.
1. Di kotak dialog, pilih salah satu dari berikut ini:
+ Pilih **Gunakan tersedia** untuk menggunakan semua bandwidth jaringan yang tersedia untuk pelaksanaan tugas.
+ Pilih **Setel batas bandwidth (MIB/s)** dan masukkan bandwidth maksimum yang ingin Anda gunakan DataSync untuk eksekusi tugas.
1. Pilih **Simpan perubahan**.
Batas bandwidth baru mulai berlaku dalam 60 detik.
### Menggunakan DataSync API
Anda dapat memodifikasi batas bandwidth untuk eksekusi tugas yang berjalan atau antrian dengan menggunakan `BytesPerSecond` parameter dengan operasi. [UpdateTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTaskExecution.html)
# Penjadwalan saat AWS DataSync tugas Anda berjalan
Anda dapat mengatur jadwal AWS DataSync tugas untuk mentransfer data secara berkala antar lokasi penyimpanan.
## Cara kerja penjadwalan DataSync tugas
DataSync Tugas terjadwal berjalan pada frekuensi yang Anda tentukan, dengan interval minimal 1 jam. Anda dapat membuat jadwal tugas dengan menggunakan ekspresi cron atau rate.
**penting**
Anda tidak dapat menjadwalkan tugas untuk dijalankan pada interval lebih cepat dari 1 jam.
**Menggunakan ekspresi cron**
Gunakan ekspresi cron untuk jadwal tugas yang berjalan pada waktu dan hari tertentu. Misalnya, inilah cara Anda dapat mengonfigurasi jadwal tugas di AWS CLI yang berjalan pada pukul 12:00 UTC setiap hari Minggu dan Rabu.
```
cron(0 12 ? * SUN,WED *)
```
**Menggunakan ekspresi tingkat**
Gunakan ekspresi tingkat untuk jadwal tugas yang berjalan pada interval reguler, seperti setiap 12 jam. Sebagai contoh, berikut adalah bagaimana Anda dapat mengkonfigurasi jadwal tugas di AWS CLI yang berjalan setiap 12 jam:
```
rate(12 hours)
```
**Tip**
Untuk informasi selengkapnya tentang sintaks ekspresi cron dan rate, lihat [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html).
## Membuat jadwal DataSync tugas
Anda dapat menjadwalkan seberapa sering tugas Anda berjalan dengan menggunakan DataSync konsol, AWS CLI, atau DataSync API.
### Menggunakan DataSync konsol
Petunjuk berikut menjelaskan cara mengatur jadwal saat membuat tugas. Anda dapat mengubah jadwal nanti saat mengedit tugas.
Di konsol, beberapa opsi penjadwalan memungkinkan Anda menentukan waktu yang tepat saat tugas Anda berjalan (seperti setiap hari pada pukul 10:30 malam). Jika Anda tidak menyertakan waktu untuk opsi ini, tugas Anda berjalan pada saat Anda membuat (atau memperbarui) tugas.
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, silakan lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Untuk jadwal **Frekuensi**, lakukan salah satu hal berikut:
+ Pilih **Tidak dijadwalkan** jika Anda tidak ingin tugas Anda berjalan sesuai jadwal.
+ Pilih **Per Jam**, lalu pilih menit selama jam yang Anda inginkan untuk menjalankan tugas Anda.
+ Pilih **Harian** dan masukkan waktu UTC yang Anda inginkan untuk menjalankan tugas Anda.
+ Pilih **Mingguan** dan hari dalam seminggu dan masukkan waktu UTC yang Anda inginkan untuk menjalankan tugas.
+ Pilih **Hari dalam seminggu**, pilih hari atau hari tertentu, dan masukkan waktu UTC yang harus dijalankan tugas dalam format HH: MM.
+ Pilih **Kustom**, lalu pilih Ekspresi **cron atau Ekspresi** **nilai**. Masukkan jadwal tugas Anda dengan interval minimal 1 jam.
### Menggunakan AWS CLI
Anda dapat membuat jadwal untuk DataSync tugas Anda dengan menggunakan `--schedule` parameter dengan`create-task`,`update-task`, atau `start-task-execution` perintah.
Instruksi berikut menjelaskan cara melakukan ini dengan `create-task` perintah.
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
--destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)"
}'
```
1. Untuk `--source-location-arn` parameter, tentukan Nama Sumber Daya Amazon (ARN) dari lokasi tempat Anda mentransfer data.
1. Untuk `--destination-location-arn` parameternya, tentukan ARN dari lokasi tempat Anda mentransfer data.
1. Untuk `--schedule` parameter, tentukan ekspresi cron atau rate untuk jadwal Anda.
Dalam contoh, ekspresi cron `cron(0 12 ? * SUN,WED *)` menetapkan jadwal tugas yang berjalan pada pukul 12:00 UTC setiap hari Minggu dan Rabu.
1. Jalankan `create-task` perintah untuk membuat tugas Anda dengan jadwal.
## Menjeda jadwal DataSync tugas
Mungkin ada situasi di mana Anda perlu menjeda jadwal DataSync tugas Anda. Misalnya, Anda mungkin perlu menonaktifkan sementara transfer berulang untuk memperbaiki masalah dengan tugas Anda atau melakukan pemeliharaan pada sistem penyimpanan Anda.
DataSync mungkin menonaktifkan jadwal tugas Anda secara otomatis karena alasan berikut:
+ Tugas Anda gagal berulang kali dengan kesalahan yang sama.
+ Anda [menonaktifkan Wilayah AWS yang](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) digunakan tugas Anda.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**.
1. Pilih tugas yang ingin Anda jeda jadwal, lalu pilih **Edit**.
1. Untuk **Jadwal**, matikan **Aktifkan jadwal**. Pilih **Simpan perubahan**.
### Menggunakan AWS CLI
1. Salin `update-task` perintah berikut:
```
aws datasync update-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED"
}'
```
1. Untuk `--task-arn` parameternya, tentukan ARN tugas yang ingin Anda jeda jadwalnya.
1. Untuk `--schedule` parameter, lakukan hal berikut:
+ Untuk`ScheduleExpression`, tentukan ekspresi cron atau rate untuk jadwal Anda.
Dalam contoh, ekspresi `cron(0 12 ? * SUN,WED *)` menetapkan jadwal tugas yang berjalan pada pukul 12:00 UTC setiap hari Minggu dan Rabu.
+ Untuk`Status`, tentukan `DISABLED` untuk menjeda jadwal tugas.
1. Jalankan perintah `update-task`.
1. Untuk melanjutkan jadwal, jalankan `update-task` perintah yang sama dengan `Status` set to`ENABLED`.
## Memeriksa status jadwal DataSync tugas
Anda dapat melihat apakah jadwal DataSync tugas Anda diaktifkan.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**.
1. Di kolom **Jadwal**, periksa apakah jadwal tugas diaktifkan atau dinonaktifkan.
### Menggunakan AWS CLI
1. Salin `describe-task` perintah berikut:
```
aws datasync describe-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
```
1. Untuk `--task-arn` parameter, tentukan ARN dari tugas yang Anda inginkan informasinya.
1. Jalankan perintah `describe-task`.
Anda mendapatkan respons yang memberikan detail tentang tugas Anda, termasuk jadwalnya. (Contoh berikut berfokus terutama pada konfigurasi jadwal tugas dan tidak menunjukkan `describe-task` respons penuh.)
Contoh menunjukkan bahwa jadwal tugas dinonaktifkan secara manual. Jika jadwal dinonaktifkan oleh DataSync `SERVICE`, Anda akan melihat pesan kesalahan `DisabledReason` untuk membantu Anda memahami mengapa tugas terus gagal. Untuk informasi selengkapnya, lihat [Memecahkan masalah AWS DataSync](troubleshooting-datasync.md).
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh",
"Status": "AVAILABLE",
"Schedule": {
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED",
"StatusUpdateTime": 1697736000,
"DisabledBy": "USER",
"DisabledReason": "Manually disabled by user."
},
...
}
```
# Menandai tugas Anda AWS DataSync
*Tag* adalah pasangan nilai kunci yang membantu Anda mengelola, memfilter, dan mencari sumber daya Anda AWS DataSync . Anda dapat menambahkan hingga 50 tag untuk setiap DataSync tugas dan pelaksanaan tugas.
Misalnya, Anda dapat membuat tugas untuk migrasi data besar dan menandai tugas dengan kunci **Project** dan nilai**Large Migration**. Untuk mengatur migrasi lebih lanjut, Anda dapat menandai satu proses tugas dengan kunci **Transfer Date** dan nilai **May 2021** (eksekusi tugas berikutnya mungkin ditandai**June 2021**,**July 2021**, dan seterusnya).
## Menandai tugas Anda DataSync
Anda dapat menandai DataSync tugas Anda hanya saat membuat tugas.
### Menggunakan DataSync konsol
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**, lalu pilih **Buat tugas**.
1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.
Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)
1. Pada halaman **Konfigurasi pengaturan**, pilih **Tambahkan tag baru** untuk menandai tugas Anda.
### Menggunakan AWS CLI
1. Salin `create-task` perintah berikut:
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
--tags Key=tag-key,Value=tag-value
```
1. Tentukan parameter berikut dalam perintah:
+ `--source-location-arn`— Tentukan Nama Sumber Daya Amazon (ARN) dari lokasi sumber dalam transfer Anda.
+ `--destination-location-arn`— Tentukan ARN dari lokasi tujuan dalam transfer Anda.
+ `--tags`— Tentukan tag yang ingin Anda terapkan pada tugas.
Untuk lebih dari satu tag, pisahkan setiap pasangan kunci-nilai dengan spasi.
1. (Opsional) Tentukan parameter lain yang masuk akal untuk skenario transfer Anda.
Untuk daftar`--options`, lihat perintah [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).
1. Jalankan perintah `create-task`.
Anda mendapatkan respons yang menunjukkan tugas yang baru saja Anda buat.
```
{
"TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
}
```
Untuk melihat tag yang Anda tambahkan ke tugas ini, Anda dapat menggunakan [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)perintah.
## Menandai eksekusi DataSync tugas Anda
Anda dapat menandai setiap proses DataSync tugas Anda.
Jika tugas Anda sudah memiliki tag, ingat hal berikut tentang penggunaan tag dengan eksekusi tugas:
+ Jika Anda memulai tugas dengan konsol, tag yang dibuat pengguna diterapkan secara otomatis ke eksekusi tugas. Namun, tag yang dibuat sistem yang dimulai dengan tidak `aws:` diterapkan.
+ Jika Anda memulai tugas Anda dengan DataSync API atau AWS CLI, tag-nya tidak diterapkan secara otomatis ke eksekusi tugas.
### Menggunakan DataSync konsol
Untuk menambah, mengedit, atau menghapus tag dari eksekusi tugas, Anda harus memulai tugas dengan opsi utama.
1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Di panel navigasi kiri, perluas **Transfer data**, lalu pilih **Tugas**.
1. Pilih tugas.
1. Pilih **Mulai**, lalu pilih salah satu opsi berikut:
+ **Mulai dengan default** - Menerapkan tag apa pun yang terkait dengan tugas Anda.
+ **Mulai dengan opsi utama** - Memungkinkan Anda menambahkan, mengedit, atau menghapus tag untuk eksekusi tugas khusus ini.
### Menggunakan AWS CLI
1. Salin `start-task-execution` perintah berikut:
```
aws datasync start-task-execution \
--task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
--tags Key=tag-key,Value=tag-value
```
1. Tentukan parameter berikut dalam perintah:
+ `--task-arn`— Tentukan ARN dari tugas yang ingin Anda mulai.
+ `--tags`— Tentukan tag yang ingin Anda terapkan untuk menjalankan tugas khusus ini.
Untuk lebih dari satu tag, pisahkan setiap pasangan kunci-nilai dengan spasi.
1. (Opsional) Tentukan parameter lain yang masuk akal untuk situasi Anda.
Untuk informasi lebih lanjut, lihat [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html)perintah.
1. Jalankan perintah `start-task-execution`.
Anda mendapatkan respons yang menunjukkan eksekusi tugas yang baru saja Anda mulai.
```
{
"TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
}
```
Untuk melihat tag yang Anda tambahkan ke tugas ini, Anda dapat menggunakan [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)perintah.