Utilizzo delle destinazioni delle regole degli argomenti HTTP

Una destinazione della regola dell'argomento HTTP è un servizio Web al quale il motore di regola può instradare i dati provenienti da una regola di argomento. Una AWS IoT Core risorsa descrive il servizio web per AWS IoT. Le risorse di destinazione delle regole di argomento possono essere condivise da regole diverse.

Prima di AWS IoT Core poter inviare dati a un altro servizio Web, deve confermare di poter accedere all'endpoint del servizio.

Panoramica della destinazione delle regole dell'argomento HTTP

Una destinazione della regola dell'argomento HTTP si riferisce a un servizio Web che supporta un URL di conferma e uno o più URL di raccolta dati. La risorsa di destinazione della regola dell'argomento HTTP contiene l'URL di conferma del servizio Web. Quando si configura un'operazione regola dell'argomento HTTP, si specifica l'URL effettivo dell'endpoint che dovrebbe ricevere i dati insieme all'URL di conferma del servizio Web. Una volta che la destinazione è confermata, la regola dell'argomento invia il risultato dell'istruzione SQL all'endpoint HTTPS (e non all'URL di conferma).

Una destinazione dell'argomento HTTP può avere uno dei seguenti stati:

ABILITATO

La destinazione è stata confermata e può essere utilizzata da un'operazione della regola. Una destinazione deve essere nello stato ENABLED per essere utilizzata in una regola. È possibile abilitare solo una destinazione che si trovi nello stato DISABLED.

DISABILITATO

La destinazione è stata confermata ma non può essere utilizzata da un'operazione della regola. Ciò è utile se si desidera impedire temporaneamente il traffico verso l'endpoint senza dover ripetere il processo di conferma. È possibile disabilitare solo una destinazione che si trovi nello stato ENABLED.

IN_PROGRESS

La conferma della destinazione è in corso.

ERRORE

La conferma della destinazione è scaduta.

Una volta confermata e abilitata, la destinazione della regola dell'argomento HTTP può essere utilizzata con qualsiasi regola del tuo account.

Le sezioni seguenti descrivono le operazioni comuni sulle destinazioni delle regole dell'argomento HTTP.

Creazione e conferma delle destinazioni della regola dell'argomento HTTP

È possibile creare una destinazione della regola dell'argomento HTTP chiamando l'operazione CreateTopicRuleDestination o utilizzando la console AWS IoT .

Dopo aver creato una destinazione, AWS IoT invia una richiesta di conferma all'URL di conferma. La richiesta di conferma ha il seguente formato:

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"
}

Il contenuto della richiesta di conferma include le informazioni seguenti:

arn

L'Amazon Resource Name (ARN) per la destinazione della regola dell'argomento da confermare.

confirmationToken

Il token di conferma inviato da AWS IoT Core. Il token nell'esempio viene troncato. Il token sarà più lungo. Ti servirà questo token per confermare la tua destinazione con AWS IoT Core.

enableUrl

L'URL che si utilizza per confermare la destinazione di una regola dell'argomento.

messageType

Il tipo di messaggio.

Per completare il processo di conferma dell'endpoint, devi effettuare una delle seguenti operazioni dopo che l'URL di conferma ha ricevuto la richiesta di conferma.

• Chiama enableUrl nella richiesta di conferma, quindi chiama UpdateTopicRuleDestination per impostare lo stato della regola dell'argomento a ENABLED.

• Chiama l'operazione ConfirmTopicRuleDestination e il passaggio del confirmationToken dalla richiesta di conferma.

• Copia confirmationToken e incollalo nella finestra di dialogo di conferma della destinazione nella AWS IoT console.

Invio di una nuova richiesta di conferma

Per attivare un nuovo messaggio di conferma per una destinazione, chiama UpdateTopicRuleDestination e imposta lo stato della destinazione della regola dell'argomento su IN_PROGRESS.

Ripeti la procedura di conferma dopo aver inviato una nuova richiesta di conferma.

Disattivazione ed eliminazione di una destinazione di una regola dell'argomento

Per disabilitare una destinazione, chiamare UpdateTopicRuleDestination e impostare lo stato della destinazione della regola dell'argomento su DISABLED. Una regola dell'argomento nello stato DISABLED può essere nuovamente abilitata senza dover inviare una nuova richiesta di conferma.

Per eliminare la destinazione di una regola di argomento, chiamare DeleteTopicRuleDestination.