Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # HTTP Tindakan HTTPS (`http`) mengirimkan data dari pesan MQTT ke titik akhir HTTPS, yang dapat menunjuk ke aplikasi atau layanan web. ## Persyaratan Tindakan aturan ini memiliki persyaratan sebagai berikut: + Anda harus mengonfirmasi dan mengaktifkan HTTPS titik akhir sebelum mesin aturan dapat menggunakannya. Untuk informasi selengkapnya, lihat [Tujuan aksi HTTP](http-action-destination.md). ## Parameter Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut: `url` Titik akhir HTTPS tempat pesan dikirim menggunakan metode HTTP POST. Jika Anda menggunakan alamat IP sebagai pengganti nama host, itu harus berupa IPv4 alamat. IPv6 alamat tidak didukung. Mendukung [template substitusi](iot-substitution-templates.md): Ya `confirmationUrl` (Opsional) Jika ditentukan, AWS IoT gunakan URL konfirmasi untuk membuat tujuan aturan topik yang cocok. Anda harus mengaktifkan tujuan tindakan HTTP sebelum menggunakannya dalam tindakan HTTP. Untuk informasi selengkapnya, lihat [Tujuan aksi HTTP](http-action-destination.md). Jika Anda menggunakan templat substitusi, Anda harus membuat tujuan tindakan HTTP secara manual sebelum `http` tindakan dapat digunakan. `confirmationUrl`harus menjadi awalan dari. `url` Hubungan antara `url` dan `confirmationUrl` dijelaskan sebagai berikut: + Jika `url` di-hardcode dan tidak `confirmationUrl` disediakan, kami secara implisit memperlakukan bidang tersebut sebagai. `url` `confirmationUrl` AWS IoT membuat tujuan aturan topik untuk`url`. + Jika `url` dan `confirmationUrl` di-hardcode, `url` harus dimulai dengan. `confirmationUrl` AWS IoT membuat tujuan aturan topik untuk`confirmationUrl`. + Jika `url` berisi template substitusi, Anda harus menentukan `confirmationUrl` dan `url` harus mulai dengan`confirmationUrl`. Jika `confirmationUrl` berisi templat substitusi, Anda harus membuat tujuan tindakan HTTP secara manual sebelum `http` tindakan dapat digunakan. Jika `confirmationUrl` tidak berisi templat substitusi, AWS IoT buat tujuan aturan topik untuk`confirmationUrl`. Mendukung [template substitusi](iot-substitution-templates.md): Ya `headers` (Opsional) Daftar header untuk disertakan dalam permintaan HTTP ke titik akhir. Setiap header harus berisi informasi berikut: `key` Kunci header. Mendukung [template substitusi](iot-substitution-templates.md): Tidak `value` Nilai header. Mendukung [template substitusi](iot-substitution-templates.md): Ya Jenis konten default adalah application/json ketika payload dalam format JSON. Jika tidak, itu adalah application/octet-stream. Anda dapat menimpa dengan menentukan jenis konten yang tepat di header dengan tipe konten kunci (case insensitive). `auth` (Opsional) Otentikasi yang digunakan oleh mesin aturan untuk terhubung ke URL titik akhir yang ditentukan dalam argumen. `url` Saat ini, Signature Version 4 adalah satu-satunya jenis otentikasi yang didukung. Untuk informasi selengkapnya, lihat [Otorisasi HTTP](https://docs.aws.amazon.com/iot/latest/apireference/API_HttpAuthorization.html). Mendukung [template substitusi](iot-substitution-templates.md): Tidak `enableBatching` (Opsional) Apakah akan memproses pesan tindakan HTTP menjadi satu permintaan untuk url yang diberikan. Nilai bisa benar atau salah. Untuk informasi selengkapnya tentang pengelompokan, lihat [Mengelompokkan pesan tindakan HTTP](http_batching.md). Nilai Boolean Mendukung [template substitusi](iot-substitution-templates.md): Tidak `batchConfig` (Opsional) Pengaturan konfigurasi untuk batching. Setelah diaktifkan, `batchConfig` parameter harus ditentukan. Jika `batchConfig` parameter tidak ditentukan, nilai default akan digunakan. `maxBatchOpenMs` Jumlah waktu maksimum (dalam milidetik) pesan keluar menunggu pesan lain untuk membuat batch. Semakin tinggi pengaturan, semakin lama latensi tindakan HTTP batch. Nilai Minimum: 5 ms. Nilai Maksimum: 200 ms. Nilai Default: 20 ms Mendukung [template substitusi](iot-substitution-templates.md): Tidak `maxBatchSize` Jumlah maksimum pesan yang dikumpulkan bersama dalam satu eksekusi tindakan. Mendukung [template substitusi](iot-substitution-templates.md): Tidak Nilai Minimum: 2 pesan. Nilai Maksimum: 10 pesan Nilai Default: 10 pesan `maxBatchSizeBytes` Ukuran maksimum kumpulan pesan, dalam byte. Nilai Minimum: 100 byte. Nilai Maksimum: 131.072 byte Nilai Default: 5.120 byte Mendukung [template substitusi](iot-substitution-templates.md): Tidak Jenis konten default adalah application/json ketika payload dalam format JSON. Jika tidak, itu adalah application/octet-stream. Anda dapat menimpa dengan menentukan jenis konten yang tepat di header dengan tipe konten kunci (case insensitive). ## Contoh Contoh JSON berikut mendefinisikan AWS IoT aturan dengan tindakan HTTP. ``` { "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com", "headers": [ { "key": "static_header_key", "value": "static_header_value" }, { "key": "substitutable_header_key", "value": "${value_from_payload}" } ] } } ] } } ``` ``` "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com", "headers": [ { "key": "Content-Type", "value": "application/json" } ], "enableBatching": true, "batchConfig": { "maxBatchOpenMs": 123, "maxBatchSize": 5, "maxBatchSizeBytes": 131072, } }, "errorAction": { "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com" // batchConfig is not allowed here } } ``` ## Logika coba lagi tindakan HTTP Mesin AWS IoT aturan mencoba ulang tindakan HTTP sesuai dengan aturan ini: + Mesin aturan mencoba mengirim pesan setidaknya sekali. + Mesin aturan mencoba ulang paling banyak dua kali. Jumlah percobaan maksimum adalah tiga. + Mesin aturan tidak mencoba lagi jika: + Percobaan sebelumnya memberikan respons yang lebih besar dari 16.384 byte. + Layanan web hilir atau aplikasi menutup koneksi TCP setelah mencoba. + Total waktu untuk menyelesaikan permintaan dengan percobaan ulang melebihi batas batas waktu permintaan. + Permintaan mengembalikan kode status HTTP selain 429, 500-599. **catatan** [Biaya transfer data standar](https://aws.amazon.com/ec2/pricing/on-demand/) berlaku untuk percobaan ulang. ## Lihat juga + [Menempatkan pesan tindakan HTTP dalam batch](http_batching.md) + [Tujuan aksi HTTP](http-action-destination.md) + [Rutekan data langsung dari AWS IoT Core ke layanan web Anda](https://aws.amazon.com/blogs/iot/route-data-directly-from-iot-core-to-your-web-services/) di *Internet of Things di AWS* blog # Menempatkan pesan tindakan HTTP dalam batch Anda dapat menggunakan batching untuk mengirim beberapa pesan tindakan HTTP dalam satu permintaan. ## Ikhtisar Batching memungkinkan Anda mengirim pesan dari AWS IoT Core Rules Engine ke endpoint HTTP Anda dalam batch. Fungsionalitas ini dapat membantu mengurangi biaya Anda dengan menurunkan jumlah eksekusi tindakan HTTP serta meningkatkan efisiensi dengan mengurangi overhead yang terkait dengan membangun koneksi baru. **catatan** Tindakan HTTP batch diukur sebagai tindakan tunggal. Anda diukur dengan penambahan 5 KiB, berdasarkan ukuran payload batch keluar yang dipancarkan oleh Rules Engine ke layanan hilir. AWS IoT Core Untuk informasi lebih lanjut, lihat halaman [harga AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). Saat Anda mengaktifkan batching dalam definisi Tindakan Aturan IoT Anda, parameter berikut akan tersedia untuk konfigurasi: `maxBatchOpenMs` Jumlah waktu maksimum (dalam milidetik) pesan keluar menunggu pesan lain untuk membuat batch. Semakin tinggi pengaturan, semakin lama latensi tindakan HTTP batch. Nilai Minimum: 5 ms. Nilai Maksimum: 200 ms. Nilai Default: 20 ms Mendukung [template substitusi](iot-substitution-templates.md): Tidak `maxBatchSize` Jumlah maksimum pesan yang dikumpulkan bersama dalam satu eksekusi tindakan aturan IoT. Nilai Minimum: 2 pesan. Nilai Maksimum: 10 pesan Nilai Default: 10 pesan Mendukung [template substitusi](iot-substitution-templates.md): Tidak `maxBatchSizeBytes` Ukuran maksimum kumpulan pesan, dalam byte. Nilai Minimum: 100 byte. Nilai Maksimum: 131.072 byte Nilai Default: 5120 byte Mendukung [template substitusi](iot-substitution-templates.md): Tidak **penting** Saat Anda menentukan beberapa parameter batch, batching selesai saat batas pertama tercapai. Misalnya, jika Anda menentukan 100 ms sebagai Waktu Buka Batch Maksimum dan 5 KiB sebagai Ukuran Batch Maksimum, dan Batch Rules Engine hanya 2 KiB dalam 100 ms, maka batch 2 KiB akan dibuat dan dikirim. ## Menggunakan header HTTP dalam batch Saat Anda menggunakan header dalam tindakan HTTP Anda, permintaan batch menggunakan nilai header dari pesan terakhir yang ditambahkan ke batch (belum tentu pesan terakhir yang Anda terbitkan). Kami merekomendasikan menggunakan nilai header yang: + Identik di semua pesan dalam batch + Berlaku untuk semua pesan (misalnya, kredensi otentikasi) Header dikirim dengan permintaan HTTP dan bukan bagian dari badan pesan. **catatan** Saat batching diaktifkan: Permintaan batch secara otomatis menyertakan `Content-Type: application/json` header, karena batch dikirim sebagai array JSON. Kami tidak dapat menjamin bahwa pesan terakhir dalam batch adalah pesan terakhir yang Anda terbitkan. Ini adalah pesan terakhir yang berhasil masuk ke dalam batch. ## Contoh Muatan Contoh berikut menunjukkan struktur payload pesan batch yang dikirim ke titik akhir HTTP Anda: ``` [ { "user_id": "user1", "steps_today": 1000 }, { "user_id": "user2", "steps_today": 21000 }, { "user_id": "user8", "steps_today": 1500 }, ... ] ``` ## Batasan Berikut ini adalah batasan batching: + AWS IoT Core tidak menjamin pemesanan pesan secara keseluruhan. Batching dilakukan secara lokal pada setiap host, yang dapat mengakibatkan pesan dalam batch diproses dalam urutan yang berbeda dari yang diterima. + AWS IoT Core tidak menyediakan dukungan pemrosesan pesan di sisi penerima. Anda bertanggung jawab untuk memastikan bahwa layanan hilir Anda dikonfigurasi untuk menerima dan memproses data dalam batch. + Batching lintas akun tidak didukung, bahkan jika pesan ditujukan untuk pengenal sumber daya yang sama (URL HTTP atau ARN sumber daya). + AWS IoT Core tidak menjamin bahwa ukuran batch akan memenuhi konfigurasi yang Anda tentukan. Batch mungkin lebih kecil dari batas yang dikonfigurasi berdasarkan waktu dan alur pesan. + Saat batching diaktifkan, muatan biner (data non-UTF-8) tidak didukung. Hanya muatan teks UTF-8 (seperti JSON) yang diterima. Untuk mengirim data biner, base64 menyandikannya sebelum mengirimnya ke aksi HTTP, dan kemudian mendekodekannya di titik akhir penerima Anda. Misalnya, Anda dapat menggunakan [fungsi encode](iot-sql-functions.html#iot-function-encode) dalam aturan IoT untuk menyandikan payload biner. Atau, Anda dapat menyandikan payload biner di perangkat IoT Anda dan mempublikasikannya ke. AWS IoT Core ## Tindakan Kesalahan untuk Batching Anda tidak akan dapat mendefinisikan logika batching terpisah dalam definisi Tindakan Kesalahan Anda. Namun, Error Action Anda akan mendukung batching jika Anda telah menentukan logika batching di Action utama Anda. Ketika permintaan batch gagal, mesin AWS IoT Core Rules akan mengikuti [logika coba lagi tindakan HTTP](https-rule-action.md#https-rule-action-retry-logic). Setelah percobaan ulang terakhir, tindakan kesalahan akan dipanggil untuk seluruh batch yang gagal. Berikut ini adalah contoh pesan tindakan kesalahan dengan batching diaktifkan: ``` { "ruleName": "FailedTopicRule", "topic": "topic/rulesengine", "payloadsWithMetadata": [ { "id": 1, "cloudwatchTraceId": "bebd6d93-6d4a-899e-9e40-56e82252d2be", "clientId": "Test", "sourceIp": "10.0.0.0", "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0=" }, { "id": 2, "cloudwatchTraceId": "af94d3b8-0b18-1dbf-2c7d-513f5cb9e2e1", "clientId": "Test", "sourceIp": "10.0.0.0", "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0=" }, { "id": 3, "cloudwatchTraceId": "ca441266-c2ce-c916-6aee-b9e5c7831675", "clientId": "Test", "sourceIp": "10.0.0.0", "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0=" } ], "failures": [ { "affectedIds": [ 1, 2, 3 ], "failedAction": "HttpAction", "failedResource": "https://example.foobar.com/HttpAction", "errorMessage": "HttpAction failed to make a request to the specified endpoint. StatusCode: 500. Reason: Internal Server Error." }, { "affectedIds": [ 3 ], "failedAction": "S3Action", "failedResource": "amzn-s3-demo-bucket", "errorMessage": "Failed to put S3 object. The error received was The specified bucket does not exist" }, { "affectedIds": [ 3 ], "failedAction": "LambdaAction", "failedResource": "arn:aws:lambda:us-west-2:123456789012:function:dummy", "errorMessage": "Failed to invoke lambda function. Received Server error from Lambda. The error code is 403" } ] } ``` **catatan** Kegagalan tindakan batch juga menghasilkan muatan tindakan kesalahan yang lebih besar yang dapat meningkatkan kemungkinan kegagalan tindakan kesalahan karena ukurannya. Anda dapat memantau kegagalan tindakan kesalahan menggunakan `ErrorActionFailure` metrik. Untuk informasi selengkapnya, lihat [Metrik tindakan aturan](metrics_dimensions.md#rule-action-metrics). ## Mengelompokkan pesan tindakan HTTP dengan AWS CLI ### Membuat atau memperbarui tindakan aturan dengan batching 1. Gunakan AWS CLI perintah yang sesuai untuk membuat atau memperbarui aturan: + Untuk membuat aturan baru, gunakan [create-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html)perintah: ``` aws iot create-topic-rule --rule-name myrule --topic-rule-payload file://myrule.json ``` + Untuk memperbarui aturan yang ada, gunakan [replace-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/replace-topic-rule.html)perintah: ``` aws iot replace-topic-rule --rule-name myrule --topic-rule-payload file://myrule.json ``` 1. Aktifkan kemampuan batching dengan menyetel parameter enableBatching ke true di payload aturan topik Anda: ``` { "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com", "headers": [ { "key": "static_header_key", "value": "static_header_value" }, { "key": "substitutable_header_key", "value": "${value_from_payload}" } ], "enableBatching": true, "batchConfig": { "maxBatchOpenMs": 100, "maxBatchSize": 5, "maxBatchSizeBytes": 1024 } } } ] } ``` 1. Konfigurasikan parameter batching. Anda tidak perlu menentukan semua parameter batch. Anda dapat memilih untuk menentukan 1, 2, atau semua 3 parameter batch. Jika Anda tidak menentukan parameter batch, Rules Engine akan memperbarui parameter itu dengan nilai default. Untuk informasi selengkapnya tentang parameter batching dan nilai defaultnya, lihat [parameter HTTP](https-rule-action.md#https-rule-action-parameters). # Tujuan aksi HTTP Tujuan tindakan HTTP adalah layanan web tempat mesin aturan dapat merutekan data dari aturan topik. AWS IoT Core Sumber daya menjelaskan layanan web untuk AWS IoT. Sumber daya tujuan dapat dibagi dengan aturan yang berbeda. Sebelum AWS IoT Core dapat mengirim data ke layanan web lain, itu harus mengkonfirmasi bahwa ia dapat mengakses titik akhir layanan. ## Ikhtisar Tujuan tindakan HTTP mengacu pada layanan web yang mendukung URL konfirmasi dan satu atau lebih pengumpulan data URLs. Sumber daya tujuan berisi URL konfirmasi layanan web Anda. Saat Anda mengonfigurasi tindakan HTTP, Anda menentukan URL sebenarnya dari titik akhir yang seharusnya menerima data bersama dengan URL konfirmasi layanan web. Setelah tujuan Anda dikonfirmasi, aturan topik mengirimkan hasil pernyataan SQL ke titik akhir HTTPS (dan bukan ke URL konfirmasi). Tujuan tindakan HTTP dapat berada di salah satu status berikut: ENABLED Tujuan telah dikonfirmasi dan dapat digunakan oleh tindakan aturan. Tujuan harus berada di `ENABLED` negara bagian agar dapat digunakan dalam suatu aturan. Anda hanya dapat mengaktifkan tujuan yang dalam status DISABLED. DISABLED Tujuan telah dikonfirmasi tetapi tidak dapat digunakan oleh tindakan aturan. Ini berguna jika Anda ingin mencegah sementara lalu lintas ke titik akhir Anda tanpa harus melalui proses konfirmasi lagi. Anda hanya dapat menonaktifkan tujuan yang berada dalam status ENABLED. IN\$1PROGRESS Konfirmasi tujuan sedang berlangsung. ERROR Konfirmasi tujuan habis waktu. Setelah tujuan tindakan HTTP telah dikonfirmasi dan diaktifkan, itu dapat digunakan dengan aturan apa pun di akun Anda. ## Mengelola tujuan tindakan HTTP Anda dapat menggunakan operasi berikut untuk mengelola tujuan tindakan HTTP Anda. ### Membuat tujuan aksi HTTP Anda membuat tujuan tindakan HTTP dengan memanggil `CreateTopicRuleDestination` operasi atau dengan menggunakan AWS IoT konsol. Setelah Anda membuat tujuan, AWS IoT kirimkan permintaan konfirmasi ke URL konfirmasi. Permintaan konfirmasi memiliki format berikut: ``` HTTP POST {confirmationUrl}/?confirmationToken={confirmationToken} Headers: x-amz-rules-engine-message-type: DestinationConfirmation x-amz-rules-engine-destination-arn:"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4" Content-Type: application/json Body: { "arn":"arn:aws:iot:us-east-1:123456789012:ruledestination/http/7a280e37-b9c6-47a2-a751-0703693f46e4", "confirmationToken": "AYADeMXLrPrNY2wqJAKsFNn-…NBJndA", "enableUrl": "https://iot.us-east-1.amazonaws.com/confirmdestination/AYADeMXLrPrNY2wqJAKsFNn-…NBJndA", "messageType": "DestinationConfirmation" } ``` Isi permintaan konfirmasi mencakup informasi berikut: arn Nama Sumber Daya Amazon (ARN) untuk tujuan tindakan HTTP untuk mengonfirmasi. confirmationToken Token konfirmasi yang dikirim oleh AWS IoT Core. Token dalam contoh terpotong. Token Anda akan lebih lama. Anda memerlukan token ini untuk mengonfirmasi tujuan Anda AWS IoT Core. enableUrl URL yang Anda telusuri untuk mengonfirmasi tujuan aturan topik. messageType Jenis pesan. ### Mengonfirmasi tujuan tindakan HTTP Untuk menyelesaikan proses konfirmasi titik akhir, jika Anda menggunakan AWS CLI, Anda harus melakukan langkah-langkah berikut setelah URL konfirmasi Anda menerima permintaan konfirmasi. 1. **Konfirmasikan bahwa tujuan siap menerima pesan** Untuk mengonfirmasi bahwa tujuan tindakan HTTP siap menerima pesan IoT, hubungi permintaan konfirmasi, atau lakukan operasi `ConfirmTopicRuleDestination` API dan teruskan `confirmationToken` dari permintaan konfirmasi. `enableUrl` 1. **Tetapkan status aturan topik ke diaktifkan** Setelah mengonfirmasi bahwa tujuan dapat menerima pesan, Anda harus menjalankan operasi `UpdateTopicRuleDestination` API untuk menyetel status aturan topik`ENABLED`. Jika Anda menggunakan AWS IoT konsol, salin `confirmationToken` dan tempel ke dialog konfirmasi tujuan di AWS IoT konsol. Anda kemudian dapat mengaktifkan aturan topik. ### Mengirim permintaan konfirmasi baru Untuk mengaktifkan pesan konfirmasi baru untuk tujuan, panggil `UpdateTopicRuleDestination` dan setel status tujuan aturan topik ke`IN_PROGRESS`. Ulangi proses konfirmasi setelah Anda mengirim permintaan konfirmasi baru. ### Menonaktifkan dan menghapus tujuan tindakan HTTP Untuk menonaktifkan tujuan, panggil `UpdateTopicRuleDestination` dan setel status tujuan aturan topik ke`DISABLED`. Aturan topik dalam status DISABLED dapat diaktifkan lagi tanpa perlu mengirim permintaan konfirmasi baru. Untuk menghapus tujuan tindakan HTTP, panggil`DeleteTopicRuleDestination`. ## Dukungan Otoritas Sertifikat **catatan** Sertifikat yang ditandatangani sendiri tidak didukung. Titik Akhir HTTPS dalam tujuan tindakan HTTP mendukung sertifikat yang dikeluarkan oleh [AWS Private Certificate Authority](https://www.amazontrust.com/repository/) dan [Lets Encrypt](https://letsencrypt.org/certificates/).