Communication Services リソースを作成する

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。

電話番号を使用する予定がある場合は、無料試用版アカウントを使用することはできません。 リソースを作成する前に電話番号を購入する予定の場合は、サブスクリプションがすべての要件を満たしていることを確認します。

Azure portal を使用して Azure Communication Services リソースを作成する

Azure Communication Services のリソースを作成するには、まず Azure portal にサインインします。 ページの左上にある [+ リソースの作成] を選択します。

「Communication」をマーケットプレイスを検索入力欄またはポータルの上部にある検索バーに入力してください。

結果から [Communication Services] を選択し、 [作成] を選択します。

これで、Communication Services のリソースを構成できます。 作成プロセスの最初のページで、次を指定する必要があります。

• サブスクリプション。
• リソース グループ (新しい リソース グループ を作成することも、既存のリソース グループを選択することもできます)。
• Communication Services リソースの名前。
• リソースに関連付けられている地理。

次の手順では、リソースにタグを割り当てることができます。 タグを使用して、Azure リソースを整理できます。 タグについて詳しくは、「タグを使用して Azure リソースと整理階層を整理する」をご覧ください。

最後に、構成を確認し、[ 作成 ] をクリックしてリソースをデプロイします。 デプロイが完了するまでに数分かかる場合があります。

Communication Services のリソースを管理する

Communication Services のリソースを管理するには、Azure portal にサインインして、Azure Communication Services を検索して選択します。

[Communication Services] ページで、リソースの名前を選択します。

リソースの [概要] ページには、参照、停止、開始、再起動、削除などの基本的な管理のためのオプションが含まれています。 その他の構成オプションについては、リソース ページの左側のメニューをご覧ください。

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
• Azure CLI インストールします。

電話番号の使用を計画している場合は、無料試用版アカウントを使用することはできません。 リソースを作成する前に電話番号を購入する予定の場合は、サブスクリプションがすべての要件を満たしていることを確認します。

Azure CLI を使用して Azure Communication Services リソースを作成する

Azure Communication Services のリソースを作成するには、Azure CLI にサインインします。 サインインするには、ターミナルから az login コマンドを実行して資格情報を指定します。

リソースを作成するには、次のコマンドを実行します:

az communication create --name "<acsResourceName>" --___location "Global" --data-___location "United States" --resource-group "<resourceGroup>"

特定のサブスクリプションを選択したい場合は、--subscription フラグを指定してサブスクリプション ID を指定することもできます。

az communication create --name "<acsResourceName>" --___location "Global" --data-___location "United States" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

以下のオプションを使用して、Communication Services のリソースを構成できます。

• リソース グループ
• Communication Services のリソースの名前
• リソースが関連付けられている地域

次の手順では、リソースにタグを割り当てることができます。 タグを使用して、Azure リソースを整理できます。 タグについて詳しくは、「タグを使用して Azure リソースと整理階層を整理する」をご覧ください。

Communication Services のリソースを管理する

Communication Services のリソースにタグを追加するには、以下のコマンドを実行します。 また、特定のサブスクリプションを対象にすることもできます。

az communication update --name "<communicationName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"

az communication update --name "<communicationName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

その他のコマンドについては、Azure Communication CLI を参照してください。

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
• お使いのオペレーティング システムに対応した最新バージョンの .NET Core SDK。
• .NET Identity SDK の最新バージョンを取得します。
• .NET Management SDK の最新バージョンを取得します。

電話番号を使用する予定の場合、無料試用版アカウントは使用できません。 リソースを作成する前に電話番号を購入する予定の場合は、サブスクリプションがすべての要件を満たしていることを確認します。

SDK をインストールする

まず、Communication Services Management SDK を C# プロジェクトにインクルードします。

using Azure.ResourceManager.Communication;

サブスクリプション ID

Azure サブスクリプションの ID を把握しておく必要があります。 ポータルからサブスクリプション ID を取得します。

1. Azure portal でアカウントにサインインします。
2. 左側のサイドバーで、[サブスクリプション] を選択します。
3. 使用するサブスクリプションを選択します。
4. [Overview] をクリックします。
5. サブスクリプションIDを選択します。

例を機能させるには、サブスクリプション ID を AZURE_SUBSCRIPTION_ID という環境変数に格納する必要があります。

認証

Azure Communication Services と通信するには、まず Azure に対して自分自身を認証する必要があります。 これは、サービス プリンシパル ID を使用して認証できます。

オプション 1: マネージド ID

コードが Azure のサービスとして実行されている場合、最も簡単な認証方法は、Azure からマネージド ID を取得することです。 詳細については、以下を参照してください:

• マネージド ID の概要。

• マネージド ID をサポートする Azure サービス。

• App Service と Azure Functions のマネージド ID を使用する方法。

システムによって割り当てられたマネージド アイデンティティ

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var acsClient = new CommunicationManagementClient(subscriptionId, new ManagedIdentityCredential());

ユーザー割り当てのマネージド アイデンティティ

