クイック スタート: 検証済みのメール ドメインを接続する方法

  • [アーティクル]

このクイック スタートでは、メールを送信するために、検証済みドメインを Azure Communication Services で接続する方法について説明します。

前提条件

メール ドメインを Communication Service リソースに接続する

  1. Azure Communication Service リソースの概要ページの左ナビゲーション パネルで、[メール] の下にある [ドメイン] をクリックします。

    メール ドメインをリンクするための左側のナビゲーション パネルを示すスクリーンショット。

  2. 次のいずれかのオプションを選択します

    • 上部ナビゲーション バーで [Connect domain] (ドメインの接続) をクリックします。

    • スプラッシュ スクリーンで [Connect domain] (ドメインの接続) をクリックします。

      確認済みのメール ドメインの 1 つを接続する方法を示すスクリーンショット。

  3. フィルター処理によって検証済みドメインのいずれかを選択します

    • サブスクリプション
    • リソース グループ
    • メール サービス
    • 検証済みドメイン

    接続する確認済みメール ドメインの 1 つをフィルター処理して選択する方法を示すスクリーンショット。

Note

地理的な場所が同じドメインの接続のみが許可されます。 リソースの作成時に選択された通信リソースとメール通信リソースのデータの場所が同じであることを確認してください。

  1. [接続] をクリック

    確認済みのメール ドメインのいずれかが接続されたことを示すスクリーンショット。

Communication Service リソースからメール ドメインを接続解除する

  1. Azure Communication Service リソースの概要ページの左ナビゲーション パネルで、[メール] の下にある [ドメイン] をクリックします。

  2. 接続されているドメインを選択し、[...] をクリックし、[接続解除] をクリックします。

    接続されているドメインを切断する方法を示すスクリーンショット。

前提条件

メール ドメインを Communication Service リソースに接続する

サンプル要求の {subscription-id}、{resource-group-name}、{communication-services-resource-name}、および {linked-domain-resource-id} を置き換えます。

リンクされたドメイン リソース ID は、次の形式にする必要があります。

/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/emailServices/{email-service-name}/domains/{domain-name}

Azure マネージド ドメインを使用している場合、domain-name は "AzureManagedDomain" です。 email-service-name は、ドメインのプロビジョニングに使用したのと同じメール サービスである必要があります。

これらの値が設定されたら、次の要求 URL と本文を使用して PATCH 要求を行います。

https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/CommunicationServices/{communication-services-resource-name}?api-version=2023-03-31

{
    "properties": {
        "linkedDomains": ["{linked-domain-resource-id}"]
    }
}

Communication Service リソースからメール ドメインを接続解除する

サンプル要求の {subscription-id}、{resource-group-name}、および {communication-services-resource-name} を置き換えます。

これらの値が設定されたら、次の要求 URL と本文を使用して PATCH 要求を行います。

https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/CommunicationServices/{communication-services-resource-name}?api-version=2023-03-31

{
    "properties": {
        "linkedDomains": []
    }
}

前提条件

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

dotnet add package Azure.ResourceManager.Communication

管理クライアントを初期化する

環境変数 AZURE_SUBSCRIPTION_ID には、ドメインとメール リソースが含まれるサブスクリプションのサブスクリプション ID を設定します。 コード サンプルを実行して、管理クライアントを初期化します。

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Compute;
using Azure.ResourceManager.Resources;

ArmClient client = new ArmClient(new DefaultAzureCredential());

メール ドメインを Communication Service リソースに接続する

サンプル コードの <subscription-id>、<resource-group-name>、<azure-communication-services-resource-name>、および <linked-domain-resource-id> を置き換えます。

リンクされたドメイン リソース ID は、次の形式にする必要があります。

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Azure マネージド ドメインを使用している場合、domain-name は "AzureManagedDomain" です。 email-service-name は、ドメインのプロビジョニングに使用したのと同じメール サービスである必要があります。

これらの値が設定されたら、サンプル コードを実行します。

ResourceIdentifier communicationServiceResourceId = CommunicationServiceResource.CreateResourceIdentifier("<subscription-id>", "<resource-group-name>", "<azure-communication-services-resource-name>");
CommunicationServiceResource communicationServiceResource = client.GetCommunicationServiceResource(communicationServiceResourceId);

CommunicationServiceResourcePatch patch = new CommunicationServiceResourcePatch()
{
    LinkedDomains =
    {
        "<linked-domain-resource-id>",
    },
};
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);

Communication Service リソースからメール ドメインを接続解除する

サンプル コードの <subscription-id>、<resource-group-name>、および <azure-communication-services-resource-name> を置き換えます。

これらの値が設定されたら、サンプル コードを実行します。

ResourceIdentifier communicationServiceResourceId = CommunicationServiceResource.CreateResourceIdentifier("<subscription-id>", "<resource-group-name>", "<azure-communication-services-resource-name>");
CommunicationServiceResource communicationServiceResource = client.GetCommunicationServiceResource(communicationServiceResourceId);

CommunicationServiceResourcePatch patch = new CommunicationServiceResourcePatch();
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);

前提条件

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

npm install @azure/arm-communication
npm install @azure/identity

管理クライアントを初期化する

サンプル コードの フィールドを、ドメインと電子メール リソースが含まれるサブスクリプションのサブスクリプション ID に置き換えます。 コード サンプルを実行して、管理クライアントを初期化します。

