Biblioteca de clientes do Gerenciamento de Hubs de Eventos do Azure para .NET – versão 1.0.0

Artigo
10/05/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 intuitiva biblioteca de Identidade do Azure, 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 dos Hubs de Eventos do Azure para .NET com o NuGet:

dotnet add package Azure.ResourceManager.EventHubs

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.
Configurando 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

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";
EventHubsNamespaceCollection namespaceCollection = resourceGroup.GetEventHubsNamespaces();
AzureLocation location = AzureLocation.EastUS2;
EventHubsNamespaceResource eventHubNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new EventHubsNamespaceData(location))).Value;

Obter todos os namespaces em um grupo de recursos

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

Obter um namespace

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

Excluir um namespace

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

Adicionar uma marca ao namespace

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

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

Solução de problemas

Se você encontrar um bug ou tiver uma sugestão, registre um problema por meio de problemas do GitHub e adicione o rótulo "Versão prévia" ao problema.
Se você precisar de ajuda, marcar perguntas anteriores ou faça novas no StackOverflow usando marcas do azure e do .NET.
Se tiver problemas com a autenticação, acesse a documentação DefaultAzureCredential

Próximas etapas

Mais códigos de exemplo

Gerenciando EventHubs

Documentação Adicional

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.