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.
Container for the parameters to the SendMessage operation.
Delivers a message to the specified queue.
A message can include only XML, JSON, and unformatted text. The following Unicode
characters are allowed:
Any characters not included in this list will be rejected. For more information, see
the W3C specification for characters.
#x9
| #xA
| #xD
| #x20
to #xD7FF
| #xE000
to #xFFFD
| #x10000
to #x10FFFF
Namespace: Amazon.SQS.Model
Assembly: AWSSDK.SQS.dll
Version: 3.x.y.z
public class SendMessageRequest : AmazonSQSRequest IAmazonWebServiceRequest
The SendMessageRequest type exposes the following members
Name | Description | |
---|---|---|
SendMessageRequest() |
Empty constructor used to set properties independently even when a simple constructor is available |
|
SendMessageRequest(string, string) |
Instantiates SendMessageRequest with the parameterized properties |
Name | Type | Description | |
---|---|---|---|
DelaySeconds | System.Int32 |
Gets and sets the property DelaySeconds.
The length of time, in seconds, for which to delay a specific message. Valid values:
0 to 900. Maximum: 15 minutes. Messages with a positive
When you set |
|
MessageAttributes | System.Collections.Generic.Dictionary<System.String, Amazon.SQS.Model.MessageAttributeValue> |
Gets and sets the property MessageAttributes.
Each message attribute consists of a |
|
MessageBody | System.String |
Gets and sets the property MessageBody. The message to send. The minimum size is one character. The maximum size is 256 KiB. A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:
Any characters not included in this list will be rejected. For more information, see the W3C specification for characters. |
|
MessageDeduplicationId | System.String |
Gets and sets the property MessageDeduplicationId. This parameter applies only to FIFO (first-in-first-out) queues.
The token used for deduplication of sent messages. If a message with a particular
The
If a message is sent successfully but the acknowledgement is lost and the message
is resent with the same Amazon SQS continues to keep track of the message deduplication ID even after the message is received and deleted.
The maximum length of
For best practices of using |
|
MessageGroupId | System.String |
Gets and sets the property MessageGroupId. This parameter applies only to FIFO (first-in-first-out) queues.
The tag that specifies that a message belongs to a specific message group. Messages
that belong to the same message group are processed in a FIFO manner (however, messages
in different message groups might be processed out of order). To interleave multiple
ordered streams within a single queue, use
The length of
For best practices of using
|
|
MessageSystemAttributes | System.Collections.Generic.Dictionary<System.String, Amazon.SQS.Model.MessageSystemAttributeValue> |
Gets and sets the property MessageSystemAttributes.
The message system attribute to send. Each message system attribute consists of a
|
|
QueueUrl | System.String |
Gets and sets the property QueueUrl. The URL of the Amazon SQS queue to which a message is sent. Queue URLs and names are case-sensitive. |
This example shows how to send a message.
var client = new AmazonSQSClient(); var request = new SendMessageRequest { DelaySeconds = (int)TimeSpan.FromSeconds(5).TotalSeconds, MessageAttributes = new Dictionary<string, MessageAttributeValue> { { "MyNameAttribute", new MessageAttributeValue { DataType = "String", StringValue = "John Doe" } }, { "MyAddressAttribute", new MessageAttributeValue { DataType = "String", StringValue = "123 Main St." } }, { "MyRegionAttribute", new MessageAttributeValue { DataType = "String", StringValue = "Any Town, United States" } } }, MessageBody = "John Doe customer information.", QueueUrl = "https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyTestQueue" }; var response = client.SendMessage(request); Console.WriteLine("For message ID '" + response.MessageId + "':"); Console.WriteLine(" MD5 of message attributes: " + response.MD5OfMessageAttributes); Console.WriteLine(" MD5 of message body: " + response.MD5OfMessageBody);
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5, 4.0, 3.5