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à. # HTTP L'azione HTTPS (`http`) invia i dati da un messaggio MQTT a un endpoint HTTPS, che può puntare a un'applicazione o un servizio Web. ## Requisiti Questa operazione della regola presenta i seguenti requisiti: + È necessario confermare e abilitare gli endpoint HTTPS prima che il motore delle regole possa utilizzarli. Per ulteriori informazioni, consulta [Destinazioni di azioni HTTP](http-action-destination.md). ## Parameters Quando create una AWS IoT regola con questa azione, dovete specificare le seguenti informazioni: `url` L'endpoint HTTPS in cui il messaggio viene inviato utilizzando il metodo HTTP POST. Se si utilizza un indirizzo IP al posto di un nome host, deve essere un IPv4 indirizzo. IPv6 gli indirizzi non sono supportati. Supporta [modelli di sostituzione](iot-substitution-templates.md): sì `confirmationUrl` (Facoltativo) Se specificato, AWS IoT utilizza l'URL di conferma per creare una destinazione per la regola dell'argomento corrispondente. È necessario abilitare la destinazione dell'azione HTTP prima di utilizzarla in un'azione HTTP. Per ulteriori informazioni, consulta [Destinazioni di azioni HTTP](http-action-destination.md). Se si utilizzano modelli sostitutivi, è necessario creare manualmente una destinazione dell'azione HTTP prima di poter utilizzare l'`http`azione. `confirmationUrl`deve essere un prefisso di. `url` La relazione tra `url` ed `confirmationUrl` è descritta come segue: + Se `url` è codificato e non `confirmationUrl` viene fornito, trattiamo implicitamente il `url` campo come. `confirmationUrl` AWS IoT crea una destinazione per le regole tematiche per. `url` + Se `url` e `confirmationUrl` sono codificati, `url` deve iniziare con. `confirmationUrl` AWS IoT crea una destinazione per le regole tematiche per. `confirmationUrl` + Se `url` contiene un modello di sostituzione, è necessario specificare `confirmationUrl` e `url` deve cominciare con `confirmationUrl`. Se `confirmationUrl` contiene modelli di sostituzione, è necessario creare manualmente una destinazione di azione HTTP prima di poter utilizzare l'`http`azione. Se `confirmationUrl` non contiene modelli sostitutivi, AWS IoT crea una destinazione per le regole tematiche per. `confirmationUrl` Supporta [modelli di sostituzione](iot-substitution-templates.md): sì `headers` (Facoltativo) L’elenco delle intestazioni da includere nelle richieste HTTP all'endpoint. Ogni richiesta deve contenere le seguenti informazioni: `key` La chiave dell'intestazione. Supporta [modelli di sostituzione](iot-substitution-templates.md): no `value` Il valore dell'intestazione. Supporta [modelli di sostituzione](iot-substitution-templates.md): sì Il tipo di contenuto predefinito è application/json quando il payload è in formato JSON. Altrimenti, è application/octet-stream. È possibile sovrascriverlo specificando il tipo di contenuto esatto nell'intestazione con il tipo di contenuto chiave (senza distinzione tra maiuscole e minuscole). `auth` (Facoltativo) L’autenticazione utilizzata dal motore di regole per connettersi all'URL dell'endpoint specificato nell'argomento `url`. Attualmente, la versione 4 della firma è l'unico tipo di autenticazione supportato. Per ulteriori informazioni, vedere l'[Autorizzazione HTTP](https://docs.aws.amazon.com/iot/latest/apireference/API_HttpAuthorization.html). Supporta [modelli di sostituzione](iot-substitution-templates.md): no `enableBatching` (Facoltativo) Se elaborare i messaggi di azione HTTP in un'unica richiesta per un determinato URL. Il valore può essere vero o falso. Per ulteriori informazioni sul batch, vedere Creazione in [batch dei messaggi di azione HTTP](http_batching.md). Valore booleano Supporta [modelli di sostituzione](iot-substitution-templates.md): no `batchConfig` (Facoltativo) Impostazioni di configurazione per il batch. Una volta abilitati, è necessario specificare `batchConfig` i parametri. Se `batchConfig` i parametri non vengono specificati, verranno utilizzati i valori predefiniti. `maxBatchOpenMs` Il periodo di tempo massimo (in millisecondi) in cui un messaggio in uscita attende che altri messaggi creino il batch. Maggiore è l'impostazione, maggiore è la latenza dell'azione HTTP in batch. Valore minimo: 5 ms. Valore massimo: 200 ms. Valore predefinito: 20 ms Supporta [modelli di sostituzione](iot-substitution-templates.md): no `maxBatchSize` Il numero massimo di messaggi raggruppati in un'unica esecuzione di azione. Supporta [modelli di sostituzione](iot-substitution-templates.md): no Valore minimo: 2 messaggi. Valore massimo: 10 messaggi Valore predefinito: 10 messaggi `maxBatchSizeBytes` Dimensione massima di un batch di messaggi, in byte. Valore minimo: 100 byte. Valore massimo: 131.072 byte Valore predefinito: 5.120 byte Supporta [modelli di sostituzione](iot-substitution-templates.md): no Il tipo di contenuto predefinito è application/json quando il payload è in formato JSON. Altrimenti, è application/octet-stream. È possibile sovrascriverlo specificando il tipo di contenuto esatto nell'intestazione con il tipo di contenuto chiave (senza distinzione tra maiuscole e minuscole). ## Esempi Il seguente esempio JSON definisce una AWS IoT regola con un'azione HTTP. ``` { "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com", "headers": [ { "key": "static_header_key", "value": "static_header_value" }, { "key": "substitutable_header_key", "value": "${value_from_payload}" } ] } } ] } } ``` ``` "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com", "headers": [ { "key": "Content-Type", "value": "application/json" } ], "enableBatching": true, "batchConfig": { "maxBatchOpenMs": 123, "maxBatchSize": 5, "maxBatchSizeBytes": 131072, } }, "errorAction": { "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com" // batchConfig is not allowed here } } ``` ## Logica di ripetizione dell'operazione HTTP Il motore AWS IoT delle regole ritenta l'azione HTTP in base alle seguenti regole: + Il motore delle regole tenta di inviare un messaggio almeno una volta. + Il motore delle regole effettua un massimo di due tentativi. Il numero massimo di tentativi è tre. + Il motore delle regole non effettua un nuovo tentativo se: + Il tentativo precedente ha fornito una risposta maggiore di 16.384 byte. + Il servizio Web downstream o l'applicazione chiude la connessione TCP dopo il tentativo. + Il tempo totale per completare una richiesta con nuovi tentativi ha superato il limite di timeout della richiesta. + La richiesta restituisce un codice di stato HTTP diverso da 429, 500-599. **Nota** I [costi standard di trasferimento dei dati](https://aws.amazon.com/ec2/pricing/on-demand/) si applicano ai nuovi tentativi. ## Consulta anche + [Messaggi di azione HTTP in batch](http_batching.md) + [Destinazioni di azioni HTTP](http-action-destination.md) + [Indirizza i dati AWS IoT Core direttamente dai tuoi servizi Web](https://aws.amazon.com/blogs/iot/route-data-directly-from-iot-core-to-your-web-services/) nell'*Internet of Things sul blog AWS* # Messaggi di azione HTTP in batch È possibile utilizzare il batch per inviare più messaggi di azione HTTP in un'unica richiesta. ## Panoramica di Il batching consente di inviare messaggi da AWS IoT Core Rules Engine agli endpoint HTTP in batch. Questa funzionalità può aiutare a ridurre i costi riducendo il numero di esecuzioni di azioni HTTP e a migliorare l'efficienza riducendo il sovraccarico associato alla creazione di nuove connessioni. **Nota** L'azione HTTP in batch viene misurata come singola azione. Il calcolo viene effettuato in incrementi di 5 KiB, in base alla dimensione del payload in batch in uscita emesso dal Rules Engine al servizio downstream. AWS IoT Core Per ulteriori informazioni, consultare la [pagina dei prezzi di AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). Quando abiliti il batching nella definizione della tua IoT Rule Action, i seguenti parametri saranno disponibili per la configurazione: `maxBatchOpenMs` La quantità massima di tempo (in millisecondi) in cui un messaggio in uscita attende che altri messaggi creino il batch. Maggiore è l'impostazione, maggiore è la latenza dell'azione HTTP in batch. Valore minimo: 5 ms. Valore massimo: 200 ms. Valore predefinito: 20 ms Supporta [modelli di sostituzione](iot-substitution-templates.md): no `maxBatchSize` Il numero massimo di messaggi raggruppati in una singola esecuzione di un'azione di regole IoT. Valore minimo: 2 messaggi. Valore massimo: 10 messaggi Valore predefinito: 10 messaggi Supporta [modelli di sostituzione](iot-substitution-templates.md): no `maxBatchSizeBytes` Dimensione massima di un batch di messaggi, in byte. Valore minimo: 100 byte. Valore massimo: 131.072 byte Valore predefinito: 5120 byte Supporta [modelli di sostituzione](iot-substitution-templates.md): no **Importante** Quando si specificano più parametri batch, il batch viene completato quando viene raggiunto il primo limite. Ad esempio, se si specifica 100 ms come Tempo di apertura massimo del batch e 5 KiB come dimensione massima del batch e Rules Engine esegue batch solo 2 KiB entro 100 ms, verrà creato e inviato un batch da 2 KiB. ## Utilizzo delle intestazioni HTTP in un batch Quando si utilizzano le intestazioni nell'azione HTTP, la richiesta in batch utilizza il valore di intestazione dell'ultimo messaggio aggiunto al batch (non necessariamente l'ultimo messaggio pubblicato). Ti consigliamo di utilizzare valori di intestazione che siano i seguenti: + Identici in tutti i messaggi del batch + Applicabile a tutti i messaggi (ad esempio, credenziali di autenticazione) Le intestazioni vengono inviate con la richiesta HTTP e non fanno parte del corpo del messaggio. **Nota** Quando il batching è abilitato: La richiesta in batch include automaticamente l'`Content-Type: application/json`intestazione, poiché il batch viene inviato come array JSON. Non possiamo garantire che l'ultimo messaggio del batch sia l'ultimo messaggio che hai pubblicato. È l'ultimo messaggio che è stato inserito nel batch. ## Esempio di payload L'esempio seguente mostra la struttura di un payload di messaggi in batch inviato all'endpoint HTTP: ``` [ { "user_id": "user1", "steps_today": 1000 }, { "user_id": "user2", "steps_today": 21000 }, { "user_id": "user8", "steps_today": 1500 }, ... ] ``` ## Limitazioni Di seguito sono riportate le limitazioni relative al batching: + AWS IoT Core non garantisce l'ordinamento complessivo dei messaggi. Il batch viene eseguito localmente su ciascun host, il che può comportare l'elaborazione dei messaggi all'interno di un batch in un ordine diverso da quello di ricezione. + AWS IoT Core non fornisce supporto per l'elaborazione dei messaggi sul lato del destinatario. L'utente è responsabile di garantire che il servizio downstream sia configurato per accettare ed elaborare i dati in batch. + Il batching tra account non è supportato, anche se i messaggi sono destinati allo stesso identificatore di risorsa (URL HTTP o ARN della risorsa). + AWS IoT Core non garantisce che la dimensione del batch soddisfi la configurazione specificata. I batch possono essere inferiori ai limiti configurati in base alla tempistica e al flusso dei messaggi. + Quando il batching è abilitato, i payload binari (dati non UTF-8) non sono supportati. Sono accettati solo payload di testo UTF-8 (come JSON). Per inviare dati binari, base64 li codifica prima di inviarli all'azione HTTP, quindi li decodifica sull'endpoint ricevente. Ad esempio, è possibile utilizzare la [funzione encode](iot-sql-functions.html#iot-function-encode) nelle regole IoT per codificare il payload binario. In alternativa, puoi codificare il payload binario nel tuo dispositivo IoT e pubblicarlo su. AWS IoT Core ## Azioni di errore per il batching Non sarà possibile definire una logica di batch separata nella definizione dell'azione di errore. Tuttavia, l'azione di errore supporterà il batch se è stata definita la logica di batch nell'azione principale. Quando una richiesta batch ha esito negativo, il motore AWS IoT Core Rules seguirà la logica di [ripetizione dell'azione HTTP](https-rule-action.md#https-rule-action-retry-logic). Dopo l'ultimo tentativo, verrà richiamata un'azione di errore per l'intero batch non riuscito. Di seguito è riportato un esempio di messaggio di errore con il batching abilitato: ``` { "ruleName": "FailedTopicRule", "topic": "topic/rulesengine", "payloadsWithMetadata": [ { "id": 1, "cloudwatchTraceId": "bebd6d93-6d4a-899e-9e40-56e82252d2be", "clientId": "Test", "sourceIp": "10.0.0.0", "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0=" }, { "id": 2, "cloudwatchTraceId": "af94d3b8-0b18-1dbf-2c7d-513f5cb9e2e1", "clientId": "Test", "sourceIp": "10.0.0.0", "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0=" }, { "id": 3, "cloudwatchTraceId": "ca441266-c2ce-c916-6aee-b9e5c7831675", "clientId": "Test", "sourceIp": "10.0.0.0", "base64OriginalPayload": "eyJ1c2VyX2lkIjogInVzZXI1NjQ3IiwgInN0ZXBzX3RvZGF5IjogMTMzNjUsICJ0aW1lc3RhbXAiOiAiMjAyNS0xMC0wOVQwNzoyMjo1OC45ODQ3OTAxNzZaIn0=" } ], "failures": [ { "affectedIds": [ 1, 2, 3 ], "failedAction": "HttpAction", "failedResource": "https://example.foobar.com/HttpAction", "errorMessage": "HttpAction failed to make a request to the specified endpoint. StatusCode: 500. Reason: Internal Server Error." }, { "affectedIds": [ 3 ], "failedAction": "S3Action", "failedResource": "amzn-s3-demo-bucket", "errorMessage": "Failed to put S3 object. The error received was The specified bucket does not exist" }, { "affectedIds": [ 3 ], "failedAction": "LambdaAction", "failedResource": "arn:aws:lambda:us-west-2:123456789012:function:dummy", "errorMessage": "Failed to invoke lambda function. Received Server error from Lambda. The error code is 403" } ] } ``` **Nota** Gli errori di azione in batch generano anche payload di azioni di errore più grandi, il che può aumentare la probabilità di errori dovuti alle dimensioni. È possibile monitorare gli errori relativi alle azioni di errore utilizzando la metrica. `ErrorActionFailure` Per ulteriori informazioni, consulta [Parametri delle operazioni sulle regole](metrics_dimensions.md#rule-action-metrics). ## Combinazione in batch dei messaggi di azione HTTP con AWS CLI ### Creazione o aggiornamento di un'azione di regola con batch 1. Usa il AWS CLI comando appropriato per creare o aggiornare una regola: + Per creare una nuova regola, usa il [create-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html)comando: ``` aws iot create-topic-rule --rule-name myrule --topic-rule-payload file://myrule.json ``` + Per aggiornare una regola esistente, usa il [replace-topic-rule](https://docs.aws.amazon.com/cli/latest/reference/iot/replace-topic-rule.html)comando: ``` aws iot replace-topic-rule --rule-name myrule --topic-rule-payload file://myrule.json ``` 1. Abilita le funzionalità di batch impostando il parametro enableBatching su true nel payload della regola dell'argomento: ``` { "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "http": { "url": "https://www.example.com/subpath", "confirmationUrl": "https://www.example.com", "headers": [ { "key": "static_header_key", "value": "static_header_value" }, { "key": "substitutable_header_key", "value": "${value_from_payload}" } ], "enableBatching": true, "batchConfig": { "maxBatchOpenMs": 100, "maxBatchSize": 5, "maxBatchSizeBytes": 1024 } } } ] } ``` 1. Configura i parametri di batch. Non è necessario specificare tutti i parametri del batch. È possibile scegliere di specificare 1, 2 o tutti e 3 i parametri del batch. Se non si specifica un parametro batch, Rules Engine aggiornerà tale parametro con i valori predefiniti. Per ulteriori informazioni sui parametri di batch e sui relativi valori predefiniti, vedere [Parametri HTTP](https-rule-action.md#https-rule-action-parameters). # 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.