MessageAttributeValue - Amazon Simple Queue Service
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.

MessageAttributeValue

The user-specified message attribute value. For string data types, the Value attribute has the same restrictions on the content as the message body. For more information, see SendMessage.

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 KB or 262,144 bytes).

Contents

BinaryListValue.N

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

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 Simple Queue Service Developer Guide.

Type: String

Required: Yes

StringListValue.N

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: