SNS Message Attributes
Amazon SNS 支持传输消息属性,消息属性可让您提供消息相关的结构化元数据项目(如时间戳、地理空间数据、签名和标识符)。每条消息最多可以包含 10 个属性。
消息属性是可选的,并独立于消息正文(但随消息正文一起发送)。接收方可以使用此信息来决定如何处理消息,而不必先处理消息正文。
消息属性项目和验证
每个消息属性包含以下项目:
-
Name – 消息属性的名称可以包含以下字符:A-Z、a-z、0-9、下划线 (_)、连字符 (-) 和句点 (.)。名称不得以句点开头或结尾,并且不应包含连续句点。名称区分大小写,且必须在消息的所有属性名称中是唯一的。名称最多可以有 256 个字符。名称不能以“AWS.”或“Amazon.”(或任何大小写变化形式)开头,因为这些前缀已预留以供 Amazon Web Services 使用。
-
Type – 受支持的消息属性数据类型有
String
、String.Array
、Number
和Binary
。数据类型在内容方面具有与消息正文相同的限制。数据类型区分大小写,长度最多可以为 256 字节。想要了解更多信息,请参阅消息属性数据类型和验证部分。 -
Value – 用户指定的消息属性值。对于字符串数据类型,值属性在内容方面具有与消息正文相同的限制。有关更多信息,请参阅Amazon Simple Notification Service API Reference 中的 Publish 操作。
名称、类型和值都不得为空或 null。此外,消息正文也不应为空或 null。消息属性的所有部分 (包括名称、类型和值) 都包含在消息大小限制中,该限制当前是 256 KB。