Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 |