Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Definição de recursos do bíceps
O tipo de recurso namespaces/topics pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.ServiceBus/namespaces/topics, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.ServiceBus/namespaces/topics@2026-01-01' = {
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
| Name | Descrição | Value |
|---|---|---|
| name | O nome do recurso | string Constraints: Comprimento mínimo = 1 (obrigatório) |
| elemento principal | 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 recurso do tipo: namespaces |
| propriedades | Propriedades do recurso de tópico. | SBTopicProperties |
SBTopicProperties
| Name | Descrição | Value |
|---|---|---|
| autoDeleteOnIdle | Intervalo de tempo ocioso ISO 8601 após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. | cadeia (de caracteres) |
| defaultMessageTimeToLive | ISO 8601 Tempo de tempo padrão da mensagem para o valor em tempo real. Esta é a duração após a qual a mensagem expira, começando a partir do momento em que a mensagem é enviada para o Service Bus. Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si. | cadeia (de caracteres) |
| duplicateDetectionHistoryTimeWindow | ISO8601 estrutura de intervalo de tempo que define a duração do histórico de deteção de duplicados. O valor predefinido é 10 minutos. | cadeia (de caracteres) |
| enableBatchedOperations | Valor que indica se as operações em lote do lado do servidor estão habilitadas. | bool |
| habilitarExpress | Valor que indica se as Entidades Expressas estão habilitadas. Um tópico expresso mantém uma mensagem na memória temporariamente antes de gravá-la no armazenamento persistente. | bool |
| enableParticionamento | 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) da carga útil da mensagem que pode ser aceite pelo tópico. Esta propriedade só é usada 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 deteção de duplicatas. | bool |
| estado | Enumera os valores possíveis para o status de uma entidade de mensagens. | 'Ativo' 'Creating' 'Eliminação' 'Disabled' 'ReceiveDisabled' 'Renaming' 'Restoring' 'SendDisabled' 'Desconhecido' |
| suporteEncomendar | Valor que indica se o tópico suporta ordenação. | bool |
| userMetadata | Obtém e define metadados do usuário. | cadeia (de caracteres) |
Exemplos de uso
Amostras do Bicep
Um exemplo básico de implantação do tópico ServiceBus.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource namespace 'Microsoft.ServiceBus/namespaces@2022-01-01-preview' = {
name: resourceName
location: location
sku: {
capacity: 0
name: 'Standard'
tier: 'Standard'
}
properties: {
disableLocalAuth: false
publicNetworkAccess: 'Enabled'
zoneRedundant: false
}
}
resource topic 'Microsoft.ServiceBus/namespaces/topics@2021-06-01-preview' = {
name: resourceName
parent: namespace
properties: {
enableBatchedOperations: false
enableExpress: false
enablePartitioning: true
maxSizeInMegabytes: 81920
requiresDuplicateDetection: false
status: 'Active'
supportOrdering: false
}
}
Exemplos de início rápido do Azure
Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.
| Arquivo Bicep | Descrição |
|---|---|
| Cria um aplicativo de microsserviços Dapr usando o Container Apps | Crie um aplicativo de microsserviços Dapr usando Aplicativos de Contêiner. |
| Cria um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner | Crie um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner. |
Definição de recurso de modelo ARM
O tipo de recurso namespaces/topics pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.ServiceBus/namespaces/topics, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.ServiceBus/namespaces/topics",
"apiVersion": "2026-01-01",
"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
| Name | Descrição | Value |
|---|---|---|
| apiVersion | A versão api | '2026-01-01' |
| name | O nome do recurso | string Constraints: Comprimento mínimo = 1 (obrigatório) |
| propriedades | Propriedades do recurso de tópico. | SBTopicProperties |
| tipo | O tipo de recurso | 'Microsoft.ServiceBus/namespaces/topics' |
SBTopicProperties
| Name | Descrição | Value |
|---|---|---|
| autoDeleteOnIdle | Intervalo de tempo ocioso ISO 8601 após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. | cadeia (de caracteres) |
| defaultMessageTimeToLive | ISO 8601 Tempo de tempo padrão da mensagem para o valor em tempo real. Esta é a duração após a qual a mensagem expira, começando a partir do momento em que a mensagem é enviada para o Service Bus. Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si. | cadeia (de caracteres) |
| duplicateDetectionHistoryTimeWindow | ISO8601 estrutura de intervalo de tempo que define a duração do histórico de deteção de duplicados. O valor predefinido é 10 minutos. | cadeia (de caracteres) |
| enableBatchedOperations | Valor que indica se as operações em lote do lado do servidor estão habilitadas. | bool |
| habilitarExpress | Valor que indica se as Entidades Expressas estão habilitadas. Um tópico expresso mantém uma mensagem na memória temporariamente antes de gravá-la no armazenamento persistente. | bool |
| enableParticionamento | 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) da carga útil da mensagem que pode ser aceite pelo tópico. Esta propriedade só é usada 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 deteção de duplicatas. | bool |
| estado | Enumera os valores possíveis para o status de uma entidade de mensagens. | 'Ativo' 'Creating' 'Eliminação' 'Disabled' 'ReceiveDisabled' 'Renaming' 'Restoring' 'SendDisabled' 'Desconhecido' |
| suporteEncomendar | Valor que indica se o tópico suporta ordenação. | bool |
| userMetadata | Obtém e define metadados do usuário. | cadeia (de caracteres) |
Exemplos de uso
Modelos de início rápido do Azure
Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.
| Template | Descrição |
|---|---|
Correlacionar mensagens em aplicativos lógicos usando o Service Bus
|
que mostra como podemos correlacionar mensagens em Aplicativos Lógicos usando o Barramento de Serviço do Azure |
|
Cria um aplicativo de microsserviços Dapr usando o Container Apps
|
Crie um aplicativo de microsserviços Dapr usando Aplicativos de Contêiner. |
|
Cria um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner
|
Crie um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner. |
| Padrões de integração - Message Router - Service Bus
|
Solução que mostra como podemos configurar o padrão do Message Router usando um tópico do Service Bus |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso namespaces/topics pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.ServiceBus/namespaces/topics, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceBus/namespaces/topics@2026-01-01"
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
| Name | Descrição | Value |
|---|---|---|
| name | O nome do recurso | string Constraints: Comprimento mínimo = 1 (obrigatório) |
| parent_id | A ID do recurso que é o pai para este recurso. | ID para recurso do tipo: namespaces |
| propriedades | Propriedades do recurso de tópico. | SBTopicProperties |
| tipo | O tipo de recurso | "Microsoft. ServiceBus/namespaces/topics@2026-01-01" |
SBTopicProperties
| Name | Descrição | Value |
|---|---|---|
| autoDeleteOnIdle | Intervalo de tempo ocioso ISO 8601 após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. | cadeia (de caracteres) |
| defaultMessageTimeToLive | ISO 8601 Tempo de tempo padrão da mensagem para o valor em tempo real. Esta é a duração após a qual a mensagem expira, começando a partir do momento em que a mensagem é enviada para o Service Bus. Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si. | cadeia (de caracteres) |
| duplicateDetectionHistoryTimeWindow | ISO8601 estrutura de intervalo de tempo que define a duração do histórico de deteção de duplicados. O valor predefinido é 10 minutos. | cadeia (de caracteres) |
| enableBatchedOperations | Valor que indica se as operações em lote do lado do servidor estão habilitadas. | bool |
| habilitarExpress | Valor que indica se as Entidades Expressas estão habilitadas. Um tópico expresso mantém uma mensagem na memória temporariamente antes de gravá-la no armazenamento persistente. | bool |
| enableParticionamento | 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) da carga útil da mensagem que pode ser aceite pelo tópico. Esta propriedade só é usada 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 deteção de duplicatas. | bool |
| estado | Enumera os valores possíveis para o status de uma entidade de mensagens. | 'Ativo' 'Creating' 'Eliminação' 'Disabled' 'ReceiveDisabled' 'Renaming' 'Restoring' 'SendDisabled' 'Desconhecido' |
| suporteEncomendar | Valor que indica se o tópico suporta ordenação. | bool |
| userMetadata | Obtém e define metadados do usuário. | cadeia (de caracteres) |
Exemplos de uso
Amostras Terraform
Um exemplo básico de implantação do tópico 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 = true
maxSizeInMegabytes = 81920
requiresDuplicateDetection = false
status = "Active"
supportOrdering = false
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}