Guia de início rápido: como conectar um domínio de e-mail verificado

  • Artigo

Neste início rápido, você aprenderá a conectar um domínio verificado nos Serviços de Comunicação do Azure para enviar email.

Pré-requisitos

Conectar um domínio de email a um recurso de serviço de comunicação

  1. Na página de visão geral do Recurso do Serviço de Comunicação do Azure, clique em Domínios no painel de navegação esquerdo em Email.

    Captura de tela que mostra o painel de navegação esquerdo para vincular domínios de e-mail.

  2. Selecione uma das opções abaixo

    • Clique em Conectar domínio na barra de navegação superior.

    • Clique em Conectar domínio na tela inicial.

      Captura de ecrã que mostra como ligar um dos seus domínios de e-mail verificados.

  3. Selecione um dos domínios verificados filtrando

    • Subscrição
    • Grupo de Recursos
    • Serviço de Email
    • Domínio verificado

    Captura de tela que mostra como filtrar e selecionar um dos domínios de e-mail verificados para se conectar.

Nota

Permitimos apenas ligar os domínios na mesma geografia. Certifique-se de que a localização dos dados para o recurso de comunicação e o recurso de comunicação por e-mail que foi selecionado durante a criação do recurso são os mesmos.

  1. Clique em Conectar

    Captura de ecrã que mostra que um dos domínios de e-mail verificados está agora ligado.

Desconectar um domínio de email do recurso de serviço de comunicação

  1. Na página de visão geral do Recurso do Serviço de Comunicação do Azure, clique em Domínios no painel de navegação esquerdo em Email.

  2. Selecione os Domínios Conectados, clique no botão ... e clique em Desconectar.

    Captura de tela que mostra como desconectar o domínio conectado.

Pré-requisitos

Conectar um domínio de email a um recurso de serviço de comunicação

Substitua o {subscription-id}, {resource-group-name}, {communication-services-resource-name}, e {linked-domain-resource-id} na solicitação de amostra.

O ID do recurso de domínio vinculado deve estar no seguinte formato.

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

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name é "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de e-mail que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, faça uma solicitação PATCH para o usando a seguinte URL e Corpo da Solicitação.

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

Desconectar um domínio de email do recurso de serviço de comunicação

Substitua o {subscription-id}, {resource-group-name}e {communication-services-resource-name} na solicitação de amostra.

Depois que esses valores forem preenchidos, faça uma solicitação PATCH para o usando a seguinte URL e Corpo da Solicitação.

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é-requisitos

Instale os pacotes necessários

dotnet add package Azure.ResourceManager.Communication

Inicializar o cliente de gerenciamento

Defina a variável AZURE_SUBSCRIPTION_ID de ambiente com o ID de assinatura da assinatura em que seus recursos de Domínio e Email estão. Execute o exemplo de código para inicializar o cliente de gerenciamento.

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

Conectar um domínio de email a um recurso de serviço de comunicação

Substitua o <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name>e <linked-domain-resource-id> no código de exemplo.

O ID do recurso de domínio vinculado deve estar no seguinte formato.

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

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name é "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de e-mail que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.

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

Desconectar um domínio de email do recurso de serviço de comunicação

Substitua o <subscription-id>, <resource-group-name>e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.

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

Pré-requisitos

Instale os pacotes necessários

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

Inicializar o cliente de gerenciamento

Substitua o campo no código de exemplo pelo ID de assinatura da assinatura em que seus recursos de domínio e e-mail estão. Execute o exemplo de código para inicializar o cliente de gerenciamento.

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

Conectar um domínio de email a um recurso de serviço de comunicação

Substitua o <resource-group-name>, <azure-communication-services-resource-name>e <linked-domain-resource-id> no código de exemplo.

O ID do recurso de domínio vinculado deve estar no seguinte formato.

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

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name é "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de e-mail que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.

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

Desconectar um domínio de email do recurso de serviço de comunicação

Substitua o <resource-group-name>, e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.

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

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

Pré-requisitos

Instale os pacotes necessários

Adicione a seguinte dependência ao seu pom.xml.

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

Inicializar o cliente de gerenciamento

Defina a variável AZURE_SUBSCRIPTION_ID de ambiente com o ID de assinatura da assinatura em que seus recursos de Domínio e Email estão. Execute o exemplo de código para inicializar o cliente de gerenciamento.

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

Conectar um domínio de email a um recurso de serviço de comunicação

Substitua o <resource-group-name>, <azure-communication-services-resource-name>e <linked-domain-resource-id> no código de exemplo.

O ID do recurso de domínio vinculado deve estar no seguinte formato.

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

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name é "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de e-mail que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.

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

Desconectar um domínio de email do recurso de serviço de comunicação

Substitua o <resource-group-name>, e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.

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

Pré-requisitos

Instale os pacotes necessários

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

Inicializar o cliente de gerenciamento

Substitua o campo no código de exemplo pelo ID de assinatura da assinatura em que seus recursos de domínio e e-mail estão. Execute o exemplo de código para inicializar o cliente de gerenciamento.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Conectar um domínio de email a um recurso de serviço de comunicação

Substitua o <resource-group-name>, <azure-communication-services-resource-name>e <linked-domain-resource-id> no código de exemplo.

O ID do recurso de domínio vinculado deve estar no seguinte formato.

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

Se você estiver usando um Domínio Gerenciado do Azure, o domain-name é "AzureManagedDomain". O email-service-name deve ser o mesmo serviço de e-mail que você usou para provisionar o domínio.

Depois que esses valores forem preenchidos, execute o código de exemplo.


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

Desconectar um domínio de email do recurso de serviço de comunicação

Substitua o <resource-group-name> e <azure-communication-services-resource-name> no código de exemplo.

Depois que esses valores forem preenchidos, execute o código de exemplo.


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

Próximos passos

  • Familiarize-se com a biblioteca de cliente de e-mail