Udostępnij przez


Przestrzenie nazw Microsoft.ServiceBus

Definicja zasobu Bicep

Typ zasobu przestrzeni nazw 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, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.ServiceBus/namespaces@2025-05-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    alternateName: 'string'
    disableLocalAuth: bool
    encryption: {
      keySource: 'Microsoft.KeyVault'
      keyVaultProperties: [
        {
          identity: {
            userAssignedIdentity: 'string'
          }
          keyName: 'string'
          keyVaultUri: 'string'
          keyVersion: 'string'
        }
      ]
      requireInfrastructureEncryption: bool
    }
    geoDataReplication: {
      locations: [
        {
          clusterArmId: 'string'
          locationName: 'string'
          roleType: 'string'
        }
      ]
      maxReplicationLagDurationInSeconds: int
    }
    minimumTlsVersion: 'string'
    platformCapabilities: {
      confidentialCompute: {
        mode: 'string'
      }
    }
    premiumMessagingPartitions: int
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {
            id: 'string'
          }
          privateLinkServiceConnectionState: {
            description: 'string'
            status: 'string'
          }
          provisioningState: 'string'
        }
      }
    ]
    publicNetworkAccess: 'string'
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Wartości właściwości

Microsoft.ServiceBus/przestrzenie nazw

Nazwa Opis Wartość
tożsamość Właściwości opisu tożsamości BYOK Tożsamość
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu string

Ograniczenia:
Minimalna długość = 6
Maksymalna długość = 50 (wymagane)
Właściwości Właściwości przestrzeni nazw. SBNamespaceProperties (Właściwości przestrzeni powietrznej)
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Numer jednostki magazynowej Właściwości jednostki SKU SBSku
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

Poufne obliczenia

Nazwa Opis Wartość
tryb Ustawienie włączania lub wyłączania poufnych zasobów obliczeniowych "Wyłączone"
"Włączone"

Stan połączenia

Nazwa Opis Wartość
opis Opis stanu połączenia. ciąg
stan Stan połączenia. "Zatwierdzone"
"Rozłączono"
"Oczekujące"
"Odrzucono"

Szyfrowanie

Nazwa Opis Wartość
keySource (źródło klucza) Wylicza możliwą wartość keySource dla szyfrowania "Microsoft.KeyVault"
keyVaultProperties (właściwości klucza) Właściwości usługi KeyVault Właściwości KeyVault[]
requireInfrastructureEncryption Włączanie szyfrowania infrastruktury (podwójne szyfrowanie) Bool

Właściwości GeoDataReplicationProperties

Nazwa Opis Wartość
lokalizacje Lista regionów, w których są przechowywane repliki przestrzeni nazw. Przestrzeni nazwReplicaLocation[]
maxReplicationLagDurationInSeconds Maksymalne dopuszczalne opóźnienie dla operacji replikacji danych z repliki podstawowej do kworum replik pomocniczych. Gdy opóźnienie przekroczy skonfigurowaną ilość, operacje na repliki podstawowej nie będą działać. Dozwolone wartości to od 0 do 5 minut do 1 dnia. Int

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Właściwości tożsamości przypisanych przez użytkownika IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nazwa Opis Wartość

Właściwości KeyVaultProperties

Nazwa Opis Wartość
tożsamość UserAssignedIdentityProperties (Właściwości tożsamości)
keyName (nazwa_klucza) Nazwa klucza z usługi KeyVault ciąg
identyfikator keyVaultUri Identyfikator URI usługi KeyVault ciąg
keyVersion (wersja klucza) Wersja usługi KeyVault ciąg

Przestrzeń nazwReplicaLocation

Nazwa Opis Wartość
clusterArmId (identyfikator clusterArmId) Opcjonalna właściwość, która określa identyfikator usługi ARM klastra. Jest to wymagane, jeśli replika przestrzeni nazw powinna zostać umieszczona w dedykowanym klastrze centrum zdarzeń ciąg
locationName (nazwa_lokalizacji) Regiony platformy Azure, w których jest utrzymywana replika przestrzeni nazw ciąg
roleType (typ roli) Typy ról GeoDR "Podstawowy"
"Pomocnicza"

