Inicio rápido: Conexión de un dominio de correo electrónico verificado

En este inicio rápido se describe cómo conectar un dominio comprobado en Azure Communication Services para enviar correo electrónico.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Azure Email Communication Services listo para aprovisionar dominios. Introducción a la creación de un recurso de comunicación de correo electrónico.
• Un dominio administrado de Azure o Custom Domain aprovisionado y listo para enviar correos electrónicos. Este dominio debe comprobarse completamente antes de intentar vincularlo al recurso de Communication Services.
• Un recurso de Azure Communication Services. Cree un recurso de Communication Services.

Conexión de un dominio de correo electrónico a un recurso de Communication Services

1. En la página Información general del recurso de Azure Communication Services, haga clic en Dominios en el panel de navegación izquierdo en Correo electrónico.

   

2. Seleccione una de las siguientes opciones:

   • En la barra de navegación superior, haga clic en Conectar dominio.

   • En la pantalla de presentación, haga clic en Conectar dominio.

     

3. Para seleccionar uno de los dominios comprobados, filtre por lo siguiente:

   • Suscripción
   • Grupo de recursos
   • Servicio de correo electrónico
   • Dominio comprobado

   

Nota:

Solo se permite la conexión de los dominios en la misma geografía. Asegúrese de que la ubicación de los datos para el recurso de comunicación y el recurso de comunicación de correo electrónico que ha seleccionado durante la creación de los recursos están en la misma geografía.

4. Haga clic en Conectar.

   

Nota:

Se permite a los clientes vincular hasta 100 dominios personalizados a un único recurso de servicio de comunicación. Todas las direcciones de correo electrónico configuradas en estos dominios personalizados son accesibles para el recurso del servicio de comunicación. Solo puede vincular dominios personalizados comprobados.

Desconexión de un dominio de correo electrónico de un recurso de Communication Services

1. En la página Información general del recurso de Azure Communication Services, haga clic en Dominios en el panel de navegación izquierdo en Correo electrónico.

2. Seleccione los dominios conectados, haga clic en ... y seleccione Desconectar.

   

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Azure Email Communication Services listo para aprovisionar dominios. Introducción a la creación de un recurso de comunicación de correo electrónico.
• Un dominio administrado de Azure o Custom Domain aprovisionado y listo para enviar correos electrónicos. Este dominio debe comprobarse completamente antes de intentar vincularlo al recurso de Communication Services.
• Un recurso de Azure Communication Services. Cree un recurso de Communication Services.

Conexión de un dominio de correo electrónico a un recurso de Communication Services

Reemplace {subscription-id}, {resource-group-name}, {communication-services-resource-name} y {linked-domain-resource-id} en la solicitud de ejemplo.

Aplique el siguiente formato al identificador de recurso de dominio vinculado:

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

Si usa un dominio administrado de Azure, domain-name es "AzureManagedDomain". email-service-name debe ser el mismo servicio de correo electrónico que usó para aprovisionar el dominio.

Una vez que rellenes estos valores, realice una solicitud PATCH mediante la siguiente dirección URL y cuerpo de solicitud.

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

Desconexión de un dominio de correo electrónico de un recurso de Communication Services

Reemplace {subscription-id}, {resource-group-name} y {communication-services-resource-name} en la solicitud de ejemplo.

Una vez que rellenes estos valores, realice una solicitud PATCH mediante la siguiente dirección URL y cuerpo de solicitud.

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

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Azure Email Communication Services listo para aprovisionar dominios. Introducción a la creación de un recurso de comunicación de correo electrónico.
• Un dominio administrado de Azure o Custom Domain aprovisionado y listo para enviar correos electrónicos. Este dominio debe comprobarse completamente antes de intentar vincularlo al recurso de Communication Services.
• Un recurso de Azure Communication Services. Cree un recurso de Communication Services.
• Estamos usando una entidad de servicio para la autenticación. Establezca los valores de Id. de cliente, Id. de inquilino y secreto de cliente de la aplicación Microsoft Entra con las siguientes variables de entorno: AZURE_CLIENT_ID, AZURE_TENANT_ID y AZURE_CLIENT_SECRET.

Instalación de los paquetes necesarios

dotnet add package Azure.ResourceManager.Communication

Inicializar el cliente de administración

Establecer la variable de entorno AZURE_SUBSCRIPTION_ID con el id. de suscripción de la suscripción en la que se encuentran los recursos de dominio y correo electrónico. Ejecutar el ejemplo de código para inicializar el cliente de administración.

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

Conexión de un dominio de correo electrónico a un recurso de Communication Services

Reemplace <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name> y <linked-domain-resource-id> en el código de ejemplo.

Aplique el siguiente formato al identificador de recurso de dominio vinculado:

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

Si usa un dominio administrado de Azure, domain-name es "AzureManagedDomain". email-service-name debe ser el mismo servicio de correo electrónico que usó para aprovisionar el dominio.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Desconexión de un dominio de correo electrónico de un recurso de Communication Services

