Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Definição de recurso do Bicep
O tipo de recurso namespaces/tópicos pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.ServiceBus/namespaces/topics, adicione o Bicep a seguir ao seu modelo.
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'
}
}
Valores de propriedade
Microsoft.ServiceBus/namespaces/topics
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do recurso | corda Restrições: Comprimento mínimo = 1 (obrigatório) |
| pai | No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai. Para obter mais informações, consulte recurso filho fora do recurso pai. |
Nome simbólico para o recurso do tipo: namespaces |
| Propriedades | Propriedades do recurso de tópico. | SBTopicProperties |
SBTopicProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoDeleteOnIdle | Intervalo ocioso iso 8601 timespan após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. | cadeia |
| defaultMessageTimeToLive | ISO 8601 Tempo de tempo de mensagem padrão para valor dinâmico. Essa é a duração após a qual a mensagem expira, começando de quando a mensagem é enviada ao Barramento de Serviço. Esse é o valor padrão usado quando TimeToLive não é definido em uma mensagem em si. | cadeia |
| duplicateDetectionHistoryTimeWindow | ISO8601 estrutura de tempo que define a duração do histórico de detecção duplicado. O valor padrão é 10 minutos. | cadeia |
| enableBatchedOperations | Valor que indica se as operações em lote do lado do servidor estão habilitadas. | Bool |
| enableExpress | Valor que indica se as Entidades Expressas estão habilitadas. Um tópico expresso mantém uma mensagem na memória temporariamente antes de escrevê-la no armazenamento persistente. | Bool |
| enablePartitioning | Valor que indica se o tópico a ser particionado em vários agentes de mensagens está habilitado. | Bool |
| maxMessageSizeInKilobytes | Tamanho máximo (em KB) do conteúdo da mensagem que pode ser aceito pelo tópico. Essa propriedade é usada apenas no Premium hoje e o padrão é 1024. | int |
| maxSizeInMegabytes | Tamanho máximo do tópico em megabytes, que é o tamanho da memória alocada para o tópico. O padrão é 1024. | int |
| requiresDuplicateDetection | Valor que indica se este tópico requer detecção duplicada. | Bool |
| status | Enumera os valores possíveis para o status de uma entidade de mensagens. | 'Ativo' 'Criando' 'Excluindo' 'Desabilitado' 'ReceiveDisabled' 'Renomeando' 'Restaurando' 'SendDisabled' 'Desconhecido' |
| supportOrdering | Valor que indica se o tópico dá suporte à ordenação. | Bool |
| metadados do usuário | Obtém e define metadados do usuário. | cadeia |
Exemplos de uso
Exemplos do Bicep
Um exemplo básico de implantação do Tópico do Barramento de Serviço.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource namespace 'Microsoft.ServiceBus/namespaces@2022-01-01-preview' = {
name: resourceName
location: location
properties: {
disableLocalAuth: false
publicNetworkAccess: 'Enabled'
zoneRedundant: false
}
sku: {
capacity: 0
name: 'Standard'
tier: 'Standard'
}
}
resource topic 'Microsoft.ServiceBus/namespaces/topics@2021-06-01-preview' = {
parent: namespace
name: resourceName
properties: {
enableBatchedOperations: false
enableExpress: false
enablePartitioning: true
maxSizeInMegabytes: 81920
requiresDuplicateDetection: false
status: 'Active'
supportOrdering: false
}
}
Exemplos de Início Rápido do Azure
Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.
| Arquivo Bicep | Descrição |
|---|---|
| cria um aplicativo de microsserviços da Dapr usando aplicativos de contêiner | Crie um aplicativo de microsserviços Dapr usando Aplicativos de Contêiner. |
| Cria um aplicativo dapr pub-sub servicebus usando aplicativos de contêiner | Crie um aplicativo dapr pub-sub servicebus usando Aplicativos de Contêiner. |
Definição de recurso de modelo do ARM
O tipo de recurso namespaces/tópicos pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.ServiceBus/namespaces/topics, adicione o JSON a seguir ao seu modelo.
{
"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"
}
}
Valores de propriedade
Microsoft.ServiceBus/namespaces/topics
SBTopicProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoDeleteOnIdle | Intervalo ocioso iso 8601 timespan após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. | cadeia |
| defaultMessageTimeToLive | ISO 8601 Tempo de tempo de mensagem padrão para valor dinâmico. Essa é a duração após a qual a mensagem expira, começando de quando a mensagem é enviada ao Barramento de Serviço. Esse é o valor padrão usado quando TimeToLive não é definido em uma mensagem em si. | cadeia |
| duplicateDetectionHistoryTimeWindow | ISO8601 estrutura de tempo que define a duração do histórico de detecção duplicado. O valor padrão é 10 minutos. | cadeia |
| enableBatchedOperations | Valor que indica se as operações em lote do lado do servidor estão habilitadas. | Bool |
| enableExpress | Valor que indica se as Entidades Expressas estão habilitadas. Um tópico expresso mantém uma mensagem na memória temporariamente antes de escrevê-la no armazenamento persistente. | Bool |
| enablePartitioning | Valor que indica se o tópico a ser particionado em vários agentes de mensagens está habilitado. | Bool |
| maxMessageSizeInKilobytes | Tamanho máximo (em KB) do conteúdo da mensagem que pode ser aceito pelo tópico. Essa propriedade é usada apenas no Premium hoje e o padrão é 1024. | int |
| maxSizeInMegabytes | Tamanho máximo do tópico em megabytes, que é o tamanho da memória alocada para o tópico. O padrão é 1024. | int |
| requiresDuplicateDetection | Valor que indica se este tópico requer detecção duplicada. | Bool |
| status | Enumera os valores possíveis para o status de uma entidade de mensagens. | 'Ativo' 'Criando' 'Excluindo' 'Desabilitado' 'ReceiveDisabled' 'Renomeando' 'Restaurando' 'SendDisabled' 'Desconhecido' |
| supportOrdering | Valor que indica se o tópico dá suporte à ordenação. | Bool |
| metadados do usuário | Obtém e define metadados do usuário. | cadeia |
Exemplos de uso
Modelos de Início Rápido do Azure
Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.
| Modelo | Descrição |
|---|---|
|
correlacionar mensagens em aplicativos lógicos usando do Barramento de Serviço |
que mostra como podemos correlacionar mensagens em aplicativos lógicos usando o Barramento de Serviço do Azure |
|
cria um aplicativo de microsserviços da Dapr usando aplicativos de contêiner |
Crie um aplicativo de microsserviços Dapr usando Aplicativos de Contêiner. |
|
Cria um aplicativo dapr pub-sub servicebus usando aplicativos de contêiner |
Crie um aplicativo dapr pub-sub servicebus usando Aplicativos de Contêiner. |
| Padrões de integração – Roteador de Mensagens – Barramento de Serviço |
Solução que mostra como podemos configurar o padrão roteador de mensagem usando um tópico do Barramento de Serviço |
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso namespaces/tópicos pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.ServiceBus/namespaces/topics, adicione o Terraform a seguir ao seu modelo.
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"
}
}
}
Valores de propriedade
Microsoft.ServiceBus/namespaces/topics
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do recurso | corda Restrições: Comprimento mínimo = 1 (obrigatório) |
| parent_id | A ID do recurso que é o pai desse recurso. | ID do recurso do tipo: namespaces |
| Propriedades | Propriedades do recurso de tópico. | SBTopicProperties |
| tipo | O tipo de recurso | "Microsoft.ServiceBus/namespaces/topics@2025-05-01-preview" |
SBTopicProperties
| Nome | Descrição | Valor |
|---|---|---|
| autoDeleteOnIdle | Intervalo ocioso iso 8601 timespan após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. | cadeia |
| defaultMessageTimeToLive | ISO 8601 Tempo de tempo de mensagem padrão para valor dinâmico. Essa é a duração após a qual a mensagem expira, começando de quando a mensagem é enviada ao Barramento de Serviço. Esse é o valor padrão usado quando TimeToLive não é definido em uma mensagem em si. | cadeia |
| duplicateDetectionHistoryTimeWindow | ISO8601 estrutura de tempo que define a duração do histórico de detecção duplicado. O valor padrão é 10 minutos. | cadeia |
| enableBatchedOperations | Valor que indica se as operações em lote do lado do servidor estão habilitadas. | Bool |
| enableExpress | Valor que indica se as Entidades Expressas estão habilitadas. Um tópico expresso mantém uma mensagem na memória temporariamente antes de escrevê-la no armazenamento persistente. | Bool |
| enablePartitioning | Valor que indica se o tópico a ser particionado em vários agentes de mensagens está habilitado. | Bool |
| maxMessageSizeInKilobytes | Tamanho máximo (em KB) do conteúdo da mensagem que pode ser aceito pelo tópico. Essa propriedade é usada apenas no Premium hoje e o padrão é 1024. | int |
| maxSizeInMegabytes | Tamanho máximo do tópico em megabytes, que é o tamanho da memória alocada para o tópico. O padrão é 1024. | int |
| requiresDuplicateDetection | Valor que indica se este tópico requer detecção duplicada. | Bool |
| status | Enumera os valores possíveis para o status de uma entidade de mensagens. | 'Ativo' 'Criando' 'Excluindo' 'Desabilitado' 'ReceiveDisabled' 'Renomeando' 'Restaurando' 'SendDisabled' 'Desconhecido' |
| supportOrdering | Valor que indica se o tópico dá suporte à ordenação. | Bool |
| metadados do usuário | Obtém e define metadados do usuário. | cadeia |
Exemplos de uso
Exemplos do Terraform
Um exemplo básico de implantação do Tópico do Barramento de Serviço.
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 = ["*"]
}