biblioteca de clientes do gerenciamento de Barramento de Serviço do Azure para .NET – versão 1.0.0

Artigo
04/18/2023

Esse pacote segue as novas diretrizes do SDK do Azure que fornecem uma série de recursos principais que são compartilhados entre todos os SDKs do Azure, incluindo a biblioteca intuitiva do Azure Identity, um Pipeline HTTP com políticas personalizadas, tratamento de erros, rastreamento distribuído e muito mais.

Introdução

Instalar o pacote

Instale a biblioteca de gerenciamento do Barramento de Serviço do Azure para .NET com o NuGet:

dotnet add package Azure.ResourceManager.ServiceBus

Pré-requisitos

Configure uma maneira de autenticar no Azure com o Azure Identity.

Algumas opções são:

Por meio do Logon da CLI do Azure.
Por meio do Visual Studio.
Definindo variáveis de ambiente.

Mais informações e diferentes abordagens de autenticação usando o Azure Identity podem ser encontradas neste documento.

Autenticar o cliente

A opção padrão para criar um cliente autenticado é usar DefaultAzureCredential. Como todas as APIs de gerenciamento passam pelo mesmo endpoint, para interagir com recursos, apenas um ArmClient de nível superior precisa ser criado.

Para autenticar no Azure e criar um ArmClient, faça o seguinte:

using Azure.Identity;

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

Documentação adicional para a Azure.Identity.DefaultAzureCredential classe pode ser encontrada neste documento.

Principais conceitos

Os principais conceitos do SDK do .NET do Azure podem ser encontrados aqui

Documentação

A documentação está disponível para ajudá-lo a aprender a usar este pacote

Exemplos

Criar um namespace

Antes de criar um namespace, precisamos ter um 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;

Em seguida, podemos criar um namespace dentro desse 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;

Obter todos os namespaces em um grupo de recursos

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

Obter um namespace

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

Excluir um namespace

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

Para exemplos mais detalhados, dê uma olhada nos exemplos que temos disponíveis.

Solução de problemas

Registrar um problema por meio de problemas do Github
Verifique as perguntas anteriores ou faça novas no Stack Overflow usando as marcas azure e .net.

Próximas etapas

Para obter mais informações sobre o SDK do Azure, consulte este site

Participante

Para obter detalhes sobre como contribuir para esse repositório, consulte o guia de contribuição.

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite https://cla.microsoft.com.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios usando nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Compartilhar via