Librerie di gestione del bus di servizioService Bus management libraries

Le librerie di gestione del bus di servizio di Azure possono eseguire il provisioning di entità e spazi dei nomi del bus di servizio in modo dinamico,The Azure Service Bus management libraries can dynamically provision Service Bus namespaces and entities. per consentire distribuzioni complesse e scenari di messaggistica e permettere di determinare a livello di codice le entità di cui eseguire il provisioning.This enables complex deployments and messaging scenarios, and makes it possible to programmatically determine what entities to provision. Queste librerie sono attualmente disponibili per .NET.These libraries are currently available for .NET.

Funzionalità supportateSupported functionality

  • Creazione, aggiornamento, eliminazione di spazi dei nomiNamespace creation, update, deletion
  • Creazione, aggiornamento, eliminazione di codeQueue creation, update, deletion
  • Creazione, aggiornamento, eliminazione di argomentiTopic creation, update, deletion
  • Creazione, aggiornamento, eliminazione di sottoscrizioniSubscription creation, update, deletion

PrerequisitiPrerequisites

Per iniziare a usare le librerie di gestione del bus di servizio, è necessario eseguire l'autenticazione con il servizio Azure Active Directory (AAD).To get started using the Service Bus management libraries, you must authenticate with the Azure Active Directory (AAD) service. AAD richiede l'autenticazione come entità servizio, che fornisce l'accesso alle risorse di Azure in uso.AAD requires that you authenticate as a service principal, which provides access to your Azure resources. Per informazioni su come creare un'entità servizio, vedere uno di questi articoli:For information about creating a service principal, see one of these articles:

Nel corso di queste esercitazioni vengono forniti un AppId (ID client), un TenantId e un ClientSecret (chiave di autenticazione) che sono usati per l'autenticazione da parte delle librerie di gestione.These tutorials provide you with an AppId (Client ID), TenantId, and ClientSecret (authentication key), all of which are used for authentication by the management libraries. È necessario disporre delle autorizzazioni di Proprietario per il gruppo di risorse in cui verranno eseguite le librerie.You must have Owner permissions for the resource group on which you wish to run.

Modello di programmazioneProgramming pattern

Il modello di modifica delle risorse del bus di servizio segue un protocollo comune:The pattern to manipulate any Service Bus resource follows a common protocol:

  1. Ottenere un token da Azure Active Directory usando la libreria Microsoft.IdentityModel.Clients.ActiveDirectory.Obtain a token from Azure Active Directory using the Microsoft.IdentityModel.Clients.ActiveDirectory library.

    var context = new AuthenticationContext($"https://login.microsoftonline.com/{tenantId}");
    
    var result = await context.AcquireTokenAsync("https://management.core.windows.net/", new ClientCredential(clientId, clientSecret));
    
  2. Creare l'oggetto ServiceBusManagementClient.Create the ServiceBusManagementClient object.

    var creds = new TokenCredentials(token);
    var sbClient = new ServiceBusManagementClient(creds)
    {
        SubscriptionId = SettingsCache["SubscriptionId"]
    };
    
  3. Impostare i parametri CreateOrUpdate sui valori specificati.Set the CreateOrUpdate parameters to your specified values.

    var queueParams = new QueueCreateOrUpdateParameters()
    {
        Location = SettingsCache["DataCenterLocation"],
        EnablePartitioning = true
    };
    
  4. Effettuare la chiamata.Execute the call.

    await sbClient.Queues.CreateOrUpdateAsync(resourceGroupName, namespaceName, QueueName, queueParams);
    

Passaggi successiviNext steps