快速入門：如何連線已驗證的電子郵件網域

發行項
04/05/2024

在本快速入門中，您將瞭解如何連線 Azure 通訊服務中已驗證的網域以傳送電子郵件。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
準備布建網域的 Azure 電子郵件通訊服務資源。開始建立電子郵件通訊資源。
布建並準備好傳送電子郵件的 Azure 受控網域或自定義網域。嘗試將網域連結至通訊服務資源之前，必須先完整驗證此網域。
Azure 通訊服務資源。建立通訊服務資源。

將電子郵件網域連線至通訊服務資源

在 [Azure 通訊服務資源概觀] 頁面中，按兩下 [電子郵件] 下方左側導覽面板中的 [網域 ]。
選取下列其中一個選項
- 按下上方導覽列中連線網域。
- 按兩下啟動顯示畫面中的連線網域。
篩選來選取其中一個已驗證的網域
- 訂用帳戶
- 資源群組
- 電子郵件服務
- 已驗證的網域

注意

我們只允許在相同地理位置中連接網域。請確定在資源建立期間選取的通訊資源和電子郵件通訊資源的數據位置都相同。

按兩下 [連線

中斷電子郵件網域與通訊服務資源的連線

在 [Azure 通訊服務資源概觀] 頁面中，按兩下 [電子郵件] 下方左側導覽面板中的 [網域 ]。
選取連線網域，按一下 ...然後按兩下 [中斷連線]。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
準備布建網域的 Azure 電子郵件通訊服務資源。開始建立電子郵件通訊資源。
布建並準備好傳送電子郵件的 Azure 受控網域或自定義網域。嘗試將網域連結至通訊服務資源之前，必須先完整驗證此網域。
Azure 通訊服務資源。建立通訊服務資源。

連線電子郵件網域至通訊服務資源

{subscription-id}取代範例要求中的、 {resource-group-name}{communication-services-resource-name}與 {linked-domain-resource-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}"]
    }
}

中斷電子郵件網域與通訊服務資源的連線

{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": []
    }
}

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
準備布建網域的 Azure 電子郵件通訊服務資源。開始建立電子郵件通訊資源。
布建並準備好傳送電子郵件的 Azure 受控網域或自定義網域。嘗試將網域連結至通訊服務資源之前，必須先完整驗證此網域。
Azure 通訊服務資源。建立通訊服務資源。
我們使用服務主體進行驗證。將 Microsoft Entra 應用程式的用戶端識別碼、租使用者識別碼和客戶端密碼的值設定為下列環境變數： AZURE_CLIENT_ID、 AZURE_TENANT_ID和 AZURE_CLIENT_SECRET。

安裝必要套件

dotnet add package Azure.ResourceManager.Communication

初始化管理用戶端

使用您網域和電子郵件資源的訂用帳戶標識碼來設定環境變數 AZURE_SUBSCRIPTION_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());

連線電子郵件網域至通訊服務資源

<subscription-id>取代範例程式代碼中的、 <resource-group-name><azure-communication-services-resource-name>與 <linked-domain-resource-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);

中斷電子郵件網域與通訊服務資源的連線

<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);

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
準備布建網域的 Azure 電子郵件通訊服務資源。開始建立電子郵件通訊資源。
布建並準備好傳送電子郵件的 Azure 受控網域或自定義網域。嘗試將網域連結至通訊服務資源之前，必須先完整驗證此網域。
Azure 通訊服務資源。建立通訊服務資源。
我們使用服務主體進行驗證。將 Microsoft Entra 應用程式的用戶端識別碼、租使用者識別碼和客戶端密碼的值設定為下列環境變數： AZURE_CLIENT_ID、 AZURE_TENANT_ID和 AZURE_CLIENT_SECRET。

安裝必要套件

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

初始化管理用戶端

將範例程式代碼中的欄位取代為您網域和電子郵件資源所使用的訂用帳戶識別碼。執行程式代碼範例來初始化管理用戶端。

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);

連線電子郵件網域至通訊服務資源

<resource-group-name>取代範例程式代碼中的、 <azure-communication-services-resource-name>與 <linked-domain-resource-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
);

中斷電子郵件網域與通訊服務資源的連線

<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
);

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
準備布建網域的 Azure 電子郵件通訊服務資源。開始建立電子郵件通訊資源。
布建並準備好傳送電子郵件的 Azure 受控網域或自定義網域。嘗試將網域連結至通訊服務資源之前，必須先完整驗證此網域。
Azure 通訊服務資源。建立通訊服務資源。
我們使用服務主體進行驗證。將 Microsoft Entra 應用程式的用戶端識別碼、租使用者識別碼和客戶端密碼的值設定為下列環境變數： AZURE_CLIENT_ID、 AZURE_TENANT_ID和 AZURE_CLIENT_SECRET。

安裝必要套件

將下列相依性新增至。pom.xml

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

初始化管理用戶端

使用您網域和電子郵件資源的訂用帳戶標識碼來設定環境變數 AZURE_SUBSCRIPTION_ID 。執行程式代碼範例來初始化管理用戶端。

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

將電子郵件網域連線至通訊服務資源

<resource-group-name>取代範例程式代碼中的、 <azure-communication-services-resource-name>與 <linked-domain-resource-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();

中斷電子郵件網域與通訊服務資源的連線

<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();

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
準備布建網域的 Azure 電子郵件通訊服務資源。開始建立電子郵件通訊資源。
布建並準備好傳送電子郵件的 Azure 受控網域或自定義網域。嘗試將網域連結至通訊服務資源之前，必須先完整驗證此網域。
Azure 通訊服務資源。建立通訊服務資源。
我們使用服務主體進行驗證。將 Microsoft Entra 應用程式的用戶端識別碼、租使用者識別碼和客戶端密碼的值設定為下列環境變數： AZURE_CLIENT_ID、 AZURE_TENANT_ID和 AZURE_CLIENT_SECRET。

安裝必要套件

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

初始化管理用戶端

將範例程式代碼中的欄位取代為您網域和電子郵件資源所使用的訂用帳戶識別碼。執行程式代碼範例來初始化管理用戶端。

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

連線電子郵件網域至通訊服務資源

<resource-group-name>取代範例程式代碼中的、 <azure-communication-services-resource-name>與 <linked-domain-resource-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()

中斷電子郵件網域與通訊服務資源的連線

<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()

下一步

熟悉電子郵件用戶端程式庫

快速入門：如何連線已驗證的電子郵件網域

必要條件

將電子郵件網域 連線 至通訊服務資源

中斷電子郵件網域與通訊服務資源的連線

必要條件

連線 電子郵件網域至通訊服務資源

中斷電子郵件網域與通訊服務資源的連線

必要條件

安裝必要套件

初始化管理用戶端

連線 電子郵件網域至通訊服務資源

中斷電子郵件網域與通訊服務資源的連線

必要條件

安裝必要套件

初始化管理用戶端

連線 電子郵件網域至通訊服務資源

中斷電子郵件網域與通訊服務資源的連線

必要條件

安裝必要套件

初始化管理用戶端

將電子郵件網域 連線 至通訊服務資源

中斷電子郵件網域與通訊服務資源的連線

必要條件

安裝必要套件

初始化管理用戶端

連線 電子郵件網域至通訊服務資源

中斷電子郵件網域與通訊服務資源的連線

下一步

相關文章

其他資源

將電子郵件網域連線至通訊服務資源

連線電子郵件網域至通訊服務資源

連線電子郵件網域至通訊服務資源

連線電子郵件網域至通訊服務資源

將電子郵件網域連線至通訊服務資源

連線電子郵件網域至通訊服務資源