Możliwości platformy

Nazwa Opis Wartość
poufneCompute Poufne obliczenia

Prywatny punkt końcowy

Nazwa Opis Wartość
id Identyfikator usługi ARM dla prywatnego punktu końcowego. ciąg

PrivateEndpointConnection (Połączenie PrivateEndpointConnection)

Nazwa Opis Wartość
Właściwości Właściwości elementu PrivateEndpointConnection. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nazwa Opis Wartość
privateEndpoint (punkt końcowy prywatny) Zasób prywatnego punktu końcowego dla tego połączenia. PrivateEndpoint
privateLinkServiceConnectionState Szczegółowe informacje o stanie połączenia. Stan połączenia
stan provisioningu Stan aprowizacji połączenia prywatnego punktu końcowego. "Anulowano"
"Tworzenie"
"Usuwanie"
"Niepowodzenie"
"Powodzenie"
"Aktualizowanie"

SBNamespaceProperties (Właściwości przestrzeni powietrznej)

Nazwa Opis Wartość
alternateName (alternatywnaNazwa) Alternatywna nazwa przestrzeni nazw ciąg
disableLocalAuth (wyłącz uwierzytelnianie lokalne) Ta właściwość wyłącza uwierzytelnianie sygnatury dostępu współdzielonego dla przestrzeni nazw usługi Service Bus. Bool
szyfrowanie Właściwości opisu szyfrowania BYOK Szyfrowanie
geoDataReplication (replikacja danych geo) Ustawienia replikacji danych geograficznych dla przestrzeni nazw Właściwości GeoDataReplicationProperties
minimumTlsVersion Minimalna wersja protokołu TLS dla klastra do obsługi, np. "1.2" '1.0'
'1.1'
'1.2'
platformaMożliwości Możliwości platformy
premiumMessagingPartitions (partycje premiumMessagingPartitions) Liczba partycji przestrzeni nazw usługi Service Bus. Ta właściwość ma zastosowanie tylko do przestrzeni nazw jednostek SKU w warstwie Premium. Wartość domyślna to 1, a możliwe wartości to 1, 2 i 4 Int
privateEndpointConnections (połączenia prywatnegopunktu końcowego) Lista połączeń prywatnych punktów końcowych. PrivateEndpointConnection[]
dostęp do sieci publicznej Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest on włączony. "Wyłączone"
"Włączone"
"SecuredByPerimeter"
zoneNadmiarowy Włączenie tej właściwości powoduje utworzenie przestrzeni nazw usługi Service Bus w warstwie Premium w regionach obsługiwanych przez strefy dostępności. Bool

SBSku

Nazwa Opis Wartość
dyspozycyjność Jednostki obsługi komunikatów dla przestrzeni nazw usługi Service Bus w warstwie Premium. Prawidłowe pojemności to {1, 2, 4, 8, 16} wielokrotności właściwości.premiumMessagingPartitions. Jeśli na przykład właściwości.premiumMessagingPartitions to 1, możliwe wartości pojemności to 1, 2, 4, 8 i 16. Jeśli właściwości.premiumMessagingPartitions ma wartość 4, możliwe wartości pojemności to 4, 8, 16, 32 i 64 Int
nazwa Nazwa tej jednostki SKU. "Podstawowa"
"Premium"
"Standardowa" (wymagana)
warstwa Warstwa rozliczeń tej konkretnej jednostki SKU. "Podstawowa"
"Premium"
"Standardowa"

Śledzone tagi zasobów

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

UserAssignedIdentityProperties (Właściwości tożsamości)

