AWS SDK Version 4 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Sends an MQTT message directly to a specific client identified by its client ID.

SendDirectMessage targets a single client ID. The receiving client does not need to subscribe to the topic, but the receiver's policy must allow iot:Receive on the specified topic.

Requires permission to access the SendDirectMessage action.

For more information about messaging costs, see Amazon Web Services IoT Core pricing.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to SendDirectMessageAsync.

Namespace: Amazon.IotData
Assembly: AWSSDK.IotData.dll
Version: 3.x.y.z

Syntax

C#
public virtual SendDirectMessageResponse SendDirectMessage(
         SendDirectMessageRequest request
)

Parameters

request
Type: Amazon.IotData.Model.SendDirectMessageRequest

Container for the necessary parameters to execute the SendDirectMessage service method.

Return Value


The response from the SendDirectMessage service method, as returned by IotData.

Exceptions

ExceptionCondition
ForbiddenException The caller isn't authorized to make the request.
GatewayTimeoutException The delivery confirmation was not received from the client within the specified timeout period.
InternalFailureException An unexpected error has occurred.
InvalidRequestException The request is not valid.
RequestEntityTooLargeException The payload exceeds the maximum size allowed.
ResourceNotFoundException The specified resource does not exist.
ThrottlingException The rate exceeds the limit.
UnauthorizedException You are not authorized to perform this operation.

Version Information

.NET Framework:
Supported in: 4.7.2 and newer

See Also