Delen via

Quickstart: Verbinding maken met een geverifieerd e-maildomein

  • Artikel

In deze quickstart wordt beschreven hoe u een geverifieerd domein in Azure Communication Services verbindt om e-mail te verzenden.

Vereisten

Een e-maildomein verbinden met een Communication Service-resource

  1. Klik op de overzichtspagina van De Azure Communication Service-resource in het linkernavigatievenster onder E-mail op Domeinen.

    Schermopname van het linkernavigatievenster voor het koppelen van e-maildomeinen.

  2. Selecteer een van de volgende opties:

    • Klik in de bovenste navigatiebalk op Verbinding maken met domein.

    • Klik in het welkomstscherm op Connect-domein.

      Schermopname van het verbinden van een van uw geverifieerde e-maildomeinen.

  3. Selecteer een van de geverifieerde domeinen door te filteren:

    • Abonnement
    • Resourcegroep
    • E-mailservice
    • Geverifieerd domein

    Schermopname die laat zien hoe u een van de geverifieerde e-maildomeinen filtert en selecteert om verbinding te maken.

Notitie

U kunt alleen domeinen in dezelfde geografie verbinden. Zorg ervoor dat de gegevenslocatie voor communicatieresource en e-mailcommunicatieresource die u tijdens het maken van de resource hebt geselecteerd, zich in dezelfde geografie bevinden.

  1. Klik op Verbinding maken.

    Schermopname van een van de geverifieerde e-maildomeinen is nu verbonden.

Notitie

Klanten kunnen maximaal 100 aangepaste domeinen koppelen aan één communicatieserviceresource. Alle Mail-From-adressen die zijn geconfigureerd onder deze aangepaste domeinen, zijn toegankelijk voor de communicatieserviceresource. U kunt alleen geverifieerde aangepaste domeinen koppelen.

Een e-maildomein loskoppelen van de Communication Service-resource

  1. Klik op de overzichtspagina van Azure Communication Services-resources in het linkernavigatievenster onder E-mail op Domeinen.

  2. Selecteer de verbonden domeinen, klik vervolgens op ... en selecteer Verbinding verbreken.

    Schermopname die laat zien hoe u de verbinding met het verbonden domein verbreekt.

Vereisten

Een e-maildomein verbinden met een Communication Service-resource

Vervang de {subscription-id}, {resource-group-name}, en {communication-services-resource-name}{linked-domain-resource-id} in de voorbeeldaanvraag.

Maak de resource-id van het gekoppelde domein als volgt op:

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

Als u een beheerd Azure-domein gebruikt, is het domain-name 'AzureManagedDomain'. Dit email-service-name moet dezelfde e-mailservice zijn die u hebt gebruikt om het domein in te richten.

Zodra deze waarden zijn ingevuld, maakt u een PATCH-aanvraag met behulp van de volgende aanvraag-URL en hoofdtekst.

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

Een e-maildomein loskoppelen van de Communication Service-resource

Vervang de {subscription-id}, {resource-group-name}en {communication-services-resource-name} in de voorbeeldaanvraag.

Zodra deze waarden zijn ingevuld, maakt u een PATCH-aanvraag met behulp van de volgende aanvraag-URL en hoofdtekst.

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

Vereisten

De vereiste pakketten installeren

dotnet add package Azure.ResourceManager.Communication

De beheerclient initialiseren

Stel de omgevingsvariabele AZURE_SUBSCRIPTION_ID in met de abonnements-id van het abonnement waarin uw domein- en e-mailbronnen zich bevinden. Voer het codevoorbeeld uit om de beheerclient te initialiseren.

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

Een e-maildomein verbinden met een Communication Service-resource

Vervang de <subscription-id>, <resource-group-name>en <azure-communication-services-resource-name><linked-domain-resource-id> in de voorbeeldcode.

Maak de resource-id van het gekoppelde domein als volgt op:

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

Als u een beheerd Azure-domein gebruikt, is het domain-name 'AzureManagedDomain'. Dit email-service-name moet dezelfde e-mailservice zijn die u hebt gebruikt om het domein in te richten.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.

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

Een e-maildomein loskoppelen van de Communication Service-resource

Vervang de <subscription-id>, <resource-group-name>en <azure-communication-services-resource-name> in de voorbeeldcode.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.

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

Vereisten

De vereiste pakketten installeren

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

De beheerclient initialiseren

Vervang het veld in de voorbeeldcode door de abonnements-id van het abonnement waarin uw domein- en e-mailbronnen zich bevinden. Voer het codevoorbeeld uit om de beheerclient te initialiseren.

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

Een e-maildomein verbinden met een Communication Service-resource

Vervang de <resource-group-name>, <azure-communication-services-resource-name>en <linked-domain-resource-id> in de voorbeeldcode.

Maak de resource-id van het gekoppelde domein als volgt op:

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

Als u een beheerd Azure-domein gebruikt, is het domain-name 'AzureManagedDomain'. Dit email-service-name moet dezelfde e-mailservice zijn die u hebt gebruikt om het domein in te richten.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.

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

Een e-maildomein loskoppelen van de Communication Service-resource

Vervang de <resource-group-name>en <azure-communication-services-resource-name> in de voorbeeldcode.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.

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

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

Vereisten

De vereiste pakketten installeren

Voeg de volgende afhankelijkheid toe aan uw pom.xml.

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

De beheerclient initialiseren

Stel de omgevingsvariabele AZURE_SUBSCRIPTION_ID in met de abonnements-id van het abonnement waarin uw domein- en e-mailbronnen zich bevinden. Voer het codevoorbeeld uit om de beheerclient te initialiseren.

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

Een e-maildomein verbinden met een Communication Service-resource

Vervang de <resource-group-name>, <azure-communication-services-resource-name>en <linked-domain-resource-id> in de voorbeeldcode.

De resource-id van het gekoppelde domein moet de volgende indeling hebben.

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

Als u een beheerd Azure-domein gebruikt, is het domain-name 'AzureManagedDomain'. Dit email-service-name moet dezelfde e-mailservice zijn die u hebt gebruikt om het domein in te richten.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.

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

Een e-maildomein loskoppelen van de Communication Service-resource

Vervang de <resource-group-name>en <azure-communication-services-resource-name> in de voorbeeldcode.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.

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

Vereisten

De vereiste pakketten installeren

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

De beheerclient initialiseren

Vervang het veld in de voorbeeldcode door de abonnements-id van het abonnement waarin uw domein- en e-mailbronnen zich bevinden. Voer het codevoorbeeld uit om de beheerclient te initialiseren.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Een e-maildomein verbinden met een Communication Service-resource

Vervang de <resource-group-name>, <azure-communication-services-resource-name>en <linked-domain-resource-id> in de voorbeeldcode.

De resource-id van het gekoppelde domein moet de volgende indeling hebben.

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

Als u een beheerd Azure-domein gebruikt, is het domain-name 'AzureManagedDomain'. Dit email-service-name moet dezelfde e-mailservice zijn die u hebt gebruikt om het domein in te richten.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.


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

Een e-maildomein loskoppelen van de Communication Service-resource

Vervang de <resource-group-name> en <azure-communication-services-resource-name> in de voorbeeldcode.

Zodra deze waarden zijn ingevuld, voert u de voorbeeldcode uit.


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

Volgende stappen