Partilhar via


Namespaces/tópicos/assinaturas do Microsoft.ServiceBus

Definição de recursos do bíceps

O tipo de recurso namespaces/topics/subscriptions pode ser implantado com operações direcionadas:

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/subscriptions, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.ServiceBus/namespaces/topics/subscriptions@2024-01-01' = {
  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'
  }
}

Valores de propriedade

Microsoft.ServiceBus/namespaces/topics/assinaturas

Designação Descrição Valor
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 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 recurso do tipo: namespaces/topics
propriedades Propriedades do recurso de assinaturas. SBSubscriptionProperties

SBClientAffineProperties

Designação Descrição Valor
ID do cliente Indica a ID do cliente do aplicativo que criou a assinatura de cliente afim. string
isDurable Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é durável ou não. Bool
isShared Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é compartilhada ou não. Bool

SBSubscriptionProperties

Designação Descrição Valor
autoDeleteOnIdle ISO 8061 timeSpan intervalo ocioso após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. string
clientAffineProperties Propriedades específicas para subscrições afins de clientes. SBClientAffineProperties
deadLetteringOnFilterEvaluationExceptions Valor que indica se uma assinatura tem suporte a letra morta em exceções de avaliação de filtro. Bool
deadLetteringOnMessageExpiration Valor que indica se uma assinatura tem suporte a letra morta quando uma mensagem expira. Bool
defaultMessageTimeToLive ISO 8061 Tempo de tempo padrão da mensagem para o valor dinâmico. Esta é a duração após a qual a mensagem expira, a partir de quando a mensagem é enviada para o Service Bus. Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si. string
duplicateDetectionHistoryTimeWindow Estrutura timeSpan ISO 8601 que define a duração do histórico de deteção de duplicados. O valor padrão é 10 minutos. string
enableBatchedOperations Valor que indica se as operações em lote do lado do servidor estão habilitadas. Bool
encaminharDeadLetteredMessagesTo Nome da fila/tópico para encaminhar a mensagem de letra morta string
encaminharPara Nome da fila/tópico para encaminhar as mensagens string
isClientAffine Valor que indica se a assinatura tem afinidade com a ID do cliente. Bool
lockDuration Período de tempo de duração do bloqueio ISO 8061 para a assinatura. O valor padrão é 1 minuto. string
maxDeliveryCount Número máximo de entregas. Int
requiresSession Valor que indica se uma subscrição suporta o conceito de sessões. Bool
Situação Enumera os valores possíveis para o status de uma entidade de mensagens. 'Ativo'
'Criar'
'Eliminação'
'Desativado'
'ReceberDesativado'
'Renomear'
'Restauração'
'SendDisabled'
'Desconhecido'

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam 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/subscriptions pode ser implantado com operações direcionadas:

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/subscriptions, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.ServiceBus/namespaces/topics/subscriptions",
  "apiVersion": "2024-01-01",
  "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"
  }
}

Valores de propriedade

Microsoft.ServiceBus/namespaces/topics/assinaturas

Designação Descrição Valor
apiVersion A versão api '2024-01-01'
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)
propriedades Propriedades do recurso de assinaturas. SBSubscriptionProperties
tipo O tipo de recurso 'Microsoft.ServiceBus/namespaces/topics/subscriptions'

SBClientAffineProperties

Designação Descrição Valor
ID do cliente Indica a ID do cliente do aplicativo que criou a assinatura de cliente afim. string
isDurable Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é durável ou não. Bool
isShared Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é compartilhada ou não. Bool

SBSubscriptionProperties

