Librerie di gestione di Hub eventiEvent Hubs management libraries

Le librerie di gestione di Hub eventi possono effettuare il provisioning di entità e spazi dei nomi di Hub eventi in modo dinamico,The Event Hubs management libraries can dynamically provision Event Hubs namespaces and entities. per consentire distribuzioni complesse e scenari di messaggistica e permettere di determinare a livello di codice le entità di cui effettuare il provisioning.This enables complex deployments and messaging scenarios, so that you can 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 Hub eventiEvent Hubs creation, update, deletion
  • Creazione, aggiornamento, eliminazione di gruppi di consumerConsumer Group creation, update, deletion

PrerequisitiPrerequisites

Per iniziare a usare le librerie di gestione di Hub eventi, è necessario eseguire l'autenticazione con Azure Active Directory (AAD).To get started using the Event Hubs management libraries, you must authenticate with Azure Active Directory (AAD). 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 avere 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 want to run.

Modello di programmazioneProgramming pattern

Il modello di modifica delle risorse di Hub eventi segue un protocollo comune:The pattern to manipulate any Event Hubs resource follows a common protocol:

  1. Ottenere un token da AAD usando la libreria Microsoft.IdentityModel.Clients.ActiveDirectory.Obtain a token from AAD 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 EventHubManagementClient.Create the EventHubManagementClient object.

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

    var ehParams = new EventHubCreateOrUpdateParameters()
    {
        Location = SettingsCache["DataCenterLocation"]
    };
    
  4. Effettuare la chiamata.Execute the call.

    await ehClient.EventHubs.CreateOrUpdateAsync(resourceGroupName, namespaceName, EventHubName, ehParams);
    

Passaggi successiviNext steps