Gestione delle destinazioni delle regole degli argomenti HTTP - AWS IoT Core

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione delle destinazioni delle regole degli argomenti HTTP

È possibile utilizzare le seguenti operazioni per gestire le destinazioni delle regole degli argomenti HTTP.

Creazione di destinazioni per le regole degli argomenti 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. Avrai bisogno di 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.

Conferma delle destinazioni delle regole degli argomenti HTTP

Per completare il processo di conferma dell'endpoint, se si utilizza il AWS CLI, è necessario eseguire le seguenti operazioni dopo che l'URL di conferma ha ricevuto la richiesta di conferma.

  1. Conferma che la destinazione è disposta a ricevere messaggi

    Per confermare che la destinazione della regola dell'argomento è disposta a ricevere messaggi IoT, enableUrl chiamala nella richiesta di conferma oppure esegui l'operazione ConfirmTopicRuleDestination API e passa il messaggio confirmationToken dalla richiesta di conferma.

  2. Imposta lo stato della regola dell'argomento su abilitato

    Dopo aver confermato che la destinazione può ricevere messaggi, devi eseguire l'operazione UpdateTopicRuleDestination API per impostare lo stato della regola dell'argomento suENABLED.

Se utilizzi la AWS IoT console, copiala confirmationToken e incollala nella finestra di dialogo di conferma della destinazione nella AWS IoT console. Puoi quindi abilitare la regola dell'argomento.

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.