Designação Descrição Valor
autoDeleteOnIdle ISO 8061 timeSpan intervalo ocioso após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. string
clientAffineProperties Propriedades específicas para subscrições afins de clientes. SBClientAffineProperties
deadLetteringOnFilterEvaluationExceptions Valor que indica se uma assinatura tem suporte a letra morta em exceções de avaliação de filtro. Bool
deadLetteringOnMessageExpiration Valor que indica se uma assinatura tem suporte a letra morta quando uma mensagem expira. Bool
defaultMessageTimeToLive ISO 8061 Tempo de tempo padrão da mensagem para o valor dinâmico. Esta é a duração após a qual a mensagem expira, a partir de quando a mensagem é enviada para o Service Bus. Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si. string
duplicateDetectionHistoryTimeWindow Estrutura timeSpan ISO 8601 que define a duração do histórico de deteção de duplicados. O valor padrão é 10 minutos. string
enableBatchedOperations Valor que indica se as operações em lote do lado do servidor estão habilitadas. Bool
encaminharDeadLetteredMessagesTo Nome da fila/tópico para encaminhar a mensagem de letra morta string
encaminharPara Nome da fila/tópico para encaminhar as mensagens string
isClientAffine Valor que indica se a assinatura tem afinidade com a ID do cliente. Bool
lockDuration Período de tempo de duração do bloqueio ISO 8061 para a assinatura. O valor padrão é 1 minuto. string
maxDeliveryCount Número máximo de entregas. Int
requiresSession Valor que indica se uma subscrição suporta o conceito de sessões. Bool
Situação Enumera os valores possíveis para o status de uma entidade de mensagens. 'Ativo'
'Criar'
'Eliminação'
'Desativado'
'ReceberDesativado'
'Renomear'
'Restauração'
'SendDisabled'
'Desconhecido'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Correlacionar mensagens através do Logic Apps com o Service Bus

Implantar no Azure
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

Implantar no Azure
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

Implantar no Azure
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

Implantar no Azure
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/subscriptions 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/subscriptions, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceBus/namespaces/topics/subscriptions@2024-01-01"
  name = "string"
  body = jsonencode({
    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"
    }
  })
}

Valores de propriedade

Microsoft.ServiceBus/namespaces/topics/assinaturas

Designação Descrição Valor
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1 (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID para recurso do tipo: namespaces/tópicos
propriedades Propriedades do recurso de assinaturas. SBSubscriptionProperties
tipo O tipo de recurso "Microsoft.ServiceBus/namespaces/topics/subscriptions@2024-01-01"

SBClientAffineProperties

Designação Descrição Valor
ID do cliente Indica a ID do cliente do aplicativo que criou a assinatura de cliente afim. string
isDurable Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é durável ou não. Bool
isShared Para assinaturas com afinidade de cliente, esse valor indica se a assinatura é compartilhada ou não. Bool

SBSubscriptionProperties

Designação Descrição Valor
autoDeleteOnIdle ISO 8061 timeSpan intervalo ocioso após o qual o tópico é excluído automaticamente. A duração mínima é de 5 minutos. string
clientAffineProperties Propriedades específicas para subscrições afins de clientes. SBClientAffineProperties
deadLetteringOnFilterEvaluationExceptions Valor que indica se uma assinatura tem suporte a letra morta em exceções de avaliação de filtro. Bool
deadLetteringOnMessageExpiration Valor que indica se uma assinatura tem suporte a letra morta quando uma mensagem expira. Bool
defaultMessageTimeToLive ISO 8061 Tempo de tempo padrão da mensagem para o valor dinâmico. Esta é a duração após a qual a mensagem expira, a partir de quando a mensagem é enviada para o Service Bus. Este é o valor padrão usado quando TimeToLive não está definido em uma mensagem em si. string
duplicateDetectionHistoryTimeWindow Estrutura timeSpan ISO 8601 que define a duração do histórico de deteção de duplicados. O valor padrão é 10 minutos. string
enableBatchedOperations Valor que indica se as operações em lote do lado do servidor estão habilitadas. Bool
encaminharDeadLetteredMessagesTo Nome da fila/tópico para encaminhar a mensagem de letra morta string
encaminharPara Nome da fila/tópico para encaminhar as mensagens string
isClientAffine Valor que indica se a assinatura tem afinidade com a ID do cliente. Bool
lockDuration Período de tempo de duração do bloqueio ISO 8061 para a assinatura. O valor padrão é 1 minuto. string
maxDeliveryCount Número máximo de entregas. Int
requiresSession Valor que indica se uma subscrição suporta o conceito de sessões. Bool
Situação Enumera os valores possíveis para o status de uma entidade de mensagens. 'Ativo'
'Criar'
'Eliminação'
'Desativado'
'ReceberDesativado'
'Renomear'
'Restauração'
'SendDisabled'
'Desconhecido'