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

Microsoft.ServiceBus namespaces/topics

Bicep 资源定义

命名空间/主题资源类型可以部署到:

有关每个 API 版本中更改的属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ServiceBus/namespaces/topics 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.ServiceBus/namespaces/topics@2022-01-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    autoDeleteOnIdle: 'string'
    defaultMessageTimeToLive: 'string'
    duplicateDetectionHistoryTimeWindow: 'string'
    enableBatchedOperations: bool
    enableExpress: bool
    enablePartitioning: bool
    maxMessageSizeInKilobytes: int
    maxSizeInMegabytes: int
    requiresDuplicateDetection: bool
    status: 'string'
    supportOrdering: bool
  }
}

属性值

namespaces/topics

名称 说明 Value
name 资源名称

了解如何在 Bicep 中为子资源设置名称和类型。
字符串 (必需)

字符限制:1-260

有效字符:
字母数字、句点、连字符、下划线和斜杠。

以字母数字开头和结尾。
父级 (parent) 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源之外的子资源
类型为资源的符号名称: 命名空间
properties 主题资源的属性。 SBTopicProperties

SBTopicProperties

名称 说明 Value
autoDeleteOnIdle ISO 8601 时间跨度空闲间隔后,主题将自动删除。 最短持续时间为 5 分钟。 字符串
defaultMessageTimeToLive ISO 8601 默认消息时间跨度到实时值。 这是消息过期的持续时间,从消息发送到服务总线时开始。 这是未在消息本身上设置 TimeToLive 时使用的默认值。 字符串
duplicateDetectionHistoryTimeWindow ISO8601 时间跨度结构,用于定义重复检测历史记录的持续时间。 默认值为 10 分钟。 字符串
enableBatchedOperations 指示是否启用服务器端批处理操作的值。 bool
enableExpress 指示是否启用 Express Entities 的值。 快速主题在将消息写入持久存储之前暂时将其保留在内存中。 bool
enablePartitioning 指示是否启用要跨多个消息中转站进行分区的主题的值。 bool
maxMessageSizeInKilobytes 主题可接受的消息有效负载) 的最大大小 (KB。 此属性目前仅在高级版中使用,默认值为 1024。 int
maxSizeInMegabytes 主题的最大大小(以 MB 为单位),即为主题分配的内存大小。 默认值为 1024。 int
requiresDuplicateDetection 指示本主题是否需要重复检测的值。 bool
状态 枚举消息实体状态的可能值。 “Active”
“正在创建”
“正在删除”
“Disabled”
“ReceiveDisabled”
“重命名”
“正在还原”
“SendDisabled”
“未知”
supportOrdering 指示主题是否支持排序的值。 bool

快速入门模板

以下快速入门模板部署此资源类型。

模板 说明
集成模式 - 消息路由器 - 服务总线

部署到 Azure
显示如何使用服务总线主题设置消息路由器模式的解决方案
创建自定义主题订阅Azure 事件网格

部署到 Azure
创建Azure 事件网格自定义主题和服务总线主题订阅。 模板最初由 Markus Meyer 创作。
使用服务总线通过逻辑应用关联消息

部署到 Azure
其中显示了如何使用 Azure 服务总线
创建服务总线命名空间、主题和订阅

部署到 Azure
使用此模板可以部署服务总线标准命名空间、主题和订阅。
创建服务总线命名空间、主题、订阅和规则

部署到 Azure
使用此模板可以部署服务总线标准命名空间、主题、订阅和规则。
创建服务总线命名空间和主题

部署到 Azure
此模板创建服务总线命名空间和主题。
使用订阅和 SQL 筛选器创建服务总线主题

部署到 Azure
此模板使用 SQL 筛选器表达式创建包含订阅的服务总线命名空间和主题,以便仅接收与定义的 SQL 筛选器表达式匹配的消息。

ARM 模板资源定义

命名空间/主题资源类型可以部署到:

有关每个 API 版本中更改的属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ServiceBus/namespaces/topics 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.ServiceBus/namespaces/topics",
  "apiVersion": "2022-01-01-preview",
  "name": "string",
  "properties": {
    "autoDeleteOnIdle": "string",
    "defaultMessageTimeToLive": "string",
    "duplicateDetectionHistoryTimeWindow": "string",
    "enableBatchedOperations": "bool",
    "enableExpress": "bool",
    "enablePartitioning": "bool",
    "maxMessageSizeInKilobytes": "int",
    "maxSizeInMegabytes": "int",
    "requiresDuplicateDetection": "bool",
    "status": "string",
    "supportOrdering": "bool"
  }
}

属性值

namespaces/topics

名称 说明 Value
type 资源类型 “Microsoft.ServiceBus/namespaces/topics”
apiVersion 资源 API 版本 “2022-01-01-preview”
name 资源名称

了解如何在 JSON ARM 模板中为子资源设置名称和类型。
字符串 (必需)

字符限制:1-260

有效字符:
字母数字、句点、连字符、下划线和斜杠。

以字母数字开头和结尾。
properties 主题资源的属性。 SBTopicProperties

SBTopicProperties

