Ketentuan namespace dan entitas Bus Layanan secara dinamis

Azure Service Bus menyediakan pustaka untuk membantu memprovisikan namespace dan entitas Bus Layanan secara dinamis. Hal ini memungkinkan skenario penyebaran dan olahpesan yang kompleks, dan memungkinkan untuk secara terprogram menentukan entitas apa yang akan diprovisikan.

Gambaran Umum

Ada dua pendekatan yang dapat Anda ambil untuk mengelola sumber daya Azure Service Bus secara terprogram. Yang pertama adalah menggunakan pustaka berbasis Azure Resource Manager yang memungkinkan Anda mengelola namespace, antrean, topik, langganan, aturan, dan kebijakan SAS. Pustaka berbasis Azure Resource Manager memiliki dukungan untuk autentikasi melalui ID Microsoft Entra, tetapi tidak melalui string koneksi. Pendekatan kedua adalah memanfaatkan pustaka klien Bus Layanan yang sama yang Anda gunakan untuk mengirim dan menerima pesan. Pustaka klien juga menyediakan API untuk membantu Anda mengelola antrean, topik, langganan, dan aturan di namespace yang ada. Mereka memiliki dukungan untuk autentikasi dengan string koneksi. Ketika memutuskan pendekatan mana yang harus diambil, pertimbangkan hal berikut.

Pustaka berbasis Azure Resource Manager menawarkan fungsi yang sama dengan portal Microsoft Azure, CLI, dan PowerShell dalam hal mengelola namespace dan entitas Bus Layanan seperti antrean, topik, langganan, dll. Jika Anda telah menggunakan portal Microsoft Azure, CLI, atau PowerShell untuk operasi manajemen Anda dan menginginkan cara dinamis untuk melakukan itu, maka pustaka ini mungkin menjadi pilihan yang lebih baik untuk Anda.

Namun, jika Anda sudah menggunakan pustaka klien Bus Layanan untuk operasi khusus layanan seperti mengirim dan menerima pesan dan Anda perlu mengelola entitas Bus Layanan juga, maka menggunakan pustaka yang sama mungkin lebih nyaman bagi Anda. Pustaka klien memiliki ServiceBusAdministrationClient (disebut ServiceBusManagementClient di pustaka yang lebih lama) yang menyediakan subset dari fitur manajemen yang disediakan oleh pustaka berbasis Azure Resource Manager. Harus ditekankan bahwa sementara pustaka berbasis Azure Resource Manager memungkinkan Anda untuk mengelola namespace dan entitas Bus Layanan, pustaka klien hanya memungkinkan Anda untuk mengelola entitas di namespace yang sudah ada tetapi bukan namespace itu sendiri.

Mengelola menggunakan pustaka berbasis Azure Resource Manager

Pustaka berbasis Azure Resource Manager memungkinkan Anda mengelola namespace, antrean, topik, langganan, aturan, dan kebijakan SAS. Mereka hanya mendukung autentikasi dengan ID Microsoft Entra; mereka tidak mendukung string koneksi.

Language Paket Dokumentasi Sampel
.NET Azure.ResourceManager.ServiceBus Referensi API untuk Microsoft.Azure.Management.ServiceBus .NET
Java azure-resourcemanager-servicebus Referensi API untuk com.azure.resourcemanager.servicebus Java
JavaScript @azure/arm-servicebus API reference for @azure/arm-servicebus
Python azure-mgmt-servicebus Referensi API untuk azure-mgmt-servicebus

Pustaka .NET dan Java Fasih

Ada versi Fasih dari pustaka berbasis Azure Resource Manager.

Language Paket Dokumentasi
.NET Microsoft.Azure.Management.ServiceBus.Fluent Referensi API untuk Microsoft.Azure.Management.ServiceBus.Fluent
Java azure-resourcemanager-servicebus Referensi API untuk com.azure.resourcemanager.servicebus.fluent

Mengelola menggunakan pustaka klien Bus Layanan

Pustaka klien Bus Layanan yang digunakan untuk operasi seperti mengirim dan menerima pesan juga dapat digunakan untuk mengelola antrean, topik, langganan, dan aturan di namespace Bus Layanan yang sudah ada. Fitur ini tersedia melalui ServiceBusAdministrationClient di pustaka terbaru dan melalui ServiceBusManagementClient di pustaka yang lebih lama. Sangat disarankan agar Anda menggunakan pustaka terbaru.

Pustaka Azure Service Bus terbaru

Language Paket Dokumentasi Sampel
.NET Azure.Messaging.ServiceBus ServiceBusAdministrationClient .NET
Java azure-messaging-servicebus ServiceBusAdministrationAsyncClient, ServiceBusAdministrationClient Java
JavaScript @azure/service-bus ServiceBusAdministrationClient JavaScript/TypeScript
Python azure-servicebus ServiceBusAdministrationClient Python

Pustaka Bus Layanan Warisan

Language Paket Dokumentasi Sampel
.NET Microsoft.Azure.ServiceBus ManagementClient .NET
Java azure-mgmt-servicebus ManagementClientAsync, ManagementClient Java

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

  • Mengirim pesan ke dan menerima pesan dari antrean menggunakan pustaka Bus Layanan terbaru: .NET, Java, JavaScript, Python
  • Kirim pesan ke topik dan terima pesan dari langganan menggunakan perpustakaan Bus Layanan terbaru: .NET, Java, JavaScript, Python