Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Demo unggahan dasar CoreHTTP Amazon S3
**penting**
Demo ini di-host di repositori Amazon-Freertos yang tidak digunakan lagi. Kami menyarankan Anda [mulai di sini](freertos-getting-started-modular.md) ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori Amazon-Freertos yang sekarang tidak digunakan lagi, lihat. [Panduan Migrasi Repositori Github Amazon-freertos](github-repo-migration.md)
## Pengantar
Contoh ini menunjukkan cara mengirim permintaan PUT ke server HTTP Amazon Simple Storage Service (Amazon S3) Simple Storage S3) dan mengunggah file kecil. Ini juga melakukan permintaan GET untuk memverifikasi ukuran file setelah unggahan. Contoh ini menggunakan [antarmuka transportasi jaringan](https://freertos.org/network-interface.html) yang menggunakan mBEDTLS untuk membuat koneksi yang saling diautentikasi antara klien perangkat IoT yang menjalankan CoreHTTP dan server HTTP Amazon S3.
**catatan**
Untuk mengatur dan menjalankan demo FreeRTOS, ikuti langkah-langkahnya. [Memulai dengan FreeRTOS](freertos-getting-started.md)
### Berulir tunggal versus multi ulir
Ada dua model penggunaan CoreHTTP, *single threaded dan *multithreaded** (multitasking). Meskipun demo di bagian ini menjalankan perpustakaan HTTP di utas, ini sebenarnya menunjukkan cara menggunakan CoreHTTP dalam satu lingkungan berulir. Hanya satu tugas dalam demo ini yang menggunakan HTTP API. Meskipun aplikasi single threaded harus berulang kali memanggil perpustakaan HTTP, aplikasi multithreaded malah dapat mengirim permintaan HTTP di latar belakang dalam tugas agen (atau daemon).
## Organisasi kode sumber
File sumber demo diberi nama `http_demo_s3_upload.c` dan dapat ditemukan di `freertos/demos/coreHTTP/` direktori dan di [ GitHub](https://github.com/aws/amazon-freertos/blob/main/demos/coreHTTP/http_demo_s3_upload.c)situs web.
## Mengkonfigurasi koneksi server HTTP Amazon S3
Demo ini menggunakan URL yang telah ditandatangani sebelumnya untuk terhubung ke server HTTP Amazon S3 dan mengotorisasi akses ke objek untuk diunduh. Koneksi TLS server HTTP Amazon S3 hanya menggunakan otentikasi server. Pada tingkat aplikasi, akses ke objek diautentikasi dengan parameter dalam kueri URL yang telah ditandatangani sebelumnya. Ikuti langkah-langkah di bawah ini untuk mengonfigurasi koneksi Anda AWS.
1. Siapkan AWS akun:
1. Jika Anda belum melakukannya, [buat AWS akun](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/).
1. Akun dan izin ditetapkan menggunakan AWS Identity and Access Management (IAM). Anda menggunakan IAM untuk mengelola izin untuk setiap pengguna di akun Anda. Secara default, pengguna tidak memiliki izin sampai diberikan oleh pemilik root.
1. Untuk menambahkan pengguna ke AWS akun Anda, lihat [Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
1. Berikan izin ke AWS akun Anda untuk mengakses FreeRTOS AWS IoT dan dengan menambahkan kebijakan ini:
+ AmazonS3 FullAccess
1. Buat bucket di Amazon S3 dengan mengikuti langkah-langkah di [Bagaimana cara membuat bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html)? di *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon*.
1. Unggah file ke Amazon S3 dengan mengikuti langkah-langkah di [Bagaimana cara mengunggah file dan folder ke bucket S3](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/upload-objects.html)? .
1. Hasilkan URL yang telah ditandatangani sebelumnya menggunakan skrip yang terletak di `FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator/Common/presigned_url_generator/presigned_urls_gen.py` file.
Untuk petunjuk penggunaan, lihat `FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator/Common/presigned_url_generator/README.md` file.
## Fungsionalitas
Demo pertama terhubung ke server HTTP Amazon S3 dengan otentikasi server TLS. Kemudian, itu membuat permintaan HTTP untuk mengunggah data yang ditentukan dalam`democonfigDEMO_HTTP_UPLOAD_DATA`. Setelah mengunggah file, ia memeriksa bahwa file berhasil diunggah dengan meminta ukuran file. Kode sumber untuk demo dapat ditemukan di situs [GitHub](https://github.com/aws/amazon-freertos/blob/main/demos/coreHTTP/http_demo_s3_upload.c)web.
### Menghubungkan ke server HTTP Amazon S3
[ connectToServerWithBackoffRetries](https://github.com/aws/amazon-freertos/blob/main/demos/common/http_demo_helpers/http_demo_utils.c#L131-L170)Fungsi ini mencoba untuk membuat koneksi TCP ke server HTTP. Jika koneksi gagal, ia mencoba lagi setelah batas waktu. Nilai batas waktu akan meningkat secara eksponensial hingga jumlah upaya maksimum tercapai atau nilai batas waktu maksimum tercapai. `connectToServerWithBackoffRetries`Fungsi mengembalikan status kegagalan jika koneksi TCP ke server tidak dapat dibuat setelah jumlah upaya yang dikonfigurasi.
`prvConnectToServer`Fungsi ini menunjukkan cara membuat koneksi ke server HTTP Amazon S3 dengan menggunakan otentikasi server saja. Ini menggunakan antarmuka transport berbasis MBEDTLS yang diimplementasikan dalam file. `FreeRTOS-Plus/Source/Application-Protocols/network_transport/freertos_plus_tcp/using_mbedtls/using_mbedtls.c` Definisi `prvConnectToServer` dapat ditemukan di situs [GitHub](https://github.com/aws/amazon-freertos/blob/main/demos/coreHTTP/http_demo_s3_upload.c#L306-L366)web.
### Unggah data
`prvUploadS3ObjectFile`Fungsi ini menunjukkan cara membuat permintaan PUT dan menentukan file yang akan diunggah. Bucket Amazon S3 tempat file diunggah dan nama file yang akan diunggah ditentukan dalam URL yang telah ditandatangani sebelumnya. Untuk menyimpan memori, buffer yang sama digunakan untuk header permintaan dan untuk menerima respons. Respons diterima secara sinkron menggunakan fungsi `HTTPClient_Send` API. Kode status `200 OK` respons diharapkan dari server HTTP Amazon S3. Kode status lainnya adalah kesalahan.
Kode sumber untuk `prvUploadS3ObjectFile()` dapat ditemukan di situs [ GitHub](https://github.com/aws/amazon-freertos/blob/main/demos/coreHTTP/http_demo_s3_upload.c#L539-L632)web.
### Memverifikasi unggahan
`prvVerifyS3ObjectFileSize`Fungsi ini memanggil `prvGetS3ObjectFileSize` untuk mengambil ukuran objek di bucket S3. Server HTTP Amazon S3 saat ini tidak mendukung permintaan HEAD menggunakan URL yang telah ditandatangani sebelumnya, jadi byte ke-0 diminta. Ukuran file terkandung dalam bidang `Content-Range` header respon. `206 Partial Content`Respons diharapkan dari server. Kode status respons lainnya adalah kesalahan.
Kode sumber untuk `prvGetS3ObjectFileSize()` dapat ditemukan di situs [ GitHub](https://github.com/aws/amazon-freertos/blob/main/demos/coreHTTP/http_demo_s3_upload.c#L370-L535)web.