名称 说明 Value
autoDeleteOnIdle ISO 8601 时间跨度空闲间隔后,主题将自动删除。 最短持续时间为 5 分钟。 字符串
defaultMessageTimeToLive ISO 8601 默认消息时间跨度到实时值。 这是消息过期的持续时间,从消息发送到服务总线时开始。 这是未在消息本身上设置 TimeToLive 时使用的默认值。 字符串
duplicateDetectionHistoryTimeWindow ISO8601 时间跨度结构,用于定义重复检测历史记录的持续时间。 默认值为 10 分钟。 字符串
enableBatchedOperations 指示是否启用服务器端批处理操作的值。 bool
enableExpress 指示是否启用 Express Entities 的值。 快速主题在将消息写入持久存储之前暂时将其保留在内存中。 bool
enablePartitioning 指示是否启用要跨多个消息中转站进行分区的主题的值。 bool
maxMessageSizeInKilobytes 主题可接受的消息有效负载) 的最大大小 (KB。 此属性目前仅在高级版中使用,默认值为 1024。 int
maxSizeInMegabytes 主题的最大大小(以 MB 为单位),即为主题分配的内存大小。 默认值为 1024。 int
requiresDuplicateDetection 指示本主题是否需要重复检测的值。 bool
状态 枚举消息实体状态的可能值。 “Active”
“正在创建”
“正在删除”
“Disabled”
“ReceiveDisabled”
“重命名”
“正在还原”
“SendDisabled”
“未知”
supportOrdering 指示主题是否支持排序的值。 bool

快速入门模板

以下快速入门模板部署此资源类型。

模板 说明
集成模式 - 消息路由器 - 服务总线

部署到 Azure
演示如何使用服务总线主题设置消息路由器模式的解决方案
创建Azure 事件网格自定义主题订阅

部署到 Azure
创建Azure 事件网格自定义主题和服务总线主题订阅。 模板最初由 Markus Meyer 创作。
使用服务总线通过逻辑应用关联消息

部署到 Azure
其中显示了如何使用 Azure 服务总线
创建服务总线命名空间、主题和订阅

部署到 Azure
使用此模板可以部署服务总线标准命名空间、主题和订阅。
创建服务总线命名空间、主题、订阅和规则

部署到 Azure
使用此模板可以部署服务总线标准命名空间、主题、订阅和规则。
创建服务总线命名空间和主题

部署到 Azure
此模板创建服务总线命名空间和主题。
使用订阅和 SQL 筛选器创建服务总线主题

部署到 Azure
此模板使用 SQL 筛选器表达式创建包含订阅的服务总线命名空间和主题,以仅接收与定义的 SQL 筛选器表达式匹配的消息。

Terraform (AzAPI 提供程序) 资源定义

命名空间/主题资源类型可以部署到:

  • 资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ServiceBus/namespaces/topics 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceBus/namespaces/topics@2022-01-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      autoDeleteOnIdle = "string"
      defaultMessageTimeToLive = "string"
      duplicateDetectionHistoryTimeWindow = "string"
      enableBatchedOperations = bool
      enableExpress = bool
      enablePartitioning = bool
      maxMessageSizeInKilobytes = int
      maxSizeInMegabytes = int
      requiresDuplicateDetection = bool
      status = "string"
      supportOrdering = bool
    }
  })
}

属性值

namespaces/topics

名称 说明 Value
type 资源类型 “Microsoft.ServiceBus/namespaces/topics@2022-01-01-preview”
name 资源名称 字符串 (必需)

字符限制:1-260

有效字符:
字母数字、句点、连字符、下划线和斜杠。

以字母数字开头和结尾。
parent_id 此资源的父资源的 ID。 类型为:命名空间的资源的 ID
properties 主题资源的属性。 SBTopicProperties

SBTopicProperties

名称 说明 Value
autoDeleteOnIdle ISO 8601 时间跨度空闲间隔,在此间隔后将自动删除主题。 最短持续时间为 5 分钟。 字符串
defaultMessageTimeToLive ISO 8601 默认消息时间跨度到实时值。 这是消息过期的持续时间,从消息发送到服务总线时开始。 这是未在消息本身上设置 TimeToLive 时使用的默认值。 字符串
duplicateDetectionHistoryTimeWindow 定义重复检测历史记录持续时间的 ISO8601 时间跨度结构。 默认值为 10 分钟。 字符串
enableBatchedOperations 指示是否启用服务器端批处理操作的值。 bool
enableExpress 指示是否启用快速实体的值。 在将消息写入永久性存储之前,快速主题暂时将消息保留在内存中。 bool
enablePartitioning 指示是否启用要在多个消息中转站之间分区的主题的值。 bool
maxMessageSizeInKilobytes 主题可以接受的消息有效负载的最大大小 (kb) 。 此属性目前仅在高级版中使用,默认值为 1024。 int
maxSizeInMegabytes 主题的最大大小(以 MB 为单位),即为主题分配的内存大小。 默认值为 1024。 int
requiresDuplicateDetection 指示本主题是否需要重复检测的值。 bool
状态 枚举消息实体状态的可能值。 “Active”
“正在创建”
“正在删除”
“Disabled”
“ReceiveDisabled”
“重命名”
“正在还原”
“SendDisabled”
"Unknown"
supportOrdering 指示主题是否支持排序的值。 bool