你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ServiceBusMessage interface

包:

@azure/service-bus

描述要发送到服务总线的消息。

属性

applicationProperties	可用于自定义消息元数据的应用程序特定属性。
body	需要发送或接收的消息正文。 如果接收消息的应用程序未使用此 SDK，请将正文有效负载转换为字节数组或缓冲区，以提高跨语言兼容性。
contentType	消息的内容类型。 （可选）描述消息的有效负载，其描述符遵循 RFC2045 第 5 节的格式，例如“application/json”。
correlationId	相关标识符，它允许应用程序为消息指定上下文以实现关联，例如反映正在答复的消息的 MessageId。 请参阅 消息路由和关联。
messageId	消息标识符是应用程序定义的值，可用于唯一标识消息及其有效负载。 注意：不允许使用不是整数的数字。
partitionKey	用于将消息发送到分区实体的分区键。 最大长度为 128 个字符。 对于已分区实体，设置此值后，可以将相关消息分配到同一内部分区，以便能够正确记录提交序列顺序。 分区是由哈希函数通过此值进行选择，无法直接选择。 对于会话感知实体， sessionId 属性将替代此值。 对于未分区的实体，将忽略分区键
replyTo	要向其发送答复的实体的地址。 应用程序定义的这一可选值是一种标准方法，可用于向消息接收程序明示答复路径。 如果发送程序希望收到答复，它会将此值设置为，要将答复发送到的队列或主题的绝对或相关路径。 请参阅 消息路由和关联。
replyToSessionId	用于扩充地址的 replyTo 会话标识符。 最大长度为 128 个字符。 此值补充了 ReplyTo 信息，并指定了应为发送给答复实体的答复设置的 SessionId。 请参阅 消息路由和关联。
scheduledEnqueueTimeUtc	消息排队的 UTC 日期和时间。 此属性返回 UTC 时间;设置 属性时，提供的 DateTime 值也必须采用 UTC 格式。 此值用于延迟消息发送。 它用于将消息发送延迟到将来的特定时间。 消息排队时间并不意味着将同时发送消息。 它将排队，但实际发送时间取决于队列的工作负荷及其状态。
sessionId	会话感知实体的会话标识符。 最大长度为 128 个字符。 对于会话感知实体，应用程序定义的此值指定了消息的会话附属关系。 会话标识符相同的消息会处于摘要锁定状态，并确切启用依序处理和解多路复用。 对于非会话感知实体，可忽略此值。 消息会话。
subject	应用程序特定标签。 此属性使应用程序能够在标准化中向接收方指示消息的用途。 fashion，类似于电子邮件主题行。 映射的 AMQP 属性为“subject”。
timeToLive	消息的生存时间值。 此值是消息过期的相对持续时间，从中转站接受并存储消息的瞬间开始，如 中 enqueuedTimeUtc捕获。 如果未明确设置，假设值为适用于相应队列或主题的 DefaultTimeToLive。 消息级别 timeToLive 值不能长于实体的 DefaultTimeToLive 设置，如果存在，则会以无提示方式对其进行调整。 请参阅 过期。
to	“to”地址。 此属性已保留，以供将来用于路由方案，暂被中转站本身忽略。 应用程序可以在规则驱动的 自动转发链接 方案中使用此值，以指示消息的预期逻辑目标。

属性详细信息

applicationProperties

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

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

属性值

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

body

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

body: any

属性值

any

contentType

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

contentType?: string

属性值

string

correlationId

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

correlationId?: string | number | Buffer

属性值

string | number | Buffer

messageId

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

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

messageId?: string | number | Buffer

属性值

string | number | Buffer

partitionKey

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

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

partitionKey?: string

属性值

string

replyTo

要向其发送答复的实体的地址。 应用程序定义的这一可选值是一种标准方法，可用于向消息接收程序明示答复路径。 如果发送程序希望收到答复，它会将此值设置为，要将答复发送到的队列或主题的绝对或相关路径。 请参阅 消息路由和关联。

replyTo?: string

属性值

string

replyToSessionId

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

replyToSessionId?: string

属性值

string

scheduledEnqueueTimeUtc

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

scheduledEnqueueTimeUtc?: Date

属性值

Date

sessionId

会话感知实体的会话标识符。 最大长度为 128 个字符。 对于会话感知实体，应用程序定义的此值指定了消息的会话附属关系。 会话标识符相同的消息会处于摘要锁定状态，并确切启用依序处理和解多路复用。 对于非会话感知实体，可忽略此值。 消息会话。

sessionId?: string

属性值

string

subject

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

subject?: string

属性值

string

timeToLive

消息的生存时间值。 此值是消息过期的相对持续时间，从中转站接受并存储消息的瞬间开始，如 中 enqueuedTimeUtc捕获。 如果未明确设置，假设值为适用于相应队列或主题的 DefaultTimeToLive。 消息级别 timeToLive 值不能长于实体的 DefaultTimeToLive 设置，如果存在，则会以无提示方式对其进行调整。 请参阅 过期。

timeToLive?: number

属性值

number

to

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

to?: string

属性值

string