Partager via

Démarrage rapide : Comment connecter un domaine de courrier vérifié

  • Article

Ce guide de démarrage rapide décrit comment connecter un domaine vérifié dans Azure Communication Services pour envoyer des e-mails.

Prérequis

Connecter un domaine de messagerie à une ressource Communication Service

  1. Dans la page de vue d’ensemble de la ressource Azure Communication Services, dans le volet de navigation gauche sous E-mail, cliquez sur Domaines.

    Capture d’écran montrant le panneau de navigation gauche pour lier des domaines de courrier.

  2. Sélectionnez l’une des options suivantes :

    • Dans la barre de navigation du haut, cliquez sur Connecter un domaine.

    • Dans l’écran de démarrage, cliquez sur Connecter un domaine.

      Capture d’écran montrant comment connecter un de vos domaines de courrier vérifiés.

  3. Sélectionnez l’un des domaines vérifiés en filtrant :

    • Abonnement
    • Groupe de ressources
    • Service de messagerie
    • Domaine vérifié

    Capture d’écran montrant comment filtrer et sélectionner un des domaines de courrier vérifiés à connecter.

Remarque

Vous pouvez uniquement connecter des domaines qui se trouvent dans la même zone géographique. Vérifiez que les emplacements des données pour la ressource de communication et la ressource de communication de messagerie que vous avez sélectionnés lors de la création des ressources sont dans la même zone géographique.

  1. Cliquez sur Connecter.

    Capture d’écran montrant qu’un des domaines de messagerie vérifiés est maintenant connecté.

Remarque

Nous permettons aux clients de lier jusqu’à 100 domaines personnalisés à une même ressource de service de communication. Toutes les adresses e-mail sources configurées sous ces domaines personnalisés sont accessibles à la ressource du service de communication. Vous ne pouvez lier que des domaines personnalisés vérifiés.

Connecter un domaine de messagerie d’une ressource Communication Service

  1. Dans la page de vue d’ensemble de la ressource Azure Communication Services, dans le volet de navigation gauche sous E-mail, cliquez sur Domaines.

  2. Sélectionnez les domaines connectés, puis cliquez sur ... et sélectionnez Déconnecter.

    Capture d’écran montrant comment déconnecter le domaine connecté.

Prérequis

Connecter un domaine de messagerie à une ressource Communication Service

Remplacez , {subscription-id}{resource-group-name}, {communication-services-resource-name}et {linked-domain-resource-id} dans l’exemple de demande.

Mettez en forme l’ID de ressource de domaine lié comme suit :

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

Si vous utilisez un domaine managé Azure, le domain-name est « AzureManagedDomain ». Le email-service-name doit être le même service de messagerie que celui que vous avez utilisé pour approvisionner le domaine.

Une fois ces valeurs renseignées, effectuez une requête PATCH à l’aide de l’URL et du corps de requête suivants.

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

Connecter un domaine de messagerie d’une ressource Communication Service

Remplacez , {subscription-id}{resource-group-name}, et {communication-services-resource-name} dans l’exemple de demande.

Une fois ces valeurs renseignées, effectuez une requête PATCH à l’aide de l’URL et du corps de requête suivants.

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

Prérequis

Installer les packages requis

dotnet add package Azure.ResourceManager.Communication

Initialiser le client de gestion

Définissez la variable d’environnement AZURE_SUBSCRIPTION_ID avec l’ID d’abonnement de l’abonnement dans lequel se trouvent vos ressources Domaine et E-mail. Exécutez l’exemple de code pour initialiser le client de gestion.

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

Connecter un domaine de messagerie à une ressource Communication Service

Remplacez , <subscription-id><resource-group-name>, <azure-communication-services-resource-name> et <linked-domain-resource-id> dans l’exemple de code.

Mettez en forme l’ID de ressource de domaine lié comme suit :

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

Si vous utilisez un domaine managé Azure, le domain-name est « AzureManagedDomain ». Le email-service-name doit être le même service de messagerie que celui que vous avez utilisé pour approvisionner le domaine.

Une fois ces valeurs renseignées, exécutez l’exemple de code.

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

Connecter un domaine de messagerie d’une ressource Communication Service

Remplacez , <subscription-id><resource-group-name>, et <azure-communication-services-resource-name> dans l’exemple de code.

Une fois ces valeurs renseignées, exécutez l’exemple de code.

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

Prérequis

Installer les packages requis

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

Initialiser le client de gestion

Remplacez le champ dans l’exemple de code par l’ID d’abonnement de l’abonnement dans lequel se trouvent vos ressources Domaine et E-mail. Exécutez l’exemple de code pour initialiser le client de gestion.

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

Connecter un domaine de messagerie à une ressource Communication Service

Remplacez , <resource-group-name><azure-communication-services-resource-name>, et <linked-domain-resource-id> dans l’exemple de code.

Mettez en forme l’ID de ressource de domaine lié comme suit :

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

Si vous utilisez un domaine managé Azure, le domain-name est « AzureManagedDomain ». Le email-service-name doit être le même service de messagerie que celui que vous avez utilisé pour approvisionner le domaine.

Une fois ces valeurs renseignées, exécutez l’exemple de code.

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

Connecter un domaine de messagerie d’une ressource Communication Service

Remplacez le <resource-group-name> et <azure-communication-services-resource-name> dans l’exemple de code.

Une fois ces valeurs renseignées, exécutez l’exemple de code.

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

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

Prérequis

Installer les packages requis

Ajoutez la dépendance suivante à votre pom.xml.

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

Initialiser le client de gestion

Définissez la variable d’environnement AZURE_SUBSCRIPTION_ID avec l’ID d’abonnement de l’abonnement dans lequel se trouvent vos ressources Domaine et E-mail. Exécutez l’exemple de code pour initialiser le client de gestion.

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

Connecter un domaine de messagerie à une ressource Communication Service

Remplacez , <resource-group-name><azure-communication-services-resource-name>, et <linked-domain-resource-id> dans l’exemple de code.

L’ID de ressource de domaine lié doit être au format suivant.

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

Si vous utilisez un domaine managé Azure, le domain-name est « AzureManagedDomain ». Le email-service-name doit être le même service de messagerie que celui que vous avez utilisé pour approvisionner le domaine.

Une fois ces valeurs renseignées, exécutez l’exemple de code.

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

Connecter un domaine de messagerie d’une ressource Communication Service

Remplacez le <resource-group-name> et <azure-communication-services-resource-name> dans l’exemple de code.

Une fois ces valeurs renseignées, exécutez l’exemple de code.

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

Prérequis

Installer les packages requis

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

Initialiser le client de gestion

Remplacez le champ dans l’exemple de code par l’ID d’abonnement de l’abonnement dans lequel se trouvent vos ressources Domaine et E-mail. Exécutez l’exemple de code pour initialiser le client de gestion.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Connecter un domaine de messagerie à une ressource Communication Service

Remplacez , <resource-group-name><azure-communication-services-resource-name>, et <linked-domain-resource-id> dans l’exemple de code.

L’ID de ressource de domaine lié doit être au format suivant.

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

Si vous utilisez un domaine managé Azure, le domain-name est « AzureManagedDomain ». Le email-service-name doit être le même service de messagerie que celui que vous avez utilisé pour approvisionner le domaine.

Une fois ces valeurs renseignées, exécutez l’exemple de code.


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

Connecter un domaine de messagerie d’une ressource Communication Service

Remplacez le <resource-group-name> et <azure-communication-services-resource-name> dans l’exemple de code.

Une fois ces valeurs renseignées, exécutez l’exemple de code.


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

Étapes suivantes