Ziele für HTTP-Aktionen - AWS IoT Core
-ÜbersichtVerwaltung von HTTP-AktionszielenSupport durch Zertifizierungsstellen

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_PROGRESS

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.

  2. 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 setzenENABLED.

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 als auch von Lets Encrypt ausgestellt wurden.