Поделиться через


Пространства имен Microsoft.ServiceBus и разделы

Определение ресурсов Bicep

Тип ресурса пространства имен и разделов можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ServiceBus/namespaces/topics, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.ServiceBus/namespaces/topics@2025-05-01-preview' = {
  parent: resourceSymbolicName
  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
    userMetadata: 'string'
  }
}

Значения свойств

Microsoft.ServiceBus/namespaces/темы

Имя Описание Ценность
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 1 (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: пространства имен
свойства Свойства ресурса раздела. SBTopicProperties

SBTopicProperties

Имя Описание Ценность
autoDeleteOnIdle Интервал простоя интервала времени ISO 8601, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут. струна
defaultMessageTimeToLive Время ожидания сообщения ISO 8601 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении. струна
duplicateDetectionHistoryTimeWindow ISO8601 структура интервала времени, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию — 10 минут. струна
enableBatchedOperations Значение, указывающее, включены ли пакетные операции на стороне сервера. булевая переменная (bool)
enableExpress Значение, указывающее, включены ли экспресс-сущности. Экспресс-раздел содержит сообщение в памяти временно перед записью в постоянное хранилище. булевая переменная (bool)
enablePartitioning Значение, указывающее, включена ли секция между несколькими брокерами сообщений. булевая переменная (bool)
maxMessageSizeInKilobytes Максимальный размер (в КБ) полезных данных сообщения, которые можно принять в разделе. Это свойство используется только в Premium сегодня, а по умолчанию — 1024. инт
maxSizeInMegabytes Максимальный размер раздела в мегабайтах, который является размером памяти, выделенной для раздела. Значение по умолчанию — 1024. инт
requiresDuplicateDetection Значение, указывающее, требуется ли для этого раздела обнаружение повторяющихся данных. булевая переменная (bool)
статус Перечисляет возможные значения состояния сущности обмена сообщениями. "Активный"
Создание
Удаление
"Отключено"
"ReceiveDisabled"
Переименование
Восстановление
SendDisabled
"Неизвестно"
supportOrdering Значение, указывающее, поддерживает ли раздел упорядочение. булевая переменная (bool)
метаданные пользователя Возвращает и задает метаданные пользователя. струна

Примеры использования

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
создает приложение микрослужб Dapr с помощью приложений контейнеров Создайте приложение микрослужб Dapr с помощью контейнерных приложений.
Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений.

Определение ресурса шаблона ARM

Тип ресурса пространства имен и разделов можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ServiceBus/namespaces/topics, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.ServiceBus/namespaces/topics",
  "apiVersion": "2025-05-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",
    "userMetadata": "string"
  }
}

Значения свойств

Microsoft.ServiceBus/namespaces/темы

Имя Описание Ценность
apiVersion Версия API '2025-05-01-preview'
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 1 (обязательно)
свойства Свойства ресурса раздела. SBTopicProperties
тип Тип ресурса "Microsoft.ServiceBus/namespaces/topics"

SBTopicProperties

Имя Описание Ценность
autoDeleteOnIdle Интервал простоя интервала времени ISO 8601, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут. струна
defaultMessageTimeToLive Время ожидания сообщения ISO 8601 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении. струна
duplicateDetectionHistoryTimeWindow ISO8601 структура интервала времени, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию — 10 минут. струна
enableBatchedOperations Значение, указывающее, включены ли пакетные операции на стороне сервера. булевая переменная (bool)
enableExpress Значение, указывающее, включены ли экспресс-сущности. Экспресс-раздел содержит сообщение в памяти временно перед записью в постоянное хранилище. булевая переменная (bool)
enablePartitioning Значение, указывающее, включена ли секция между несколькими брокерами сообщений. булевая переменная (bool)
maxMessageSizeInKilobytes Максимальный размер (в КБ) полезных данных сообщения, которые можно принять в разделе. Это свойство используется только в Premium сегодня, а по умолчанию — 1024. инт
maxSizeInMegabytes Максимальный размер раздела в мегабайтах, который является размером памяти, выделенной для раздела. Значение по умолчанию — 1024. инт
requiresDuplicateDetection Значение, указывающее, требуется ли для этого раздела обнаружение повторяющихся данных. булевая переменная (bool)
статус Перечисляет возможные значения состояния сущности обмена сообщениями. "Активный"
Создание
Удаление
"Отключено"
"ReceiveDisabled"
Переименование
Восстановление
SendDisabled
"Неизвестно"
supportOrdering Значение, указывающее, поддерживает ли раздел упорядочение. булевая переменная (bool)
метаданные пользователя Возвращает и задает метаданные пользователя. струна

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
корреляция сообщений по Logic Apps с помощью служебной шины

