[ aws . iotanalytics ]

batch-put-message

Description

Sends messages to a channel.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  batch-put-message
--channel-name <value>
--messages <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--channel-name (string)

The name of the channel where the messages are sent.

--messages (list)

The list of messages to be sent. Each message has format: '{ "messageId": "string", "payload": "string"}'.

Note that the field names of message payloads (data) that you send to AWS 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 greater 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.

Shorthand Syntax:

messageId=string,payload=blob ...

JSON Syntax:

[
  {
    "messageId": "string",
    "payload": blob
  }
  ...
]

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Examples

To send a message to a channel

The following batch-put-message example sends a message to the specified channel.

aws iotanalytics batch-put-message \
    --cli-input-json file://batch-put-message.json

Contents of batch-put-message.json:

{
    "channelName": "mychannel",
    "messages": [
        {
            "messageId": "0001",
            "payload": "eyAidGVtcGVyYXR1cmUiOiAyMCB9"
        }
    ]
}

Output:

{
    "batchPutMessageErrorEntries": []
}

For more information, see BatchPutMessage in the AWS IoT Analytics API Reference.

Output

batchPutMessageErrorEntries -> (list)

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

(structure)

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.