Automatisch doorsturen inschakelen voor Azure Service Bus-wachtrijen en -abonnementen

  • Artikel

Met de functie voor automatisch doorsturen van Service Bus kunt u een wachtrij of abonnement koppelen aan een andere wachtrij of een ander onderwerp dat deel uitmaakt van dezelfde naamruimte. Wanneer automatisch doorsturen is ingeschakeld, verwijdert Service Bus automatisch berichten die in de eerste wachtrij of het eerste abonnement (bron) worden geplaatst en worden deze in de tweede wachtrij of het tweede onderwerp (bestemming) geplaatst. Het is nog steeds mogelijk om rechtstreeks een bericht naar de doelentiteit te verzenden. Zie Service Bus-entiteiten koppelen met automatisch doorsturen voor meer informatie. In dit artikel vindt u verschillende manieren om automatisch doorsturen in te schakelen voor Service Bus-wachtrijen en -abonnementen.

Belangrijk

De basic-laag van Service Bus biedt geen ondersteuning voor de functie voor automatisch doorsturen. De standard- en Premium-lagen ondersteunen de functie. Zie Service Bus-prijzen voor verschillen tussen deze lagen.

Azure-portal gebruiken

Wanneer u een wachtrij of abonnement voor een onderwerp in Azure Portal maakt, selecteert u Berichten doorsturen naar wachtrij/onderwerp, zoals wordt weergegeven in de volgende voorbeelden. Geef vervolgens op of berichten moeten worden doorgestuurd naar een wachtrij of een onderwerp. In dit voorbeeld is de optie Wachtrij geselecteerd en wordt er een wachtrij uit dezelfde naamruimte geselecteerd.

Een wachtrij maken waarvoor automatisch doorsturen is ingeschakeld

Enable auto forward at the time of the queue creation

Een abonnement maken voor een onderwerp waarvoor automatisch doorsturen is ingeschakeld

Enable auto forward at the time of the subscription creation

De instelling voor automatisch doorsturen bijwerken voor een bestaande wachtrij

Selecteer op de pagina Overzicht voor uw Service Bus-wachtrij de huidige waarde voor de instelling Berichten doorsturen . In het volgende voorbeeld is de huidige waarde uitgeschakeld. In het venster Berichten doorsturen naar wachtrij/onderwerp kunt u de wachtrij of het onderwerp selecteren waar u de berichten wilt doorsturen.

Enable auto forward for an existing queue

De instelling voor automatisch doorsturen voor een bestaand abonnement bijwerken

Selecteer op de pagina Overzicht voor uw Service Bus-abonnement de huidige waarde voor de instelling Berichten doorsturen . In het volgende voorbeeld is de huidige waarde uitgeschakeld. In het venster Berichten doorsturen naar wachtrij/onderwerp kunt u de wachtrij of het onderwerp selecteren waar u de berichten wilt doorsturen.

Enable auto forward for an existing subscription

Azure CLI gebruiken

Als u een wachtrij wilt maken waarvoor automatisch doorsturen is ingeschakeld, gebruikt u de az servicebus queue create opdracht die --forward-to is ingesteld op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen.

az servicebus queue create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --forward-to myqueue2

Als u de instelling voor automatisch doorsturen voor een bestaande wachtrij wilt bijwerken, gebruikt u de az servicebus queue update opdracht die --forward-to is ingesteld op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen.

az servicebus queue update \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --name myqueue \
    --forward-to myqueue2

Als u een abonnement wilt maken op een onderwerp waarvoor automatisch doorsturen is ingeschakeld, gebruikt u de az servicebus topic subscription create opdracht die --forward-to is ingesteld op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen.

az servicebus topic subscription create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --forward-to myqueue2

Als u de instelling voor automatisch doorsturen voor een abonnement op een onderwerp wilt bijwerken, gebruikt u de az servicebus topic subscription update opdracht die --forward-to is ingesteld op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen.

