View a markdown version of this page

HTTP - AWS IoT Core
ExigencesParametersExemplesLogique de nouvelle tentative d'action HTTPConsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

HTTP

L'action HTTPS (http) envoie les données d'un message MQTT à un point de terminaison HTTPS, qui peut pointer vers une application ou un service Web.

Exigences

Ce rôle d’action possède les critères suivants :

  • Vous devez confirmer et activer les points de terminaison HTTPS avant que le moteur de règles puisse les utiliser. Pour de plus amples informations, veuillez consulter Destinations d’action HTTP.

Parameters

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

url

Point de terminaison HTTPS à l'endroit où le message est envoyé à l'aide de la méthode HTTP POST. Si vous utilisez une adresse IP à la place d'un nom d'hôte, il doit s'agir d'une adresse IPv4. Les adresses IPv6 ne sont pas prises en charge.

Prend en charge les modèles de substitution : Oui

confirmationUrl

(Facultatif) Si cela est spécifié, AWS IoT utilise l'URL de confirmation pour créer une destination de règle de sujet correspondante. Vous devez activer la destination de l'action HTTP avant de l'utiliser dans une action HTTP. Pour de plus amples informations, veuillez consulter Destinations d’action HTTP. Si vous utilisez des modèles de substitution, vous devez créer manuellement une destination d'action HTTP avant de pouvoir utiliser l'httpaction. confirmationUrldoit être un préfixe de. url

La relation entre url et confirmationUrl est décrite par les éléments suivants :

  • S'il url est codé en dur et n'confirmationUrlest pas fourni, nous traitons implicitement le url champ comme le. confirmationUrl AWS IoT crée une destination de règle de sujet poururl.

  • Si url et confirmationUrl sont codés en dur, cela url doit commencer confirmationUrl par. AWS IoT crée une destination de règle de sujet pourconfirmationUrl.

  • Si url contient un modèle de substitution, vous devez spécifier confirmationUrl et url doit commencer par confirmationUrl. S'il confirmationUrl contient des modèles de substitution, vous devez créer manuellement une destination d'action HTTP avant de pouvoir utiliser l'httpaction. S'il confirmationUrl ne contient pas de modèles de substitution, AWS IoT crée une destination de règle de sujet pourconfirmationUrl.

Prend en charge les modèles de substitution : Oui

headers

(Facultatif) La liste des en-têtes à inclure dans les requêtes HTTP adressées au point de terminaison. Chaque entête doit contenir les informations suivantes.

key

La clé de l'en-tête.

Prend en charge les modèles de substitution: Non

value

Valeur de l'en-tête.

Prend en charge les modèles de substitution: Oui

Note

Le type de contenu par défaut est application/json lorsque la charge utile est au format JSON. Sinon, il s'agit de application/octet -stream. Vous pouvez le remplacer en spécifiant le type de contenu exact dans l'en-tête avec le type de contenu clé (insensible à la casse).

auth

(Facultatif) L'authentification utilisée par le moteur de règles pour se connecter à l'URL du point final spécifié dans url l'argument. Actuellement, Signature Version 4 est le seul type d'authentification pris en charge. Pour de plus amples informations, veuillez consulter Autorisation HTTP.

Prend en charge les modèles de substitution : Non

enableBatching

(Facultatif) S'il faut traiter les messages d'action HTTP en une seule demande pour une URL donnée. La valeur peut être vraie ou fausse. Pour plus d'informations sur le traitement par lots, consultez la section Traitement par lots des messages d'action HTTP.

Valeur booléenne

Prend en charge les modèles de substitution : Non

batchConfig

(Facultatif) Paramètres de configuration pour le traitement par lots. Une fois activé, batchConfig les paramètres doivent être spécifiés. Si aucun batchConfig paramètre n'est spécifié, les valeurs par défaut seront utilisées.

maxBatchOpenMs

Durée maximale (en millisecondes) pendant laquelle un message sortant attend que d'autres messages créent le lot. Plus le paramètre est élevé, plus la latence de l'action HTTP par lots est longue.

Valeur minimale : 5 ms. Valeur maximale : 200 ms.

Valeur par défaut : 20 ms

Prend en charge les modèles de substitution : Non

maxBatchSize

Le nombre maximal de messages qui sont regroupés en une seule exécution d'action.

Prend en charge les modèles de substitution : Non

Valeur minimale : 2 messages. Valeur maximale : 10 messages

Valeur par défaut : 10 messages

maxBatchSizeBytes

Taille maximale d'un lot de messages, en octets.

Valeur minimale : 100 octets. Valeur maximale : 131 072 octets

Valeur par défaut : 5 120 octets

Prend en charge les modèles de substitution : Non

batchAcrossTopics

Autoriser ou non le regroupement de messages provenant de différents sujets MQTT en une seule requête HTTP. Par défaut, seuls les messages du même sujet sont regroupés par lots. Activez ce paramètre pour les cas d'utilisation du routage dans lesquels des messages provenant de plusieurs rubriques d'appareils sont destinés au même point de terminaison HTTP.

Valeur par défaut : false

Prend en charge les modèles de substitution : Non

Note

Les messages sont toujours groupés dans le cadre du même compte, du même nom de règle, de l'URL du point de terminaison HTTP cible et du même groupe de facturation. Les messages présentant des attributs différents ne sont jamais combinés dans le même lot, quel que soit le batchAcrossTopics paramètre.

Note

Le type de contenu par défaut est application/json lorsque la charge utile est au format JSON. Sinon, il s'agit de application/octet -stream. Vous pouvez le remplacer en spécifiant le type de contenu exact dans l'en-tête avec le type de contenu clé (insensible à la casse).

Exemples

L'exemple JSON suivant définit une AWS IoT règle avec une action 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
        }
}

Logique de nouvelle tentative d'action HTTP

Le moteur de AWS IoT règles tente à nouveau l'action HTTP conformément aux règles suivantes :

  • Le moteur de règles essaie d'envoyer un message au moins une fois.

  • Le moteur de règles effectue au plus deux nouvelles tentatives. Le nombre maximum de nouvelles tentatives est trois.

  • Le moteur de règles n'effectue pas de nouvelle tentative si :

    • L'essai précédent a fourni une réponse de plus de 16 384 octets.

    • Le service web ou l'application en aval ferme la connexion TCP après la tentative.

    • Le temps total d'exécution d'une demande avec tentatives a dépassé la limite de temporisation de la demande.

    • La requête renvoie un code d'état HTTP autre que 429, 500-599.

Note

Les coûts standard de transfert de données s'appliquent aux nouvelles tentatives.

Consultez aussi