Mengaktifkan penerusan otomatis untuk antrean dan langganan Azure Service Bus
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
Membuat langganan untuk topik dengan penerusan otomatis diaktifkan
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.
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.
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 create \
--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 `
-QueueName myqueue `
-ForwardTo myqueue2
Untuk memperbarui pengaturan penerusan otomatis untuk antrean yang sudah ada, gunakan perintah Set-AzServiceBusQueue seperti yang diperlihatkan dalam contoh berikut.
$queue=Get-AzServiceBusQueue -ResourceGroup myresourcegroup `
-NamespaceName mynamespace `
-QueueName myqueue
$queue.ForwardTo='myqueue2'
Set-AzServiceBusQueue -ResourceGroup myresourcegroup `
-NamespaceName mynamespace `
-QueueName myqueue `
-QueueObj $queue
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 `
-SubscriptionName mysubscription `
-ForwardTo myqueue2
Untuk memperbarui pengaturan penerusan otomatis untuk langganan yang sudah ada, lihat contoh berikut ini.
$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
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.
- Sampel pustaka klien Azure Service Bus untuk .NET (terbaru)
- Sampel pustaka klien Azure Service Bus untuk Java (terbaru)
- Sampel pustaka klien Azure Service Bus untuk Python
- Sampel pustaka klien Azure Service Bus untuk JavaScript
- Sampel pustaka klien Azure Service Bus untuk TypeScript
Temukan sampel untuk pustaka klien .NET dan Java yang lebih lama di bawah ini:
- Sampel pustaka klien Azure Service Bus untuk .NET (warisan)
- Sampel pustaka klien Azure Service Bus untuk Java (warisan)
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.