Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # HTTP La acción HTTPS (`http`) envía los datos de un mensaje MQTT a un punto final HTTPS, que puede apuntar a una aplicación o servicio web. ## Requisitos Esta regla tiene los siguientes requisitos: + Debe confirmar y habilitar los puntos de conexión HTTPS antes de que el motor de reglas pueda usarlos. Para obtener más información, consulte [Destinos de acciones HTTP](http-action-destination.md). ## Parameters Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información: `url` El punto de conexión HTTPS al que se envía el mensaje mediante el método HTTP POST. Si utiliza una dirección IP en lugar de un nombre de host, debe ser una IPv4 dirección. IPv6 no se admiten direcciones. Admite [plantillas de sustitución](iot-substitution-templates.md): Sí `confirmationUrl` (Opcional) Si se especifica, AWS IoT utiliza la URL de confirmación para crear un destino de regla temática coincidente. Debe habilitar el destino de la acción HTTP antes de usarlo en una acción HTTP. Para obtener más información, consulte [Destinos de acciones HTTP](http-action-destination.md). Si utiliza plantillas de sustitución, debe crear manualmente un destino de acción HTTP antes de poder utilizar la `http` acción. `confirmationUrl`debe ser un prefijo de`url`. La relación entre `url` y `confirmationUrl` se describe de la siguiente manera: + Si `url` está codificado y no `confirmationUrl` se proporciona, tratamos implícitamente el `url` campo como. `confirmationUrl` AWS IoT crea un tema de destino para la regla. `url` + Si `url` y `confirmationUrl` están codificados, `url` deben empezar `confirmationUrl` por. AWS IoT crea un tema de destino para `confirmationUrl` la regla. + Si `url` contiene una plantilla de sustitución, debe especificar `confirmationUrl` y `url` debe comenzar por `confirmationUrl`. Si `confirmationUrl` contiene plantillas de sustitución, debe crear manualmente un destino de acción HTTP antes de poder utilizar la `http` acción. Si `confirmationUrl` no contiene plantillas de sustitución, AWS IoT crea un tema de destino para la regla`confirmationUrl`. Admite [plantillas de sustitución](iot-substitution-templates.md): Sí `headers` (Opcional) La lista de encabezados que se van a incluir en las solicitudes HTTP al punto de conexión. Cada encabezado debe contener la siguiente información: `key` La clave del encabezado. Admite [plantillas de sustitución](iot-substitution-templates.md): No `value` El valor del encabezado. Admite [plantillas de sustitución](iot-substitution-templates.md): Sí El tipo de contenido predeterminado es application/json cuando la carga útil está en formato JSON. De lo contrario, es application/octet-stream. Puede sobrescribirlo especificando el tipo de contenido exacto en el encabezado con el tipo de contenido de la clave (sin distinción entre mayúsculas y minúsculas). `auth` (Opcional) Autenticación utilizada por el motor de reglas para conectarse a la dirección URL del punto de conexión especificada en el argumento `url`. Actualmente, Signature Version 4 es el único tipo de autenticación admitido. Para obtener más información, consulte [Autorización HTTP](https://docs.aws.amazon.com/iot/latest/apireference/API_HttpAuthorization.html). Admite [plantillas de sustitución](iot-substitution-templates.md): No `enableBatching` (Opcional) Si se deben procesar los mensajes de acción HTTP en una sola solicitud para una URL determinada. El valor puede ser verdadero o falso. Para obtener más información sobre el procesamiento por lotes, consulte Procesamiento por [lotes de mensajes de acción HTTP](http_batching.md). Valor booleano Admite [plantillas de sustitución](iot-substitution-templates.md): No `batchConfig` (Opcional) Ajustes de configuración para el procesamiento por lotes. Una vez habilitados, se deben especificar `batchConfig` los parámetros. Si no se especifican los `batchConfig` parámetros, se utilizarán los valores predeterminados. `maxBatchOpenMs` El tiempo máximo (en milisegundos) que un mensaje saliente espera a que otros mensajes creen el lote. Cuanto más alta sea la configuración, mayor será la latencia de la acción HTTP agrupada en lotes. Valor mínimo: 5 ms. Valor máximo: 200 ms. Valor predeterminado: 20 ms Admite [plantillas de sustitución](iot-substitution-templates.md): No `maxBatchSize` El número máximo de mensajes que se agrupan en lotes en la ejecución de una sola acción. Admite [plantillas de sustitución](iot-substitution-templates.md): No Valor mínimo: 2 mensajes. Valor máximo: 10 mensajes Valor predeterminado: 10 mensajes `maxBatchSizeBytes` Tamaño máximo de un lote de mensajes, en bytes. Valor mínimo: 100 bytes. Valor máximo: 131.072 bytes Valor predeterminado: 5.120 bytes Admite [plantillas de sustitución](iot-substitution-templates.md): No El tipo de contenido predeterminado es application/json cuando la carga útil está en formato JSON. De lo contrario, es application/octet-stream. Puede sobrescribirlo especificando el tipo de contenido exacto en el encabezado con el tipo de contenido de la clave (sin distinción entre mayúsculas y minúsculas). ## Ejemplos El siguiente ejemplo de JSON define una AWS IoT regla con una acción 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 } } ``` ## Lógica de reintento de acciones HTTP El motor de AWS IoT reglas vuelve a intentar la acción HTTP de acuerdo con estas reglas: + El motor de reglas intenta enviar un mensaje al menos una vez. + El motor de reglas realiza como máximo dos reintentos. El número máximo de intentos es tres. + El motor de reglas no realiza un reintento si: + El intento anterior proporcionó una respuesta mayor de 16.384 bytes. + El servicio o la aplicación web de salida cierra la conexión TCP después del intento. + El tiempo total para completar una solicitud con reintentos superó el límite de tiempo de espera de la solicitud. + La solicitud devuelve un código de estado HTTP distinto de 429, 500-599. **nota** Se aplican [costos estándar de transferencia de datos](https://aws.amazon.com/ec2/pricing/on-demand/) a los reintentos. ## Véase también + [Procesamiento por lotes de mensajes de acción HTTP](http_batching.md) + [Destinos de acciones HTTP](http-action-destination.md) + [Enrute los datos directamente desde AWS IoT Core sus servicios web](https://aws.amazon.com/blogs/iot/route-data-directly-from-iot-core-to-your-web-services/) en el blog *de Internet de las AWS cosas* # Procesamiento por lotes de mensajes de acción HTTP Puedes usar el procesamiento por lotes para enviar varios mensajes de acción HTTP en una sola solicitud. ## Descripción general de El procesamiento por lotes le permite enviar mensajes desde AWS IoT Core Rules Engine a sus puntos de enlace HTTP por lotes. Esta funcionalidad puede ayudarle a reducir los costes al reducir el número de ejecuciones de acciones HTTP, así como a mejorar la eficiencia al reducir la sobrecarga asociada al establecimiento de nuevas conexiones. **nota** La acción HTTP por lotes se mide como una acción única. Se mide en incrementos de 5 KiB, en función del tamaño de la carga útil saliente por lotes emitida por el motor de reglas al AWS IoT Core servicio descendente. Para obtener más información, consulte la [página de precios de AWS IoT Core](https://aws.amazon.com/iot-core/pricing/). Cuando habilita el procesamiento por lotes en la definición de su acción de regla de IoT, los siguientes parámetros estarán disponibles para la configuración: `maxBatchOpenMs` El tiempo máximo (en milisegundos) que un mensaje saliente espera a que otros mensajes creen el lote. Cuanto más alta sea la configuración, mayor será la latencia de la acción HTTP agrupada en lotes. Valor mínimo: 5 ms. Valor máximo: 200 ms. Valor predeterminado: 20 ms Admite [plantillas de sustitución](iot-substitution-templates.md): No `maxBatchSize` La cantidad máxima de mensajes que se agrupan por lotes en una sola ejecución de acción de regla de IoT. Valor mínimo: 2 mensajes. Valor máximo: 10 mensajes Valor predeterminado: 10 mensajes Admite [plantillas de sustitución](iot-substitution-templates.md): No `maxBatchSizeBytes` Tamaño máximo de un lote de mensajes, en bytes. Valor mínimo: 100 bytes. Valor máximo: 131.072 bytes Valor predeterminado: 5120 bytes Admite [plantillas de sustitución](iot-substitution-templates.md): No **importante** Al especificar varios parámetros de lote, el procesamiento por lotes finaliza cuando se alcanza el primer límite. Por ejemplo, si especifica 100 ms como el tiempo máximo de apertura del lote y 5 KiB como el tamaño máximo del lote, y Rules Engine solo graba 2 KiB en 100 ms, se creará y enviará un lote de 2 KiB. ## Uso de encabezados HTTP en un lote Cuando utilizas encabezados en tu acción HTTP, la solicitud agrupada usa el valor del encabezado del último mensaje que se agregó al lote (no necesariamente el último mensaje que publicaste). Te recomendamos usar valores de encabezado que sean: + Idénticos en todos los mensajes del lote + Aplicable a todos los mensajes (por ejemplo, las credenciales de autenticación) Los encabezados se envían con la solicitud HTTP y no forman parte del cuerpo del mensaje. **nota** Cuando el procesamiento por lotes está habilitado: La solicitud agrupada incluye automáticamente el `Content-Type: application/json` encabezado, ya que el lote se envía como una matriz JSON. No podemos garantizar que el último mensaje del lote sea el último mensaje que hayas publicado. Es el último mensaje que se incluyó en el lote. ## Ejemplo de carga útil El siguiente ejemplo muestra la estructura de la carga útil de un mensaje por lotes que se envía a tu punto final HTTP: ``` [ { "user_id": "user1", "steps_today": 1000 }, { "user_id": "user2", "steps_today": 21000 }, { "user_id": "user8", "steps_today": 1500 }, ... ] ``` ## Limitaciones Las siguientes son las limitaciones del procesamiento por lotes: + AWS IoT Core no garantiza el orden general de los mensajes. El procesamiento por lotes se realiza localmente en cada host, lo que puede provocar que los mensajes de un lote se procesen en un orden diferente al que se recibieron. + AWS IoT Core no proporciona soporte para el procesamiento de mensajes en el lado del receptor. Usted es responsable de garantizar que su servicio descendente esté configurado para aceptar y procesar los datos en lotes. + No se admite el procesamiento por lotes entre cuentas, incluso si los mensajes están destinados al mismo identificador de recurso (URL HTTP o ARN del recurso). + AWS IoT Core no garantiza que el tamaño del lote cumpla con la configuración que especificó. Los lotes pueden ser más pequeños que los límites configurados en función del tiempo y el flujo de mensajes. + Cuando el procesamiento por lotes está activado, no se admiten las cargas útiles binarias (datos que no sean UTF-8). Solo se aceptan cargas útiles de texto en UTF-8 (como JSON). Para enviar datos binarios, base64 los codifica antes de enviarlos a la acción HTTP y, a continuación, los decodifica en el punto final receptor. Por ejemplo, puede usar la [función](iot-sql-functions.html#iot-function-encode) de codificación en las reglas de IoT para codificar la carga útil binaria. Como alternativa, puedes codificar la carga binaria en tu dispositivo IoT y publicarla en. AWS IoT Core ## Acciones de error al procesar por lotes No podrá definir una lógica de procesamiento por lotes independiente en la definición de la acción de error. Sin embargo, su acción de error admitirá el procesamiento por lotes si ha definido la lógica de procesamiento por lotes en su acción principal. Cuando se produce un error en una solicitud por lotes, el motor de AWS IoT Core reglas seguirá la lógica de [reintento de una acción HTTP](https-rule-action.md#https-rule-action-retry-logic). Tras el último intento, se ejecutará una acción de error para todo el lote fallido. El siguiente es un ejemplo de un mensaje de acción de error con el procesamiento por lotes activado: ``` { "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** Los errores de las acciones por lotes también generan una mayor carga útil de las acciones de error, lo que, debido al tamaño, puede aumentar la probabilidad de que se produzcan errores en las acciones de error. Puede supervisar los fallos en las acciones de error mediante la `ErrorActionFailure` métrica. Para obtener más información, consulte [Métricas de acciones de reglas](metrics_dimensions.md#rule-action-metrics). ## Agrupar por lotes los mensajes de acción HTTP con AWS CLI ### Crear o actualizar una acción de regla con procesamiento por lotes 1. Utilice el AWS CLI comando correspondiente para crear o actualizar una regla: + Para crear una regla nueva, utilice el [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 ``` + Para actualizar una regla existente, utilice el [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. Habilite las capacidades de procesamiento por lotes configurando el parámetro enableBatching en true en la carga útil de la regla temática: ``` { "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. Configure los parámetros de procesamiento por lotes. No es necesario especificar todos los parámetros del lote. Puede elegir especificar 1, 2 o los 3 parámetros del lote. Si no especifica un parámetro de lote, Rules Engine actualizará ese parámetro con los valores predeterminados. Para obtener más información sobre los parámetros de procesamiento por lotes y sus valores predeterminados, consulte [Parámetros HTTP](https-rule-action.md#https-rule-action-parameters). # Destinos de acciones HTTP Un destino de acción HTTP es un servicio web al que el motor de reglas puede enrutar los datos de una regla temática. Un AWS IoT Core recurso describe el servicio web para AWS IoT. Los recursos de destino se pueden compartir mediante diferentes reglas. Antes de AWS IoT Core poder enviar datos a otro servicio web, debe confirmar que puede acceder al punto final del servicio. ## Descripción general de El destino de una acción HTTP hace referencia a un servicio web que admite una URL de confirmación y una o varias recopilaciones de datos URLs. El recurso de destino contiene la URL de confirmación de su servicio web. Al configurar una acción HTTP, se especifica la URL real del punto final que debe recibir los datos junto con la URL de confirmación del servicio web. Una vez confirmado el destino, la regla temática envía el resultado de la sentencia SQL al punto de conexión HTTPS (y no a la URL de confirmación). El destino de una acción HTTP puede estar en uno de los siguientes estados: ENABLED El destino se ha confirmado y se puede utilizar mediante una acción de regla. Un destino debe tener el estado `ENABLED` para que se utilice en una regla. Solo puede habilitar destinos con el estado DISABLED. DISABLED El destino se ha confirmado y se puede utilizar mediante una acción de regla. Esto es útil si desea impedir temporalmente el tráfico a su punto de conexión sin tener que pasar de nuevo por el proceso de confirmación. Solo puede deshabilitar un destino con el estado ENABLED. IN\$1PROGRESS La confirmación del destino se está realizando. ERROR Se ha agotado el tiempo de espera de confirmación del destino. Una vez que se haya confirmado y habilitado el destino de una acción HTTP, se puede usar con cualquier regla de tu cuenta. ## Administrar los destinos de acciones HTTP Puede utilizar las siguientes operaciones para gestionar los destinos de sus acciones HTTP. ### Crear destinos de acción HTTP Para crear un destino de acción HTTP, llame a la `CreateTopicRuleDestination` operación o utilice la AWS IoT consola. Tras crear un destino, AWS IoT envía una solicitud de confirmación a la URL de confirmación. La solicitud de confirmación tiene el siguiente 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" } ``` El contenido de la solicitud de confirmación incluye la siguiente información: arn El nombre del recurso de Amazon (ARN) del destino de la acción HTTP a confirmar. confirmationToken El token de confirmación enviado por AWS IoT Core. El token del ejemplo está truncado. Su token será mayor. Necesitará este token para confirmar su destino con AWS IoT Core. enableUrl La dirección URL a la que se desplaza para confirmar el destino de una regla del tema. messageType Tipo de mensaje. ### Confirmar los destinos de las acciones HTTP Para completar el proceso de confirmación del punto de conexión, si utiliza la AWS CLI, debe realizar uno de los siguientes pasos después de que su URL de confirmación reciba la solicitud de confirmación. 1. **Confirme que el destino está listo para recibir mensajes** Para confirmar que el destino de la acción HTTP está listo para recibir mensajes de IoT, llama a la que `enableUrl` aparece en la solicitud de confirmación o realiza la operación de `ConfirmTopicRuleDestination` API y pasa la `confirmationToken` de la solicitud de confirmación. 1. **Definición del estado de la regla temática como activado** Después de confirmar que el destino puede recibir mensajes, debe ejecutar la operación de la API `UpdateTopicRuleDestination` para establecer el estado de la regla temática en `ENABLED`. Si utilizas la AWS IoT consola, cópiala `confirmationToken` y pégala en el cuadro de diálogo de confirmación del destino en la AWS IoT consola. A continuación, ya podrá activar la regla temática. ### Enviar una nueva solicitud de confirmación Para activar un nuevo mensaje de confirmación para un destino, llame a `UpdateTopicRuleDestination` y establezca el estado del destino de la regla del tema en `IN_PROGRESS`. Repita el proceso de confirmación después de enviar una nueva solicitud de confirmación. ### Deshabilitar y eliminar un destino de acción HTTP Para deshabilitar un destino, llame a `UpdateTopicRuleDestination` y establezca el estado del destino de la regla del tema en `DISABLED`. Una regla temática en estado DESACTIVADO se puede volver a activar sin necesidad de enviar una nueva solicitud de confirmación. Para eliminar un destino de acción HTTP, llama`DeleteTopicRuleDestination`. ## Certificate Authority Support **nota** No se admiten los certificados autofirmados. Los puntos de enlace HTTPS de un destino de acción HTTP admiten certificados emitidos tanto por [AWS Private Certificate Authority](https://www.amazontrust.com/repository/) como por [Lets](https://letsencrypt.org/certificates/) Encrypt.