MessageAttributeValue - Amazon Simple Queue Service (original) (raw)
The user-specified message attribute value. For string data types, theValue attribute has the same restrictions on the content as the message body. For more information, see [SendMessage](./API%5FSendMessage.html).
Name, type, value and the message body must not be empty or null. All parts of the message attribute, including Name,Type, and Value, are part of the message size restriction (256 KiB or 262,144 bytes).
Contents
DataType
Amazon SQS supports the following logical data types: String,Number, and Binary. For the Number data type, you must use StringValue.
You can also append custom labels. For more information, see Amazon SQS Message Attributes in the Amazon SQS Developer Guide.
Type: String
Required: Yes
BinaryListValues
Not implemented. Reserved for future use.
Type: Array of Base64-encoded binary data objects
Required: No
BinaryValue
Binary type attributes can store any binary data, such as compressed data, encrypted data, or images.
Type: Base64-encoded binary data object
Required: No
StringListValues
Not implemented. Reserved for future use.
Type: Array of strings
Required: No
StringValue
Strings are Unicode with UTF-8 binary encoding. For a list of code values, see ASCII Printable Characters.
Type: String
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: