aws_sdk_iotanalytics/client/
batch_put_message.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`BatchPutMessage`](crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`channel_name(impl Into<String>)`](crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder::channel_name) / [`set_channel_name(Option<String>)`](crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder::set_channel_name):<br>required: **true**<br><p>The name of the channel where the messages are sent.</p><br>
7    ///   - [`messages(Message)`](crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder::messages) / [`set_messages(Option<Vec::<Message>>)`](crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder::set_messages):<br>required: **true**<br><p>The list of messages to be sent. Each message has the format: { "messageId": "string", "payload": "string"}.</p> <p>The field names of message payloads (data) that you send to IoT Analytics:</p> <ul>  <li>   <p>Must contain only alphanumeric characters and undescores (_). No other special characters are allowed.</p></li>  <li>   <p>Must begin with an alphabetic character or single underscore (_).</p></li>  <li>   <p>Cannot contain hyphens (-).</p></li>  <li>   <p>In regular expression terms: "^\[A-Za-z_\](\[A-Za-z0-9\]*|\[A-Za-z0-9\]\[A-Za-z0-9_\]*)$".</p></li>  <li>   <p>Cannot be more than 255 characters.</p></li>  <li>   <p>Are case insensitive. (Fields named foo and FOO in the same payload are considered duplicates.)</p></li> </ul> <p>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.</p><br>
8    /// - On success, responds with [`BatchPutMessageOutput`](crate::operation::batch_put_message::BatchPutMessageOutput) with field(s):
9    ///   - [`batch_put_message_error_entries(Option<Vec::<BatchPutMessageErrorEntry>>)`](crate::operation::batch_put_message::BatchPutMessageOutput::batch_put_message_error_entries): <p>A list of any errors encountered when sending the messages to the channel.</p>
10    /// - On failure, responds with [`SdkError<BatchPutMessageError>`](crate::operation::batch_put_message::BatchPutMessageError)
11    pub fn batch_put_message(&self) -> crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder {
12        crate::operation::batch_put_message::builders::BatchPutMessageFluentBuilder::new(self.handle.clone())
13    }
14}