Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Определение ресурсов Bicep
Тип ресурса пространства имен, разделов и подписок можно развернуть с помощью операций, предназначенных для следующих целей:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.ServiceBus/namespaces/topics/subscriptions, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.ServiceBus/namespaces/topics/subscriptions@2022-10-01-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
autoDeleteOnIdle: 'string'
clientAffineProperties: {
clientId: 'string'
isDurable: bool
isShared: bool
}
deadLetteringOnFilterEvaluationExceptions: bool
deadLetteringOnMessageExpiration: bool
defaultMessageTimeToLive: 'string'
duplicateDetectionHistoryTimeWindow: 'string'
enableBatchedOperations: bool
forwardDeadLetteredMessagesTo: 'string'
forwardTo: 'string'
isClientAffine: bool
lockDuration: 'string'
maxDeliveryCount: int
requiresSession: bool
status: 'string'
}
}
Значения свойств
Microsoft.ServiceBus/namespaces/topics/subscriptions
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя ресурса | струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 50 (обязательно) |
| родитель | В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса. Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса. |
Символьное имя ресурса типа: пространства имен и разделы |
| свойства | Свойства ресурса подписок. | SBSubscriptionProperties |
SBClientAffineProperties
| Имя | Описание | Ценность |
|---|---|---|
| clientId | Указывает идентификатор клиента приложения, создавшего клиент-аффинную подписку. | струна |
| isDurable | Для клиентских подписок это значение указывает, является ли подписка устойчивой или нет. | булевая переменная (bool) |
| isShared | Для клиентских подписок, аффинных подписок это значение указывает, является ли подписка общей или нет. | булевая переменная (bool) |
SBSubscriptionProperties
| Имя | Описание | Ценность |
|---|---|---|
| autoDeleteOnIdle | Интервал простоя области времени ISO 8061, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут. | струна |
| clientAffineProperties | Свойства, относящиеся к подпискам клиента. | SBClientAffineProperties |
| deadLetteringOnFilterEvaluationExceptions | Значение, указывающее, имеет ли подписка поддержку недоставленных писем при исключениях оценки фильтра. | булевая переменная (bool) |
| deadLetteringOnMessageExpiration | Значение, указывающее, поддерживает ли подписка недоставленную букву при истечении срока действия сообщения. | булевая переменная (bool) |
| defaultMessageTimeToLive | Время ожидания сообщения ISO 8061 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении. | струна |
| duplicateDetectionHistoryTimeWindow | Структура интервала времени ISO 8601, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию — 10 минут. | струна |
| enableBatchedOperations | Значение, указывающее, включены ли пакетные операции на стороне сервера. | булевая переменная (bool) |
| forwardDeadLetteredMessagesTo | Имя очереди и раздела для пересылки сообщения "Недоставленная буква" | струна |
| forwardTo | Имя очереди и раздела для пересылки сообщений | струна |
| isClientAffine | Значение, указывающее, имеет ли подписка сходство с идентификатором клиента. | булевая переменная (bool) |
| lockDuration | Временное интервал времени блокировки ISO 8061 для подписки. Значение по умолчанию — 1 минуту. | струна |
| maxDeliveryCount | Максимальное количество поставок. | инт |
| требуетсяSession | Значение, указывающее, поддерживает ли подписка концепцию сеансов. | булевая переменная (bool) |
| статус | Перечисляет возможные значения состояния сущности обмена сообщениями. | "Активный" Создание Удаление "Отключено" "ReceiveDisabled" Переименование Восстановление SendDisabled "Неизвестно" |
Примеры использования
Примеры быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.
| Bicep-файл | Описание |
|---|---|
| создает приложение микрослужб Dapr с помощью приложений контейнеров | Создайте приложение микрослужб Dapr с помощью контейнерных приложений. |
| Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров | Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений. |
Определение ресурса шаблона ARM
Тип ресурса пространства имен, разделов и подписок можно развернуть с помощью операций, предназначенных для следующих целей:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.ServiceBus/namespaces/topics/subscriptions, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.ServiceBus/namespaces/topics/subscriptions",
"apiVersion": "2022-10-01-preview",
"name": "string",
"properties": {
"autoDeleteOnIdle": "string",
"clientAffineProperties": {
"clientId": "string",
"isDurable": "bool",
"isShared": "bool"
},
"deadLetteringOnFilterEvaluationExceptions": "bool",
"deadLetteringOnMessageExpiration": "bool",
"defaultMessageTimeToLive": "string",
"duplicateDetectionHistoryTimeWindow": "string",
"enableBatchedOperations": "bool",
"forwardDeadLetteredMessagesTo": "string",
"forwardTo": "string",
"isClientAffine": "bool",
"lockDuration": "string",
"maxDeliveryCount": "int",
"requiresSession": "bool",
"status": "string"
}
}
Значения свойств
Microsoft.ServiceBus/namespaces/topics/subscriptions
| Имя | Описание | Ценность |
|---|---|---|
| apiVersion | Версия API | '2022-10-01-preview' |
| имя | Имя ресурса | струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 50 (обязательно) |
| свойства | Свойства ресурса подписок. | SBSubscriptionProperties |
| тип | Тип ресурса | "Microsoft.ServiceBus/namespaces/topics/subscriptions" |
SBClientAffineProperties
| Имя | Описание | Ценность |
|---|---|---|
| clientId | Указывает идентификатор клиента приложения, создавшего клиент-аффинную подписку. | струна |
| isDurable | Для клиентских подписок это значение указывает, является ли подписка устойчивой или нет. | булевая переменная (bool) |
| isShared | Для клиентских подписок, аффинных подписок это значение указывает, является ли подписка общей или нет. | булевая переменная (bool) |
SBSubscriptionProperties
| Имя | Описание | Ценность |
|---|---|---|
| autoDeleteOnIdle | Интервал простоя области времени ISO 8061, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут. | струна |
| clientAffineProperties | Свойства, относящиеся к подпискам клиента. | SBClientAffineProperties |
| deadLetteringOnFilterEvaluationExceptions | Значение, указывающее, имеет ли подписка поддержку недоставленных писем при исключениях оценки фильтра. | булевая переменная (bool) |
| deadLetteringOnMessageExpiration | Значение, указывающее, поддерживает ли подписка недоставленную букву при истечении срока действия сообщения. | булевая переменная (bool) |
| defaultMessageTimeToLive | Время ожидания сообщения ISO 8061 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении. | струна |
| duplicateDetectionHistoryTimeWindow | Структура интервала времени ISO 8601, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию — 10 минут. | струна |
| enableBatchedOperations | Значение, указывающее, включены ли пакетные операции на стороне сервера. | булевая переменная (bool) |
| forwardDeadLetteredMessagesTo | Имя очереди и раздела для пересылки сообщения "Недоставленная буква" | струна |
| forwardTo | Имя очереди и раздела для пересылки сообщений | струна |
| isClientAffine | Значение, указывающее, имеет ли подписка сходство с идентификатором клиента. | булевая переменная (bool) |
| lockDuration | Временное интервал времени блокировки ISO 8061 для подписки. Значение по умолчанию — 1 минуту. | струна |
| maxDeliveryCount | Максимальное количество поставок. | инт |
| требуетсяSession | Значение, указывающее, поддерживает ли подписка концепцию сеансов. | булевая переменная (bool) |
| статус | Перечисляет возможные значения состояния сущности обмена сообщениями. | "Активный" Создание Удаление "Отключено" "ReceiveDisabled" Переименование Восстановление SendDisabled "Неизвестно" |
Примеры использования
Шаблоны быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.
| Шаблон | Описание |
|---|---|
|
корреляция сообщений по Logic Apps с помощью служебной шины развертывание |
в котором показано, как можно сопоставить сообщения по Logic Apps с помощью служебной шины Azure |
|
создает приложение микрослужб Dapr с помощью приложений контейнеров развертывание |
Создайте приложение микрослужб Dapr с помощью контейнерных приложений. |
|
Создает приложение dapr pub-sub servicebus с помощью приложений контейнеров развертывание |
Создайте приложение dapr pub-sub servicebus с помощью контейнерных приложений. |
| Шаблоны интеграции — маршрутизатор сообщений — служебной шины развертывание |
Решение, в котором показано, как настроить шаблон маршрутизатора сообщений с помощью раздела служебной шины |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса пространства имен, разделов и подписок можно развернуть с помощью операций, предназначенных для следующих целей:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.ServiceBus/namespaces/topics/subscriptions, добавьте следующий объект Terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceBus/namespaces/topics/subscriptions@2022-10-01-preview"
name = "string"
parent_id = "string"
body = {
properties = {
autoDeleteOnIdle = "string"
clientAffineProperties = {
clientId = "string"
isDurable = bool
isShared = bool
}
deadLetteringOnFilterEvaluationExceptions = bool
deadLetteringOnMessageExpiration = bool
defaultMessageTimeToLive = "string"
duplicateDetectionHistoryTimeWindow = "string"
enableBatchedOperations = bool
forwardDeadLetteredMessagesTo = "string"
forwardTo = "string"
isClientAffine = bool
lockDuration = "string"
maxDeliveryCount = int
requiresSession = bool
status = "string"
}
}
}
Значения свойств
Microsoft.ServiceBus/namespaces/topics/subscriptions
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя ресурса | струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 50 (обязательно) |
| parent_id | Идентификатор ресурса, который является родительским для этого ресурса. | Идентификатор ресурса типа: пространства имен и разделы |
| свойства | Свойства ресурса подписок. | SBSubscriptionProperties |
| тип | Тип ресурса | "Microsoft.ServiceBus/namespaces/topics/subscriptions@2022-10-01-preview" |
SBClientAffineProperties
| Имя | Описание | Ценность |
|---|---|---|
| clientId | Указывает идентификатор клиента приложения, создавшего клиент-аффинную подписку. | струна |
| isDurable | Для клиентских подписок это значение указывает, является ли подписка устойчивой или нет. | булевая переменная (bool) |
| isShared | Для клиентских подписок, аффинных подписок это значение указывает, является ли подписка общей или нет. | булевая переменная (bool) |
SBSubscriptionProperties
| Имя | Описание | Ценность |
|---|---|---|
| autoDeleteOnIdle | Интервал простоя области времени ISO 8061, после которого раздел автоматически удаляется. Минимальная длительность составляет 5 минут. | струна |
| clientAffineProperties | Свойства, относящиеся к подпискам клиента. | SBClientAffineProperties |
| deadLetteringOnFilterEvaluationExceptions | Значение, указывающее, имеет ли подписка поддержку недоставленных писем при исключениях оценки фильтра. | булевая переменная (bool) |
| deadLetteringOnMessageExpiration | Значение, указывающее, поддерживает ли подписка недоставленную букву при истечении срока действия сообщения. | булевая переменная (bool) |
| defaultMessageTimeToLive | Время ожидания сообщения ISO 8061 по умолчанию для динамического значения. Это длительность, после которой истекает срок действия сообщения, начиная с момента отправки сообщения в служебную шину. Это значение по умолчанию, используемое, если TimeToLive не задан в самом сообщении. | струна |
| duplicateDetectionHistoryTimeWindow | Структура интервала времени ISO 8601, определяющая длительность журнала обнаружения дубликата. Значение по умолчанию — 10 минут. | струна |
| enableBatchedOperations | Значение, указывающее, включены ли пакетные операции на стороне сервера. | булевая переменная (bool) |
| forwardDeadLetteredMessagesTo | Имя очереди и раздела для пересылки сообщения "Недоставленная буква" | струна |
| forwardTo | Имя очереди и раздела для пересылки сообщений | струна |
| isClientAffine | Значение, указывающее, имеет ли подписка сходство с идентификатором клиента. | булевая переменная (bool) |
| lockDuration | Временное интервал времени блокировки ISO 8061 для подписки. Значение по умолчанию — 1 минуту. | струна |
| maxDeliveryCount | Максимальное количество поставок. | инт |
| требуетсяSession | Значение, указывающее, поддерживает ли подписка концепцию сеансов. | булевая переменная (bool) |
| статус | Перечисляет возможные значения состояния сущности обмена сообщениями. | "Активный" Создание Удаление "Отключено" "ReceiveDisabled" Переименование Восстановление SendDisabled "Неизвестно" |
Примеры использования
Примеры Terraform
Простой пример развертывания подписки ServiceBus.
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 = false
maxSizeInMegabytes = 5120
requiresDuplicateDetection = false
status = "Active"
supportOrdering = false
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "subscription" {
type = "Microsoft.ServiceBus/namespaces/topics/subscriptions@2021-06-01-preview"
parent_id = azapi_resource.topic.id
name = var.resource_name
body = {
properties = {
clientAffineProperties = {
}
deadLetteringOnFilterEvaluationExceptions = true
deadLetteringOnMessageExpiration = false
enableBatchedOperations = false
isClientAffine = false
maxDeliveryCount = 10
requiresSession = false
status = "Active"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}