Schnellstart: Verbinden einer überprüften E-Mail-Domäne

In diesem Schnellstart erfahren Sie, wie Sie eine überprüfte Domäne mit Azure Communication Services verbinden, um E-Mails zu senden.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto..
• Eine Azure E-Mail Communication Services-Ressource, die zum Bereitstellen von Domänen bereit ist. Erste Schritte zur Erstellung der E-Mail-Communication Service-Ressource
• Eine verwaltete Azure-Domäne oder benutzerdefinierte Domäne wurde bereitgestellt und ist bereit zum Senden von E-Mails. Diese Domäne muss vollständig überprüft werden, bevor Sie versuchen, sie mit der Communication Service-Ressource zu verknüpfen.
• Eine Azure Communication Services-Ressource Erstellen Sie Communication Services-Ressourcen.

Verbinden einer E-Mail-Domäne mit einer Communication Services-Ressource

1. Klicken Sie auf der Seite „Azure Communication Services-Ressource“ im linken Navigationsbereich unter „E-Mail“ auf Domänen.

   

2. Wählen Sie eine der folgenden Optionen aus.

   • Klicken Sie auf der oberen Navigationsleiste auf Domäne verbinden.

   • Klicken Sie auf dem Begrüßungsbildschirm auf Domäne verbinden.

     

3. Wählen Sie eine der überprüften Domänen aus, indem Sie nach Folgendem filtern

   • Subscription
   • Ressourcengruppe
   • E-Mail-Dienst
   • Überprüfte Domäne

   

Hinweis

Wir erlauben nur, die Domänen in derselben Geographie zu verbinden. Stellen Sie sicher, dass der Datenspeicherort, der während der Ressourcenerstellung ausgewählt wird, für Kommunikationsressource und E-Mail-Kommunikationsressource identisch ist.

4. Klicken Sie auf "Verbinden".

   

Trennen einer E-Mail-Domäne von einer Communication Services-Ressource

1. Klicken Sie auf der Seite „Azure Communication Services-Ressource“ im linken Navigationsbereich unter „E-Mail“ auf Domänen.

2. Wählen Sie „Verbundene Domänen“ aus, und klicken Sie auf „Trennen“.

   

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto..
• Eine Azure E-Mail Communication Services-Ressource, die zum Bereitstellen von Domänen bereit ist. Erste Schritte zur Erstellung der E-Mail-Communication Service-Ressource
• Eine verwaltete Azure-Domäne oder benutzerdefinierte Domäne wurde bereitgestellt und ist bereit zum Senden von E-Mails. Diese Domäne muss vollständig überprüft werden, bevor Sie versuchen, sie mit der Communication Service-Ressource zu verknüpfen.
• Eine Azure Communication Services-Ressource Erstellen Sie Communication Services-Ressourcen.

Verbinden einer E-Mail-Domäne mit einer Communication Services-Ressource

Ersetzen Sie in der Beispielanforderung {subscription-id}, {resource-group-name}, {communication-services-resource-name} und {linked-domain-resource-id}.

Die ID der verknüpften Domänenressource sollte das folgende Format aufweisen.

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

Wenn Sie eine verwaltete Azure-Domäne verwenden, lautet der domain-name „AzureManagedDomain“. Der email-service-name sollte derselbe E-Mail-Dienst sein, den Sie zum Bereitstellen der Domäne verwendet haben.

Nachdem diese Werte aufgefüllt wurden, geben Sie eine PATCH-Anforderung aus, und verwenden Sie dazu die folgende Anforderungs-URL und den folgenden Textkörper.

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}"]
    }
}

Trennen einer E-Mail-Domäne von einer Communication Services-Ressource

Ersetzen Sie in der Beispielanforderung {subscription-id}, {resource-group-name} und {communication-services-resource-name}.

Nachdem diese Werte aufgefüllt wurden, geben Sie eine PATCH-Anforderung aus, und verwenden Sie dazu die folgende Anforderungs-URL und den folgenden Textkörper.

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

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto..
• Eine Azure E-Mail Communication Services-Ressource, die zum Bereitstellen von Domänen bereit ist. Erste Schritte zur Erstellung der E-Mail-Communication Service-Ressource
• Eine verwaltete Azure-Domäne oder benutzerdefinierte Domäne wurde bereitgestellt und ist bereit zum Senden von E-Mails. Diese Domäne muss vollständig überprüft werden, bevor Sie versuchen, sie mit der Communication Service-Ressource zu verknüpfen.
• Eine Azure Communication Services-Ressource Erstellen Sie Communication Services-Ressourcen.
• Wir verwenden einen Dienstprinzipal für die Authentifizierung. Legen Sie die Werte der Client-ID, der Mandanten-ID und des geheimen Clientschlüssels der Microsoft Entra-Anwendung als die folgenden Umgebungsvariablen fest: AZURE_CLIENT_ID, AZURE_TENANT_ID und AZURE_CLIENT_SECRET.

Installieren der erforderlichen Pakete

dotnet add package Azure.ResourceManager.Communication

Initialisieren des Verwaltungsclients

Legen Sie die Umgebungsvariable AZURE_SUBSCRIPTION_ID mit der Abonnement-ID des Abonnements fest, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

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

Verbinden einer E-Mail-Domäne mit einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name> und <linked-domain-resource-id>.

Die ID der verknüpften Domänenressource sollte das folgende Format aufweisen.

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

