Udostępnij za pośrednictwem

Microsoft.ServiceBus przestrzenie nazw/tematy/subskrypcje

  • Artykuł

Definicja zasobu Bicep

Przestrzeń nazw/tematy/subskrypcje typu zasobu można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ServiceBus/namespaces/topics/subscriptions, dodaj następujący kod Bicep do szablonu.

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'
  }
}

Wartości właściwości

Microsoft.ServiceBus/przestrzenie nazw/tematy/subskrypcje

Nazwa Opis Wartość
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 1 (wymagana)
rodzic W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Nazwa symboliczna zasobu typu: przestrzenie nazw/tematy
Właściwości Właściwości zasobu subskrypcji. SBSubscriptionProperties

SBClientAffineProperties

Nazwa Opis Wartość
clientId Wskazuje identyfikator klienta aplikacji, która utworzyła subskrypcję client-affine. struna
isDurable W przypadku subskrypcji klienta affine ta wartość wskazuje, czy subskrypcja jest trwała, czy nie. Bool
isShared W przypadku subskrypcji klienta affine ta wartość wskazuje, czy subskrypcja jest współdzielona, czy nie. Bool

SBSubscriptionProperties

Nazwa Opis Wartość
autoDeleteOnIdle Interwał bezczynności zakresu czasu ISO 8061, po którym temat jest automatycznie usuwany. Minimalny czas trwania wynosi 5 minut. struna
clientAffineProperties Właściwości specyficzne dla subskrypcji affine klienta. SBClientAffineProperties
deadLetteringOnFilterEvaluationExceptions Wartość wskazująca, czy subskrypcja ma obsługę utraconych komunikatów w przypadku wyjątków oceny filtru. Bool
deadLetteringOnMessageExpiration Wartość wskazująca, czy subskrypcja ma obsługę utraconych komunikatów po wygaśnięciu komunikatu. Bool
defaultMessageTimeToLive Domyślny przedział czasu komunikatu ISO 8061 na wartość dynamiczną. Jest to czas trwania, po upływie którego komunikat wygaśnie, począwszy od momentu wysłania komunikatu do usługi Service Bus. Jest to wartość domyślna używana, gdy właściwość TimeToLive nie jest ustawiona dla samego komunikatu. struna
duplicateDetectionHistoryTimeWindow Struktura timeSpan ISO 8601, która definiuje czas trwania historii wykrywania duplikatów. Wartość domyślna to 10 minut. struna
enableBatchedOperations Wartość wskazująca, czy operacje wsadowe po stronie serwera są włączone. Bool
forwardDeadLetteredMessagesTo Nazwa kolejki/tematu do przekazywania komunikatu utraconych wiadomości struna
forwardTo Nazwa kolejki/tematu do przekazywania komunikatów struna
isClientAffine Wartość wskazująca, czy subskrypcja ma koligację z identyfikatorem klienta. Bool
lockDuration Przedział czasu trwania blokady iso 8061 dla subskrypcji. Wartość domyślna to 1 minuta. struna
maxDeliveryCount Maksymalna liczba dostaw. Int
wymagaSesja Wartość wskazująca, czy subskrypcja obsługuje koncepcję sesji. Bool
stan Wylicza możliwe wartości stanu jednostki obsługi komunikatów. "Aktywne"
"Tworzenie"
"Usuwanie"
"Wyłączone"
"ReceiveDisabled"
"Zmiana nazwy"
"Przywracanie"
"SendDisabled"
"Nieznany"

Przykłady z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.

Plik Bicep Opis
Tworzy aplikację mikrousług dapr przy użyciu usługi Container Apps Tworzenie aplikacji mikrousług dapr przy użyciu usługi Container Apps.
Tworzy aplikację dapr pub-sub servicebus przy użyciu usługi Container Apps Utwórz aplikację Dapr pub-sub servicebus przy użyciu usługi Container Apps.

