Struct aws_sdk_iotdataplane::client::fluent_builders::Publish

pub struct Publish<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to Publish.

Publishes an MQTT message.

Requires permission to access the Publish action.

For more information about MQTT messages, see MQTT Protocol in the IoT Developer Guide.

For more information about messaging costs, see IoT Core pricing - Messaging.

Implementations

impl<C, M, R> Publish<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(self) -> Result<PublishOutput, SdkError<PublishError>> where
    R::Policy: SmithyRetryPolicy<PublishInputOperationOutputAlias, PublishOutput, PublishError, PublishInputOperationRetryAlias>, 

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn topic(self, input: impl Into<String>) -> Self

The name of the MQTT topic.

pub fn set_topic(self, input: Option<String>) -> Self

The name of the MQTT topic.

pub fn qos(self, input: i32) -> Self

The Quality of Service (QoS) level.

pub fn set_qos(self, input: Option<i32>) -> Self

The Quality of Service (QoS) level.

pub fn retain(self, input: bool) -> Self

A Boolean value that determines whether to set the RETAIN flag when the message is published.

Setting the RETAIN flag causes the message to be retained and sent to new subscribers to the topic.

Valid values: true | false

Default value: false

pub fn set_retain(self, input: Option<bool>) -> Self

A Boolean value that determines whether to set the RETAIN flag when the message is published.

Setting the RETAIN flag causes the message to be retained and sent to new subscribers to the topic.

Valid values: true | false

Default value: false

pub fn payload(self, input: Blob) -> Self

The message body. MQTT accepts text, binary, and empty (null) message payloads.

Publishing an empty (null) payload with retain = true deletes the retained message identified by topic from IoT Core.

pub fn set_payload(self, input: Option<Blob>) -> Self

The message body. MQTT accepts text, binary, and empty (null) message payloads.

Publishing an empty (null) payload with retain = true deletes the retained message identified by topic from IoT Core.

Trait Implementations

impl<C: Clone, M: Clone, R: Clone> Clone for Publish<C, M, R>

fn clone(&self) -> Publish<C, M, R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C: Debug, M: Debug, R: Debug> Debug for Publish<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.