Compartir a través de

biblioteca cliente de administración de Azure Service Bus para .NET: versión 1.0.0

  • Artículo

Este paquete sigue las nuevas directrices del SDK de Azure que proporcionan una serie de funcionalidades básicas que se comparten entre todos los SDK de Azure, incluida la intuitiva biblioteca 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 Service Bus para .NET con NuGet:

dotnet add package Azure.ResourceManager.ServiceBus

Requisitos previos

Configure una manera de autenticarse en Azure con Azure Identity.

Estas son algunas opciones:

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

Autenticación del 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í.

Documentación

La documentación está disponible para ayudarle a aprender a usar este paquete.

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";
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
AzureLocation location = AzureLocation.EastUS2;
ServiceBusNamespaceResource serviceBusNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new ServiceBusNamespaceData(location))).Value;

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

ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
await foreach (ServiceBusNamespaceResource serviceBusNamespace in namespaceCollection.GetAllAsync())
{
    Console.WriteLine(serviceBusNamespace.Id.Name);
}

Obtención de un espacio de nombres

ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
ServiceBusNamespaceResource serviceBusNamespace = await namespaceCollection.GetAsync("myNamespace");
Console.WriteLine(serviceBusNamespace.Id.Name);

Eliminación de un espacio de nombres

ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
ServiceBusNamespaceResource serviceBusNamespace = await namespaceCollection.GetAsync("myNamespace");
await serviceBusNamespace.DeleteAsync(WaitUntil.Completed);

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

Solución de problemas

Pasos siguientes

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

Contribuir

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.