Definicja zasobu szablonu usługi ARM

Przestrzeń nazw/tematy/subskrypcje typu zasobu można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ServiceBus/namespaces/topics/subscriptions, dodaj następujący kod JSON do szablonu.

{
  "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"
  }
}

Wartości właściwości

Microsoft.ServiceBus/przestrzenie nazw/tematy/subskrypcje

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2024-01-01'
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 1 (wymagana)
Właściwości Właściwości zasobu subskrypcji. SBSubscriptionProperties
typ Typ zasobu "Microsoft.ServiceBus/namespaces/topics/subscriptions"

SBClientAffineProperties

Nazwa Opis Wartość
clientId Wskazuje identyfikator klienta aplikacji, która utworzyła subskrypcję client-affine. struna
isDurable W przypadku subskrypcji klienta affine ta wartość wskazuje, czy subskrypcja jest trwała, czy nie. Bool
isShared W przypadku subskrypcji klienta affine ta wartość wskazuje, czy subskrypcja jest współdzielona, czy nie. Bool

SBSubscriptionProperties

Nazwa Opis Wartość
autoDeleteOnIdle Interwał bezczynności zakresu czasu ISO 8061, po którym temat jest automatycznie usuwany. Minimalny czas trwania wynosi 5 minut. struna
clientAffineProperties Właściwości specyficzne dla subskrypcji affine klienta. SBClientAffineProperties
deadLetteringOnFilterEvaluationExceptions Wartość wskazująca, czy subskrypcja ma obsługę utraconych komunikatów w przypadku wyjątków oceny filtru. Bool
deadLetteringOnMessageExpiration Wartość wskazująca, czy subskrypcja ma obsługę utraconych komunikatów po wygaśnięciu komunikatu. Bool
defaultMessageTimeToLive Domyślny przedział czasu komunikatu ISO 8061 na wartość dynamiczną. Jest to czas trwania, po upływie którego komunikat wygaśnie, począwszy od momentu wysłania komunikatu do usługi Service Bus. Jest to wartość domyślna używana, gdy właściwość TimeToLive nie jest ustawiona dla samego komunikatu. struna
duplicateDetectionHistoryTimeWindow Struktura timeSpan ISO 8601, która definiuje czas trwania historii wykrywania duplikatów. Wartość domyślna to 10 minut. struna
enableBatchedOperations Wartość wskazująca, czy operacje wsadowe po stronie serwera są włączone. Bool
forwardDeadLetteredMessagesTo Nazwa kolejki/tematu do przekazywania komunikatu utraconych wiadomości struna
forwardTo Nazwa kolejki/tematu do przekazywania komunikatów struna
isClientAffine Wartość wskazująca, czy subskrypcja ma koligację z identyfikatorem klienta. Bool
lockDuration Przedział czasu trwania blokady iso 8061 dla subskrypcji. Wartość domyślna to 1 minuta. struna
maxDeliveryCount Maksymalna liczba dostaw. Int
wymagaSesja Wartość wskazująca, czy subskrypcja obsługuje koncepcję sesji. Bool
stan Wylicza możliwe wartości stanu jednostki obsługi komunikatów. "Aktywne"
"Tworzenie"
"Usuwanie"
"Wyłączone"
"ReceiveDisabled"
"Zmiana nazwy"
"Przywracanie"
"SendDisabled"
"Nieznany"

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Szablon Opis
korelowanie komunikatów za pośrednictwem usługi Logic Apps przy użyciu usługi Service Bus

Wdrażanie do Azure 		który pokazuje, jak możemy skorelować komunikaty za pośrednictwem usługi Logic Apps przy użyciu usługi Azure Service Bus
Tworzy aplikację mikrousług dapr przy użyciu usługi Container Apps

Wdrażanie do Azure 		Tworzenie aplikacji mikrousług dapr przy użyciu usługi Container Apps.
Tworzy aplikację dapr pub-sub servicebus przy użyciu usługi Container Apps

