Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Ziele für HTTP-Aktionen
Ein HTTP-Aktionsziel ist ein Webdienst, an den die Regel-Engine Daten aus einer Themenregel weiterleiten kann. Eine AWS IoT Core Ressource beschreibt den Webdienst für AWS IoT. Zielressourcen können nach unterschiedlichen Regeln gemeinsam genutzt werden.
Bevor Daten an einen anderen Webdienst gesendet werden AWS IoT Core können, muss dieser bestätigen, dass er auf den Endpunkt des Dienstes zugreifen kann.
## -Übersicht
Ein HTTP-Aktionsziel bezieht sich auf einen Webdienst, der eine Bestätigungs-URL und eine oder mehrere Datenerfassungen unterstützt URLs. Die Zielressource enthält die Bestätigungs-URL Ihres Webdienstes. Wenn Sie eine HTTP-Aktion konfigurieren, geben Sie die tatsächliche URL des Endpunkts, der die Daten erhalten soll, zusammen mit der Bestätigungs-URL des Webdienstes an. Nachdem Ihr Ziel bestätigt wurde, sendet die Themenregel das Ergebnis der SQL-Anweisung an den HTTPS-Endpunkt (und nicht an die Bestätigungs-URL).
Ein HTTP-Aktionsziel kann sich in einem der folgenden Zustände befinden:
ENABLED (AKTIVIERT)
Das Ziel wurde bestätigt und kann von einer Regelaktion verwendet werden. Ein Ziel muss den Zustand `ENABLED` aufweisen, damit es in einer Regel verwendet werden kann. Sie können nur Ziele im Status „DISABLED“ aktivieren.
DISABLED (DEAKTIVIERT)
Das Ziel wurde bestätigt, kann aber nicht von einer Regelaktion verwendet werden. Dies ist nützlich, wenn Sie Datenverkehr zu Ihrem Endpunkt vorübergehend aussetzen möchten, ohne den Bestätigungsvorgang erneut durchlaufen zu müssen. Sie können nur Ziele mit dem Status „ENABLED“ deaktivieren.
IN\$1PROGRESS
Die Bestätigung des Ziels wird ausgeführt.
ERROR
Zeitüberschreitung bei der Zielbestätigung.
Nachdem ein HTTP-Aktionsziel bestätigt und aktiviert wurde, kann es mit jeder Regel in Ihrem Konto verwendet werden.
## Verwaltung von HTTP-Aktionszielen
Sie können die folgenden Operationen verwenden, um Ihre HTTP-Aktionsziele zu verwalten.
### HTTP-Aktionsziele erstellen
Sie erstellen ein HTTP-Aktionsziel, indem Sie den `CreateTopicRuleDestination` Vorgang aufrufen oder die AWS IoT Konsole verwenden.
Nachdem Sie ein Ziel erstellt haben, AWS IoT sendet eine Bestätigungsanfrage an die Bestätigungs-URL. Die Bestätigungsanforderung hat das folgende Format:
```
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"
}
```
Der Inhalt der Bestätigungsanforderung umfasst die folgenden Informationen:
arn
Der Amazon-Ressourcenname (ARN) für das zu bestätigende HTTP-Aktionsziel.
confirmationToken
Das Bestätigungstoken, gesendet von AWS IoT Core. Das Token im Beispiel ist gekürzt. Ihr tatsächliches Token ist länger. Sie benötigen dieses Token, um Ihr Ziel mit AWS IoT Core zu bestätigen.
enableUrl
Die URL, zu der Sie navigieren, um ein Themenregelziel zu bestätigen.
messageType
Der Nachrichtentyp.
### Bestätigung der Ziele für HTTP-Aktionen
Wenn Sie den Endpunkt-Bestätigungsprozess verwenden, müssen Sie die folgenden Schritte ausführen AWS CLI, nachdem Ihre Bestätigungs-URL die Bestätigungsanfrage erhalten hat.
1.
**Vergewissern Sie sich, dass das Ziel bereit ist, Nachrichten zu empfangen**
Um zu bestätigen, dass das HTTP-Aktionsziel bereit ist, IoT-Nachrichten zu empfangen, rufen Sie entweder die `enableUrl` in der Bestätigungsanfrage auf oder führen Sie den `ConfirmTopicRuleDestination` API-Vorgang `confirmationToken` aus und übergeben Sie die Bestätigungsanfrage.
1.
**Setzen Sie den Status der Themenregel auf aktiviert**
Nachdem Sie bestätigt haben, dass das Ziel Nachrichten empfangen kann, müssen Sie den `UpdateTopicRuleDestination` API-Vorgang ausführen, um den Status der Themenregel auf zu setzen`ENABLED`.
Wenn Sie die AWS IoT Konsole verwenden, kopieren Sie die `confirmationToken` und fügen Sie sie in das Bestätigungsdialogfeld des Ziels in der AWS IoT Konsole ein. Anschließend können Sie die Themenregel aktivieren.
### Senden einer neuen Bestätigungsanforderung
Zum Aktivieren einer neuen Bestätigungsnachricht für ein Ziel rufen Sie `UpdateTopicRuleDestination` auf und legen den Zustand des Themenregelziels auf `IN_PROGRESS` fest.
Wiederholen Sie den Bestätigungsvorgang, nachdem Sie eine neue Bestätigungsanforderung gesendet haben.
### Deaktivieren und Löschen eines HTTP-Aktionsziels
Zum Deaktivieren eines Ziels rufen Sie `UpdateTopicRuleDestination` auf und legen den Zustand des Themenregelziels auf `DISABLED` fest. Eine Themenregel mit dem Status DISABLED (DEAKTIVIERT) kann wieder aktiviert werden, ohne dass eine neue Bestätigungsanforderung gesendet werden muss.
Um ein HTTP-Aktionsziel zu löschen, rufen Sie an. `DeleteTopicRuleDestination`
## Support durch Zertifizierungsstellen
**Anmerkung**
Selbstsignierte Zertifikate werden nicht unterstützt.
HTTPS-Endpunkte in einem HTTP-Aktionsziel unterstützen Zertifikate, die sowohl von [AWS Private Certificate Authority](https://www.amazontrust.com/repository/) als auch von [Lets](https://letsencrypt.org/certificates/) Encrypt ausgestellt wurden.