Creare uno spazio dei nomi del bus di servizio con argomento, sottoscrizione e regola usando un modello di Azure Resource Manager
Questo articolo illustra come usare un modello di Azure Resource Manager per creare uno spazio dei nomi del bus di servizio con un argomento, una sottoscrizione e una regola (filtro). L'articolo spiega come specificare le risorse da distribuire e come definire i parametri che devono essere specificati quando viene eseguita la distribuzione. È possibile usare questo modello per la distribuzione o personalizzarlo in base alle esigenze.
Per altre informazioni sulla creazione dei modelli, vedere Creazione di modelli di Azure Resource Manager.
Per altre informazioni su procedure e modelli relativi alle convenzioni di denominazione delle risorse di Azure, vedere Recommended naming conventions for Azure resources (Convenzioni di denominazione consigliate per le risorse di Azure).
Per il modello completo, vedere il modello dello spazio dei nomi del bus di servizio con argomento, sottoscrizione e regola su GitHub.
Nota
Questi modelli di Azure Resource Manager sono disponibili per il download e la distribuzione.
- Creare uno spazio dei nomi del bus di servizio con coda e regola di autorizzazione
- Creare uno spazio dei nomi del bus di servizio con coda
- Creare uno spazio dei nomi del bus di servizio
- Creare uno spazio dei nomi del bus di servizio con argomento e sottoscrizione
Per verificare la disponibilità dei modelli più recenti, visitare la raccolta modelli di avvio rapido di Azure e cercare il bus di servizio.
Cosa distribuire?
Questo modello consente di distribuire uno spazio dei nomi del bus di servizio con un argomento, una sottoscrizione e una regola (filtro).
Gli argomenti e le sottoscrizioni del bus di servizio offrono una forma di comunicazione uno-a-molti, in un schema di pubblicazione/sottoscrizione. Quando si usano gli argomenti e le sottoscrizioni, i componenti di un'applicazione distribuita non comunicano direttamente tra loro, ma scambiano messaggi tramite un argomento, che agisce da intermediario. La sottoscrizione a un argomento è simile a una coda virtuale che riceve copie dei messaggi che sono stati inviati all'argomento. L'applicazione di un filtro a una sottoscrizione consente di specificare quali messaggi inviati a un argomento devono essere presenti in una specifica sottoscrizione dell'argomento.
Che cosa sono le regole (filtri)?
In molti scenari, i messaggi con caratteristiche specifiche devono essere elaborati in modi specifici. Per abilitare questa elaborazione personalizzata, è possibile configurare le sottoscrizioni in modo che trovino i messaggi che presentano le proprietà specifiche e apportare quindi modifiche a tali proprietà. Anche se nelle sottoscrizioni del bus di servizio tutti i messaggi vengono inviati all'argomento, l'utente può copiare solo un sottoinsieme di tali messaggi nella coda virtuale delle sottoscrizioni. Questa operazione viene eseguita usando i filtri della sottoscrizione. Per altre informazioni sulle regole (filtri), vedere Regole e azioni.
Per eseguire automaticamente la distribuzione, fare clic sul pulsante seguente:
Parametri
Gestione risorse di Azure permette di definire i parametri per i valori da specificare durante la distribuzione del modello. Il modello include una sezione denominata Parameters che contiene tutti i valori dei parametri. Definire un parametro per i valori che variano in base al progetto distribuito o all'ambiente in cui viene distribuito il progetto. Non definire i parametri per i valori che rimangono invariati. Ogni valore di parametro nel modello viene usato per definire le risorse distribuite.
Il modello definisce i parametri seguenti:
serviceBusNamespaceName
Nome dello spazio dei nomi del bus di servizio da creare.
"serviceBusNamespaceName": {
"type": "string"
}
serviceBusTopicName
Nome dell'argomento creato nello spazio dei nomi del bus di servizio.
"serviceBusTopicName": {
"type": "string"
}
serviceBusSubscriptionName
Nome della sottoscrizione creata nello spazio dei nomi del bus di servizio.
"serviceBusSubscriptionName": {
"type": "string"
}
serviceBusRuleName
Nome della regola (filtro) creata nello spazio dei nomi del bus di servizio.
"serviceBusRuleName": {
"type": "string",
}
serviceBusApiVersion
Versione API del bus di servizio del modello.
"serviceBusApiVersion": {
"type": "string",
"defaultValue": "2017-04-01",
"metadata": {
"description": "Service Bus ApiVersion used by the template"
}
Risorse da distribuire
Crea uno spazio dei nomi del bus di servizio standard di tipo Messaggistica con argomento, sottoscrizione e regole.
"resources": [{
"apiVersion": "[variables('sbVersion')]",
"name": "[parameters('serviceBusNamespaceName')]",
"type": "Microsoft.ServiceBus/Namespaces",
"location": "[variables('location')]",
"sku": {
"name": "Standard",
},
"resources": [{
"apiVersion": "[variables('sbVersion')]",
"name": "[parameters('serviceBusTopicName')]",
"type": "Topics",
"dependsOn": [
"[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
],
"properties": {
"path": "[parameters('serviceBusTopicName')]"
},
"resources": [{
"apiVersion": "[variables('sbVersion')]",
"name": "[parameters('serviceBusSubscriptionName')]",
"type": "Subscriptions",
"dependsOn": [
"[parameters('serviceBusTopicName')]"
],
"properties": {},
"resources": [{
"apiVersion": "[variables('sbVersion')]",
"name": "[parameters('serviceBusRuleName')]",
"type": "Rules",
"dependsOn": [
"[parameters('serviceBusSubscriptionName')]"
],
"properties": {
"filterType": "SqlFilter",
"sqlFilter": {
"sqlExpression": "StoreName = 'Store1'",
"requiresPreprocessing": "false"
},
"action": {
"sqlExpression": "set FilterTag = 'true'"
}
}
}]
}]
}]
}]
Per la sintassi e le proprietà JSON, vedere Spazi dei nomi, Argomenti, Sottoscrizioni e Regole.
Comandi per eseguire la distribuzione
Per distribuire le risorse in Azure, è necessario aver eseguito l'accesso all'account Azure e usare il modulo Azure Resource Manager. Per altre informazioni su come usare Gestione risorse di Azure con Azure PowerShell o l'interfaccia della riga di comando di Azure, vedere:
- Gestire le risorse di Azure tramite Azure PowerShell
- Gestire le risorse di Azure tramite l'interfaccia della riga di comando di Azure.
Gli esempi seguenti presuppongono che nell'account sia già stato creato un gruppo di risorse con il nome specificato.
PowerShell
New-AzureResourceGroupDeployment -Name \<deployment-name\> -ResourceGroupName \<resource-group-name\> -TemplateUri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/quickstarts/microsoft.servicebus/servicebus-create-topic-subscription-rule/azuredeploy.json>
Interfaccia della riga di comando di Azure
az deployment group create -g \<my-resource-group\> --template-uri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/quickstarts/microsoft.servicebus/servicebus-create-topic-subscription-rule/azuredeploy.json>
Passaggi successivi
Per informazioni su come gestire queste risorse, vedere gli articoli seguenti: