.NET 用Azure Service Bus管理クライアント ライブラリ - バージョン 1.0.0
このパッケージは、直感的な Azure ID ライブラリ、カスタム ポリシーを含む HTTP パイプライン、エラー処理、分散トレースなど、すべての Azure SDK で共有される多くのコア機能を提供する 新しい Azure SDK ガイドライン に従っています。
作業の開始
パッケージをインストールする
NuGet を使用して .NET 用のAzure Service Bus管理ライブラリをインストールします。
dotnet add package Azure.ResourceManager.ServiceBus
[前提条件]
Azure ID を使用して Azure に対して認証する方法を設定します。
次のようなオプションがあります。
- Azure CLI ログインを使用します。
- Visual Studio を使用します。
- 環境変数の設定。
詳細情報と 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";
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
AzureLocation location = AzureLocation.EastUS2;
ServiceBusNamespaceResource serviceBusNamespace = (await namespaceCollection.CreateOrUpdateAsync(WaitUntil.Completed, namespaceName, new ServiceBusNamespaceData(location))).Value;
リソース グループ内のすべての名前空間を取得する
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
await foreach (ServiceBusNamespaceResource serviceBusNamespace in namespaceCollection.GetAllAsync())
{
Console.WriteLine(serviceBusNamespace.Id.Name);
}
名前空間を取得する
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
ServiceBusNamespaceResource serviceBusNamespace = await namespaceCollection.GetAsync("myNamespace");
Console.WriteLine(serviceBusNamespace.Id.Name);
名前空間を削除する
ServiceBusNamespaceCollection namespaceCollection = resourceGroup.GetServiceBusNamespaces();
ServiceBusNamespaceResource serviceBusNamespace = await namespaceCollection.GetAsync("myNamespace");
await serviceBusNamespace.DeleteAsync(WaitUntil.Completed);
より詳細な例については、サンプルを用意していますので、ご覧ください。
トラブルシューティング
次のステップ
Azure SDK の詳細については、こちらの Web サイトを参照してください
共同作成
このリポジトリへの投稿の詳細については、 投稿ガイドを参照してください。
このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。
pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 これは、CLA を使用するすべてのリポジトリで 1 回だけ行う必要があります。
このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。
Azure SDK for .NET