az servicebus topic subscription create \
    --resource-group myresourcegroup \
    --namespace-name mynamespace \
    --topic-name mytopic \
    --name mysubscription \
    --forward-to myqueue2

Azure PowerShell gebruiken

Als u een wachtrij wilt maken waarvoor automatisch doorsturen is ingeschakeld, gebruikt u de New-AzServiceBusQueue opdracht die -ForwardTo is ingesteld op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen.

New-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue `
    -ForwardTo myqueue2

Als u de instelling voor automatisch doorsturen voor een bestaande wachtrij wilt bijwerken, gebruikt u de Set-AzServiceBusQueue opdracht, zoals wordt weergegeven in het volgende voorbeeld.

$queue=Get-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue 

$queue.ForwardTo='myqueue2'

Set-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -QueueName myqueue `
    -QueueObj $queue

Als u een abonnement wilt maken voor een onderwerp waarvoor automatisch doorsturen is ingeschakeld, gebruikt u de New-AzServiceBusSubscription opdracht die -ForwardTo is ingesteld op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen.

New-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -SubscriptionName mysubscription `
    -ForwardTo myqueue2

Zie het volgende voorbeeld om de instelling voor automatisch doorsturen voor een bestaand abonnement bij te werken.

$subscription=Get-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -SubscriptionName mysub

$subscription.ForwardTo='mytopic2'

Set-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -Name mytopic `
    -SubscriptionName mysub `
    -SubscriptionObj $subscription

Azure Resource Manager-sjabloon gebruiken

Als u een wachtrij wilt maken waarvoor automatisch doorsturen is ingeschakeld, stelt u forwardTo in de sectie Wachtrijeigenschappen in op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen. Zie de sjabloonreferenties voor Microsoft.ServiceBus-naamruimten/wachtrijen voor meer informatie.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "serviceBusNamespaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusQueueName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Queue"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ServiceBus/namespaces",
      "apiVersion": "2018-01-01-preview",
      "name": "[parameters('serviceBusNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard"
      },
      "properties": {},
      "resources": [
        {
          "type": "Queues",
          "apiVersion": "2017-04-01",
          "name": "[parameters('serviceBusQueueName')]",
          "dependsOn": [
            "[resourceId('Microsoft.ServiceBus/namespaces', parameters('serviceBusNamespaceName'))]"
          ],
          "properties": {
            "forwardTo": "myqueue2"
          }
        }
      ]
    }
  ]
}

Als u een abonnement wilt maken voor een onderwerp waarvoor automatisch doorsturen is ingeschakeld, stelt u forwardTo in de sectie Wachtrijeigenschappen in op de naam van de wachtrij of het onderwerp waarnaar u de berichten wilt doorsturen. Zie Microsoft.ServiceBus-naamruimten/onderwerpen/abonnementensjabloonreferenties voor meer informatie.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "service_BusNamespace_Name": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusTopicName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Topic"
      }
    },
    "serviceBusSubscriptionName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Subscription"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "apiVersion": "2018-01-01-preview",
      "name": "[parameters('service_BusNamespace_Name')]",
      "type": "Microsoft.ServiceBus/namespaces",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard"
      },
      "properties": {},
      "resources": [
        {
          "apiVersion": "2017-04-01",
          "name": "[parameters('serviceBusTopicName')]",
          "type": "topics",
          "dependsOn": [
            "[resourceId('Microsoft.ServiceBus/namespaces/', parameters('service_BusNamespace_Name'))]"
          ],
          "properties": {
            "maxSizeInMegabytes": 1024
          },
          "resources": [
            {
              "apiVersion": "2017-04-01",
              "name": "[parameters('serviceBusSubscriptionName')]",
              "type": "Subscriptions",
              "dependsOn": [
                "[parameters('serviceBusTopicName')]"
              ],
              "properties": {
                "forwardTo": "myqueue2"
              }
            }
          ]
        }
      ]
    }
  ]
}

.NET

Azure.Messaging.ServiceBus (nieuwste versie)

U kunt de functie voor automatisch doorsturen inschakelen door CreateQueueOptions.ForwardTo of CreateSubscriptionOptions.ForwardTo in te stellen en vervolgens de createQueueAsync- of CreateSubscriptionAsync-methoden te gebruiken die CreateQueueOptions gebruikmaken van of CreateSubscriptionOptionsparameters.

Microsoft.Azure.ServiceBus (verouderd)

U kunt autoforwarding inschakelen door queueDescription.ForwardTo of SubscriptionDescription.ForwardTo in te stellen voor de bron, zoals in het volgende voorbeeld:

SubscriptionDescription srcSubscription = new SubscriptionDescription (srcTopic, srcSubscriptionName);
srcSubscription.ForwardTo = destTopic;
namespaceManager.CreateSubscription(srcSubscription));

Op 30 september 2026 gaan we de Azure Service Bus SDK-bibliotheken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus en com.microsoft.azure.servicebus buiten gebruik stellen, die niet voldoen aan de Azure SDK-richtlijnen. We beëindigen ook de ondersteuning van het SBMP-protocol, zodat u dit protocol na 30 september 2026 niet meer kunt gebruiken. Migreer naar de nieuwste Azure SDK-bibliotheken, die vóór die datum essentiële beveiligingsupdates en verbeterde mogelijkheden bieden.

Hoewel de oudere bibliotheken nog steeds meer dan 30 september 2026 kunnen worden gebruikt, ontvangen ze geen officiële ondersteuning en updates meer van Microsoft. Zie de aankondiging van de buitengebruikstelling van de ondersteuning voor meer informatie.

Java

azure-messaging-servicebus (nieuwste)

U kunt de functie automatisch doorsturen inschakelen met behulp van de methode CreateQueueOptions.setForwardTo(String forwardTo) of de methode CreateSubscriptionOptions.setForwardTo(String forwardTo), en vervolgens met behulp van de methode createQueue of de methode createSubscription die of parameters accepteertCreateQueueOptions.CreateSubscriptionOptions

azure-servicebus (verouderd)

U kunt automatisch doorsturen inschakelen met behulp van QueueDescription.setForwardTo (String forwardTo) of SubscriptionDescription.setForwardTo(String forwardTo) voor de bron.

Op 30 september 2026 gaan we de Azure Service Bus SDK-bibliotheken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus en com.microsoft.azure.servicebus buiten gebruik stellen, die niet voldoen aan de Azure SDK-richtlijnen. We beëindigen ook de ondersteuning van het SBMP-protocol, zodat u dit protocol na 30 september 2026 niet meer kunt gebruiken. Migreer naar de nieuwste Azure SDK-bibliotheken, die vóór die datum essentiële beveiligingsupdates en verbeterde mogelijkheden bieden.

Hoewel de oudere bibliotheken nog steeds meer dan 30 september 2026 kunnen worden gebruikt, ontvangen ze geen officiële ondersteuning en updates meer van Microsoft. Zie de aankondiging van de buitengebruikstelling van de ondersteuning voor meer informatie.

Volgende stappen

Probeer de voorbeelden in de taal van uw keuze om Azure Service Bus-functies te verkennen.

Hieronder vindt u voorbeelden voor de oudere .NET- en Java-clientbibliotheken:

Op 30 september 2026 gaan we de Azure Service Bus SDK-bibliotheken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus en com.microsoft.azure.servicebus buiten gebruik stellen, die niet voldoen aan de Azure SDK-richtlijnen. We beëindigen ook de ondersteuning van het SBMP-protocol, zodat u dit protocol na 30 september 2026 niet meer kunt gebruiken. Migreer naar de nieuwste Azure SDK-bibliotheken, die vóór die datum essentiële beveiligingsupdates en verbeterde mogelijkheden bieden.

Hoewel de oudere bibliotheken nog steeds meer dan 30 september 2026 kunnen worden gebruikt, ontvangen ze geen officiële ondersteuning en updates meer van Microsoft. Zie de aankondiging van de buitengebruikstelling van de ondersteuning voor meer informatie.