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:
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\$1PROGRESS
La conferma della destinazione è in corso.
ERRORE
La conferma della destinazione è scaduta.
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'`CreateTopicRuleDestination`operazione 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:
arn
L'Amazon Resource Name (ARN) per la destinazione dell'azione HTTP 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 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.
1.
**Verifica che la destinazione sia pronta per ricevere messaggi**
Per confermare che la destinazione dell'azione HTTP è pronta a ricevere messaggi IoT, `enableUrl` chiamala nella richiesta di conferma oppure esegui l'operazione `ConfirmTopicRuleDestination` API e passa la richiesta `confirmationToken` di conferma.
1.
**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 su`ENABLED`.
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
**Nota**
I certificati autofirmati non sono supportati.
Gli endpoint HTTPS in una destinazione di azione HTTP supportano i certificati emessi sia da [AWS Private Certificate Authority che da [Let's](https://letsencrypt.org/certificates/)](https://www.amazontrust.com/repository/) Encrypt.