Guida introduttiva: Come connettere un dominio di posta elettronica verificato

In questa guida introduttiva si apprenderà come connettere un dominio verificato in Servizi di comunicazione di Azure per inviare un messaggio di posta elettronica.

Prerequisiti

Connessione un dominio di posta elettronica a una risorsa del servizio di comunicazione

  1. Nella pagina panoramica delle risorse del servizio di comunicazione di Azure fare clic su Domini nel pannello di spostamento a sinistra in Posta elettronica.

    Screenshot che mostra il pannello di spostamento sinistro per il collegamento di Domini di posta elettronica.

  2. Selezionare una delle opzioni seguenti

    • Fare clic su Connessione dominio nella barra di spostamento superiore.

    • Fare clic su Connessione dominio nella schermata iniziale.

      Screenshot che mostra come connettere uno dei domini di posta elettronica verificati.

  3. Selezionare uno dei domini verificati filtrando

    • Subscription
    • Gruppo di risorse
    • Servizio di posta elettronica
    • Dominio verificato

    Screenshot che mostra come filtrare e selezionare uno dei domini di posta elettronica verificati da connettere.

Nota

È consentito connettere solo i domini nella stessa area geografica. Assicurarsi che il percorso dei dati per la risorsa di comunicazione e la risorsa di comunicazione tramite posta elettronica selezionati durante la creazione della risorsa siano gli stessi.

  1. Fare clic su Connetti

    Screenshot che mostra che uno dei domini di posta elettronica verificati è ora connesso.

Disconnettere un dominio di posta elettronica dalla risorsa del servizio di comunicazione

  1. Nella pagina panoramica delle risorse del servizio di comunicazione di Azure fare clic su Domini nel pannello di spostamento a sinistra in Posta elettronica.

  2. Selezionare i domini Connessione ed fare clic su ... e fare clic su Disconnetti.

    Screenshot che mostra come disconnettere il dominio connesso.

Prerequisiti

Connessione un dominio di posta elettronica a una risorsa del servizio di comunicazione

{subscription-id}Sostituire , {resource-group-name}{communication-services-resource-name}, e {linked-domain-resource-id} nella richiesta di esempio.

L'ID risorsa del dominio collegato deve essere nel formato seguente.

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

Se si usa un dominio gestito di Azure, è domain-name "AzureManagedDomain". Deve email-service-name essere lo stesso servizio di posta elettronica usato per effettuare il provisioning del dominio.

Dopo aver popolato questi valori, effettuare una richiesta PATCH all'oggetto usando l'URL della richiesta e il corpo seguenti.

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

Disconnettere un dominio di posta elettronica dalla risorsa del servizio di comunicazione

{subscription-id}Sostituire , {resource-group-name}e {communication-services-resource-name} nella richiesta di esempio.

Dopo aver popolato questi valori, effettuare una richiesta PATCH all'oggetto usando l'URL della richiesta e il corpo seguenti.

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

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
  • Una risorsa di Servizi di comunicazione di posta elettronica di Azure pronta per il provisioning dei domini. Introduzione alla creazione di una risorsa di comunicazione tramite posta elettronica.
  • Un dominio gestito di Azure o un dominio personalizzato di cui è stato effettuato il provisioning e pronto per l'invio di messaggi di posta elettronica. Questo dominio deve essere verificato completamente prima di tentare di collegarlo alla risorsa del servizio di comunicazione.
  • Risorsa Servizi di comunicazione di Azure. Creare risorse di Servizi di comunicazione.
  • Viene usata un'entità servizio per l'autenticazione. Impostare i valori dell'ID client, dell'ID tenant e del segreto client dell'applicazione Microsoft Entra come variabili di ambiente seguenti: AZURE_CLIENT_ID, AZURE_TENANT_IDe AZURE_CLIENT_SECRET.

Installare i pacchetti necessari

dotnet add package Azure.ResourceManager.Communication

Inizializzare il client di gestione

Impostare la variabile AZURE_SUBSCRIPTION_ID di ambiente con l'ID sottoscrizione della sottoscrizione in cui si trovano le risorse dominio e posta elettronica. Eseguire l'esempio di codice per inizializzare il client di gestione.

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

Connessione un dominio di posta elettronica a una risorsa del servizio di comunicazione

<subscription-id>Sostituire , <resource-group-name>, <azure-communication-services-resource-name>e <linked-domain-resource-id> nel codice di esempio.

L'ID risorsa del dominio collegato deve essere nel formato seguente.

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

Se si usa un dominio gestito di Azure, è domain-name "AzureManagedDomain". Deve email-service-name essere lo stesso servizio di posta elettronica usato per effettuare il provisioning del dominio.

Dopo aver popolato questi valori, eseguire il codice di esempio.

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

Disconnettere un dominio di posta elettronica dalla risorsa del servizio di comunicazione

<subscription-id>Sostituire , <resource-group-name>e <azure-communication-services-resource-name> nel codice di esempio.

Dopo aver popolato questi valori, eseguire il codice di esempio.

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

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
  • Una risorsa di Servizi di comunicazione di posta elettronica di Azure pronta per il provisioning dei domini. Introduzione alla creazione di una risorsa di comunicazione tramite posta elettronica.
  • Un dominio gestito di Azure o un dominio personalizzato di cui è stato effettuato il provisioning e pronto per l'invio di messaggi di posta elettronica. Questo dominio deve essere verificato completamente prima di tentare di collegarlo alla risorsa del servizio di comunicazione.
  • Risorsa Servizi di comunicazione di Azure. Creare risorse di Servizi di comunicazione.
  • Viene usata un'entità servizio per l'autenticazione. Impostare i valori dell'ID client, dell'ID tenant e del segreto client dell'applicazione Microsoft Entra come variabili di ambiente seguenti: AZURE_CLIENT_ID, AZURE_TENANT_IDe AZURE_CLIENT_SECRET.