Nazwa Opis Wartość
tożsamość przypisana przez użytkownika Identyfikator arm tożsamości użytkownika wybranej do szyfrowania ciąg

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
przestrzeni nazw usługi Service Bus Moduł zasobów AVM dla przestrzeni nazw usługi Service Bus

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Tworzenie przestrzeni nazw i kolejki usługi Service Bus Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus w warstwie Standardowa i kolejki.
tworzenie reguły sieci wirtualnej przestrzeni nazw usługi Service Bus Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus Premium z regułą sieci wirtualnej
tworzenie niestandardowego tematu i subskrypcji kolejki usługi Azure Event Grid Tworzy niestandardowy temat usługi Azure Event Grid i subskrypcję kolejki usługi Service Bus. Szablon pierwotnie autorstwa Markusa Meyera.
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

Typ zasobu przestrzeni nazw 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, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.ServiceBus/namespaces",
  "apiVersion": "2025-05-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "alternateName": "string",
    "disableLocalAuth": "bool",
    "encryption": {
      "keySource": "Microsoft.KeyVault",
      "keyVaultProperties": [
        {
          "identity": {
            "userAssignedIdentity": "string"
          },
          "keyName": "string",
          "keyVaultUri": "string",
          "keyVersion": "string"
        }
      ],
      "requireInfrastructureEncryption": "bool"
    },
    "geoDataReplication": {
      "locations": [
        {
          "clusterArmId": "string",
          "locationName": "string",
          "roleType": "string"
        }
      ],
      "maxReplicationLagDurationInSeconds": "int"
    },
    "minimumTlsVersion": "string",
    "platformCapabilities": {
      "confidentialCompute": {
        "mode": "string"
      }
    },
    "premiumMessagingPartitions": "int",
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
            "id": "string"
          },
          "privateLinkServiceConnectionState": {
            "description": "string",
            "status": "string"
          },
          "provisioningState": "string"
        }
      }
    ],
    "publicNetworkAccess": "string",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Microsoft.ServiceBus/przestrzenie nazw

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2025-05-01-preview'
tożsamość Właściwości opisu tożsamości BYOK Tożsamość
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu string

Ograniczenia:
Minimalna długość = 6
Maksymalna długość = 50 (wymagane)
Właściwości Właściwości przestrzeni nazw. SBNamespaceProperties (Właściwości przestrzeni powietrznej)
Numer jednostki magazynowej Właściwości jednostki SKU SBSku
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.ServiceBus/namespaces"

Poufne obliczenia

Nazwa Opis Wartość
tryb Ustawienie włączania lub wyłączania poufnych zasobów obliczeniowych "Wyłączone"
"Włączone"

Stan połączenia

Nazwa Opis Wartość
opis Opis stanu połączenia. ciąg
stan Stan połączenia. "Zatwierdzone"
"Rozłączono"
"Oczekujące"
"Odrzucono"

Szyfrowanie

Nazwa Opis Wartość
keySource (źródło klucza) Wylicza możliwą wartość keySource dla szyfrowania "Microsoft.KeyVault"
keyVaultProperties (właściwości klucza) Właściwości usługi KeyVault Właściwości KeyVault[]
requireInfrastructureEncryption Włączanie szyfrowania infrastruktury (podwójne szyfrowanie) Bool

Właściwości GeoDataReplicationProperties

Nazwa Opis Wartość
lokalizacje Lista regionów, w których są przechowywane repliki przestrzeni nazw. Przestrzeni nazwReplicaLocation[]
maxReplicationLagDurationInSeconds Maksymalne dopuszczalne opóźnienie dla operacji replikacji danych z repliki podstawowej do kworum replik pomocniczych. Gdy opóźnienie przekroczy skonfigurowaną ilość, operacje na repliki podstawowej nie będą działać. Dozwolone wartości to od 0 do 5 minut do 1 dnia. Int

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Właściwości tożsamości przypisanych przez użytkownika IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nazwa Opis Wartość

Właściwości KeyVaultProperties

