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

En esta guía de inicio rápido obtendrá información sobre 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 de recursos de Azure Communication Services, haga clic en Domains en el panel de navegación izquierdo en Email.

   

2. Seleccione una de las opciones siguientes:

   • Haga clic en Conectar dominio en la barra de navegación superior.

   • Haga clic en Conectar dominio en la pantalla de presentación.

     

3. Selección de uno de los dominios comprobados mediante el filtrado

   • 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 se seleccionó durante la creación de recursos son los mismos.

4. Haga clic en Conectar

   

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

1. En la página Información general de recursos de Azure Communication Services, haga clic en Domains en el panel de navegación izquierdo en Email.

2. Seleccione los dominios conectados y haga clic en 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.

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, 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 rellenados 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 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

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.

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.

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

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.

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.

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