Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mentransfer file menggunakan adaptor Amazon S3 untuk migrasi data ke atau dari Snowball Edge
Berikut ini adalah ikhtisar adaptor Amazon S3, yang dapat Anda gunakan untuk mentransfer data secara terprogram ke dan dari bucket S3 yang sudah ada di perangkat menggunakan tindakan AWS Snowball Edge Amazon S3 REST API. Dukungan API REST Amazon S3 terbatas pada subset tindakan. Anda dapat menggunakan subset tindakan ini dengan salah satu AWS SDKs untuk mentransfer data secara terprogram. Anda juga dapat menggunakan subset dari perintah AWS Command Line Interface (AWS CLI) yang didukung untuk Amazon S3 untuk mentransfer data secara terprogram.
Jika solusi Anda menggunakan AWS SDK untuk Java versi 1.11.0 atau yang lebih baru, Anda harus menggunakan yang berikut: `S3ClientOptions`
+ `disableChunkedEncoding()` – Menunjukkan bahwa enkode chunk tidak didukung dengan antarmuka.
+ `setPathStyleAccess(true)` – Mengonfigurasi antarmuka untuk menggunakan akses path-style untuk semua permintaan.
Untuk informasi selengkapnya, lihat [Kelas S3 ClientOptions .Builder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/S3ClientOptions.Builder.html) di *Amazon AppStream SDK* for Java.
**penting**
Kami menyarankan Anda hanya menggunakan satu metode pada satu waktu untuk membaca dan menulis data ke bucket lokal pada AWS Snowball Edge perangkat. Menggunakan antarmuka NFS dan adaptor Amazon S3 pada bucket yang sama pada saat yang sama dapat mengakibatkan read/write konflik.
[AWS Snowball Edge kuota](limits.md)detail batasnya.
Agar AWS layanan berfungsi dengan baik di Snowball Edge, Anda harus mengizinkan port untuk layanan tersebut. Lihat perinciannya di [Persyaratan port untuk AWS layanan di Snowball Edge](port-requirements.md).
**Topics**
+ [Mengunduh dan menginstal AWS CLI versi 1.16.14 untuk digunakan dengan adaptor Amazon S3](#aws-cli-version)
+ [Menggunakan operasi AWS CLI dan API pada perangkat Snowball Edge](#using-adapter-cli-specify-region)
+ [Mendapatkan dan menggunakan kredensyal Amazon S3 lokal di Snowball Edge](#adapter-credentials)
+ [Fitur Amazon S3 yang tidak didukung untuk adaptor Amazon S3 di Snowball Edge](#snowball-edge-s3-unsupported-features)
+ [Mengelompokkan file kecil untuk meningkatkan kinerja transfer data ke Snowball Edge](batching-small-files.md)
+ [AWS CLI Perintah yang didukung untuk transfer data ke atau dari Snowball Edge](using-adapter-cli.md)
+ [Tindakan Amazon S3 REST API yang didukung di Snowball Edge untuk transfer data](using-adapter-supported-api.md)
## Mengunduh dan menginstal AWS CLI versi 1.16.14 untuk digunakan dengan adaptor Amazon S3
Saat ini, perangkat Snowball Edge hanya mendukung versi 1.16.14 dan sebelumnya AWS CLI untuk digunakan dengan adaptor Amazon S3. Versi yang lebih baru tidak AWS CLI kompatibel dengan adaptor Amazon S3 karena mereka tidak mendukung semua fungsionalitas adaptor S3.
**catatan**
Jika Anda menggunakan penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge, Anda dapat menggunakan versi terbaru. AWS CLI Untuk mengunduh dan menggunakan versi terbaru, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
### AWS CLI Instal sistem operasi Linux
Jalankan perintah berantai ini:
```
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.14.zip" -o "awscli-bundle.zip";unzip awscli-bundle.zip;sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws;/usr/local/bin/aws --version;
```
### Instal AWS CLI pada sistem operasi Windows
Unduh dan jalankan file penginstal untuk sistem operasi Anda:
+ [Penginstal 32-bit dibundel dengan Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI32-1.16.14.msi)
+ [Penginstal 32-bit dibundel dengan Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3-1.16.14.msi)
+ [Penginstal 64 bit dibundel dengan Python 2](https://s3.amazonaws.com/aws-cli/AWSCLI64-1.16.14.msi)
+ [Penginstal 64 bit dibundel dengan Python 3](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3-1.16.14.msi)
+ [File setup termasuk installer 32‐ dan 64‐bit yang secara otomatis akan menginstal versi yang benar](https://s3.amazonaws.com/aws-cli/AWSCLISetup-1.16.14.exe)
## Menggunakan operasi AWS CLI dan API pada perangkat Snowball Edge
Saat menggunakan operasi AWS CLI atau API untuk mengeluarkan perintah IAM, Amazon S3, dan EC2 Amazon di Snowball Edge, Anda harus menentukan Wilayah sebagai ".” `snow` Anda dapat melakukan ini menggunakan `AWS configure` atau di dalam perintah itu sendiri, seperti pada contoh berikut.
```
aws configure --profile abc
AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
AWS Secret Access Key [None]: 1234567
Default region name [None]: snow
Default output format [None]: json
```
Atau
```
aws s3 ls --endpoint http://192.0.2.0:8080 --region snow --profile snowballEdge
```
### Otorisasi dengan antarmuka API Amazon S3 untuk AWS Snowball Edge
Saat Anda menggunakan adaptor Amazon S3, setiap interaksi ditandatangani dengan algoritma AWS Signature Version 4 secara default. Otorisasi ini hanya digunakan untuk memverifikasi data yang berjalan dari sumbernya ke antarmuka. Semua enkripsi dan dekripsi terjadi pada perangkat. Data yang tidak terenkripsi tidak pernah disimpan pada perangkat.
Saat menggunakan antarmuka, perhatikan hal berikut:
+ Untuk mendapatkan kredensil Amazon S3 lokal untuk menandatangani permintaan Anda ke AWS Snowball Edge perangkat, jalankan perintah klien dan `snowballEdge list-access-keys` Snowball `snowballEdge get-secret-access-keys` Edge. Untuk informasi selengkapnya, lihat [Mengkonfigurasi dan menggunakan Snowball Edge Client](using-client-commands.md). Kredensial Amazon S3 lokal ini mencakup sepasang kunci: access key dan kunci rahasia. Kunci ini hanya berlaku untuk perangkat yang terkait dengan tugas Anda. Mereka tidak dapat digunakan di AWS Cloud karena mereka tidak memiliki mitra AWS Identity and Access Management (IAM).
+ Kunci enkripsi tidak diubah oleh AWS kredensi apa yang Anda gunakan. Penandatanganan dengan algoritme Signature Version 4 hanya digunakan untuk memverifikasi data yang berjalan dari sumbernya ke antarmuka. Dengan demikian, penandatanganan ini tidak pernah memperhitungkan kunci enkripsi yang digunakan untuk mengenkripsi data Anda pada Snowball.
## Mendapatkan dan menggunakan kredensyal Amazon S3 lokal di Snowball Edge
Setiap interaksi dengan Snowball Edge ditandatangani dengan algoritma AWS Signature Version 4. Untuk informasi selengkapnya tentang algoritme, lihat [Proses Penandatanganan Versi Tanda Tangan 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) di *Referensi Umum AWS*.
Anda bisa mendapatkan kredensi Amazon S3 lokal untuk menandatangani permintaan Anda ke perangkat Edge klien Snowball Edge dengan menjalankan informasi klien Snowball Edge dan `snowballEdge list-access-keys` Snowball `snowballEdge get-secret-access-key` Edge, lihat. [Mendapatkan kredensi untuk Snowball Edge](using-client-commands.md#client-credentials) Kredensial Amazon S3 lokal ini mencakup sepasang kunci: access key ID dan kunci rahasia. Kredensial ini hanya berlaku untuk perangkat yang terkait dengan tugas Anda. Mereka tidak dapat digunakan di AWS Cloud karena mereka tidak memiliki mitra IAM.
Anda dapat menambahkan kredensyal ini ke file AWS kredensyal di server Anda. File profil kredensial default biasanya terletak di `~/.aws/credentials`, tetapi lokasi dapat bervariasi per platform. File ini dibagikan oleh banyak AWS SDKs dan oleh AWS CLI. Anda dapat menyimpan kredensial lokal dengan nama profil seperti dalam contoh berikut.
```
[snowballEdge]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Mengkonfigurasi AWS CLI untuk menggunakan adaptor S3 pada Snowball Edge sebagai titik akhir
Saat Anda menggunakan perintah AWS CLI untuk mengeluarkan perintah ke AWS Snowball Edge perangkat, Anda menentukan bahwa titik akhir adalah adaptor Amazon S3. Anda memiliki pilihan untuk menggunakan titik akhir HTTPS, atau titik akhir HTTP tidak aman, seperti yang ditunjukkan berikut.
**Titik akhir yang diamankan HTTPS**
```
aws s3 ls --endpoint https://192.0.2.0:8443 --ca-bundle path/to/certificate --profile snowballEdge
```
**Titik akhir HTTP tidak aman**
```
aws s3 ls --endpoint http://192.0.2.0:8080 --profile snowballEdge
```
Jika Anda menggunakan titik akhir HTTPS `8443`, data Anda ditransfer dengan aman dari server Anda ke Snowball Edge. Enkripsi ini dipastikan dengan sertifikat yang dihasilkan oleh Snowball Edge ketika mendapat alamat IP baru. Setelah Anda memiliki sertifikat, Anda dapat menyimpannya ke file `ca-bundle.pem` lokal. Kemudian Anda dapat mengonfigurasi AWS CLI profil Anda untuk menyertakan jalur ke sertifikat Anda, seperti yang dijelaskan berikut.
**Untuk mengaitkan sertifikat Anda dengan titik akhir antarmuka**
1. Connect Snowball Edge ke daya dan jaringan, dan nyalakan.
1. Setelah perangkat selesai melakukan booting, catat alamat IP-nya di jaringan lokal Anda.
1. Dari terminal di jaringan Anda, pastikan Anda dapat melakukan ping Snowball Edge.
1. Jalankan perintah `snowballEdge get-certificate` di terminal Anda. Untuk informasi lebih lanjut tentang perintah ini, lihat [Mengelola sertifikat kunci publik di Snowball Edge](snowball-edge-certificates-cli.md).
1. Simpan output dari perintah `snowballEdge get-certificate` ke file, misalnya `ca-bundle.pem`.
1. Jalankan perintah berikut dari terminal Anda.
```
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
```
Setelah Anda menyelesaikan prosedur, Anda dapat menjalankan perintah CLI dengan kredensial lokal ini, sertifikat Anda, dan titik akhir yang ditentukan, seperti dalam contoh berikut.
```
aws s3 ls --endpoint https://192.0.2.0:8443 --profile snowballEdge
```
## Fitur Amazon S3 yang tidak didukung untuk adaptor Amazon S3 di Snowball Edge
Menggunakan adaptor Amazon S3, Anda dapat mentransfer data secara terprogram ke dan dari Snowball Edge dengan tindakan API Amazon S3. Namun, tidak semua fitur transfer Amazon S3 dan tindakan API didukung untuk digunakan dengan perangkat Snowball Edge saat menggunakan adaptor Amazon S3. Misalnya, fitur dan tindakan dan fitur berikut tidak didukung untuk digunakan dengan Snowball Edge:
+ [TransferManager](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/examples-s3-transfermanager.html)— Utilitas ini mentransfer file dari lingkungan lokal ke Amazon S3 dengan SDK for Java. Pertimbangkan untuk menggunakan tindakan API yang didukung atau perintah AWS CLI dengan antarmuka sebagai gantinya.
+ [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) – Implementasi tindakan GET ini menghasilkan beberapa atau semua (hingga 1.000) objek dalam bucket. Pertimbangkan untuk menggunakan tindakan [GET Bucket (List Objects) Version 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) atau perintah AWS CLI [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html).
+ [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)— Titik akhir ListBuckets dengan objek tidak didukung. Perintah berikut tidak berfungsi dengan penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge:
```
aws s3 ls --endpoint https://192.0.2.0 --profile profile
```
# Mengelompokkan file kecil untuk meningkatkan kinerja transfer data ke Snowball Edge
Setiap salinan operasi memiliki beberapa overhead karena enkripsi. Untuk mempercepat proses mentransfer file kecil ke AWS Snowball Edge perangkat Anda, Anda dapat menggabungkannya bersama-sama dalam satu arsip. Ketika Anda melakukan batch file bersama, file-file tersebut dapat diekstrak secara otomatis saat diimpor ke Amazon S3, jika file-file tersebut di-batch ke dalam salah satu format arsip yang didukung.
Biasanya, file yang berukuran 1 MB atau lebih kecil harus disertakan dalam batch. Tidak ada batas keras pada jumlah file yang dapat Anda miliki dalam batch, kami merekomendasikan Anda membatasi batch Anda ke sekitar 10.000 file. Memiliki lebih dari 100.000 file dalam satu batch dapat mempengaruhi seberapa cepat file tersebut mengimpor ke Amazon S3 setelah Anda mengembalikan perangkat. Kami merekomendasikan bahwa ukuran total setiap batch tidak lebih besar dari 100 GB.
Pengelompokkan file adalah proses manual, yang Anda kelola. Setelah Anda mengumpulkan file Anda, transfer ke perangkat Snowball Edge menggunakan AWS CLI `cp` perintah dengan opsi. `--metadata snowball-auto-extract=true` Menentukan `snowball-auto-extract=true` secara otomatis mengekstrak isi file yang diarsipkan saat data diimpor ke Amazon S3, asalkan ukuran file yang dikelompokkan tidak lebih besar dari 100 GB.
**catatan**
Setiap batch yang lebih besar dari 100 GB tidak diekstraksi ketika diimpor ke Amazon S3.
**Untuk melakukan batch file kecil**
1. Tentukan format apa yang Anda inginkan untuk melakukan batch file-file kecil Anda. Fitur ekstrak otomatis mendukung format `TAR`, `ZIP`, dan `tar.gz`.
1. Identifikasi file kecil yang Anda ingin lakukan batch bersama, termasuk ukuran dan jumlah total file yang ingin Anda kelompokkan bersama.
1. Batch file-file Anda pada baris perintah seperti yang ditunjukkan dalam contoh berikut.
+ Untuk Linux, Anda dapat melakukan batch file di baris perintah yang sama yang digunakan untuk mentransfer file Anda ke perangkat.
```
tar -cf - /Logs/April | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.tar --metadata snowball-auto-extract=true --endpoint http://192.0.2.0:8080
```
**catatan**
Atau, Anda dapat menggunakan utilitas arsip pilihan Anda untuk melakukan batch file menjadi satu atau lebih arsip besar. Namun, pendekatan ini membutuhkan penyimpanan lokal ekstra untuk menyimpan arsip sebelum Anda mentransfernya ke Snowball Edge.
+ Untuk Windows, gunakan perintah contoh berikut untuk mengumpulkan file ketika semua file berada di direktori yang sama dari mana perintah dijalankan:
```
7z a -tzip -so "test" | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.zip --metadata snowball-auto-extract=true --endpoint http://192.0.2.0:8080
```
Untuk batch file dari direktori yang berbeda dari mana perintah dijalankan, gunakan perintah contoh berikut:
```
7z a -tzip -so "test" "c:\temp" | aws s3 cp - s3://amzn-s3-demo-bucket/batch01.zip --metadata snowball-auto-extract=true --endpoint http://10.x.x.x:8080
```
**catatan**
Untuk Microsoft Windows 2016, tar tidak tersedia, namun Anda dapat mengunduhnya dari situs web *Tar untuk Windows*.
Anda dapat mengunduh 7 ZIP dari situs web 7ZIP.
1. Ulangi sampai Anda telah mengarsipkan semua file kecil yang ingin Anda transfer ke Amazon S3 menggunakan Snowball Edge.
1. Mentransfer file yang diarsipkan ke Snowball. Jika Anda ingin data diekstraksi secara otomatis, dan Anda menggunakan salah satu format arsip yang didukung yang disebutkan sebelumnya di langkah 1, gunakan AWS CLI `cp` perintah dengan opsi. `--metadata snowball-auto-extract=true`
**catatan**
Jika ada file non-arsip, jangan gunakan perintah ini.
Saat membuat file arsip, ekstraksi akan mempertahankan struktur data saat ini. Ini berarti jika Anda membuat file arsip yang berisi file dan folder, Snowball Edge akan membuat ulang ini selama proses penyerapan ke Amazon S3.
File arsip akan diekstrak di direktori yang sama dalam tempat penyimpanannya dan struktur folder akan dibangun sesuai dengan itu. Perlu diingat bahwa saat menyalin file arsip, penting untuk mengatur bendera`--metadata snowball-auto-extract=true`. Jika tidak, Snowball Edge tidak akan mengekstrak data saat diimpor ke Amazon S3.
Menggunakan contoh di langkah 3, jika Anda memiliki struktur folder /Logs/April/ yang berisi file `a.txt`, `b.txt` dan `c.txt`. Jika file arsip ini ditempatkan di root/amzn-s3-demo-bucket/maka data akan terlihat seperti berikut setelah ekstraksi:
```
/amzn-s3-demo-bucket/Logs/April/a.txt
/amzn-s3-demo-bucket/Logs/April/b.txt
/amzn-s3-demo-bucket/Logs/April/c.txt
```
Jika file arsip ditempatkan ke amzn-s3-demo-bucket//Test/, maka ekstraksi akan terlihat seperti berikut:
```
/amzn-s3-demo-bucket/Test/Logs/April/a.txt
/amzn-s3-demo-bucket/Test/Logs/April/b.txt
/amzn-s3-demo-bucket/Test/Logs/April/c.txt
```
# AWS CLI Perintah yang didukung untuk transfer data ke atau dari Snowball Edge
Berikut ini, Anda dapat menemukan informasi tentang cara menentukan adaptor Amazon S3 atau penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge sebagai titik akhir untuk perintah () yang berlaku. AWS Command Line Interface AWS CLI Anda juga dapat menemukan daftar AWS CLI perintah untuk Amazon S3 yang didukung untuk mentransfer data ke AWS Snowball Edge perangkat dengan adaptor atau penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge.
**catatan**
Untuk informasi tentang menginstal dan menyiapkan AWS CLI, termasuk menentukan Wilayah yang ingin Anda lakukan AWS CLI panggilan, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
Saat ini, perangkat Snowball Edge hanya mendukung versi 1.16.14 dan sebelumnya AWS CLI saat menggunakan adaptor Amazon S3. Lihat [Menemukan versi klien Snowball Edge](using-adapter.md#aws-cli-version). Jika Anda menggunakan penyimpanan yang kompatibel dengan Amazon S3 di Snowball Edge, Anda dapat menggunakan versi terbaru. AWS CLI Untuk mengunduh dan menggunakan versi terbaru, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
**catatan**
Pastikan untuk menginstal Python versi 2.6.5\$1 atau 3.4\$1 sebelum Anda menginstal AWS CLI versi 1.16.14.
## AWS CLI Perintah yang didukung untuk transfer data dengan Amazon S3 dan Snowball Edge
Berikut ini adalah deskripsi subset AWS CLI perintah dan opsi untuk Amazon S3 yang AWS Snowball Edge didukung perangkat. Jika perintah atau opsi tidak tercantum, perintah tersebut tidak didukung. Anda dapat menyatakan beberapa pilihan yang tidak didukung, seperti `--sse` atau `--storage-class`, bersama dengan perintah. Namun, hal ini diabaikan dan tidak berdampak pada cara data diimpor.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) — Menyalin file atau objek ke atau dari AWS Snowball Edge perangkat. Berikut ini adalah pilihan untuk perintah ini:
+ `--dryrun` (Boolean) – Operasi yang akan dilakukan dengan menggunakan perintah tertentu ditampilkan tanpa dijalankan.
+ `--quiet` (Boolean) – Operasi yang dilakukan oleh perintah yang ditentukan tidak ditampilkan.
+ `--include` (string) – Jangan mengecualikan file atau objek dalam perintah yang sesuai dengan pola yang ditentukan. Untuk detailnya, lihat [Penggunaan Kecualikan dan Sertakan Filter](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) di *Referensi Perintah AWS CLI *.
+ `--exclude` (string) – Mengecualikan semua file atau objek dari perintah yang cocok dengan pola yang ditentukan.
+ `--follow-symlinks | --no-follow-symlinks` (Boolean) – Tautan simbolik (symlink) diikuti hanya ketika mengunduh ke Amazon S3 dari sistem file lokal. Amazon S3 tidak mendukung tautan simbolik, sehingga isi target tautan diunggah dengan nama tautan. Ketika opsi tidak ditentukan, default-nya mengikuti symlink.
+ `--only-show-errors` (Boolean) – Hanya kesalahan dan peringatan yang ditampilkan. Semua output lainnya ditekan.
+ `--recursive` (Boolean) – Perintah ini dilakukan pada semua file atau objek di bawah direktori atau awalan tertentu.
+ `--page-size` (integer) – Jumlah hasil yang dihasilkan di setiap respons terhadap operasi daftar. Nilai default adalah 1000 (maksimum yang diizinkan). Menggunakan nilai yang lebih rendah dapat membantu jika operasi kali keluar.
+ `--metadata` (peta) – Peta metadata untuk menyimpan dengan objek di Amazon S3. Peta ini diterapkan untuk setiap objek yang merupakan bagian dari permintaan ini. Dalam sinkronisasi, fungsi ini berarti file yang tidak berubah tidak menerima metadata baru. Saat menyalin antara dua lokasi Amazon S3, argumen `metadata-directive` default ke `REPLACE` kecuali ditentukan.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) — Daftar objek pada AWS Snowball Edge perangkat. Berikut ini adalah pilihan untuk perintah ini:
+ `--human-readable` (Boolean) – Ukuran file ditampilkan dalam format yang dapat dibaca manusia.
+ `--summarize` (Boolean) – Ringkasan informasi ditampilkan. Informasi ini adalah jumlah objek dan ukuran totalnya.
+ `--recursive` (Boolean) – Perintah ini dilakukan pada semua file atau objek di bawah direktori atau awalan tertentu.
+ `--page-size` (integer) – Jumlah hasil yang dihasilkan di setiap respons terhadap operasi daftar. Nilai default adalah 1000 (maksimum yang diizinkan). Menggunakan nilai yang lebih rendah dapat membantu jika operasi kali keluar.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) — Menghapus objek pada AWS Snowball Edge perangkat. Berikut ini adalah pilihan untuk perintah ini:
+ `--dryrun` (Boolean) – Operasi yang akan dilakukan dengan menggunakan perintah tertentu ditampilkan tanpa dijalankan.
+ `--include` (string) – Jangan mengecualikan file atau objek dalam perintah yang sesuai dengan pola yang ditentukan. Untuk detailnya, lihat [Penggunaan Kecualikan dan Sertakan Filter](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) di *Referensi Perintah AWS CLI *.
+ `--exclude` (string) – Mengecualikan semua file atau objek dari perintah yang cocok dengan pola yang ditentukan.
+ `--recursive` (Boolean) – Perintah ini dilakukan pada semua file atau objek di bawah direktori atau awalan tertentu.
+ `--page-size` (integer) – Jumlah hasil yang dihasilkan di setiap respons terhadap operasi daftar. Nilai default adalah 1000 (maksimum yang diizinkan). Menggunakan nilai yang lebih rendah dapat membantu jika operasi kali keluar.
+ `--only-show-errors` (Boolean) – Hanya kesalahan dan peringatan yang ditampilkan. Semua output lainnya ditekan.
+ `--quiet` (Boolean) – Operasi yang dilakukan oleh perintah yang ditentukan tidak ditampilkan.
+ [sync](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) – Menyinkronkan direktori dan awalan. Perintah ini menyalin file yang baru dan diperbarui dari direktori sumber ke tujuan. Perintah ini hanya membuat direktori di tujuan jika direktori berisi satu atau lebih file.
**penting**
Sinkronisasi dari satu direktori ke direktori lain pada Snowball Edge yang sama tidak didukung.
Sinkronisasi dari satu AWS Snowball Edge perangkat ke AWS Snowball Edge perangkat lain tidak didukung.
Anda hanya dapat menggunakan opsi ini untuk menyinkronkan konten antara penyimpanan data on-premise dan Snowball Edge.
+ `--dryrun` (Boolean) – Operasi yang akan dilakukan dengan menggunakan perintah tertentu ditampilkan tanpa dijalankan.
+ `--quiet` (Boolean) – Operasi yang dilakukan oleh perintah yang ditentukan tidak ditampilkan.
+ `--include` (string) – Jangan mengecualikan file atau objek dalam perintah yang sesuai dengan pola yang ditentukan. Untuk detailnya, lihat [Penggunaan Kecualikan dan Sertakan Filter](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters) di *Referensi Perintah AWS CLI *.
+ `--exclude` (string) – Mengecualikan semua file atau objek dari perintah yang cocok dengan pola yang ditentukan.
+ `--follow-symlinks` or `--no-follow-symlinks` (Boolean) – Tautan simbolik (symlink) diikuti hanya ketika mengunggah ke Amazon S3 dari sistem file lokal. Amazon S3 tidak mendukung tautan simbolik, sehingga isi target tautan diunggah dengan nama tautan. Ketika opsi tidak ditentukan, default-nya mengikuti symlink.
+ `--only-show-errors` (Boolean) – Hanya kesalahan dan peringatan yang ditampilkan. Semua output lainnya ditekan.
+ `--no-progress` (Boolean) – Kemajuan file transfer tidak ditampilkan. Opsi ini hanya diterapkan ketika pilihan `--quiet` dan `--only-show-errors` tidak tersedia.
+ `--page-size` (integer) – Jumlah hasil yang dihasilkan di setiap respons terhadap operasi daftar. Nilai default adalah 1000 (maksimum yang diizinkan). Menggunakan nilai yang lebih rendah dapat membantu jika operasi kali keluar.
+ `--metadata` (peta) – Peta metadata untuk menyimpan dengan objek di Amazon S3. Peta ini diterapkan untuk setiap objek yang merupakan bagian dari permintaan ini. Dalam sinkronisasi, fungsi ini berarti file yang tidak berubah tidak menerima metadata baru. Saat menyalin antara dua lokasi Amazon S3, argumen `metadata-directive` default ke `REPLACE` kecuali ditentukan.
**penting**
Sinkronisasi dari satu direktori ke direktori lain pada Snowball Edge yang sama tidak didukung.
Sinkronisasi dari satu AWS Snowball Edge perangkat ke AWS Snowball Edge perangkat lain tidak didukung.
Anda hanya dapat menggunakan opsi ini untuk menyinkronkan konten antara penyimpanan data on-premise dan Snowball Edge.
+ `--size-only` (Boolean) – Dengan opsi ini, ukuran setiap kunci adalah satu-satunya kriteria yang digunakan untuk memutuskan apakah akan melakukan sinkronisasi dari sumber ke tujuan.
+ `--exact-timestamps` (Boolean) – Ketika sinkronisasi dari Amazon S3 ke penyimpanan lokal, item berukuran sama diabaikan hanya ketika cap waktu cocok persis. Perilaku default adalah untuk mengabaikan item yang berukuran sama kecuali versi lokal lebih baru dari versi Amazon S3.
+ `--delete` (Boolean) – File yang ada di tujuan tetapi tidak di dalam sumber dihapus selama sinkronisasi.
Anda dapat bekerja dengan file atau folder dengan spasi dalam nama mereka, seperti `my photo.jpg` atau `My Documents`. Namun, pastikan Anda menangani spasi dengan benar dalam AWS CLI perintah. Untuk informasi selengkapnya, lihat [Menentukan nilai parameter untuk AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html) di *Panduan Pengguna AWS Command Line Interface *.
# Tindakan Amazon S3 REST API yang didukung di Snowball Edge untuk transfer data
Berikut ini, Anda dapat menemukan daftar tindakan Amazon S3 REST API yang didukung untuk menggunakan adaptor Amazon S3. Daftar ini menyertakan tautan ke informasi tentang bagaimana tindakan API bekerja dengan Amazon S3. Daftar ini juga mencakup perbedaan perilaku antara tindakan API Amazon S3 dan mitra AWS Snowball Edge perangkat. Semua tanggapan yang datang kembali dari AWS Snowball Edge perangkat menyatakan `Server` sebagai`AWSSnowball`, seperti pada contoh berikut.
```
HTTP/1.1 201 OK
x-amz-id-2: JuKZqmXuiwFeDQxhD7M8KtsKobSzWA1QEjLbTMTagkKdBX2z7Il/jGhDeJ3j6s80
x-amz-request-id: 32FE2CEB32F5EE25
Date: Fri, 08 2016 21:34:56 GMT
Server: AWSSnowball
```
Panggilan REST API Amazon S3 memerlukan penandatanganan SigV4. Jika Anda menggunakan AWS CLI atau AWS SDK untuk melakukan panggilan API ini, penandatanganan SigV4 ditangani untuk Anda. Jika tidak, Anda harus menerapkan solusi penandatanganan SigV4 Anda sendiri. Untuk informasi selengkapnya, lihat [Mengautentikasi permintaan (Versi AWS Tanda Tangan 4)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/sig-v4-authenticating-requests.html) di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.
+ [GET Bucket (List Objects) versi 1](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGET.html) – Didukung. Namun, dalam implementasi operasi GET ini, berikut ini tidak didukung:
+ Paginasi
+ Penanda
+ Pembatas
+ Ketika daftar dikembalikan, daftar tidak diurutkan
Hanya versi 1 yang didukung. GET Bucket (List Objects) versi 2 tidak didukung.
+ [DAPATKAN Layanan](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTServiceGET.html)
+ [Ember KEPALA](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketHEAD.html)
+ [Objek HEAD](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html)
+ [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) - adalah DOWNLOAD objek dari ember S3 perangkat Snow.
+ [PUT Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) - Ketika sebuah objek diunggah ke AWS Snowball Edge perangkat menggunakan`PUT Object`, sebuah ETag dihasilkan.
ETag Itu adalah hash dari objek. ETag Merefleksikan perubahan hanya pada isi objek, bukan metadatanya. ETag Mungkin atau mungkin bukan MD5 intisari data objek. Untuk informasi selengkapnya ETags, lihat [Header Respons Umum](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html) di *Referensi API Amazon Simple Storage Service*.
+ [HAPUS Objek](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html)
+ [Memulai Unggahan Multipart](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html) — Dalam implementasi ini, memulai permintaan unggahan multibagian untuk objek yang sudah ada di AWS Snowball Edge perangkat akan menghapus objek tersebut terlebih dahulu. Kemudian menyalinnya menjadi beberapa bagian ke AWS Snowball Edge perangkat.
+ [Daftarkan Unggahan Multibagian](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)
+ [Unggah Bagian](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadUploadPart.html)
+ [Selesaikan Unggahan Multibagian](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadComplete.html)
+ [Batalkan Unggahan Multibagian](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadAbort.html)
**catatan**
Tindakan REST API adaptor Amazon S3 apa pun yang tidak tercantum di sini tidak didukung. Menggunakan tindakan REST API yang tidak didukung dengan Snowball Edge Anda menghasilkan pesan kesalahan yang mengatakan bahwa tindakan tidak didukung.