ServiceBusReceivedMessage interface

消息死电的错误说明。

deadLetterErrorDescription?: string

属性值

导致消息死亡的原因。

deadLetterReason?: string

属性值

此消息排队的队列或订阅的名称，在消息被终止之前。 仅在已死信的消息中设置，随后从死信子队列自动转发到另一个实体。 指示消息为死信的实体。

deadLetterSource?: string

属性值

已尝试传递此消息的传递数。 当消息锁过期或消息使用 abandon() 方法显式放弃消息时，计数会递增。

deliveryCount?: number

属性值

消息的原始序列号。 对于已自动转发的邮件，此属性反映最初提交时已分配给邮件的序列号。

enqueuedSequenceNumber?: number

属性值

消息已接受并存储在服务总线中的 UTC 实例。

enqueuedTimeUtc?: Date

属性值

消息标记为删除的 UTC 即时，由于过期而不再可用于从实体检索。 此属性从消息上的 2 个其他属性计算：enqueuedTimeUtc + timeToLive。

expiresAtUtc?: Date

属性值

UTC 即时，直到消息被锁定在队列/订阅中。 锁过期后，deliveryCount 递增，消息再次可供检索。

• 在 receiveAndDelete 接收模式下收到消息时不适用。 模式。

lockedUntilUtc?: Date

属性值

锁令牌是对代理在 peekLock 接收模式下所持有的锁的引用。 锁在内部解决消息，如 产品文档中所述，更详细地

• 在 receiveAndDelete 接收模式下收到消息时不适用。 模式。

lockToken?: string

属性值

服务总线分配给消息的唯一编号。 序列号是分配给消息的唯一 64 位整数，因为它被中转站接受并存储为其真正的标识符。 对于分区实体，最顶层的 16 位反映分区标识符。 序列号单调增加。 当 48-64 位范围耗尽时，它们将滚动到 0。

Javascript 当前支持的最大安全整数2^53 - 1。 序列号是 AMQP Long 类型，长度可达 64 位。 为了表示我们使用名为 long.js的库。 我们希望客户使用此库导出的 Long 类型。

sequenceNumber?: Long

属性值

消息的状态可以是活动、延迟或计划的。 延迟消息具有延迟状态、计划消息具有计划状态、所有其他消息都具有活动状态。

state: "active" | "deferred" | "scheduled"

属性值

可用于自定义消息元数据的应用程序特定属性。

applicationProperties?: {[key: string]: number | boolean | string | Date | null}

属性值

继承自ServiceBusMessage.applicationProperties

需要发送或接收的消息正文。 如果接收消息的应用程序未使用此 SDK，请将正文有效负载转换为字节数组或缓冲区，以便更好地实现跨语言兼容性。

body: any

属性值

继承自ServiceBusMessage.body

消息的内容类型。 （可选）描述消息的有效负载，其描述符遵循RFC2045（第 5 节）的格式，例如“application/json”。

contentType?: string

属性值

继承自 ServiceBusMessage.contentType

允许应用程序为相关目的指定消息的上下文的相关标识符，例如反映正在答复的消息的 MessageId。 请参阅 消息路由和关联。

correlationId?: string | number | Buffer

属性值

继承自ServiceBusMessage.correlationId

消息标识符是一个应用程序定义的值，用于唯一标识消息及其有效负载。

注意：不允许使用非整数的数字。

messageId?: string | number | Buffer

属性值

继承自ServiceBusMessage.messageId

用于向分区实体发送消息的分区键。 最大长度为 128 个字符。 对于 分区实体，设置此值可向同一内部分区分配相关消息，以便正确记录提交顺序。 分区是由哈希函数选择的，不能直接选择此值。

• 对于会话感知实体，sessionId 属性将替代此值。
• 对于非分区实体，将忽略分区键

partitionKey?: string

属性值

继承自ServiceBusMessage.partitionKey

要向其发送答复的实体的地址。 此可选值和应用程序定义值是向消息接收方表达答复路径的标准方法。 当发送方需要答复时，它会将值设置为队列或主题的绝对或相对路径，而该队列或主题要求将答复发送到该队列或主题。 请参阅 消息路由和关联。

replyTo?: string

属性值

继承自ServiceBusMessage.replyTo

扩充 replyTo 地址的会话标识符。 最大长度为 128 个字符。 此值扩充 ReplyTo 信息，并指定在发送到回复实体时应为答复设置哪些 SessionId。 请参阅 消息路由和关联。

replyToSessionId?: string

属性值

继承自ServiceBusMessage.replyToSessionId

消息排队的 UTC 日期和时间。 此属性以 UTC 为单位返回时间;设置属性时，提供的 DateTime 值也必须采用 UTC 格式。 此值用于延迟发送消息。 它用于将发送的消息延迟到将来的特定时间。 消息排队时间并不意味着消息将同时发送。 它将排队，但实际发送时间取决于队列的工作负荷及其状态。

scheduledEnqueueTimeUtc?: Date

属性值

继承自ServiceBusMessage.scheduledEnqueueTimeUtc

会话感知实体的会话标识符。 最大长度为 128 个字符。 对于会话感知实体，此应用程序定义的值指定消息的会话关联。 具有相同会话标识符的消息将受到摘要锁定的约束，并启用确切的无序处理和解体。 对于会话不知道的实体，将忽略此值。 消息会话。

sessionId?: string

属性值

继承自ServiceBusMessage.sessionId

应用程序特定的标签。 此属性使应用程序能够在标准化中向接收方指示消息的用途。 fashion，类似于电子邮件主题行。 映射的 AMQP 属性为“subject”。

subject?: string

属性值

继承自ServiceBusMessage.subject

消息生存时间值。 此值是消息过期的相对持续时间，从中转站接受并存储消息的即时开始，如 enqueuedTimeUtc中捕获的那样。 如果未显式设置，则假定的值是相应队列或主题的 DefaultTimeToLive。 消息级 timeToLive 值不能超过实体的 DefaultTimeToLive 设置，如果这样做，则以无提示方式调整该值。 请参阅 过期。

timeToLive?: number

属性值

继承自 ServiceBusMessage.timeToLive 的

“to”地址。 此属性保留供将来在路由方案中使用，目前被中转站本身忽略。 应用程序可以在规则驱动的 自动转发链接 方案中使用此值来指示消息的预期逻辑目标。

to?: string

属性值

继承自 ServiceBusMessage.to 的