Udostępnij za pośrednictwem


Dynamiczne aprowizuj przestrzenie nazw i jednostki usługi Service Bus

Usługa Azure Service Bus udostępnia biblioteki ułatwiające dynamiczne inicjowanie obsługi przestrzeni nazw i jednostek usługi Service Bus. Umożliwia to złożone wdrożenia i scenariusze obsługi komunikatów oraz umożliwia programowe określanie jednostek do aprowizacji.

Omówienie

Istnieją dwa podejścia, które można zastosować w celu programowego zarządzania zasobami usługi Azure Service Bus. Pierwszym z nich jest użycie bibliotek opartych na usłudze Azure Resource Manager, które umożliwiają zarządzanie przestrzeniami nazw, kolejkami, tematami, subskrypcjami, regułami i zasadami sygnatur dostępu współdzielonego. Biblioteki oparte na usłudze Azure Resource Manager obsługują uwierzytelnianie za pośrednictwem identyfikatora Entra firmy Microsoft, ale nie za pośrednictwem parametry połączenia. Drugim podejściem jest wykorzystanie tych samych bibliotek klienta usługi Service Bus, których używasz do wysyłania i odbierania komunikatów. Biblioteki klienckie udostępniają również interfejsy API ułatwiające zarządzanie kolejkami, tematami, subskrypcjami i regułami w istniejącej przestrzeni nazw. Mają one obsługę uwierzytelniania za pomocą parametry połączenia. Podczas podejmowania decyzji o tym, które podejście należy podjąć, należy wziąć pod uwagę następujące kwestie.

Biblioteki oparte na usłudze Azure Resource Manager oferują takie same funkcje jak witryna Azure Portal, interfejs wiersza polecenia i program PowerShell, jeśli chodzi o zarządzanie przestrzeniami nazw i jednostkami usługi Service Bus, takimi jak kolejki, tematy, subskrypcje itp. Jeśli używasz witryny Azure Portal, interfejsu wiersza polecenia lub programu PowerShell dla operacji zarządzania i chcesz, aby był to dynamiczny sposób, te biblioteki mogą być lepszym wyborem dla Ciebie.

Jeśli jednak używasz już biblioteki klienta usługi Service Bus na potrzeby operacji specyficznych dla usługi, takich jak wysyłanie i odbieranie komunikatów, a także zarządzanie jednostkami usługi Service Bus, użycie tej samej biblioteki może być dla Ciebie wygodniejsze. Biblioteki klienckie mają bibliotekę ServiceBusAdministrationClient (nazywaną ServiceBusManagementClient w starszych bibliotekach), która udostępnia podzbiór funkcji zarządzania udostępnianych przez biblioteki oparte na usłudze Azure Resource Manager. Należy podkreślić, że chociaż biblioteki oparte na usłudze Azure Resource Manager umożliwiają zarządzanie przestrzeniami nazw i jednostkami usługi Service Bus, biblioteki klienckie umożliwiają zarządzanie jednostkami w istniejącej przestrzeni nazw, ale nie samą przestrzenią nazw.

Zarządzanie przy użyciu bibliotek opartych na usłudze Azure Resource Manager

Biblioteki oparte na usłudze Azure Resource Manager umożliwiają zarządzanie przestrzeniami nazw, kolejkami, tematami, subskrypcjami, regułami i zasadami sygnatur dostępu współdzielonego. Obsługują one uwierzytelnianie tylko za pomocą identyfikatora Entra firmy Microsoft. Nie obsługują one parametry połączenia.

Język Pakiet Dokumentacja Przykłady
.NET Azure.ResourceManager.ServiceBus Dokumentacja interfejsu API dla biblioteki Microsoft.Azure.Management.ServiceBus .NET
Java azure-resourcemanager-servicebus Dokumentacja interfejsu API dla com.azure.resourcemanager.servicebus Java
JavaScript @azure/arm-servicebus API reference for @azure/arm-servicebus
Python azure-mgmt-servicebus Dokumentacja interfejsu API dla narzędzia azure-mgmt-servicebus

Biblioteki Fluent .NET i Java

Istnieje wersja Fluent bibliotek opartych na usłudze Azure Resource Manager.

Język Pakiet Dokumentacja
.NET Microsoft.Azure.Management.ServiceBus.Fluent Dokumentacja interfejsu API dla microsoft.Azure.Management.ServiceBus.Fluent
Java azure-resourcemanager-servicebus Dokumentacja interfejsu API dla com.azure.resourcemanager.servicebus.fluent

Zarządzanie przy użyciu bibliotek klienckich usługi Service Bus

Biblioteki klienta usługi Service Bus, które są używane do wykonywania operacji, takich jak wysyłanie i odbieranie komunikatów, mogą również służyć do zarządzania kolejkami, tematami, subskrypcjami i regułami w istniejącej przestrzeni nazw usługi Service Bus. Ta funkcja jest dostępna za pośrednictwem ServiceBusAdministrationClient najnowszych bibliotek i bibliotek ServiceBusManagementClient w starszych bibliotekach. Zdecydowanie zaleca się używanie najnowszych bibliotek.

Najnowsze biblioteki usługi Service Bus

Język Pakiet Dokumentacja Przykłady
.NET Azure.Messaging.ServiceBus ServiceBus Administracja istrationClient .NET
Java azure-messaging-servicebus ServiceBus Administracja istrationAsyncClient, ServiceBus Administracja istrationClient Java
JavaScript @azure/service-bus ServiceBus Administracja istrationClient JavaScript TypeScript/
Python azure-servicebus ServiceBus Administracja istrationClient Python

Starsze biblioteki usługi Service Bus

Język Pakiet Dokumentacja Przykłady
.NET Microsoft.Azure.ServiceBus ManagementClient .NET
Java azure-mgmt-servicebus ManagementClientAsync, ManagementClient Java

30 września 2026 r. wycofamy biblioteki zestawu SDK usługi Azure Service Bus WindowsAzure.ServiceBus, Microsoft.Azure.ServiceBus i com.microsoft.azure.servicebus, które nie są zgodne z wytycznymi dotyczącymi zestawu Azure SDK. Zakończymy również obsługę protokołu SBMP, więc nie będzie można już używać tego protokołu po 30 września 2026 r. Przeprowadź migrację do najnowszych bibliotek zestawu Azure SDK, które oferują krytyczne aktualizacje zabezpieczeń i ulepszone możliwości przed tą datą.

Mimo że starsze biblioteki mogą być nadal używane poza 30 września 2026 r., nie będą już otrzymywać oficjalnej pomocy technicznej i aktualizacji od firmy Microsoft. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu pomocy technicznej.

Następne kroki

  • Wysyłanie komunikatów do kolejki i odbieranie ich z kolejki przy użyciu najnowszej biblioteki usługi Service Bus: .NET, Java, JavaScript, Python
  • Wysyłanie komunikatów do tematu i odbieranie komunikatów z subskrypcji przy użyciu najnowszej biblioteki usługi Service Bus: .NET, Java, JavaScript, Python