Nazwa Opis Wartość
tożsamość UserAssignedIdentityProperties (Właściwości tożsamości)
keyName (nazwa_klucza) Nazwa klucza z usługi KeyVault ciąg
identyfikator keyVaultUri Identyfikator URI usługi KeyVault ciąg
keyVersion (wersja klucza) Wersja usługi KeyVault ciąg

Przestrzeń nazwReplicaLocation

Nazwa Opis Wartość
clusterArmId (identyfikator clusterArmId) Opcjonalna właściwość, która określa identyfikator usługi ARM klastra. Jest to wymagane, jeśli replika przestrzeni nazw powinna zostać umieszczona w dedykowanym klastrze centrum zdarzeń ciąg
locationName (nazwa_lokalizacji) Regiony platformy Azure, w których jest utrzymywana replika przestrzeni nazw ciąg
roleType (typ roli) Typy ról GeoDR "Podstawowy"
"Pomocnicza"

Możliwości platformy

Nazwa Opis Wartość
poufneCompute Poufne obliczenia

Prywatny punkt końcowy

Nazwa Opis Wartość
id Identyfikator usługi ARM dla prywatnego punktu końcowego. ciąg

PrivateEndpointConnection (Połączenie PrivateEndpointConnection)

Nazwa Opis Wartość
Właściwości Właściwości elementu PrivateEndpointConnection. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nazwa Opis Wartość
privateEndpoint (punkt końcowy prywatny) Zasób prywatnego punktu końcowego dla tego połączenia. PrivateEndpoint
privateLinkServiceConnectionState Szczegółowe informacje o stanie połączenia. Stan połączenia
stan provisioningu Stan aprowizacji połączenia prywatnego punktu końcowego. "Anulowano"
"Tworzenie"
"Usuwanie"
"Niepowodzenie"
"Powodzenie"
"Aktualizowanie"

SBNamespaceProperties (Właściwości przestrzeni powietrznej)

Nazwa Opis Wartość
alternateName (alternatywnaNazwa) Alternatywna nazwa przestrzeni nazw ciąg
disableLocalAuth (wyłącz uwierzytelnianie lokalne) Ta właściwość wyłącza uwierzytelnianie sygnatury dostępu współdzielonego dla przestrzeni nazw usługi Service Bus. Bool
szyfrowanie Właściwości opisu szyfrowania BYOK Szyfrowanie
geoDataReplication (replikacja danych geo) Ustawienia replikacji danych geograficznych dla przestrzeni nazw Właściwości GeoDataReplicationProperties
minimumTlsVersion Minimalna wersja protokołu TLS dla klastra do obsługi, np. "1.2" '1.0'
'1.1'
'1.2'
platformaMożliwości Możliwości platformy
premiumMessagingPartitions (partycje premiumMessagingPartitions) Liczba partycji przestrzeni nazw usługi Service Bus. Ta właściwość ma zastosowanie tylko do przestrzeni nazw jednostek SKU w warstwie Premium. Wartość domyślna to 1, a możliwe wartości to 1, 2 i 4 Int
privateEndpointConnections (połączenia prywatnegopunktu końcowego) Lista połączeń prywatnych punktów końcowych. PrivateEndpointConnection[]
dostęp do sieci publicznej Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest on włączony. "Wyłączone"
"Włączone"
"SecuredByPerimeter"
zoneNadmiarowy Włączenie tej właściwości powoduje utworzenie przestrzeni nazw usługi Service Bus w warstwie Premium w regionach obsługiwanych przez strefy dostępności. Bool

SBSku

Nazwa Opis Wartość
dyspozycyjność Jednostki obsługi komunikatów dla przestrzeni nazw usługi Service Bus w warstwie Premium. Prawidłowe pojemności to {1, 2, 4, 8, 16} wielokrotności właściwości.premiumMessagingPartitions. Jeśli na przykład właściwości.premiumMessagingPartitions to 1, możliwe wartości pojemności to 1, 2, 4, 8 i 16. Jeśli właściwości.premiumMessagingPartitions ma wartość 4, możliwe wartości pojemności to 4, 8, 16, 32 i 64 Int
nazwa Nazwa tej jednostki SKU. "Podstawowa"
"Premium"
"Standardowa" (wymagana)
warstwa Warstwa rozliczeń tej konkretnej jednostki SKU. "Podstawowa"
"Premium"
"Standardowa"