Reemplace <subscription-id>, <resource-group-name> y <azure-communication-services-resource-name> en el código de ejemplo.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Azure Email Communication Services listo para aprovisionar dominios. Introducción a la creación de un recurso de comunicación de correo electrónico.
• Un dominio administrado de Azure o Custom Domain aprovisionado y listo para enviar correos electrónicos. Este dominio debe comprobarse completamente antes de intentar vincularlo al recurso de Communication Services.
• Un recurso de Azure Communication Services. Cree un recurso de Communication Services.
• Estamos usando una entidad de servicio para la autenticación. Establezca los valores de Id. de cliente, Id. de inquilino y secreto de cliente de la aplicación Microsoft Entra con las siguientes variables de entorno: AZURE_CLIENT_ID, AZURE_TENANT_ID y AZURE_CLIENT_SECRET.

Instalación de los paquetes necesarios

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

Inicializar el cliente de administración

Reemplace el campo del código de ejemplo por el id. de suscripción de la suscripción en la que se encuentran los recursos de dominio y correo electrónico. Ejecutar el ejemplo de código para inicializar el cliente de administración.

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

Conexión de un dominio de correo electrónico a un recurso de Communication Services

Reemplace <resource-group-name>, <azure-communication-services-resource-name> y <linked-domain-resource-id> en el código de ejemplo.

Aplique el siguiente formato al identificador de recurso de dominio vinculado:

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

Si usa un dominio administrado de Azure, domain-name es "AzureManagedDomain". email-service-name debe ser el mismo servicio de correo electrónico que usó para aprovisionar el dominio.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Desconexión de un dominio de correo electrónico de un recurso de Communication Services

Reemplace <resource-group-name> y <azure-communication-services-resource-name> en el código de ejemplo.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

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

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Azure Email Communication Services listo para aprovisionar dominios. Introducción a la creación de un recurso de comunicación de correo electrónico.
• Un dominio administrado de Azure o Custom Domain aprovisionado y listo para enviar correos electrónicos. Este dominio debe comprobarse completamente antes de intentar vincularlo al recurso de Communication Services.
• Un recurso de Azure Communication Services. Cree un recurso de Communication Services.
• Estamos usando una entidad de servicio para la autenticación. Establezca los valores de identificador de cliente, identificador de inquilino y secreto de cliente de la aplicación Microsoft Entra con las siguientes variables de entorno: AZURE_CLIENT_ID, AZURE_TENANT_ID y AZURE_CLIENT_SECRET.

Instalación de los paquetes necesarios

Agregue la siguiente dependencia en su pom.xml.

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

Inicializar el cliente de administración

Establecer la variable de entorno AZURE_SUBSCRIPTION_ID con el id. de suscripción de la suscripción en la que se encuentran los recursos de dominio y correo electrónico. Ejecutar el ejemplo de código para inicializar el cliente de administración.

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

Conexión de un dominio de correo electrónico a un recurso de Communication Services

Reemplace <resource-group-name>, <azure-communication-services-resource-name> y <linked-domain-resource-id> en el código de ejemplo.

El id. de recurso del dominio vinculado debe tener el formato siguiente.

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

Si usa un dominio administrado de Azure, domain-name es "AzureManagedDomain". email-service-name debe ser el mismo servicio de correo electrónico que usó para aprovisionar el dominio.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Desconexión de un dominio de correo electrónico de un recurso de Communication Services

Reemplace <resource-group-name> y <azure-communication-services-resource-name> en el código de ejemplo.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Azure Email Communication Services listo para aprovisionar dominios. Introducción a la creación de un recurso de comunicación de correo electrónico.
• Un dominio administrado de Azure o Custom Domain aprovisionado y listo para enviar correos electrónicos. Este dominio debe comprobarse completamente antes de intentar vincularlo al recurso de Communication Services.
• Un recurso de Azure Communication Services. Cree un recurso de Communication Services.
• Estamos usando una entidad de servicio para la autenticación. Establezca los valores de identificador de cliente, identificador de inquilino y secreto de cliente de la aplicación Microsoft Entra con las siguientes variables de entorno: AZURE_CLIENT_ID, AZURE_TENANT_ID y AZURE_CLIENT_SECRET.

Instalación de los paquetes necesarios

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

Inicializar el cliente de administración

Reemplace el campo del código de ejemplo por el id. de suscripción de la suscripción en la que se encuentran los recursos de dominio y correo electrónico. Ejecutar el ejemplo de código para inicializar el cliente de administración.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Conexión de un dominio de correo electrónico a un recurso de Communication Services

Reemplace <resource-group-name>, <azure-communication-services-resource-name> y <linked-domain-resource-id> en el código de ejemplo.

El id. de recurso del dominio vinculado debe tener el formato siguiente.

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

Si usa un dominio administrado de Azure, domain-name es "AzureManagedDomain". email-service-name debe ser el mismo servicio de correo electrónico que usó para aprovisionar el dominio.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Desconexión de un dominio de correo electrónico de un recurso de Communication Services

Reemplace <resource-group-name> y <azure-communication-services-resource-name> en el código de ejemplo.

Una vez rellenados estos valores, ejecute el código de ejemplo.

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

Pasos siguientes

• Envío de un correo electrónico

• ¿Qué es el recurso de comunicación por correo electrónico de Azure Communication Services?

Artículos relacionados

• Familiarizarse con la biblioteca cliente de correo electrónico