Tujuan aksi HTTP - AWS IoT Core
IkhtisarMengelola tujuan tindakan HTTPDukungan Otoritas Sertifikat

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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_PROGRESS

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

  2. Tetapkan status aturan topik ke diaktifkan

    Setelah mengonfirmasi bahwa tujuan dapat menerima pesan, Anda harus menjalankan operasi UpdateTopicRuleDestination API untuk menyetel status aturan topikENABLED.

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 keIN_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 keDISABLED. Aturan topik dalam status DISABLED dapat diaktifkan lagi tanpa perlu mengirim permintaan konfirmasi baru.

Untuk menghapus tujuan tindakan HTTP, panggilDeleteTopicRuleDestination.

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 dan Lets Encrypt.