Śledzone tagi zasobów

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

UserAssignedIdentityProperties (Właściwości tożsamości)

Nazwa Opis Wartość
tożsamość przypisana przez użytkownika Identyfikator arm tożsamości użytkownika wybranej do szyfrowania ciąg

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Nawiązywanie połączenia z przestrzenią nazw usługi Service Bus za pośrednictwem prywatnego punktu końcowego

Wdrażanie do Azure
W tym przykładzie pokazano, jak skonfigurować sieć wirtualną i prywatną strefę DNS w celu uzyskania dostępu do przestrzeni nazw usługi Service Bus za pośrednictwem prywatnego punktu końcowego.
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
tworzenie odzyskiwania geograficznego usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia skonfigurowanie aliasu odzyskiwania geograficznego po awarii usługi Service Bus w przestrzeniach nazw jednostki SKU w warstwie Premium.
Tworzenie przestrzeni nazw usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus przy użyciu jednostki SKU w warstwie Podstawowa/Standardowa.
Tworzenie przestrzeni nazw i kolejki usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus w warstwie Standardowa i kolejki.
Tworzenie przestrzeni nazw usługi Service Bus i reguły autoryzacji kolejki

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus w warstwie Standardowa oraz reguł autoryzacji zarówno dla przestrzeni nazw, jak i kolejki.
tworzenie przestrzeni nazw i tematu usługi Service Bus

Wdrażanie do Azure
Ten szablon tworzy przestrzeń nazw i temat usługi Service Bus.
tworzenie reguły filtru ip przestrzeni nazw usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus Premium z regułą filtru ADRESÓW IP
tworzenie reguły sieci wirtualnej przestrzeni nazw usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie przestrzeni nazw usługi Service Bus Premium z regułą sieci wirtualnej
Tworzenie przestrzeni nazw, tematu i subskrypcji usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie standardowej przestrzeni nazw usługi Service Bus, tematu i subskrypcji.
Tworzenie przestrzeni nazw, tematu, subskrypcji i reguły usługi Service Bus

Wdrażanie do Azure
Ten szablon umożliwia wdrożenie standardowej przestrzeni nazw usługi Service Bus, tematu, subskrypcji i reguły.
tworzenie przestrzeni nazw usługi Service Bus w warstwie Premium i reguły autoryzacji

Wdrażanie do Azure
Ten szablon tworzy przestrzeń nazw usługi Service Bus Premium i przestrzeń nazw AuthorizationRule
tworzenie tematu usługi Service Bus przy użyciu subskrypcji i filtru SQL

Wdrażanie do Azure
Ten szablon tworzy przestrzeń nazw usługi Service Bus i temat z subskrypcją przy użyciu wyrażenia filtru SQL w celu odbierania tylko komunikatów pasujących do zdefiniowanego wyrażenia filtru SQL.
tworzenie niestandardowego tematu i subskrypcji kolejki usługi Azure Event Grid

Wdrażanie do Azure
Tworzy niestandardowy temat usługi Azure Event Grid i subskrypcję kolejki usługi Service Bus. Szablon pierwotnie autorstwa Markusa Meyera.
tworzenie subskrypcji tematu niestandardowego usługi Azure Event Grid

Wdrażanie do Azure
Tworzy niestandardowy temat usługi Azure Event Grid i subskrypcję tematu usługi Service Bus. Szablon pierwotnie autorstwa Markusa Meyera.
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.
EPiserverCMS w usłudze Azure

Wdrażanie do Azure
Ten szablon umożliwia tworzenie zasobów wymaganych do wdrożenia EpiServerCMS na platformie Azure
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)

