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

# Tujuan aksi HTTP
<a name="http-action-destination"></a>

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
<a name="http-action-destination-overview"></a>

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\$1PROGRESS  
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
<a name="http-action-destination-managing"></a>

Anda dapat menggunakan operasi berikut untuk mengelola tujuan tindakan HTTP Anda.

### Membuat tujuan aksi HTTP
<a name="http-action-destination-creating"></a>

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
<a name="http-action-destination-confirming"></a>

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`

1. 

**Tetapkan status aturan topik ke diaktifkan**  
Setelah mengonfirmasi bahwa tujuan dapat menerima pesan, Anda harus menjalankan operasi `UpdateTopicRuleDestination` API untuk menyetel status aturan topik`ENABLED`.

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
<a name="trigger-confirm"></a>

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

Ulangi proses konfirmasi setelah Anda mengirim permintaan konfirmasi baru.

### Menonaktifkan dan menghapus tujuan tindakan HTTP
<a name="http-action-destination-deleting"></a>

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

Untuk menghapus tujuan tindakan HTTP, panggil`DeleteTopicRuleDestination`.

## Dukungan Otoritas Sertifikat
<a name="http-action-destination-certificates"></a>

**catatan**  
Sertifikat yang ditandatangani sendiri tidak didukung. 

 Titik Akhir HTTPS dalam tujuan tindakan HTTP mendukung sertifikat yang dikeluarkan oleh [AWS Private Certificate Authority](https://www.amazontrust.com/repository/) dan [Lets Encrypt](https://letsencrypt.org/certificates/).