你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 .NET 的 Azure 事件中心 管理客户端库 - 版本 1.0.0

  • 项目

此包遵循 新的 Azure SDK 准则 ，该准则提供了许多在所有 Azure SDK 之间共享的核心功能，包括直观的 Azure 标识库、具有自定义策略的 HTTP 管道、错误处理、分布式跟踪等。

入门

安装包

使用 NuGet 安装适用于 .NET 的 Azure 事件中心 管理库：

dotnet add package Azure.ResourceManager.EventHubs

必备条件

设置一种使用 Azure 标识向 Azure 进行身份验证的方法。

一些选项包括：

有关使用 Azure 标识的详细信息和不同的身份验证方法，请参阅此文档。

对客户端进行身份验证

创建已经过身份验证的客户端的默认选项是使用 DefaultAzureCredential。 由于所有管理 API 都通过同一终结点，因此，若要与资源交互，只需创建一个顶级 ArmClient。

若要向 Azure 进行身份验证并创建 ArmClient，请执行下列操作：

using Azure.Identity;

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

有关 类的其他文档 Azure.Identity.DefaultAzureCredential ，可 在此文档中找到。

关键概念

可在此处找到 Azure .NET SDK 的关键概念

示例

创建命名空间

在创建命名空间之前，我们需要有一个资源组。

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;

然后，我们可以在此资源组中创建命名空间。

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

获取资源组中的所有命名空间

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

获取命名空间

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

删除命名空间

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

将标记添加到命名空间

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

有关更详细的示例，请查看我们提供的示例。

疑难解答

后续步骤

更多示例代码

其他文档

有关 Azure SDK 的详细信息，请参阅此网站。

贡献

有关参与此存储库的详细信息，请参阅 参与指南。

本项目欢迎贡献和建议。 大多数贡献要求你同意贡献者许可协议 (CLA)，并声明你有权（并且确实有权）授予我们使用你的贡献的权利。 有关详细信息，请访问 https://cla.microsoft.com 。

提交拉取请求时，CLA 机器人将自动确定你是否需要提供 CLA，并相应地修饰 PR（例如标签、注释）。 直接按机器人提供的说明操作。 只需使用 CLA 在所有存储库中执行此操作一次。

此项目采用了 Microsoft 开放源代码行为准则。 有关详细信息，请参阅行为准则常见问题解答，或如果有任何其他问题或意见，请与 联系。