Mengaktifkan penerusan otomatis untuk antrean dan langganan Azure Service Bus

Artikel
10/18/2023

Fitur penerusan otomatis Service Bus memungkinkan Anda untuk menautkan antrean atau langganan ke antrean atau topik lain yang merupakan bagian dari namespace yang sama. Saat penerusan otomatis diaktifkan, Service Bus secara otomatis menghapus pesan yang ditempatkan di antrean pertama atau langganan (sumber) dan menempatkannya di antrean kedua atau topik (tujuan). Masih mungkin untuk mengirim pesan ke entitas tujuan secara langsung. Untuk informasi selengkapnya, lihat Menautkan entitas Service Bus dengan penerusan otomatis. Artikel ini menunjukkan kepada Anda berbagai cara untuk mengaktifkan penerusan otomatis untuk antrean dan langganan Service Bus.

Penting

Tingkatan dasar Service Bus tidak mendukung fitur penerusan otomatis. Tingkatan standar dan premium mendukung fitur ini. Untuk perbedaan antara tingkatan ini, lihat Harga Service Bus.

Menggunakan portal Azure

Saat membuat antrean atau langganan untuk topik di portal Microsoft Azure, pilih Teruskan pesan ke antrean/topik sebagaimana yang diperlihatkan dalam contoh berikut. Kemudian, tentukan apakah Anda ingin pesan diteruskan ke antrean atau topik. Dalam contoh ini, opsi Antrean dipilih dan antrean dari namespace yang sama dipilih.

Membuat antrean dengan penerusan otomatis diaktifkan

Aktifkan penerusan otomatis pada saat pembuatan antrean

Membuat langganan untuk topik dengan penerusan otomatis diaktifkan

Mengaktifkan penerusan otomatis pada saat pembuatan langganan

Memperbarui pengaturan penerusan otomatis untuk antrean yang sudah ada

Pada halaman Gambaran Umum untuk antrean Service Bus Anda, pilih nilai saat ini untuk pengaturan Teruskan pesan ke. Dalam contoh berikut, nilai saat ini adalah Dinonaktifkan. Di jendela Teruskan pesan ke antrean/topik, Anda dapat memilih antrean atau topik di mana Anda ingin pesan diteruskan.

Aktifkan penerusan otomatis untuk antrean yang sudah ada

Memperbarui pengaturan penerusan otomatis untuk langganan yang sudah ada

Pada halaman Ringkasan untuk langganan Service Bus Anda, pilih nilai saat ini untuk pengaturan Teruskan pesan ke. Dalam contoh berikut, nilai saat ini adalah Dinonaktifkan. Di jendela Teruskan pesan ke antrean/topik, Anda dapat memilih antrean atau topik di mana Anda ingin pesan diteruskan.

Mengaktifkan penerusan otomatis untuk langganan yang sudah ada

Menggunakan Azure CLI

Untuk membuat antrean dengan penerusan otomatis diaktifkan, gunakan perintah az servicebus queue create dengan --forward-to diatur ke nama antrean atau topik pada pesan yang ingin Anda teruskan.

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

Untuk memperbarui pengaturan penerusan otomatis untuk antrean yang sudah ada, gunakan perintah az servicebus queue update dengan --forward-to diatur ke nama antrean atau topik pada pesan yang ingin Anda teruskan.

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

Untuk membuat langganan ke topik dengan penerusan otomatis diaktifkan, gunakan perintah az servicebus topic subscription create dengan --forward-to diatur ke nama antrean atau topik pada pesan yang ingin Anda teruskan.

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

Untuk memperbarui pengaturan penerusan otomatis untuk langganan ke topik, gunakan perintah az servicebus topic subscription update dengan --forward-to diatur ke nama antrean atau topik pada pesan yang ingin Anda teruskan.

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

Menggunakan Azure PowerShell

Untuk membuat antrean dengan penerusan otomatis diaktifkan, gunakan perintah New-AzServiceBusQueue dengan -ForwardTo diatur ke nama antrean atau topik pada pesan yang ingin Anda teruskan.

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

Untuk memperbarui pengaturan penerusan otomatis untuk antrean yang sudah ada, gunakan perintah Set-AzServiceBusQueue seperti yang diperlihatkan dalam contoh berikut.

