Bekerja dengan tujuan aturan topik HTTP

Tujuan aturan topik 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 aturan topik dapat dibagikan 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 aturan topik HTTP

Tujuan aturan topik HTTP mengacu pada layanan web yang mendukung URL konfirmasi dan satu atau beberapa URL pengumpulan data. Sumber daya tujuan aturan topik HTTP berisi URL konfirmasi layanan web Anda. Saat mengonfigurasi tindakan aturan topik 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 aturan topik 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_PROGRESS

Konfirmasi tujuan sedang berlangsung.

ERROR

Waktu konfirmasi tujuan habis.

Setelah tujuan aturan topik HTTP telah dikonfirmasi dan diaktifkan, itu dapat digunakan dengan aturan apa pun di akun Anda.

Bagian berikut menjelaskan tindakan umum pada tujuan aturan topik HTTP.

Membuat dan mengonfirmasi tujuan aturan topik HTTP

Anda membuat tujuan aturan topik 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 aturan topik 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.

Untuk menyelesaikan proses konfirmasi endpoint, Anda harus melakukan salah satu hal berikut setelah URL konfirmasi Anda menerima permintaan konfirmasi.

• enableUrlPanggil permintaan konfirmasi, lalu panggil UpdateTopicRuleDestination untuk mengatur status aturan topikENABLED.

• Panggil ConfirmTopicRuleDestination operasi dan meneruskan confirmationToken dari permintaan konfirmasi.

• Salin confirmationToken dan tempel ke dialog konfirmasi tujuan di AWS IoT konsol.

Mengirim permintaan konfirmasi baru

Untuk mengaktifkan pesan konfirmasi baru untuk tujuan, panggil UpdateTopicRuleDestination dan setel status tujuan aturan topik keIN_PROGRESS.

Ulangi proses konfirmasi setelah Anda mengirim permintaan konfirmasi baru.

Menonaktifkan dan menghapus tujuan aturan topik

Untuk menonaktifkan tujuan, panggil UpdateTopicRuleDestination dan setel status tujuan aturan topik keDISABLED. Aturan topik dalam status DISABLED dapat diaktifkan lagi tanpa perlu mengirim permintaan konfirmasi baru.

Untuk menghapus tujuan aturan topik, hubungiDeleteTopicRuleDestination.