共用方式為


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

本快速入門說明如何在 Azure 通訊服務 中聯機已驗證的網域以傳送電子郵件。

必要條件

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

  1. 在 [Azure 通訊服務資源概觀] 頁面的左側瀏覽面板中,按兩下 [電子郵件] 下的 [ 網域]。

    顯示連結電子郵件網域之左側瀏覽面板的螢幕快照。

  2. 選取下列其中一個選項:

    • 從上方導覽列中,按兩下 [ 連線網域]。

    • 從啟動顯示畫面,按兩下 [ 連線網域]。

      顯示如何連線其中一個已驗證電子郵件網域的螢幕快照。

  3. 篩選來選取其中一個已驗證的網域:

    • 訂用帳戶
    • 資源群組
    • 電子郵件服務
    • 已驗證的網域

    顯示如何篩選並選取其中一個要連線之已驗證電子郵件網域的螢幕擷取畫面。

注意

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

  1. 按一下 [連線]

    顯示其中一個已驗證的電子郵件網域現在已連線的螢幕擷取畫面。

注意

我們可讓客戶將最多100個自定義網域連結到單一通訊服務資源。 通訊服務資源可存取這些自定義網域下設定的所有郵件來源位址。 您只能連結已驗證的自訂網域。

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

  1. 在 [Azure 通訊服務 資源概觀] 頁面中,從左側瀏覽面板的 [電子郵件] 下,按兩下[網域]。

  2. 選取 [已連線的網域],然後按兩下 [... ],然後選取 [ 中斷連線]。

    顯示如何中斷連線網域連線的螢幕快照。

必要條件

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

取代範例要求中的 {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": []
    }
}

必要條件

安裝必要套件

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();
patch.LinkedDomains.Clear();
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);

必要條件

安裝必要套件

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

必要條件

安裝必要套件

將下列相依性新增至 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();

必要條件

安裝必要套件

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

下一步