Aktivera automatisk vidarebefordran för Azure Service Bus-köer och prenumerationer

  • Artikel

Med funktionen automatisk vidarebefordring i Service Bus kan du länka en kö eller prenumeration till en annan kö eller ett annat ämne som ingår i samma namnområde. När automatisk vidarebefordran är aktiverad tar Service Bus automatiskt bort meddelanden som placeras i den första kön eller prenumerationen (källa) och placerar dem i den andra kön eller det andra ämnet (målet). Det går fortfarande att skicka ett meddelande direkt till målentiteten. Mer information finns i Länka Service Bus-entiteter med automatisk vidarebefordran. Den här artikeln visar olika sätt att aktivera automatisk vidarebefordring för Service Bus-köer och prenumerationer.

Viktigt!

Den grundläggande nivån för Service Bus stöder inte funktionen för automatisk vidarebefordring. Standard- och premiumnivåerna stöder funktionen. Skillnader mellan dessa nivåer finns i Service Bus-priser.

Med Azure Portal

När du skapar en kö eller en prenumeration för ett ämne i Azure-portalen väljer du Vidarebefordra meddelanden till kö/ämne enligt följande exempel. Ange sedan om du vill att meddelanden ska vidarebefordras till en kö eller ett ämne. I det här exemplet är alternativet Kö valt och en kö från samma namnområde har valts.

Skapa en kö med automatisk vidarebefordran aktiverad

Enable auto forward at the time of the queue creation

Skapa en prenumeration för ett ämne med automatisk vidarebefordring aktiverat

Enable auto forward at the time of the subscription creation

Uppdatera inställningen för automatisk vidarebefordran för en befintlig kö

På sidan Översikt för Service Bus-kön väljer du det aktuella värdet för inställningen Vidarebefordra meddelanden till . I följande exempel är det aktuella värdet Inaktiverat. I fönstret Vidarebefordra meddelanden till kö/ämne kan du välja den kö eller det ämne där du vill att meddelandena ska vidarebefordras.

Enable auto forward for an existing queue

Uppdatera inställningen för automatisk vidarebefordran för en befintlig prenumeration

På sidan Översikt för din Service Bus-prenumeration väljer du det aktuella värdet för inställningen Vidarebefordra meddelanden till . I följande exempel är det aktuella värdet Inaktiverat. I fönstret Vidarebefordra meddelanden till kö/ämne kan du välja den kö eller det ämne där du vill att meddelandena ska vidarebefordras.

Enable auto forward for an existing subscription

Använda Azure CLI

Om du vill skapa en kö med automatisk vidarebefordran aktiverad använder az servicebus queue create du kommandot med --forward-to inställt på namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till.

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

Om du vill uppdatera inställningen för automatisk vidarebefordran för en befintlig kö använder az servicebus queue update du kommandot med --forward-to inställt på namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till.

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

Om du vill skapa en prenumeration på ett ämne med automatisk vidarebefordring aktiverad använder az servicebus topic subscription create du kommandot med --forward-to inställt på namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till.

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

Om du vill uppdatera inställningen för automatisk vidarebefordran för en prenumeration till ett ämne använder az servicebus topic subscription update du kommandot med --forward-to inställt på namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till.

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

Använda Azure PowerShell

Om du vill skapa en kö med automatisk vidarebefordran aktiverad använder New-AzServiceBusQueue du kommandot med -ForwardTo inställt på namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till.

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

Om du vill uppdatera inställningen för automatisk vidarebefordran för en befintlig kö använder du Set-AzServiceBusQueue kommandot enligt följande exempel.

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

$queue.ForwardTo='myqueue2'

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

Om du vill skapa en prenumeration för ett ämne med automatisk vidarebefordran aktiverad använder New-AzServiceBusSubscription du kommandot med -ForwardTo inställt på namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till.

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

Information om hur du uppdaterar inställningen för automatisk vidarebefordran för en befintlig prenumeration finns i följande exempel.

$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

Använda Azure Resource Manager-mall