Wenn Sie eine verwaltete Azure-Domäne verwenden, lautet der domain-name „AzureManagedDomain“. Der email-service-name sollte derselbe E-Mail-Dienst sein, den Sie zum Bereitstellen der Domäne verwendet haben.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Trennen einer E-Mail-Domäne von einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <subscription-id>, <resource-group-name> und <azure-communication-services-resource-name>.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto..
• Eine Azure E-Mail Communication Services-Ressource, die zum Bereitstellen von Domänen bereit ist. Erste Schritte zur Erstellung der E-Mail-Communication Service-Ressource
• Eine verwaltete Azure-Domäne oder benutzerdefinierte Domäne wurde bereitgestellt und ist bereit zum Senden von E-Mails. Diese Domäne muss vollständig überprüft werden, bevor Sie versuchen, sie mit der Communication Service-Ressource zu verknüpfen.
• Eine Azure Communication Services-Ressource Erstellen Sie Communication Services-Ressourcen.
• Wir verwenden einen Dienstprinzipal für die Authentifizierung. Legen Sie die Werte der Client-ID, der Mandanten-ID und des geheimen Clientschlüssels der Microsoft Entra-Anwendung als die folgenden Umgebungsvariablen fest: AZURE_CLIENT_ID, AZURE_TENANT_ID und AZURE_CLIENT_SECRET.

Installieren der erforderlichen Pakete

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

Initialisieren des Verwaltungsclients

Ersetzen Sie das Feld im Beispielcode durch die Abonnement-ID des Abonnements, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

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

Verbinden einer E-Mail-Domäne mit einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <resource-group-name>, <azure-communication-services-resource-name> und <linked-domain-resource-id>.

Die ID der verknüpften Domänenressource sollte das folgende Format aufweisen.

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

Wenn Sie eine verwaltete Azure-Domäne verwenden, lautet der domain-name „AzureManagedDomain“. Der email-service-name sollte derselbe E-Mail-Dienst sein, den Sie zum Bereitstellen der Domäne verwendet haben.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Trennen einer E-Mail-Domäne von einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <resource-group-name> und <azure-communication-services-resource-name>.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

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

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto..
• Eine Azure E-Mail Communication Services-Ressource, die zum Bereitstellen von Domänen bereit ist. Erste Schritte zur Erstellung der E-Mail-Communication Service-Ressource
• Eine verwaltete Azure-Domäne oder benutzerdefinierte Domäne wurde bereitgestellt und ist bereit zum Senden von E-Mails. Diese Domäne muss vollständig überprüft werden, bevor Sie versuchen, sie mit der Communication Service-Ressource zu verknüpfen.
• Eine Azure Communication Services-Ressource Erstellen Sie Communication Services-Ressourcen.
• Wir verwenden einen Dienstprinzipal für die Authentifizierung. Legen Sie die Werte der Client-ID, der Mandanten-ID und des geheimen Clientschlüssels der Microsoft Entra-Anwendung als die folgenden Umgebungsvariablen fest: AZURE_CLIENT_ID, AZURE_TENANT_ID und AZURE_CLIENT_SECRET.

Installieren der erforderlichen Pakete

Fügen Sie Ihrer Datei pom.xml die folgende Abhängigkeit hinzu.

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

Initialisieren des Verwaltungsclients

Legen Sie die Umgebungsvariable AZURE_SUBSCRIPTION_ID mit der Abonnement-ID des Abonnements fest, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

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

Verbinden einer E-Mail-Domäne mit einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <resource-group-name>, <azure-communication-services-resource-name> und <linked-domain-resource-id>.

Die ID der verknüpften Domänenressource sollte das folgende Format aufweisen.

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

Wenn Sie eine verwaltete Azure-Domäne verwenden, lautet der domain-name „AzureManagedDomain“. Der email-service-name sollte derselbe E-Mail-Dienst sein, den Sie zum Bereitstellen der Domäne verwendet haben.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Trennen einer E-Mail-Domäne von einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <resource-group-name> und <azure-communication-services-resource-name>.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto..
• Eine Azure E-Mail Communication Services-Ressource, die zum Bereitstellen von Domänen bereit ist. Erste Schritte zur Erstellung der E-Mail-Communication Service-Ressource
• Eine verwaltete Azure-Domäne oder benutzerdefinierte Domäne wurde bereitgestellt und ist bereit zum Senden von E-Mails. Diese Domäne muss vollständig überprüft werden, bevor Sie versuchen, sie mit der Communication Service-Ressource zu verknüpfen.
• Eine Azure Communication Services-Ressource Erstellen Sie Communication Services-Ressourcen.
• Wir verwenden einen Dienstprinzipal für die Authentifizierung. Legen Sie die Werte der Client-ID, der Mandanten-ID und des geheimen Clientschlüssels der Microsoft Entra-Anwendung als die folgenden Umgebungsvariablen fest: AZURE_CLIENT_ID, AZURE_TENANT_ID und AZURE_CLIENT_SECRET.

Installieren der erforderlichen Pakete

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

Initialisieren des Verwaltungsclients

Ersetzen Sie das Feld im Beispielcode durch die Abonnement-ID des Abonnements, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Verbinden einer E-Mail-Domäne mit einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <resource-group-name>, <azure-communication-services-resource-name> und <linked-domain-resource-id>.

Die ID der verknüpften Domänenressource sollte das folgende Format aufweisen.

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

Wenn Sie eine verwaltete Azure-Domäne verwenden, lautet der domain-name „AzureManagedDomain“. Der email-service-name sollte derselbe E-Mail-Dienst sein, den Sie zum Bereitstellen der Domäne verwendet haben.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Trennen einer E-Mail-Domäne von einer Communication Services-Ressource

Ersetzen Sie im Beispielcode <resource-group-name> und <azure-communication-services-resource-name>.

Nachdem diese Werte aufgefüllt wurden, führen Sie den Beispielcode aus.

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

Nächste Schritte

• Senden einer E-Mail

• Was ist die E-Mail-Communication Service-Resource für Azure Communication Services?

Verwandte Artikel

• Informationen zur Clientbibliothek für E-Mail