

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

# Memilih AWS DataSync transfer apa
<a name="task-options"></a>

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
<a name="transferring-with-manifest"></a>

*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
<a name="transferring-with-manifest-create"></a>

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
<a name="transferring-with-manifest-guidelines"></a>

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
<a name="manifest-examples"></a>

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
<a name="transferring-with-manifest-access"></a>

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
<a name="creating-manfiest-role-automatically"></a>

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)
<a name="creating-manfiest-role-automatically-same-account"></a>

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)
<a name="creating-manfiest-role-automatically-different-account"></a>

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
<a name="creating-manfiest-role-automatically-different-account-1"></a>

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
<a name="creating-manfiest-role-automatically-different-account-2"></a>

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
<a name="manifest-creating-task"></a>

Anda dapat menentukan manifes yang DataSync ingin Anda gunakan saat membuat tugas.

### Menggunakan DataSync konsol
<a name="manifest-creating-task-console"></a>

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
<a name="manifest-creating-task-cli"></a>

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
<a name="manifest-starting-task"></a>

Anda dapat menentukan manifes yang DataSync ingin Anda gunakan saat menjalankan tugas.

### Menggunakan DataSync konsol
<a name="manifest-starting-task-console"></a>

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
<a name="manifest-starting-task-cli"></a>

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
<a name="transferring-with-manifest-limitations"></a>
+ 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
<a name="manifests-troubleshooting"></a>

**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
<a name="manifests-next-steps"></a>

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
<a name="filtering"></a>

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
<a name="filter-overview"></a>

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
<a name="sample-filters"></a>

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
<a name="include-filters"></a>

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
<a name="include-filters-console"></a>

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
<a name="include-filters-cli"></a>

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
<a name="exclude-filters"></a>

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
<a name="directories-ignored-during-transfers"></a>

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
<a name="adding-exclude-filters"></a>

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
<a name="adding-exclude-filters-cli"></a>

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
<a name="metadata-copied"></a>

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
<a name="metadata-copied-system-level"></a>

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
<a name="metadata-copied-amazon-s3"></a>

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
<a name="metadata-copied-to-s3"></a>


| 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
<a name="metadata-copied-between-object-s3"></a>

[\[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
<a name="metadata-copied-between-hdfs-s3"></a>


| 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
<a name="metadata-copied-nfs"></a>

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
<a name="metadata-copied-smb"></a>

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
<a name="metadata-copied-different"></a>

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
<a name="POSIX-metadata"></a>

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
<a name="special-files-copied"></a>

AWS DataSync menangani hard link, tautan simbolik, dan direktori secara berbeda tergantung pada lokasi penyimpanan yang terlibat dalam transfer Anda.

## Tautan keras
<a name="special-files-copied-hard-links"></a>

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
<a name="special-files-copied-symbolic-links"></a>

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
<a name="special-files-copied-directories"></a>

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
<a name="configure-metadata"></a>

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
<a name="task-option-transfer-mode"></a>

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
<a name="task-option-file-object-handling"></a>

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
<a name="task-option-metadata-handling"></a>

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
<a name="configure-file-metadata-options"></a>

Anda dapat mengonfigurasi cara DataSync menangani file, objek, dan metadata saat membuat, mengedit, atau memulai tugas transfer Anda.

### Menggunakan DataSync konsol
<a name="configure-metadata-console"></a>

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
<a name="configure-file-metadata-options-api"></a>

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)