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à.

Destinazioni di azioni HTTP

Una destinazione di azione HTTP è un servizio Web verso il quale il motore delle regole può indirizzare i dati da una regola tematica. Una AWS IoT Core risorsa descrive il servizio Web per AWS IoT. Le risorse di destinazione possono essere condivise secondo regole diverse.

Prima di AWS IoT Core poter inviare dati a un altro servizio Web, è necessario confermare che può accedere all'endpoint del servizio.

Panoramica di

Una destinazione di azione HTTP si riferisce a un servizio Web che supporta un URL di conferma e una o più raccolte URLs di dati. La risorsa di destinazione contiene l'URL di conferma del servizio Web. Quando configuri un'azione HTTP, specifichi l'URL effettivo dell'endpoint che deve 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 di azione HTTP può trovarsi in uno dei seguenti stati:

Dopo che una destinazione di azione HTTP è stata confermata e abilitata, può essere utilizzata con qualsiasi regola del tuo account.

Gestione delle destinazioni di azione HTTP

È possibile utilizzare le seguenti operazioni per gestire le destinazioni delle azioni HTTP.

Creazione di destinazioni d'azione HTTP

È possibile creare una destinazione di azione HTTP chiamando l'CreateTopicRuleDestinationoperazione o utilizzando la AWS IoT console.

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:

Conferma delle destinazioni di azione HTTP

Per completare il processo di conferma dell'endpoint, se utilizzi il AWS CLI, devi eseguire i seguenti passaggi dopo che l'URL di conferma ha ricevuto la richiesta di conferma.

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.

Disabilitazione ed eliminazione di una destinazione di azione HTTP

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 una destinazione di azione HTTP, chiama. DeleteTopicRuleDestination

Supporto per l'autorità di certificazione

Gli endpoint HTTPS in una destinazione di azione HTTP supportano i certificati emessi sia da AWS Private Certificate Authority che da Let's Encrypt.