Wdrażanie do Azure 		Utwórz aplikację Dapr pub-sub servicebus przy użyciu usługi Container Apps.
Wzorce integracji — router komunikatów — usługi Service Bus

Wdrażanie do Azure 		Rozwiązanie pokazujące, jak można skonfigurować wzorzec routera komunikatów przy użyciu tematu usługi Service Bus

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Przestrzeń nazw/tematy/subskrypcje typu zasobu można wdrożyć przy użyciu operacji docelowych:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ServiceBus/namespaces/topics/subscriptions, dodaj następujący program Terraform do szablonu.

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"
    }
  })
}

Wartości właściwości

Microsoft.ServiceBus/przestrzenie nazw/tematy/subskrypcje

Nazwa Opis Wartość
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 1
Maksymalna długość = 1 (wymagana)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: przestrzenie nazw/tematy
Właściwości Właściwości zasobu subskrypcji. SBSubscriptionProperties
typ Typ zasobu "Microsoft.ServiceBus/namespaces/topics/subscriptions@2024-01-01"

SBClientAffineProperties

Nazwa Opis Wartość
clientId Wskazuje identyfikator klienta aplikacji, która utworzyła subskrypcję client-affine. struna
isDurable W przypadku subskrypcji klienta affine ta wartość wskazuje, czy subskrypcja jest trwała, czy nie. Bool
isShared W przypadku subskrypcji klienta affine ta wartość wskazuje, czy subskrypcja jest współdzielona, czy nie. Bool

SBSubscriptionProperties

Nazwa Opis Wartość
autoDeleteOnIdle Interwał bezczynności zakresu czasu ISO 8061, po którym temat jest automatycznie usuwany. Minimalny czas trwania wynosi 5 minut. struna
clientAffineProperties Właściwości specyficzne dla subskrypcji affine klienta. SBClientAffineProperties
deadLetteringOnFilterEvaluationExceptions Wartość wskazująca, czy subskrypcja ma obsługę utraconych komunikatów w przypadku wyjątków oceny filtru. Bool
deadLetteringOnMessageExpiration Wartość wskazująca, czy subskrypcja ma obsługę utraconych komunikatów po wygaśnięciu komunikatu. Bool
defaultMessageTimeToLive Domyślny przedział czasu komunikatu ISO 8061 na wartość dynamiczną. Jest to czas trwania, po upływie którego komunikat wygaśnie, począwszy od momentu wysłania komunikatu do usługi Service Bus. Jest to wartość domyślna używana, gdy właściwość TimeToLive nie jest ustawiona dla samego komunikatu. struna
duplicateDetectionHistoryTimeWindow Struktura timeSpan ISO 8601, która definiuje czas trwania historii wykrywania duplikatów. Wartość domyślna to 10 minut. struna
enableBatchedOperations Wartość wskazująca, czy operacje wsadowe po stronie serwera są włączone. Bool
forwardDeadLetteredMessagesTo Nazwa kolejki/tematu do przekazywania komunikatu utraconych wiadomości struna
forwardTo Nazwa kolejki/tematu do przekazywania komunikatów struna
isClientAffine Wartość wskazująca, czy subskrypcja ma koligację z identyfikatorem klienta. Bool
lockDuration Przedział czasu trwania blokady iso 8061 dla subskrypcji. Wartość domyślna to 1 minuta. struna
maxDeliveryCount Maksymalna liczba dostaw. Int
wymagaSesja Wartość wskazująca, czy subskrypcja obsługuje koncepcję sesji. Bool
stan Wylicza możliwe wartości stanu jednostki obsługi komunikatów. "Aktywne"
"Tworzenie"
"Usuwanie"
"Wyłączone"
"ReceiveDisabled"
"Zmiana nazwy"
"Przywracanie"
"SendDisabled"
"Nieznany"