biblioteca cliente de administración de Azure Event Hubs para .NET: versión 1.0.0

Artículo
10/05/2023

Este paquete sigue las nuevas directrices del SDK de Azure que proporcionan una serie de funcionalidades principales que se comparten entre todos los SDK de Azure, incluida la biblioteca intuitiva de identidades de Azure, una canalización HTTP con directivas personalizadas, control de errores, seguimiento distribuido y mucho más.

Introducción

Instalar el paquete

Instale la biblioteca de administración de Azure Event Hubs para .NET con NuGet:

dotnet add package Azure.ResourceManager.EventHubs

Requisitos previos

Configure una manera de autenticarse en Azure con Azure Identity.

Estas son algunas opciones:

A través del inicio de sesión de la CLI de Azure.
A través de Visual Studio.
Establecer variables de entorno.

Puede encontrar más información y diferentes enfoques de autenticación mediante Azure Identity en este documento.

Autenticar el cliente

La opción predeterminada para crear un cliente autenticado es usar DefaultAzureCredential. Dado que todas las API de administración pasan por el mismo punto de conexión, para interactuar con los recursos, solo se tiene que crear un ArmClient de nivel superior.

Para autenticarse en Azure y crear un ArmClient, haga lo siguiente:

using Azure.Identity;

ArmClient armClient = new ArmClient(new DefaultAzureCredential());

Puede encontrar documentación adicional para la Azure.Identity.DefaultAzureCredential clase en este documento.

Conceptos clave

Los conceptos clave del SDK de Azure .NET se pueden encontrar aquí.

Ejemplos

Creación de un espacio de nombres

Antes de crear un espacio de nombres, es necesario tener un grupo de recursos.

ArmClient armClient = new ArmClient(new DefaultAzureCredential());
SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();
string rgName = "myRgName";
AzureLocation location = AzureLocation.WestUS2;
ArmOperation<ResourceGroupResource> operation = await subscription.GetResourceGroups().CreateOrUpdateAsync(WaitUntil.Completed, rgName, new ResourceGroupData(location));
ResourceGroupResource resourceGroup = operation.Value;

A continuación, podemos crear un espacio de nombres dentro de este grupo de recursos.

string namespaceName = "myNamespace";
EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
AzureLocation location = AzureLocation.EastUS2;
EventHubsNamespaceResource eventHubNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new EventHubsNamespaceData(location))).Value;

Obtención de todos los espacios de nombres en un grupo de recursos

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
await foreach (EventHubsNamespaceResource eventHubNamespace in namespaceCollection.GetAllAsync())
{
    Console.WriteLine(eventHubNamespace.Id.Name);
}

Obtención de un espacio de nombres

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
EventHubsNamespaceResource eventHubNamespace = await namespaceCollection.GetAsync("myNamespace");
Console.WriteLine(eventHubNamespace.Id.Name);

Eliminación de un espacio de nombres

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
EventHubsNamespaceResource eventHubNamespace = await namespaceCollection.GetAsync("myNamespace");
await eventHubNamespace.DeleteAsync(WaitUntil.Completed);

Adición de una etiqueta al espacio de nombres

EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
EventHubsNamespaceResource eventHubNamespace = await namespaceCollection.GetAsync("myNamespace");
await eventHubNamespace.AddTagAsync("key","value");

Para obtener ejemplos más detallados, vea los ejemplos disponibles.

Solución de problemas

Si encuentra un error o tiene una sugerencia, abra un problema a través de problemas de GitHub y asegúrese de agregar la etiqueta "Versión preliminar" al problema.
Si necesita ayuda, consulte las preguntas anteriores o haga otras nuevas en StackOverflow con las etiquetas "azure" y ".NET".
Si tiene problemas con la autenticación, vaya a La documentación de DefaultAzureCredential.

Pasos siguientes

Más código de ejemplo

Administración de EventHubs

Documentación adicional

Para obtener más información sobre el SDK de Azure, consulte este sitio web.

Contribuciones

Para más información sobre cómo contribuir a este repositorio, consulte la guía de contribución.

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para más detalles, visite https://cla.microsoft.com.

Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo tendrá que hacerlo una vez en todos los repositorios mediante nuestra CLA.

Este proyecto ha adoptado el Código de conducta de Microsoft Open Source. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.

Compartir a través de