Rychlý start: Připojení ověřené e-mailové domény

V tomto rychlém startu se dozvíte, jak připojit ověřenou doménu ve službě Azure Communication Services k odesílání e-mailů.

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Prostředek Azure Email Communication Services připravený ke zřízení domén. Začněte vytvářet prostředek pro e-mailovou komunikaci.
• Zřízená a připravená k odesílání e-mailů ve spravované doméně Azure nebo vlastní doméně . Před pokusem o propojení s prostředkem komunikační služby musí být tato doména plně ověřená.
• Prostředek Azure Communication Services. Vytvořte prostředky komunikačních služeb.

Připojení e-mailovou doménu k prostředku komunikační služby

1. Na stránce Přehled prostředků služby Azure Communication Service klikněte na Domény na levém navigačním panelu v části E-mail.

   

2. Vyberte jednu z možností níže.

   • V horním navigačním panelu klikněte na Připojení doménu.

   • Na úvodní obrazovce klikněte na Připojení doménu.

     

3. Vyberte jednu z ověřených domén filtrováním.

   • Předplatné
   • Skupina prostředků
   • E-mailová služba
   • Ověřená doména

   

Poznámka:

Povolujeme pouze připojení domén ve stejné zeměpisné oblasti. Ujistěte se, že umístění dat pro prostředek komunikace a prostředek komunikace e-mailem, které bylo vybráno při vytváření prostředku, jsou stejné.

4. Klikněte na Připojení

   

Odpojení e-mailové domény od prostředku komunikační služby

1. Na stránce Přehled prostředků služby Azure Communication Service klikněte na Domény na levém navigačním panelu v části E-mail.

2. Vyberte Připojení ed Domains klikněte na ... a klepněte na tlačítko Odpojit.

   

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Prostředek Azure Email Communication Services připravený ke zřízení domén. Začněte vytvářet prostředek pro e-mailovou komunikaci.
• Zřízená a připravená k odesílání e-mailů ve spravované doméně Azure nebo vlastní doméně . Před pokusem o propojení s prostředkem komunikační služby musí být tato doména plně ověřená.
• Prostředek Azure Communication Services. Vytvořte prostředky komunikačních služeb.

Připojení e-mailovou doménu k prostředku komunikační služby

Nahraďte položku {subscription-id}, {communication-services-resource-name}{resource-group-name}a {linked-domain-resource-id} v ukázkové žádosti.

ID propojeného prostředku domény by mělo být v následujícím formátu.

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

Pokud používáte spravovanou doménu Azure, jedná se o domain-name doménu AzureManagedDomain. Měla email-service-name by to být stejná e-mailová služba, kterou jste použili ke zřízení domény.

Po naplnění těchto hodnot proveďte požadavek PATCH na následující adresu URL požadavku a text požadavku.

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

Odpojení e-mailové domény od prostředku komunikační služby

Nahraďte položku {subscription-id}, {resource-group-name}a {communication-services-resource-name} v ukázkové žádosti.

Po naplnění těchto hodnot proveďte požadavek PATCH na následující adresu URL požadavku a text požadavku.

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

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Prostředek Azure Email Communication Services připravený ke zřízení domén. Začněte vytvářet prostředek pro e-mailovou komunikaci.
• Zřízená a připravená k odesílání e-mailů ve spravované doméně Azure nebo vlastní doméně . Před pokusem o propojení s prostředkem komunikační služby musí být tato doména plně ověřená.
• Prostředek Azure Communication Services. Vytvořte prostředky komunikačních služeb.
• K ověřování používáme instanční objekt. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako následující proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRET.

Instalace požadovaných balíčků

dotnet add package Azure.ResourceManager.Communication

Inicializace klienta pro správu

Nastavte proměnnou AZURE_SUBSCRIPTION_ID prostředí s ID předplatného předplatného, ve které jsou vaše prostředky domény a e-mailu. Spuštěním ukázky kódu inicializujete klienta pro správu.

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

Připojení e-mailovou doménu k prostředku komunikační služby

Nahraďte znak <subscription-id>, <azure-communication-services-resource-name><resource-group-name>a <linked-domain-resource-id> v vzorovém kódu.

ID propojeného prostředku domény by mělo být v následujícím formátu.

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

Pokud používáte spravovanou doménu Azure, jedná se o domain-name doménu AzureManagedDomain. Měla email-service-name by to být stejná e-mailová služba, kterou jste použili ke zřízení domény.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Odpojení e-mailové domény od prostředku komunikační služby

