IoTAnalytics / Client / batch_put_message

batch_put_message#

IoTAnalytics.Client.batch_put_message(**kwargs)#

Sends messages to a channel.

See also: AWS API Documentation

Request Syntax

response = client.batch_put_message(
    channelName='string',
    messages=[
        {
            'messageId': 'string',
            'payload': b'bytes'
        },
    ]
)
Parameters:
  • channelName (string) –

    [REQUIRED]

    The name of the channel where the messages are sent.

  • messages (list) –

    [REQUIRED]

    The list of messages to be sent. Each message has the format: { “messageId”: “string”, “payload”: “string”}.

    The field names of message payloads (data) that you send to IoT Analytics:

    • Must contain only alphanumeric characters and undescores (_). No other special characters are allowed.

    • Must begin with an alphabetic character or single underscore (_).

    • Cannot contain hyphens (-).

    • In regular expression terms: “^[A-Za-z_]([A-Za-z0-9]*|[A-Za-z0-9][A-Za-z0-9_]*)$”.

    • Cannot be more than 255 characters.

    • Are case insensitive. (Fields named foo and FOO in the same payload are considered duplicates.)

    For example, {“temp_01”: 29} or {“_temp_01”: 29} are valid, but {“temp-01”: 29}, {“01_temp”: 29} or {“__temp_01”: 29} are invalid in message payloads.

    • (dict) –

      Information about a message.

      • messageId (string) – [REQUIRED]

        The ID you want to assign to the message. Each messageId must be unique within each batch sent.

      • payload (bytes) – [REQUIRED]

        The payload of the message. This can be a JSON string or a base64-encoded string representing binary data, in which case you must decode it by means of a pipeline activity.

Return type:

dict

Returns:

Response Syntax

{
    'batchPutMessageErrorEntries': [
        {
            'messageId': 'string',
            'errorCode': 'string',
            'errorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • batchPutMessageErrorEntries (list) –

      A list of any errors encountered when sending the messages to the channel.

      • (dict) –

        Contains informations about errors.

        • messageId (string) –

          The ID of the message that caused the error. See the value corresponding to the messageId key in the message object.

        • errorCode (string) –

          The code associated with the error.

        • errorMessage (string) –

          The message associated with the error.

Exceptions

  • IoTAnalytics.Client.exceptions.ResourceNotFoundException

  • IoTAnalytics.Client.exceptions.InvalidRequestException

  • IoTAnalytics.Client.exceptions.InternalFailureException

  • IoTAnalytics.Client.exceptions.ServiceUnavailableException

  • IoTAnalytics.Client.exceptions.ThrottlingException