View a markdown version of this page

Tujuan tindakan HTTP - AWS IoT Core
Gambaran umumMengelola 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 tindakan HTTP

Tujuan tindakan HTTP adalah layanan web tempat mesin aturan dapat merutekan data dari aturan topik. Sumber AWS IoT Core 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, ia harus mengonfirmasi bahwa ia dapat mengakses titik akhir layanan.

Gambaran umum

Tujuan tindakan HTTP mengacu pada layanan web yang mendukung URL konfirmasi dan satu atau beberapa URL pengumpulan data. Sumber daya tujuan berisi URL konfirmasi layanan web Anda. Saat mengonfigurasi tindakan HTTP, Anda menentukan URL aktual dari titik akhir yang harus 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 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 sementara mencegah lalu lintas ke titik akhir Anda tanpa harus melalui proses konfirmasi lagi. Anda hanya dapat menonaktifkan tujuan yang dalam status ENABLED.

IN_PROGRESS

Konfirmasi tujuan sedang berlangsung.

ERROR

Waktu konfirmasi tujuan habis.

Setelah tujuan tindakan HTTP dikonfirmasi dan diaktifkan, tujuan tersebut 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 tindakan HTTP

Anda membuat tujuan tindakan HTTP dengan memanggil CreateTopicRuleDestination operasi atau dengan menggunakan AWS IoT konsol.

Setelah Anda membuat tujuan, AWS IoT kirim 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 dikonfirmasi.

KonfirmasiToken

Token konfirmasi dikirim oleh AWS IoT Core. Token dalam contoh terpotong. Token Anda akan lebih panjang. Anda akan memerlukan token ini untuk mengonfirmasi tujuan Anda AWS IoT Core.

AktifkanURL

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 menerima permintaan konfirmasi.

  1. Konfirmasikan bahwa tujuan siap menerima pesan

    Untuk mengonfirmasi bahwa tujuan tindakan HTTP siap menerima pesan IoT, panggil permintaan konfirmasi, atau lakukan operasi ConfirmTopicRuleDestination API dan lewati confirmationToken dari permintaan konfirmasi. enableUrl

  2. Tetapkan status aturan topik untuk diaktifkan

    Setelah mengonfirmasi bahwa tujuan dapat menerima pesan, Anda harus melakukan operasi UpdateTopicRuleDestination API untuk menyetel status aturan topik keENABLED.

Jika Anda menggunakan AWS IoT konsol, salin confirmationToken dan tempelkan 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, hubungi UpdateTopicRuleDestination dan atur status tujuan aturan topik keIN_PROGRESS.

Ulangi proses konfirmasi setelah Anda mengirim permintaan konfirmasi baru.

Menonaktifkan dan menghapus tujuan tindakan HTTP

Untuk menonaktifkan tujuan, hubungi UpdateTopicRuleDestination dan atur 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

Self-signed Sertifikat tidak didukung.

Titik Akhir HTTPS dalam tujuan tindakan HTTP mendukung sertifikat yang dikeluarkan oleh Otoritas Sertifikat AWS Pribadi dan Lets Encry pt.