Nahraďte znak <subscription-id>, <resource-group-name>a <azure-communication-services-resource-name> v vzorovém kódu.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Prostředek Azure Email Communication Services připravený ke zřízení domén. Začněte vytvářet prostředek pro e-mailovou komunikaci.
• Zřízená a připravená k odesílání e-mailů ve spravované doméně Azure nebo vlastní doméně . Před pokusem o propojení s prostředkem komunikační služby musí být tato doména plně ověřená.
• Prostředek Azure Communication Services. Vytvořte prostředky komunikačních služeb.
• K ověřování používáme instanční objekt. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako následující proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRET.

Instalace požadovaných balíčků

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

Inicializace klienta pro správu

Nahraďte pole v ukázkovém kódu ID předplatného předplatného, ve které se nachází vaše doména a prostředky e-mailu. Spuštěním ukázky kódu inicializujete klienta pro správu.

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

Připojení e-mailovou doménu k prostředku komunikační služby

Nahraďte znak <resource-group-name>, <azure-communication-services-resource-name>a <linked-domain-resource-id> v vzorovém kódu.

ID propojeného prostředku domény by mělo být v následujícím formátu.

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

Pokud používáte spravovanou doménu Azure, jedná se o domain-name doménu AzureManagedDomain. Měla email-service-name by to být stejná e-mailová služba, kterou jste použili ke zřízení domény.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Odpojení e-mailové domény od prostředku komunikační služby

Nahraďte a <resource-group-name><azure-communication-services-resource-name> v vzorovém kódu.

Po naplnění těchto hodnot spusťte vzorový kód.

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

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

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Prostředek Azure Email Communication Services připravený ke zřízení domén. Začněte vytvářet prostředek pro e-mailovou komunikaci.
• Zřízená a připravená k odesílání e-mailů ve spravované doméně Azure nebo vlastní doméně . Před pokusem o propojení s prostředkem komunikační služby musí být tato doména plně ověřená.
• Prostředek Azure Communication Services. Vytvořte prostředky komunikačních služeb.
• K ověřování používáme instanční objekt. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako následující proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRET.

Instalace požadovaných balíčků

Přidejte do svého pom.xmlsouboru následující závislost .

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

Inicializace klienta pro správu

Nastavte proměnnou AZURE_SUBSCRIPTION_ID prostředí s ID předplatného předplatného, ve které jsou vaše prostředky domény a e-mailu. Spuštěním ukázky kódu inicializujete klienta pro správu.

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

Připojení e-mailovou doménu k prostředku komunikační služby

Nahraďte znak <resource-group-name>, <azure-communication-services-resource-name>a <linked-domain-resource-id> v vzorovém kódu.

ID propojeného prostředku domény by mělo být v následujícím formátu.

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

Pokud používáte spravovanou doménu Azure, jedná se o domain-name doménu AzureManagedDomain. Měla email-service-name by to být stejná e-mailová služba, kterou jste použili ke zřízení domény.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Odpojení e-mailové domény od prostředku komunikační služby

Nahraďte a <resource-group-name><azure-communication-services-resource-name> v vzorovém kódu.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Prostředek Azure Email Communication Services připravený ke zřízení domén. Začněte vytvářet prostředek pro e-mailovou komunikaci.
• Zřízená a připravená k odesílání e-mailů ve spravované doméně Azure nebo vlastní doméně . Před pokusem o propojení s prostředkem komunikační služby musí být tato doména plně ověřená.
• Prostředek Azure Communication Services. Vytvořte prostředky komunikačních služeb.
• K ověřování používáme instanční objekt. Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace Microsoft Entra jako následující proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_IDa AZURE_CLIENT_SECRET.

Instalace požadovaných balíčků

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

Inicializace klienta pro správu

Nahraďte pole v ukázkovém kódu ID předplatného předplatného, ve které se nachází vaše doména a prostředky e-mailu. Spuštěním ukázky kódu inicializujete klienta pro správu.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Připojení e-mailovou doménu k prostředku komunikační služby

Nahraďte znak <resource-group-name>, <azure-communication-services-resource-name>a <linked-domain-resource-id> v vzorovém kódu.

ID propojeného prostředku domény by mělo být v následujícím formátu.

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

Pokud používáte spravovanou doménu Azure, jedná se o domain-name doménu AzureManagedDomain. Měla email-service-name by to být stejná e-mailová služba, kterou jste použili ke zřízení domény.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Odpojení e-mailové domény od prostředku komunikační služby

<resource-group-name> Nahraďte vzorový kód a <azure-communication-services-resource-name> v tomto vzorovém kódu.

Po naplnění těchto hodnot spusťte vzorový kód.

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

Další kroky

• Jak odeslat e-mail

• Co je prostředek komunikace e-mailu pro službu Azure Communication Services

Související články

• Seznámení s e-mailovou klientskou knihovnou