HTTP

Tindakan HTTPS (http) mengirimkan data dari MQTT pesan ke aplikasi web atau layanan.

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 HTTP topik.

Parameter

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

url

HTTPSTitik akhir di mana pesan dikirim menggunakan HTTP POST metode. Jika Anda menggunakan alamat IP sebagai pengganti nama host, itu harus berupa IPv4 alamat. IPv6alamat tidak didukung.

Mendukung template substitusi: Ya

confirmationUrl

(Opsional) Jika ditentukan, AWS IoT gunakan konfirmasi URL untuk membuat tujuan aturan topik yang cocok. Anda harus mengaktifkan tujuan aturan topik sebelum menggunakannya dalam suatu HTTP tindakan. Untuk informasi selengkapnya, lihat Bekerja dengan tujuan aturan HTTP topik. 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 HTTP permintaan 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 titik akhir yang URL ditentukan dalam argumen. url Saat ini, Signature Version 4 adalah satu-satunya jenis otentikasi yang didukung. Untuk informasi selengkapnya, lihat HTTPOtorisasi.

Mendukung template substitusi: Tidak

Contoh

JSONContoh berikut mendefinisikan AWS IoT aturan dengan HTTP tindakan.

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

HTTPtindakan coba lagi logika

Mesin AWS IoT aturan mencoba ulang HTTP tindakan 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 TCP koneksi setelah mencoba.

  • Total waktu untuk menyelesaikan permintaan dengan percobaan ulang melebihi batas batas waktu permintaan.

  • Permintaan mengembalikan kode HTTP status selain 429, 500-599.

catatan

Biaya transfer data standar berlaku untuk percobaan ulang.

Lihat juga

• Bekerja dengan tujuan aturan HTTP topik

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