const { CommunicationServiceManagementClient } = require("@azure/arm-communication");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();
const subscriptionId = "<your-subscription-id>";

client = new CommunicationServiceManagementClient(credential, subscriptionId);

メール ドメインを Communication Service リソースに接続する

サンプル コードの <resource-group-name>、<azure-communication-services-resource-name>、および <linked-domain-resource-id> を置き換えます。

リンクされたドメイン リソース ID は、次の形式にする必要があります。

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Azure マネージド ドメインを使用している場合、domain-name は "AzureManagedDomain" です。 email-service-name は、ドメインのプロビジョニングに使用したのと同じメール サービスである必要があります。

これらの値が設定されたら、サンプル コードを実行します。

const parameters = {
    dataLocation: "United States",
    location: "Global",
    linkedDomains: [
        "<linked-domain-resource-id>"
    ]
};

const result = await client.communicationServices.beginCreateOrUpdateAndWait(
    "<resource-group-name>",
    "<azure-communication-services-resource-name>",
    parameters
);

Communication Service リソースからメール ドメインを接続解除する

サンプル コードの <resource-group-name>、および <azure-communication-services-resource-name> を置き換えます。

これらの値が設定されたら、サンプル コードを実行します。

const parameters = {
    dataLocation: "United States",
    location: "Global"
};

const result = await client.communicationServices.beginCreateOrUpdateAndWait(
    "<resource-group-name>",
    "<azure-communication-services-resource-name>",
    parameters
);

前提条件

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

次の依存関係を pom.xml に追加します。

<dependency>
    <groupId>com.azure.resourcemanager</groupId>
    <artifactId>azure-resourcemanager-communication</artifactId>
    <version>2.0.0</version>
</dependency>

管理クライアントを初期化する

環境変数 AZURE_SUBSCRIPTION_ID には、ドメインとメール リソースが含まれるサブスクリプションのサブスクリプション ID を設定します。 コード サンプルを実行して、管理クライアントを初期化します。

AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
TokenCredential credential = new DefaultAzureCredentialBuilder()
    .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
    .build();
CommunicationManager manager = CommunicationManager
    .authenticate(credential, profile);

メール ドメインを Communication Service リソースに接続する

サンプル コードの <resource-group-name>、<azure-communication-services-resource-name>、および <linked-domain-resource-id> を置き換えます。

リンクされたドメイン リソース ID は、次の形式にする必要があります。

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Azure マネージド ドメインを使用している場合、domain-name は "AzureManagedDomain" です。 email-service-name は、ドメインのプロビジョニングに使用したのと同じメール サービスである必要があります。

これらの値が設定されたら、サンプル コードを実行します。

List<String> linkedDomains = new ArrayList<>();
linkedDomains.add("<linked-domain-resource-id>") 

manager
    .communicationServices()
    .define("<azure-communication-services-resource-name>")
    .withRegion("Global")
    .withExistingResourceGroup("<resource-group-name>")
    .withDataLocation("United States")
    .withLinkedDomains(linkedDomains)
    .create();

Communication Service リソースからメール ドメインを接続解除する

サンプル コードの <resource-group-name>、および <azure-communication-services-resource-name> を置き換えます。

これらの値が設定されたら、サンプル コードを実行します。

manager
    .communicationServices()
    .define("<azure-communication-services-resource-name>")
    .withRegion("Global")
    .withExistingResourceGroup("<resource-group-name>")
    .withDataLocation("United States")
    .create();

前提条件

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

pip install azure-mgmt-communication
pip install azure-identity

管理クライアントを初期化する

サンプル コードの フィールドを、ドメインと電子メール リソースが含まれるサブスクリプションのサブスクリプション ID に置き換えます。 コード サンプルを実行して、管理クライアントを初期化します。

from azure.mgmt.communication import CommunicationServiceManagementClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>"

client = CommunicationServiceManagementClient(credential, subscription_id)

メール ドメインを Communication Service リソースに接続する

サンプル コードの <resource-group-name>、<azure-communication-services-resource-name>、および <linked-domain-resource-id> を置き換えます。

リンクされたドメイン リソース ID は、次の形式にする必要があります。

/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>

Azure マネージド ドメインを使用している場合、domain-name は "AzureManagedDomain" です。 email-service-name は、ドメインのプロビジョニングに使用したのと同じメール サービスである必要があります。

これらの値が設定されたら、サンプル コードを実行します。


response = client.communication_services.begin_create_or_update(
    resource_group_name="<resource-group-name>",
    communication_service_name="<azure-communication-services-resource-name>",
    parameters={
        "location": "Global",
        "properties": {
            "dataLocation": "United States",
            "linkedDomains": [
                "<linked-domain-resource-id>"
            ],
        }
    },
).result()

Communication Service リソースからメール ドメインを接続解除する

サンプル コードの <resource-group-name>、および <azure-communication-services-resource-name> を置き換えます。

これらの値が設定されたら、サンプル コードを実行します。


response = client.communication_services.begin_create_or_update(
    resource_group_name="<resource-group-name>",
    communication_service_name="<azure-communication-services-resource-name>",
    parameters={
        "location": "Global",
        "properties": {
            "dataLocation": "United States"
        }
    },
).result()

次の手順