развертывание в Azure
в котором показано, как можно сопоставить сообщения по Logic Apps с помощью служебной шины Azure
создает приложение микрослужб Dapr с помощью приложений контейнеров

развертывание в Azure
Создайте приложение микрослужб Dapr с помощью контейнерных приложений.
Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров

развертывание в Azure
Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений.
Шаблоны интеграции — маршрутизатор сообщений — служебной шины

развертывание в Azure
Решение, в котором показано, как настроить шаблон маршрутизатора сообщений с помощью раздела служебной шины

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса пространства имен и разделов можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.ServiceBus/namespaces/topics, добавьте следующий объект Terraform в шаблон.

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

Значения свойств

Microsoft.ServiceBus/namespaces/темы

Имя Описание Ценность
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 1 (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: пространства имен
свойства Свойства ресурса раздела. SBTopicProperties
тип Тип ресурса "Microsoft.ServiceBus/namespaces/topics@2025-05-01-preview"

SBTopicProperties

Имя Описание Ценность
autoDeleteOnIdle Интервал простоя интервала времени ISO 8601, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут. струна
defaultMessageTimeToLive Время ожидания сообщения ISO 8601 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении. струна
duplicateDetectionHistoryTimeWindow ISO8601 структура интервала времени, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию — 10 минут. струна
enableBatchedOperations Значение, указывающее, включены ли пакетные операции на стороне сервера. булевая переменная (bool)
enableExpress Значение, указывающее, включены ли экспресс-сущности. Экспресс-раздел содержит сообщение в памяти временно перед записью в постоянное хранилище. булевая переменная (bool)
enablePartitioning Значение, указывающее, включена ли секция между несколькими брокерами сообщений. булевая переменная (bool)
maxMessageSizeInKilobytes Максимальный размер (в КБ) полезных данных сообщения, которые можно принять в разделе. Это свойство используется только в Premium сегодня, а по умолчанию — 1024. инт
maxSizeInMegabytes Максимальный размер раздела в мегабайтах, который является размером памяти, выделенной для раздела. Значение по умолчанию — 1024. инт
requiresDuplicateDetection Значение, указывающее, требуется ли для этого раздела обнаружение повторяющихся данных. булевая переменная (bool)
статус Перечисляет возможные значения состояния сущности обмена сообщениями. "Активный"
Создание
Удаление
"Отключено"
"ReceiveDisabled"
Переименование
Восстановление
SendDisabled
"Неизвестно"
supportOrdering Значение, указывающее, поддерживает ли раздел упорядочение. булевая переменная (bool)
метаданные пользователя Возвращает и задает метаданные пользователя. струна

Примеры использования

Примеры Terraform

Простой пример развертывания ServiceBus Topic.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "namespace" {
  type      = "Microsoft.ServiceBus/namespaces@2022-01-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      disableLocalAuth    = false
      publicNetworkAccess = "Enabled"
      zoneRedundant       = false
    }
    sku = {
      capacity = 0
      name     = "Standard"
      tier     = "Standard"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "topic" {
  type      = "Microsoft.ServiceBus/namespaces/topics@2021-06-01-preview"
  parent_id = azapi_resource.namespace.id
  name      = var.resource_name
  body = {
    properties = {
      enableBatchedOperations    = false
      enableExpress              = false
      enablePartitioning         = true
      maxSizeInMegabytes         = 81920
      requiresDuplicateDetection = false
      status                     = "Active"
      supportOrdering            = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}