Typ zasobu przestrzeni nazw 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, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceBus/namespaces@2025-05-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      alternateName = "string"
      disableLocalAuth = bool
      encryption = {
        keySource = "Microsoft.KeyVault"
        keyVaultProperties = [
          {
            identity = {
              userAssignedIdentity = "string"
            }
            keyName = "string"
            keyVaultUri = "string"
            keyVersion = "string"
          }
        ]
        requireInfrastructureEncryption = bool
      }
      geoDataReplication = {
        locations = [
          {
            clusterArmId = "string"
            locationName = "string"
            roleType = "string"
          }
        ]
        maxReplicationLagDurationInSeconds = int
      }
      minimumTlsVersion = "string"
      platformCapabilities = {
        confidentialCompute = {
          mode = "string"
        }
      }
      premiumMessagingPartitions = int
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
              id = "string"
            }
            privateLinkServiceConnectionState = {
              description = "string"
              status = "string"
            }
            provisioningState = "string"
          }
        }
      ]
      publicNetworkAccess = "string"
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  }
}

Wartości właściwości

Microsoft.ServiceBus/przestrzenie nazw

Nazwa Opis Wartość
tożsamość Właściwości opisu tożsamości BYOK Tożsamość
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu string

Ograniczenia:
Minimalna długość = 6
Maksymalna długość = 50 (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Właściwości przestrzeni nazw. SBNamespaceProperties (Właściwości przestrzeni powietrznej)
Numer jednostki magazynowej Właściwości jednostki SKU SBSku
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.ServiceBus/namespaces@2025-05-01-preview"

Poufne obliczenia

Nazwa Opis Wartość
tryb Ustawienie włączania lub wyłączania poufnych zasobów obliczeniowych "Wyłączone"
"Włączone"

Stan połączenia

Nazwa Opis Wartość
opis Opis stanu połączenia. ciąg
stan Stan połączenia. "Zatwierdzone"
"Rozłączono"
"Oczekujące"
"Odrzucono"

Szyfrowanie

Nazwa Opis Wartość
keySource (źródło klucza) Wylicza możliwą wartość keySource dla szyfrowania "Microsoft.KeyVault"
keyVaultProperties (właściwości klucza) Właściwości usługi KeyVault Właściwości KeyVault[]
requireInfrastructureEncryption Włączanie szyfrowania infrastruktury (podwójne szyfrowanie) Bool

Właściwości GeoDataReplicationProperties

Nazwa Opis Wartość
lokalizacje Lista regionów, w których są przechowywane repliki przestrzeni nazw. Przestrzeni nazwReplicaLocation[]
maxReplicationLagDurationInSeconds Maksymalne dopuszczalne opóźnienie dla operacji replikacji danych z repliki podstawowej do kworum replik pomocniczych. Gdy opóźnienie przekroczy skonfigurowaną ilość, operacje na repliki podstawowej nie będą działać. Dozwolone wartości to od 0 do 5 minut do 1 dnia. Int

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Właściwości tożsamości przypisanych przez użytkownika IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nazwa Opis Wartość

Właściwości KeyVaultProperties

Nazwa Opis Wartość
tożsamość UserAssignedIdentityProperties (Właściwości tożsamości)
keyName (nazwa_klucza) Nazwa klucza z usługi KeyVault ciąg
identyfikator keyVaultUri Identyfikator URI usługi KeyVault ciąg
keyVersion (wersja klucza) Wersja usługi KeyVault ciąg

Przestrzeń nazwReplicaLocation

Nazwa Opis Wartość
clusterArmId (identyfikator clusterArmId) Opcjonalna właściwość, która określa identyfikator usługi ARM klastra. Jest to wymagane, jeśli replika przestrzeni nazw powinna zostać umieszczona w dedykowanym klastrze centrum zdarzeń ciąg
locationName (nazwa_lokalizacji) Regiony platformy Azure, w których jest utrzymywana replika przestrzeni nazw ciąg
roleType (typ roli) Typy ról GeoDR "Podstawowy"
"Pomocnicza"

Możliwości platformy

Nazwa Opis Wartość
poufneCompute Poufne obliczenia

Prywatny punkt końcowy

Nazwa Opis Wartość
id Identyfikator usługi ARM dla prywatnego punktu końcowego. ciąg

PrivateEndpointConnection (Połączenie PrivateEndpointConnection)

Nazwa Opis Wartość
Właściwości Właściwości elementu PrivateEndpointConnection. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nazwa Opis Wartość
privateEndpoint (punkt końcowy prywatny) Zasób prywatnego punktu końcowego dla tego połączenia. PrivateEndpoint
privateLinkServiceConnectionState Szczegółowe informacje o stanie połączenia. Stan połączenia
stan provisioningu Stan aprowizacji połączenia prywatnego punktu końcowego. "Anulowano"
"Tworzenie"
"Usuwanie"
"Niepowodzenie"
"Powodzenie"
"Aktualizowanie"

SBNamespaceProperties (Właściwości przestrzeni powietrznej)

Nazwa Opis Wartość
alternateName (alternatywnaNazwa) Alternatywna nazwa przestrzeni nazw ciąg
disableLocalAuth (wyłącz uwierzytelnianie lokalne) Ta właściwość wyłącza uwierzytelnianie sygnatury dostępu współdzielonego dla przestrzeni nazw usługi Service Bus. Bool
szyfrowanie Właściwości opisu szyfrowania BYOK Szyfrowanie
geoDataReplication (replikacja danych geo) Ustawienia replikacji danych geograficznych dla przestrzeni nazw Właściwości GeoDataReplicationProperties
minimumTlsVersion Minimalna wersja protokołu TLS dla klastra do obsługi, np. "1.2" '1.0'
'1.1'
'1.2'
platformaMożliwości Możliwości platformy
premiumMessagingPartitions (partycje premiumMessagingPartitions) Liczba partycji przestrzeni nazw usługi Service Bus. Ta właściwość ma zastosowanie tylko do przestrzeni nazw jednostek SKU w warstwie Premium. Wartość domyślna to 1, a możliwe wartości to 1, 2 i 4 Int
privateEndpointConnections (połączenia prywatnegopunktu końcowego) Lista połączeń prywatnych punktów końcowych. PrivateEndpointConnection[]
dostęp do sieci publicznej Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest on włączony. "Wyłączone"
"Włączone"
"SecuredByPerimeter"
zoneNadmiarowy Włączenie tej właściwości powoduje utworzenie przestrzeni nazw usługi Service Bus w warstwie Premium w regionach obsługiwanych przez strefy dostępności. Bool

SBSku

Nazwa Opis Wartość
dyspozycyjność Jednostki obsługi komunikatów dla przestrzeni nazw usługi Service Bus w warstwie Premium. Prawidłowe pojemności to {1, 2, 4, 8, 16} wielokrotności właściwości.premiumMessagingPartitions. Jeśli na przykład właściwości.premiumMessagingPartitions to 1, możliwe wartości pojemności to 1, 2, 4, 8 i 16. Jeśli właściwości.premiumMessagingPartitions ma wartość 4, możliwe wartości pojemności to 4, 8, 16, 32 i 64 Int
nazwa Nazwa tej jednostki SKU. "Podstawowa"
"Premium"
"Standardowa" (wymagana)
warstwa Warstwa rozliczeń tej konkretnej jednostki SKU. "Podstawowa"
"Premium"
"Standardowa"

Śledzone tagi zasobów

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

UserAssignedIdentityProperties (Właściwości tożsamości)

Nazwa Opis Wartość
tożsamość przypisana przez użytkownika Identyfikator arm tożsamości użytkownika wybranej do szyfrowania ciąg

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania przestrzeni nazw usługi 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    = ["*"]
}

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
przestrzeni nazw usługi Service Bus Moduł zasobów AVM dla przestrzeni nazw usługi Service Bus