Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bicep-Ressourcendefinition
Der Namespaces-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.ServiceBus/Namespaces-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.
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'
}
}
Eigenschaftswerte
Microsoft.ServiceBus/Namespaces
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Eigenschaften der BYOK-Identitätsbeschreibung | Identität |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | string Zwänge: Min. Länge = 6 Maximale Länge = 50 (erforderlich) |
| Eigenschaften | Eigenschaften des Namespaces. | SBNamespaceEigenschaften |
| scope | Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. | Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden. |
| Sku | Eigenschaften der SKU | SBSku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
ConfidentialCompute (Englisch)
| Name | Beschreibung | Wert |
|---|---|---|
| Modus | Einstellung zum Aktivieren oder Deaktivieren von vertraulichem Computing | "Deaktiviert" "Aktiviert" |
Verbindungsstatus
| Name | Beschreibung | Wert |
|---|---|---|
| Beschreibung | Beschreibung des Verbindungszustands. | Schnur |
| Status | Status der Verbindung. | "Genehmigt" "Getrennt" "Ausstehend" "Abgelehnt" |
Verschlüsselung
| Name | Beschreibung | Wert |
|---|---|---|
| keySource | Listet den möglichen Wert von keySource für Verschlüsselung auf. | "Microsoft.KeyVault" |
| keyVault-Eigenschaften | Eigenschaften von KeyVault | KeyVault-Eigenschaften[] |
| requireInfrastructureEncryption | Aktivieren der Infrastrukturverschlüsselung (Doppelte Verschlüsselung) | Bool |
GeoDataReplicationProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Orte | Eine Liste der Regionen, in denen Replikate des Namespace verwaltet werden. | NamespaceReplicaLocation[] |
| maxReplicationLagDurationInSeconds | Die maximale zulässige Verzögerung für Datenreplikationsvorgänge vom primären Replikat auf ein Quorum sekundärer Replikate. Wenn die Verzögerung den konfigurierten Betrag überschreitet, werden Vorgänge für das primäre Replikat fehlgeschlagen. Die zulässigen Werte sind 0 und 5 Minuten bis 1 Tag. | Int |
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Typ der verwalteten Dienstidentität. | "Keine" 'SystemZugewiesen' "SystemAssigned, UserAssigned" "UserAssigned" |
| vom Benutzer zugewiesene Identitäten | Eigenschaften für vom Benutzer zugewiesene Identitäten | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
KeyVault-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | UserAssignedIdentity-Eigenschaften | |
| Schlüsselname | Name des Schlüssels von KeyVault | Schnur |
| keyVaultUri | URI von KeyVault | Schnur |
| Schlüsselversion | Version von KeyVault | Schnur |
NamespaceReplicaLocation
| Name | Beschreibung | Wert |
|---|---|---|
| clusterArmId | Optionale Eigenschaft, die die ARM-ID des Clusters angibt. Dies ist erforderlich, wenn ein Namespacereplikat in einem dedizierten Event Hub Cluster platziert werden soll. | Schnur |
| locationName | Azure-Regionen, in denen ein Replikat des Namespace verwaltet wird | Schnur |
| roleType | GeoDR-Rollentypen | 'Primary' 'Secondary' |
Plattform-Funktionen
| Name | Beschreibung | Wert |
|---|---|---|
| confidentialCompute | ConfidentialCompute (Englisch) |
PrivateEndpoint
| Name | Beschreibung | Wert |
|---|---|---|
| id | Der ARM-Bezeichner für private Endpunkte. | Schnur |
PrivateEndpointConnection
| Name | Beschreibung | Wert |
|---|---|---|
| Eigenschaften | Eigenschaften der PrivateEndpointConnection. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
| Name | Beschreibung | Wert |
|---|---|---|
| privateEndpoint | Die Private Endpoint-Ressource für diese Verbindung. | PrivateEndpoint- |
| privateLinkServiceConnectionState | Details zum Status der Verbindung. | ConnectionState- |
| provisioningState (Bereitstellen) | Bereitstellungsstatus der privaten Endpunktverbindung. | 'Abgebrochen' "Erstellen" "Löschen" 'Fehler' "Erfolgreich" "Aktualisieren" |
SBNamespaceEigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| alternativer Name | Alternativer Name für Namespace | Schnur |
| disableLocalAuth | Diese Eigenschaft deaktiviert die SAS-Authentifizierung für den Service Bus-Namespace. | Bool |
| Verschlüsselung | Eigenschaften der BYOK-Verschlüsselungsbeschreibung | Verschlüsselung |
| geoDataReplication | Geo Data Replication-Einstellungen für den Namespace | GeoDataReplicationProperties |
| minimumTlsVersion | Die mindeste TLS-Version für den Cluster, die unterstützt werden soll, z. B. "1.2" | '1.0' '1.1' '1.2' |
| platformCapabilities | Plattform-Funktionen | |
| premiumMessagingPartitions | Die Anzahl der Partitionen eines Service Bus-Namespaces. Diese Eigenschaft gilt nur für Premium-SKU-Namespaces. Der Standardwert ist 1 und mögliche Werte sind 1, 2 und 4. | Int |
| privateEndpointConnections. | Liste der privaten Endpunktverbindungen. | PrivateEndpointConnection[] |
| Öffentlicher Netzwerkzugang | Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert. | "Deaktiviert" "Aktiviert" "SecuredByPerimeter" |
| zoneRedundant | Durch aktivieren dieser Eigenschaft wird ein Premium Service Bus-Namespace in regionen unterstützter Verfügbarkeitszonen erstellt. | Bool |
SBSku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Messaging-Einheiten für Ihren Servicebus Premium-Namespace. Gültige Kapazitäten sind {1, 2, 4, 8, 16} Vielfache Ihrer Eigenschaften.premiumMessagingPartitions-Einstellung. Wenn "properties.premiumMessagingPartitions" beispielsweise 1 ist, sind mögliche Kapazitätswerte 1, 2, 4, 8 und 16. Wenn properties.premiumMessagingPartitions 4 ist, sind mögliche Kapazitätswerte 4, 8, 16, 32 und 64. | Int |
| Name | Name dieser SKU. | "Einfach" "Premium" "Standard" (erforderlich) |
| Rang | Die Abrechnungsebene dieser speziellen SKU. | "Einfach" "Premium" "Standard" |
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| userAssignedIdentity | ARM-ID der Benutzeridentität, die für die Verschlüsselung ausgewählt ist | Schnur |
Verwendungsbeispiele
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Modul | Beschreibung |
|---|---|
| Service Bus-Namespace- | AVM-Ressourcenmodul für Service Bus-Namespace |
Azure-Schnellstartbeispiele
Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.
| Bicep-Datei | Beschreibung |
|---|---|
| Erstellen eines Service Bus-Namespace und einer Service Bus-Warteschlange | Mit dieser Vorlage können Sie einen Service Bus Standard-Namespace und eine Warteschlange bereitstellen. |
| Erstellen einer Dienstbus-Namespace-Virtual Network-Regel | Mit dieser Vorlage können Sie einen Service Bus Premium-Namespace mit virtual Network-Regel bereitstellen. |
| Erstellen eines benutzerdefinierten Azure Event Grid-Themas und eines Warteschlangenabonnements | Erstellt ein benutzerdefiniertes Azure Event Grid-Thema und ein Servicebus-Warteschlangenabonnement. Vorlage, die ursprünglich von Markus Meyer verfasst wurde. |
| Erstellt eine Dapr Microservices-App mit Container-Apps | Erstellen Sie eine Dapr Microservices-App mit Container-Apps. |
| Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps | Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps. |
ARM-Vorlagenressourcendefinition
Der Namespaces-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.ServiceBus/Namespaces-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.
{
"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"
}
}
Eigenschaftswerte
Microsoft.ServiceBus/Namespaces
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion (Englisch) | Die API-Version | '2025-05-01-preview' |
| Identität | Eigenschaften der BYOK-Identitätsbeschreibung | Identität |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | string Zwänge: Min. Länge = 6 Maximale Länge = 50 (erforderlich) |
| Eigenschaften | Eigenschaften des Namespaces. | SBNamespaceEigenschaften |
| Sku | Eigenschaften der SKU | SBSku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Art | Der Ressourcentyp | "Microsoft.ServiceBus/Namespaces" |
ConfidentialCompute (Englisch)
| Name | Beschreibung | Wert |
|---|---|---|
| Modus | Einstellung zum Aktivieren oder Deaktivieren von vertraulichem Computing | "Deaktiviert" "Aktiviert" |
Verbindungsstatus
| Name | Beschreibung | Wert |
|---|---|---|
| Beschreibung | Beschreibung des Verbindungszustands. | Schnur |
| Status | Status der Verbindung. | "Genehmigt" "Getrennt" "Ausstehend" "Abgelehnt" |
Verschlüsselung
| Name | Beschreibung | Wert |
|---|---|---|
| keySource | Listet den möglichen Wert von keySource für Verschlüsselung auf. | "Microsoft.KeyVault" |
| keyVault-Eigenschaften | Eigenschaften von KeyVault | KeyVault-Eigenschaften[] |
| requireInfrastructureEncryption | Aktivieren der Infrastrukturverschlüsselung (Doppelte Verschlüsselung) | Bool |
GeoDataReplicationProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Orte | Eine Liste der Regionen, in denen Replikate des Namespace verwaltet werden. | NamespaceReplicaLocation[] |
| maxReplicationLagDurationInSeconds | Die maximale zulässige Verzögerung für Datenreplikationsvorgänge vom primären Replikat auf ein Quorum sekundärer Replikate. Wenn die Verzögerung den konfigurierten Betrag überschreitet, werden Vorgänge für das primäre Replikat fehlgeschlagen. Die zulässigen Werte sind 0 und 5 Minuten bis 1 Tag. | Int |
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Typ der verwalteten Dienstidentität. | "Keine" 'SystemZugewiesen' "SystemAssigned, UserAssigned" "UserAssigned" |
| vom Benutzer zugewiesene Identitäten | Eigenschaften für vom Benutzer zugewiesene Identitäten | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
KeyVault-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | UserAssignedIdentity-Eigenschaften | |
| Schlüsselname | Name des Schlüssels von KeyVault | Schnur |
| keyVaultUri | URI von KeyVault | Schnur |
| Schlüsselversion | Version von KeyVault | Schnur |
NamespaceReplicaLocation
| Name | Beschreibung | Wert |
|---|---|---|
| clusterArmId | Optionale Eigenschaft, die die ARM-ID des Clusters angibt. Dies ist erforderlich, wenn ein Namespacereplikat in einem dedizierten Event Hub Cluster platziert werden soll. | Schnur |
| locationName | Azure-Regionen, in denen ein Replikat des Namespace verwaltet wird | Schnur |
| roleType | GeoDR-Rollentypen | 'Primary' 'Secondary' |
Plattform-Funktionen
| Name | Beschreibung | Wert |
|---|---|---|
| confidentialCompute | ConfidentialCompute (Englisch) |
PrivateEndpoint
| Name | Beschreibung | Wert |
|---|---|---|
| id | Der ARM-Bezeichner für private Endpunkte. | Schnur |
PrivateEndpointConnection
| Name | Beschreibung | Wert |
|---|---|---|
| Eigenschaften | Eigenschaften der PrivateEndpointConnection. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
| Name | Beschreibung | Wert |
|---|---|---|
| privateEndpoint | Die Private Endpoint-Ressource für diese Verbindung. | PrivateEndpoint- |
| privateLinkServiceConnectionState | Details zum Status der Verbindung. | ConnectionState- |
| provisioningState (Bereitstellen) | Bereitstellungsstatus der privaten Endpunktverbindung. | 'Abgebrochen' "Erstellen" "Löschen" 'Fehler' "Erfolgreich" "Aktualisieren" |
SBNamespaceEigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| alternativer Name | Alternativer Name für Namespace | Schnur |
| disableLocalAuth | Diese Eigenschaft deaktiviert die SAS-Authentifizierung für den Service Bus-Namespace. | Bool |
| Verschlüsselung | Eigenschaften der BYOK-Verschlüsselungsbeschreibung | Verschlüsselung |
| geoDataReplication | Geo Data Replication-Einstellungen für den Namespace | GeoDataReplicationProperties |
| minimumTlsVersion | Die mindeste TLS-Version für den Cluster, die unterstützt werden soll, z. B. "1.2" | '1.0' '1.1' '1.2' |
| platformCapabilities | Plattform-Funktionen | |
| premiumMessagingPartitions | Die Anzahl der Partitionen eines Service Bus-Namespaces. Diese Eigenschaft gilt nur für Premium-SKU-Namespaces. Der Standardwert ist 1 und mögliche Werte sind 1, 2 und 4. | Int |
| privateEndpointConnections. | Liste der privaten Endpunktverbindungen. | PrivateEndpointConnection[] |
| Öffentlicher Netzwerkzugang | Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert. | "Deaktiviert" "Aktiviert" "SecuredByPerimeter" |
| zoneRedundant | Durch aktivieren dieser Eigenschaft wird ein Premium Service Bus-Namespace in regionen unterstützter Verfügbarkeitszonen erstellt. | Bool |
SBSku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Messaging-Einheiten für Ihren Servicebus Premium-Namespace. Gültige Kapazitäten sind {1, 2, 4, 8, 16} Vielfache Ihrer Eigenschaften.premiumMessagingPartitions-Einstellung. Wenn "properties.premiumMessagingPartitions" beispielsweise 1 ist, sind mögliche Kapazitätswerte 1, 2, 4, 8 und 16. Wenn properties.premiumMessagingPartitions 4 ist, sind mögliche Kapazitätswerte 4, 8, 16, 32 und 64. | Int |
| Name | Name dieser SKU. | "Einfach" "Premium" "Standard" (erforderlich) |
| Rang | Die Abrechnungsebene dieser speziellen SKU. | "Einfach" "Premium" "Standard" |
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| userAssignedIdentity | ARM-ID der Benutzeridentität, die für die Verschlüsselung ausgewählt ist | Schnur |
Verwendungsbeispiele
Azure-Schnellstartvorlagen
Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.
| Schablone | Beschreibung |
|---|---|
|
Herstellen einer Verbindung mit einem Service Bus-Namespace über einen privaten Endpunkt |
In diesem Beispiel wird gezeigt, wie Sie ein virtuelles Netzwerk und eine private DNS-Zone verwenden, um über einen privaten Endpunkt auf einen Service Bus-Namespace zuzugreifen. |
|
Correlating messages over Logic Apps using Service Bus (Korrelieren von Nachrichten über Logic Apps mithilfe von Service Bus) |
die zeigt, wie Nachrichten über Logik-Apps mit Azure Service Bus korreliert werden können |
|
Erstellen eines Geo-Recovery- |
Mit dieser Vorlage können Sie service Bus Geo-Notfallwiederherstellungsalias für Premium-SKU-Namespaces konfigurieren. |
|
Erstellen eines Service Bus-Namespaces |
Mit dieser Vorlage können Sie einen Service Bus-Namespace mit einer Standard-SKU bereitstellen. |
|
Erstellen eines Service Bus-Namespace und einer Service Bus-Warteschlange |
Mit dieser Vorlage können Sie einen Service Bus Standard-Namespace und eine Warteschlange bereitstellen. |
|
Erstellen einer ServiceBus-Namespace- und Warteschlangenautorisierungsregel |
Mit dieser Vorlage können Sie einen Service Bus Standard-Namespace und Autorisierungsregeln sowohl für den Namespace als auch für eine Warteschlange bereitstellen. |
|
Erstellen eines ServiceBus-Namespaces und eines Themas |
Diese Vorlage erstellt einen Service Bus-Namespace und ein Thema. |
|
Erstellen einer ServiceBus-Namespace-IP-Filterregel |
Mit dieser Vorlage können Sie einen Service Bus Premium-Namespace mit IP-Filterregel bereitstellen. |
|
Erstellen einer Dienstbus-Namespace-Virtual Network-Regel |
Mit dieser Vorlage können Sie einen Service Bus Premium-Namespace mit virtual Network-Regel bereitstellen. |
|
Erstellen eines ServiceBus-Namespaces, eines Themas und eines Abonnements |
Mit dieser Vorlage können Sie einen Service Bus Standard-Namespace, ein Thema und ein Abonnement bereitstellen. |
|
Erstellen eines ServiceBus-Namespace, eines Themas, eines Abonnements und einer Regel |
Mit dieser Vorlage können Sie einen Service Bus Standard-Namespace, ein Thema, ein Abonnement und eine Regel bereitstellen. |
|
Erstellen eines Service Bus Premium-Namespaces und eines AuthorizationRule- |
Mit dieser Vorlage wird ein Service Bus Premium-Namespace und ein Namespace-AuthorizationRule erstellt. |
|
Erstellen eines Servicebusthemas mit Abonnement- und SQL-Filter- |
Diese Vorlage erstellt einen Service Bus-Namespace und ein Thema mit einem Abonnement mithilfe eines SQL-Filterausdrucks, um nur die Nachrichten zu empfangen, die mit dem definierten SQL-Filterausdruck übereinstimmen. |
|
Erstellen eines benutzerdefinierten Azure Event Grid-Themas und eines Warteschlangenabonnements |
Erstellt ein benutzerdefiniertes Azure Event Grid-Thema und ein Servicebus-Warteschlangenabonnement. Vorlage, die ursprünglich von Markus Meyer verfasst wurde. |
|
Erstellen eines benutzerdefinierten Azure Event Grid-Themenabonnements |
Erstellt ein benutzerdefiniertes Azure Event Grid-Thema und ein Servicebus-Themenabonnement. Vorlage, die ursprünglich von Markus Meyer verfasst wurde. |
|
Erstellt eine Dapr Microservices-App mit Container-Apps |
Erstellen Sie eine Dapr Microservices-App mit Container-Apps. |
|
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps |
Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps. |
|
EPiserverCMS in Azure |
Mit dieser Vorlage können Sie Ressourcen erstellen, die für die EpiServerCMS-Bereitstellung in Azure erforderlich sind. |
|
Integrationsmuster - Nachrichtenrouter - ServiceBus- |
Lösung, die zeigt, wie wir das Nachrichtenroutermuster mithilfe eines Service Bus-Themas einrichten können |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Namespaces-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.ServiceBus/Namespaces-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
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"
}
}
}
Eigenschaftswerte
Microsoft.ServiceBus/Namespaces
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Eigenschaften der BYOK-Identitätsbeschreibung | Identität |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | string Zwänge: Min. Länge = 6 Maximale Länge = 50 (erforderlich) |
| parent_id | Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. | Zeichenfolge (erforderlich) |
| Eigenschaften | Eigenschaften des Namespaces. | SBNamespaceEigenschaften |
| Sku | Eigenschaften der SKU | SBSku- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
| Art | Der Ressourcentyp | "Microsoft.ServiceBus/namespaces@2025-05-01-preview" |
ConfidentialCompute (Englisch)
| Name | Beschreibung | Wert |
|---|---|---|
| Modus | Einstellung zum Aktivieren oder Deaktivieren von vertraulichem Computing | "Deaktiviert" "Aktiviert" |
Verbindungsstatus
| Name | Beschreibung | Wert |
|---|---|---|
| Beschreibung | Beschreibung des Verbindungszustands. | Schnur |
| Status | Status der Verbindung. | "Genehmigt" "Getrennt" "Ausstehend" "Abgelehnt" |
Verschlüsselung
| Name | Beschreibung | Wert |
|---|---|---|
| keySource | Listet den möglichen Wert von keySource für Verschlüsselung auf. | "Microsoft.KeyVault" |
| keyVault-Eigenschaften | Eigenschaften von KeyVault | KeyVault-Eigenschaften[] |
| requireInfrastructureEncryption | Aktivieren der Infrastrukturverschlüsselung (Doppelte Verschlüsselung) | Bool |
GeoDataReplicationProperties
| Name | Beschreibung | Wert |
|---|---|---|
| Orte | Eine Liste der Regionen, in denen Replikate des Namespace verwaltet werden. | NamespaceReplicaLocation[] |
| maxReplicationLagDurationInSeconds | Die maximale zulässige Verzögerung für Datenreplikationsvorgänge vom primären Replikat auf ein Quorum sekundärer Replikate. Wenn die Verzögerung den konfigurierten Betrag überschreitet, werden Vorgänge für das primäre Replikat fehlgeschlagen. Die zulässigen Werte sind 0 und 5 Minuten bis 1 Tag. | Int |
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Typ der verwalteten Dienstidentität. | "Keine" 'SystemZugewiesen' "SystemAssigned, UserAssigned" "UserAssigned" |
| vom Benutzer zugewiesene Identitäten | Eigenschaften für vom Benutzer zugewiesene Identitäten | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
KeyVault-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | UserAssignedIdentity-Eigenschaften | |
| Schlüsselname | Name des Schlüssels von KeyVault | Schnur |
| keyVaultUri | URI von KeyVault | Schnur |
| Schlüsselversion | Version von KeyVault | Schnur |
NamespaceReplicaLocation
| Name | Beschreibung | Wert |
|---|---|---|
| clusterArmId | Optionale Eigenschaft, die die ARM-ID des Clusters angibt. Dies ist erforderlich, wenn ein Namespacereplikat in einem dedizierten Event Hub Cluster platziert werden soll. | Schnur |
| locationName | Azure-Regionen, in denen ein Replikat des Namespace verwaltet wird | Schnur |
| roleType | GeoDR-Rollentypen | 'Primary' 'Secondary' |
Plattform-Funktionen
| Name | Beschreibung | Wert |
|---|---|---|
| confidentialCompute | ConfidentialCompute (Englisch) |
PrivateEndpoint
| Name | Beschreibung | Wert |
|---|---|---|
| id | Der ARM-Bezeichner für private Endpunkte. | Schnur |
PrivateEndpointConnection
| Name | Beschreibung | Wert |
|---|---|---|
| Eigenschaften | Eigenschaften der PrivateEndpointConnection. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
| Name | Beschreibung | Wert |
|---|---|---|
| privateEndpoint | Die Private Endpoint-Ressource für diese Verbindung. | PrivateEndpoint- |
| privateLinkServiceConnectionState | Details zum Status der Verbindung. | ConnectionState- |
| provisioningState (Bereitstellen) | Bereitstellungsstatus der privaten Endpunktverbindung. | 'Abgebrochen' "Erstellen" "Löschen" 'Fehler' "Erfolgreich" "Aktualisieren" |
SBNamespaceEigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| alternativer Name | Alternativer Name für Namespace | Schnur |
| disableLocalAuth | Diese Eigenschaft deaktiviert die SAS-Authentifizierung für den Service Bus-Namespace. | Bool |
| Verschlüsselung | Eigenschaften der BYOK-Verschlüsselungsbeschreibung | Verschlüsselung |
| geoDataReplication | Geo Data Replication-Einstellungen für den Namespace | GeoDataReplicationProperties |
| minimumTlsVersion | Die mindeste TLS-Version für den Cluster, die unterstützt werden soll, z. B. "1.2" | '1.0' '1.1' '1.2' |
| platformCapabilities | Plattform-Funktionen | |
| premiumMessagingPartitions | Die Anzahl der Partitionen eines Service Bus-Namespaces. Diese Eigenschaft gilt nur für Premium-SKU-Namespaces. Der Standardwert ist 1 und mögliche Werte sind 1, 2 und 4. | Int |
| privateEndpointConnections. | Liste der privaten Endpunktverbindungen. | PrivateEndpointConnection[] |
| Öffentlicher Netzwerkzugang | Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert. | "Deaktiviert" "Aktiviert" "SecuredByPerimeter" |
| zoneRedundant | Durch aktivieren dieser Eigenschaft wird ein Premium Service Bus-Namespace in regionen unterstützter Verfügbarkeitszonen erstellt. | Bool |
SBSku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Messaging-Einheiten für Ihren Servicebus Premium-Namespace. Gültige Kapazitäten sind {1, 2, 4, 8, 16} Vielfache Ihrer Eigenschaften.premiumMessagingPartitions-Einstellung. Wenn "properties.premiumMessagingPartitions" beispielsweise 1 ist, sind mögliche Kapazitätswerte 1, 2, 4, 8 und 16. Wenn properties.premiumMessagingPartitions 4 ist, sind mögliche Kapazitätswerte 4, 8, 16, 32 und 64. | Int |
| Name | Name dieser SKU. | "Einfach" "Premium" "Standard" (erforderlich) |
| Rang | Die Abrechnungsebene dieser speziellen SKU. | "Einfach" "Premium" "Standard" |
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| userAssignedIdentity | ARM-ID der Benutzeridentität, die für die Verschlüsselung ausgewählt ist | Schnur |
Verwendungsbeispiele
Terraform-Beispiele
Ein grundlegendes Beispiel für die Bereitstellung des ServiceBus-Namespaces.
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 = ["*"]
}
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Modul | Beschreibung |
|---|---|
| Service Bus-Namespace- | AVM-Ressourcenmodul für Service Bus-Namespace |