Om du vill skapa en kö med automatisk vidarebefordran aktiverad anger forwardTo du i avsnittet köegenskaper till namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till. Mer information finns i Mallreferens för Microsoft.ServiceBus-namnområden/köer.

{
  "$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"
          }
        }
      ]
    }
  ]
}

Om du vill skapa en prenumeration för ett ämne med automatisk vidarebefordring aktiverad anger forwardTo du i avsnittet köegenskaper till namnet på kön eller ämnet som du vill att meddelandena ska vidarebefordras till. Mer information finns i Mallreferens för Microsoft.ServiceBus-namnområden/ämnen/prenumerationer.

{
  "$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 (senaste)

Du kan aktivera funktionen för automatisk vidarebefordring genom att ange CreateQueueOptions.ForwardTo eller CreateSubscriptionOptions.ForwardTo och sedan använda metoderna CreateQueueAsync eller CreateSubscriptionAsync som tar CreateQueueOptions eller CreateSubscriptionOptions parametrar.

Microsoft.Azure.ServiceBus (äldre)

Du kan aktivera automatiskforwarding genom att ange QueueDescription.ForwardTo eller SubscriptionDescription.ForwardTo för källan, som i följande exempel:

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

Den 30 september 2026 drar vi tillbaka Azure Service Bus SDK-biblioteken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus och com.microsoft.azure.servicebus, som inte följer Riktlinjerna för Azure SDK. Vi kommer också att avsluta stödet för SBMP-protokollet, så du kommer inte längre att kunna använda det här protokollet efter den 30 september 2026. Migrera till de senaste Azure SDK-biblioteken, som erbjuder kritiska säkerhetsuppdateringar och förbättrade funktioner, före det datumet.

Även om de äldre biblioteken fortfarande kan användas efter den 30 september 2026 får de inte längre officiell support och uppdateringar från Microsoft. Mer information finns i meddelandet om supportavgång.

Java

azure-messaging-servicebus (senaste)

Du kan aktivera funktionen för automatisk vidarebefordring med hjälp av metoden CreateQueueOptions.setForwardTo(String forwardTo) eller metoden CreateSubscriptionOptions.setForwardTo(String forwardTo) och sedan med metoden createQueue eller metoden createSubscription som tar CreateQueueOptions eller CreateSubscriptionOptions parametrar.

azure-servicebus (äldre)

Du kan aktivera automatiskforwarding med hjälp av QueueDescription.setForwardTo(String forwardTo) eller SubscriptionDescription.setForwardTo(String forwardTo) för källan.

Den 30 september 2026 drar vi tillbaka Azure Service Bus SDK-biblioteken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus och com.microsoft.azure.servicebus, som inte följer Riktlinjerna för Azure SDK. Vi kommer också att avsluta stödet för SBMP-protokollet, så du kommer inte längre att kunna använda det här protokollet efter den 30 september 2026. Migrera till de senaste Azure SDK-biblioteken, som erbjuder kritiska säkerhetsuppdateringar och förbättrade funktioner, före det datumet.

Även om de äldre biblioteken fortfarande kan användas efter den 30 september 2026 får de inte längre officiell support och uppdateringar från Microsoft. Mer information finns i meddelandet om supportavgång.

Nästa steg

Prova exemplen på det språk du väljer för att utforska Azure Service Bus-funktioner.

Hitta exempel för de äldre .NET- och Java-klientbiblioteken nedan:

Den 30 september 2026 drar vi tillbaka Azure Service Bus SDK-biblioteken WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus och com.microsoft.azure.servicebus, som inte följer Riktlinjerna för Azure SDK. Vi kommer också att avsluta stödet för SBMP-protokollet, så du kommer inte längre att kunna använda det här protokollet efter den 30 september 2026. Migrera till de senaste Azure SDK-biblioteken, som erbjuder kritiska säkerhetsuppdateringar och förbättrade funktioner, före det datumet.

Även om de äldre biblioteken fortfarande kan användas efter den 30 september 2026 får de inte längre officiell support och uppdateringar från Microsoft. Mer information finns i meddelandet om supportavgång.