HTTP

Tindakan HTTPS (http) mengirimkan data dari pesan MQTT 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 Bekerja dengan tujuan aturan topik HTTP.

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 alamat IPv4. Alamat IPv6 tidak didukung.

Mendukung template substitusi: Ya

confirmationUrl

(Opsional) Jika ditentukan, AWS IoT gunakan URL konfirmasi untuk membuat tujuan aturan topik yang cocok. Anda harus mengaktifkan tujuan aturan topik sebelum menggunakannya dalam tindakan HTTP. Untuk informasi selengkapnya, lihat Bekerja dengan tujuan aturan topik HTTP. Jika Anda menggunakan templat substitusi, Anda harus membuat tujuan aturan topik secara manual sebelum http tindakan dapat digunakan. confirmationUrlharus 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 untukurl.

• Jika url dan confirmationUrl di-hardcode, url harus dimulai dengan. confirmationUrl AWS IoT membuat tujuan aturan topik untukconfirmationUrl.

• Jika url berisi template substitusi, Anda harus menentukan confirmationUrl dan url harus mulai denganconfirmationUrl. Jika confirmationUrl berisi templat substitusi, Anda harus membuat tujuan aturan topik secara manual sebelum http tindakan dapat digunakan. Jika confirmationUrl tidak berisi templat substitusi, AWS IoT buat tujuan aturan topik untukconfirmationUrl.

Mendukung template substitusi: 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: Tidak

value

Nilai header.

Mendukung template substitusi: Ya

catatan

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.

Mendukung template substitusi: Tidak

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}" 
                        }
                    ] 
                } 
            }
        ]
    }
}

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 berlaku untuk percobaan ulang.

Lihat juga

• Bekerja dengan tujuan aturan topik HTTP

• Rutekan data langsung dari AWS IoT Core ke layanan web Anda di Internet of Things di AWS blog