Installare i pacchetti necessari

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

Inizializzare il client di gestione

Sostituire il campo nel codice di esempio con l'ID sottoscrizione della sottoscrizione in cui si trovano le risorse dominio e posta elettronica. Eseguire l'esempio di codice per inizializzare il client di gestione.

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

Connessione un dominio di posta elettronica a una risorsa del servizio di comunicazione

<resource-group-name>Sostituire , <azure-communication-services-resource-name>e <linked-domain-resource-id> nel codice di esempio.

L'ID risorsa del dominio collegato deve essere nel formato seguente.

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

Se si usa un dominio gestito di Azure, è domain-name "AzureManagedDomain". Deve email-service-name essere lo stesso servizio di posta elettronica usato per effettuare il provisioning del dominio.

Dopo aver popolato questi valori, eseguire il codice di esempio.

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

Disconnettere un dominio di posta elettronica dalla risorsa del servizio di comunicazione

Sostituire , <resource-group-name>e <azure-communication-services-resource-name> nel codice di esempio.

Dopo aver popolato questi valori, eseguire il codice di esempio.

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

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

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
  • Una risorsa di Servizi di comunicazione di posta elettronica di Azure pronta per il provisioning dei domini. Introduzione alla creazione di una risorsa di comunicazione tramite posta elettronica.
  • Un dominio gestito di Azure o un dominio personalizzato di cui è stato effettuato il provisioning e pronto per l'invio di messaggi di posta elettronica. Questo dominio deve essere verificato completamente prima di tentare di collegarlo alla risorsa del servizio di comunicazione.
  • Risorsa Servizi di comunicazione di Azure. Creare risorse di Servizi di comunicazione.
  • Viene usata un'entità servizio per l'autenticazione. Impostare i valori dell'ID client, dell'ID tenant e del segreto client dell'applicazione Microsoft Entra come variabili di ambiente seguenti: AZURE_CLIENT_ID, AZURE_TENANT_IDe AZURE_CLIENT_SECRET.

Installare i pacchetti necessari

Aggiungere la dipendenza seguente a pom.xml.

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

Inizializzare il client di gestione

Impostare la variabile AZURE_SUBSCRIPTION_ID di ambiente con l'ID sottoscrizione della sottoscrizione in cui si trovano le risorse dominio e posta elettronica. Eseguire l'esempio di codice per inizializzare il client di gestione.

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

Connessione un dominio di posta elettronica a una risorsa del servizio di comunicazione

<resource-group-name>Sostituire , <azure-communication-services-resource-name>e <linked-domain-resource-id> nel codice di esempio.

L'ID risorsa del dominio collegato deve essere nel formato seguente.

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

Se si usa un dominio gestito di Azure, è domain-name "AzureManagedDomain". Deve email-service-name essere lo stesso servizio di posta elettronica usato per effettuare il provisioning del dominio.

Dopo aver popolato questi valori, eseguire il codice di esempio.

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

Disconnettere un dominio di posta elettronica dalla risorsa del servizio di comunicazione

Sostituire , <resource-group-name>e <azure-communication-services-resource-name> nel codice di esempio.

Dopo aver popolato questi valori, eseguire il codice di esempio.

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

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
  • Una risorsa di Servizi di comunicazione di posta elettronica di Azure pronta per il provisioning dei domini. Introduzione alla creazione di una risorsa di comunicazione tramite posta elettronica.
  • Un dominio gestito di Azure o un dominio personalizzato di cui è stato effettuato il provisioning e pronto per l'invio di messaggi di posta elettronica. Questo dominio deve essere verificato completamente prima di tentare di collegarlo alla risorsa del servizio di comunicazione.
  • Risorsa Servizi di comunicazione di Azure. Creare risorse di Servizi di comunicazione.
  • Viene usata un'entità servizio per l'autenticazione. Impostare i valori dell'ID client, dell'ID tenant e del segreto client dell'applicazione Microsoft Entra come variabili di ambiente seguenti: AZURE_CLIENT_ID, AZURE_TENANT_IDe AZURE_CLIENT_SECRET.

Installare i pacchetti necessari

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

Inizializzare il client di gestione

Sostituire il campo nel codice di esempio con l'ID sottoscrizione della sottoscrizione in cui si trovano le risorse dominio e posta elettronica. Eseguire l'esempio di codice per inizializzare il client di gestione.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Connessione un dominio di posta elettronica a una risorsa del servizio di comunicazione

<resource-group-name>Sostituire , <azure-communication-services-resource-name>e <linked-domain-resource-id> nel codice di esempio.

L'ID risorsa del dominio collegato deve essere nel formato seguente.

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

Se si usa un dominio gestito di Azure, è domain-name "AzureManagedDomain". Deve email-service-name essere lo stesso servizio di posta elettronica usato per effettuare il provisioning del dominio.

Dopo aver popolato questi valori, eseguire il codice di esempio.


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

Disconnettere un dominio di posta elettronica dalla risorsa del servizio di comunicazione

<resource-group-name> Sostituire e <azure-communication-services-resource-name> nel codice di esempio.

Dopo aver popolato questi valori, eseguire il codice di esempio.


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

Passaggi successivi