Freigeben über

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

  • Artikel

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

Voraussetzungen

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

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

    Screenshot, der den linken Navigationsbereich für die Verknüpfung von E-Mail-Domänen zeigt.

  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.

      Screenshot, der zeigt, wie Sie eine Ihrer überprüften E-Mail-Domänen verbinden.

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

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

    Screenshot, der zeigt, wie Sie eine der überprüften E-Mail-Domänen filtern und auswählen, um eine Verbindung herzustellen.

Hinweis

Sie können Domänen nur in derselben geografischen Region verbinden. Stellen Sie sicher, dass der während der Ressourcenerstellung ausgewählte Datenspeicherort für die Kommunikationsressource und E-Mail-Kommunikationsressource identisch ist.

  1. Klicken Sie auf Verbinden.

    Screenshot, der zeigt, dass eine der überprüften E-Mail-Domänen jetzt verbunden ist.

Hinweis

Wir ermöglichen es Kunden, bis zu 100 benutzerdefinierte Domänen mit einer einzigen Kommunikationsdienstressource zu verknüpfen. Auf alle unter diesen benutzerdefinierten Domänen konfigurierten Mail From-Adressen kann von der Kommunikationsdienstressource zugegriffen werden. Sie können nur überprüfte benutzerdefinierte Domänen verknüpfen.

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

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

  2. Wählen Sie zunächst „Verbundene Domänen“ aus, klicken Sie dann auf ..., und wählen Sie anschließend Trennen aus.

    Screenshot, der zeigt, wie die verbundene Domäne getrennt wird.

Voraussetzungen

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}.

Formatieren Sie die verknüpfte Domänenressourcen-ID wie folgt:

/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 mithilfe der folgende Anforderungs-URL und dem folgenden Textkörper aus.

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 mithilfe der folgende Anforderungs-URL und dem folgenden Textkörper aus.

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

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>.

Formatieren Sie die verknüpfte Domänenressourcen-ID wie folgt:

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

Voraussetzungen

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>.

Formatieren Sie die verknüpfte Domänenressourcen-ID wie folgt:

/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

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

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