快速入門:如何連線已驗證的電子郵件網域
本快速入門說明如何在 Azure 通訊服務 中聯機已驗證的網域以傳送電子郵件。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
- 準備佈建網域的 Azure 電子郵件通訊服務資源。 開始建立電子郵件通訊資源。
- Azure 受控網域或自訂網域佈建並準備好傳送電子郵件。 嘗試將網域連結至通訊服務資源之前,必須先完整驗證此網域。
- Azure 通訊服務資源。 建立通訊服務資源。
將電子郵件網域連線至通訊服務資源
在 [Azure 通訊服務資源概觀] 頁面的左側瀏覽面板中,按兩下 [電子郵件] 下的 [ 網域]。
選取下列其中一個選項:
篩選來選取其中一個已驗證的網域:
- 訂用帳戶
- 資源群組
- 電子郵件服務
- 已驗證的網域
注意
您只能連接相同地理位置中的網域。 請確定您在資源建立期間選取的通訊資源和電子郵件通訊資源的數據位置位於相同的地理位置。
注意
我們可讓客戶將最多100個自定義網域連結到單一通訊服務資源。 通訊服務資源可存取這些自定義網域下設定的所有郵件來源位址。 您只能連結已驗證的自訂網域。
中斷電子郵件網域與通訊服務資源的連線
必要條件
- 具有有效訂用帳戶的 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();
patch.LinkedDomains.Clear();
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()