.NET 用Azure Event Hubs管理クライアント ライブラリ - バージョン 1.0.0

  • [アーティクル]

このパッケージは、直感的な Azure IDENTITy ライブラリ、カスタム ポリシーを含む HTTP パイプライン、エラー処理、分散トレースなど、すべての Azure SDK で共有される多くのコア機能を提供する 新しい Azure SDK ガイドライン に従っています。

作業の開始

パッケージをインストールする

NuGet を使用して .NET 用のAzure Event Hubs管理ライブラリをインストールします。

dotnet add package Azure.ResourceManager.EventHubs

[前提条件]

Azure ID を使用して Azure に対して認証する方法を設定します。

次のようなオプションがあります。

詳細情報と Azure ID を使用したさまざまな認証方法については、こちらのドキュメントを参照してください。

クライアントを認証する

認証されたクライアントを作成するための既定のオプションは、DefaultAzureCredential を使用することです。 すべての管理 API は同じエンドポイントを通過するため、リソースを操作するには、1 つの最上位レベル 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 の詳細については、こちらの Web サイトを参照してください。

共同作成

このリポジトリへの投稿の詳細については、 投稿ガイドを参照してください。

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 これは、CLA を使用するすべてのリポジトリで 1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。