Set-AzServiceBusQueue -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -Name myqueue `
    -ForwardTo myqueue2

Untuk membuat langganan untuk topik dengan penerusan otomatis diaktifkan, gunakan perintah New-AzServiceBusSubscription dengan -ForwardTo diatur ke nama antrean atau topik pada pesan yang ingin Anda teruskan.

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

Untuk memperbarui pengaturan penerusan otomatis untuk langganan yang sudah ada, lihat contoh berikut ini.

Set-AzServiceBusSubscription -ResourceGroup myresourcegroup `
    -NamespaceName mynamespace `
    -TopicName mytopic `
    -Name mysub `
    -ForwardTo mytopic2

Menggunakan templat Azure Resource Manager

Untuk membuat antrean dengan penerusan otomatis diaktifkan, atur forwardTo di bagian properti antrean ke nama antrean atau topik pada pesan yang ingin Anda teruskan. Untuk informasi selengkapnya, lihat templat referensi Microsoft.ServiceBus namespaces/queues.

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

Untuk membuat langganan topik dengan penerusan otomatis diaktifkan, atur forwardTo di bagian properti antrean ke nama antrean atau topik pada pesan yang ingin Anda teruskan. Untuk informasi selengkapnya, lihat referensi templat namespaces/topik/langganan Microsoft.ServiceBus.

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

Anda dapat mengaktifkan fitur penerusan otomatis dengan mengatur CreateQueueOptions.ForwardTo atau CreateSubscriptionOptions.ForwardTo, lalu dengan menggunakan metode CreateQueueAsync atau CreateSubscriptionAsync yang mengambil parameter CreateQueueOptions atau CreateSubscriptionOptions.

Microsoft.Azure.ServiceBus (warisan)

Anda dapat mengaktifkan penerusan otomatis dengan mengatur QueueDescription.ForwardTo atau SubscriptionDescription.ForwardTo untuk sumbernya, seperti dalam contoh berikut:

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

Pada 30 September 2026, kami akan menghentikan pustaka Azure Bus Layanan SDK WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus, dan com.microsoft.azure.servicebus, yang tidak sesuai dengan panduan Azure SDK. Kami juga akan mengakhiri dukungan protokol SBMP, sehingga Anda tidak akan lagi dapat menggunakan protokol ini setelah 30 September 2026. Migrasikan ke pustaka Azure SDK terbaru, yang menawarkan pembaruan keamanan penting dan kemampuan yang ditingkatkan, sebelum tanggal tersebut.

Meskipun pustaka lama masih dapat digunakan melebihi 30 September 2026, pustaka tersebut tidak akan lagi menerima dukungan dan pembaruan resmi dari Microsoft. Untuk informasi selengkapnya, lihat pengumuman penghentian dukungan.

Java

azure-messaging-servicebus (terbaru)

Anda dapat mengaktifkan fitur penerusan otomatis dengan menggunakan metode CreateQueueOptions.setForwardTo(String forwardTo) atau CreateSubscriptionOptions.setForwardTo(String forwardTo), lalu dengan menggunakan metode createQueue atau metode createSubscription yang mengambil parameter CreateQueueOptions atau CreateSubscriptionOptions.

azure-servicebus (warisan)

Anda dapat mengaktifkan penerusan otomatis dengan menggunakan QueueDescription.setForwardTo(String forwardTo) atau SubscriptionDescription.setForwardTo(String forwardTo) untuk sumbernya.

Pada 30 September 2026, kami akan menghentikan pustaka Azure Bus Layanan SDK WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus, dan com.microsoft.azure.servicebus, yang tidak sesuai dengan panduan Azure SDK. Kami juga akan mengakhiri dukungan protokol SBMP, sehingga Anda tidak akan lagi dapat menggunakan protokol ini setelah 30 September 2026. Migrasikan ke pustaka Azure SDK terbaru, yang menawarkan pembaruan keamanan penting dan kemampuan yang ditingkatkan, sebelum tanggal tersebut.

Meskipun pustaka lama masih dapat digunakan melebihi 30 September 2026, pustaka tersebut tidak akan lagi menerima dukungan dan pembaruan resmi dari Microsoft. Untuk informasi selengkapnya, lihat pengumuman penghentian dukungan.

Langkah berikutnya

Cobalah sampel dalam bahasa pilihan Anda untuk menjelajahi fitur Azure Service Bus.

Temukan sampel untuk pustaka klien .NET dan Java yang lebih lama:

Pada 30 September 2026, kami akan menghentikan pustaka Azure Bus Layanan SDK WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus, dan com.microsoft.azure.servicebus, yang tidak sesuai dengan panduan Azure SDK. Kami juga akan mengakhiri dukungan protokol SBMP, sehingga Anda tidak akan lagi dapat menggunakan protokol ini setelah 30 September 2026. Migrasikan ke pustaka Azure SDK terbaru, yang menawarkan pembaruan keamanan penting dan kemampuan yang ditingkatkan, sebelum tanggal tersebut.

Meskipun pustaka lama masih dapat digunakan melebihi 30 September 2026, pustaka tersebut tidak akan lagi menerima dukungan dan pembaruan resmi dari Microsoft. Untuk informasi selengkapnya, lihat pengumuman penghentian dukungan.

Bagikan melalui