作成したマネージド ID の ClientId は、明示的に ManagedIdentityCredential に渡す必要があります。

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var managedIdentityCredential = new ManagedIdentityCredential("AZURE_CLIENT_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, managedIdentityCredential);

オプション 2: サービス プリンシパル

マネージド ID を使用する代わりに、管理するサービス プリンシパルを使用して Azure に対する認証を行うことができます。 詳細については、Microsoft Entra ID でのサービス プリンシパルの作成と管理に関する記事を参照してください。

サービス プリンシパルを作成したら、それに関する次の情報を Azure portal から収集する必要があります。

• クライアント ID
• クライアント シークレット
• テナント ID

これらの値をそれぞれ、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET、AZURE_TENANT_ID という名前の環境変数に格納します。 その後、次のような Communication Services 管理クライアントを作成できます。

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, new EnvironmentCredential());

オプション 3:ユーザー ID

サービス ID を使用するのではなく、対話ユーザーの代わりに Azure を呼び出す場合は、次のコードを使用して Azure Communication Services 管理クライアントを作成できます。 これにより、ブラウザー ウィンドウが開き、ユーザーに MSA または Microsoft Entra 資格情報の入力を求めるダイアログが表示されます。

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var communicationServiceClient = new CommunicationManagementClient(subscriptionId, new InteractiveBrowserCredential());

Communication Services リソースの管理

Azure リソースを操作する

認証が完了したら、管理クライアントを使用して API 呼び出しを行うことができます。

次の各例では、Communication Services リソースを既存のリソース グループに割り当てます。

リソース グループを作成する必要がある場合は、 Azure portal または Azure Resource Manager SDK を使用できます。

Communication Services リソースを作成して管理する

Communication Services Management SDK クライアント (Azure.ResourceManager.Communication.CommunicationManagementClient) インスタンスを使用して、Communication Services リソースに対する操作を実行できます。

Communication Services リソースを作成する

Communication Services リソースを作成するときは、リソース グループ名とリソース名を指定します。 Location プロパティは常に global であり、パブリック プレビュー中は、DataLocation 値を UnitedStates にする必要があります。

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates"  };
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Communication Services リソースを更新する

...
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates" };
resource.Tags.Add("environment","test");
resource.Tags.Add("department","tech");
// Use existing resource name and new resource object
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Communication Services リソースをすべて一覧表示する

var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
    Console.WriteLine(resource.Name);
}

Communication Services リソースを削除する

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);

キーと接続文字列の管理

すべての Communication Services リソースには、アクセスキーと対応する接続文字列のペアがあります。 他の Communication Services SDK が Azure Communication Services で認証できるようにするために、これらのキーにアクセスして使用可能にするには、Management SDK を使用します。

Communication Services リソースのアクセス キーを取得する

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keys = await acsClient.CommunicationService.ListKeysAsync(resourceGroupName, resourceName);

Console.WriteLine(keys.Value.PrimaryConnectionString);
Console.WriteLine(keys.Value.SecondaryConnectionString);

Communication Services リソースのアクセス キーを再生成する

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keyParams = new RegenerateKeyParameters { KeyType = KeyType.Primary };
var keys = await acsClient.CommunicationService.RegenerateKeyAsync(resourceGroupName, resourceName, keyParams);

Console.WriteLine(keys.Value.PrimaryKey);

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
• Azure Az PowerShell モジュールをインストールします。

電話番号の使用を計画している場合は、無料試用版アカウントを使用することはできません。 リソースを作成する前に電話番号を購入する予定の場合は、サブスクリプションがすべての要件を満たしていることを確認します。

PowerShell を使用して Azure Communication Services リソースを作成する

Azure Communication Services のリソースを作成するには、Azure CLI にサインインします。 ターミナル経由でリソースを作成するには、Connect-AzAccount コマンドを実行して、資格情報を入力します。

まず、次のコマンドを実行して、Azure Communication Services モジュール Az.Communication をインストールします。

PS C:\> Install-Module Az.Communication

リソースを作成するには、次のコマンドを実行します:

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global

特定のサブスクリプションを選択したい場合は、--subscription フラグを指定してサブスクリプション ID を指定することもできます。

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -SubscriptionId SubscriptionID

以下のオプションを使用して、Communication Services のリソースを構成できます。

• リソース グループ
• Communication Services のリソースの名前
• リソースに関連付ける地域

次の手順では、リソースにタグを割り当てることができます。 タグを使用して、Azure リソースを整理できます。 詳細については、「タグを使用して Azure リソースと整理階層を整理する」を参照してください。

Communication Services のリソースを管理する

Communication Services のリソースにタグを追加するには、以下のコマンドを実行します。 また、特定のサブスクリプションを対象にすることもできます。

PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}

PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID

特定のサブスクリプションの Azure Communication Services リソースをすべて一覧表示するには、次のコマンドを使用します。

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

特定のリソースの情報をすべて一覧表示するには、次のコマンドを使用します。

PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1