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

Tento rychlý start popisuje, jak připojit ověřenou doménu ve službě Azure Communication Services k odesílání e-mailů.

Požadavky

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

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

    Snímek obrazovky znázorňující levý navigační panel pro propojení e-mailových domén

  2. Vyberte jednu z následujících možností:

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

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

      Snímek obrazovky, který ukazuje, jak připojit jednu z ověřených e-mailových domén

  3. Filtrováním vyberte jednu z ověřených domén:

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

    Snímek obrazovky znázorňující, jak filtrovat a vybrat jednu z ověřených e-mailových domén pro připojení

Poznámka:

Domény můžete připojit pouze ve stejné zeměpisné oblasti. Ujistěte se, že umístění dat pro komunikační prostředek a prostředek e-mailové komunikace, které jste vybrali při vytváření prostředků, jsou ve stejné zeměpisné oblasti.

  1. Klepněte na tlačítko Připojit.

    Snímek obrazovky znázorňující jednu z ověřených e-mailových domén je teď připojená

Poznámka:

Zákazníkům umožňujeme propojit až 100 vlastních domén s jedním prostředkem komunikační služby. Všechny adresy od pošty nakonfigurované v rámci těchto vlastních domén jsou přístupné pro prostředek komunikační služby. Můžete propojit jenom ověřené vlastní domény.

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

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

  2. Vyberte připojené domény a pak klikněte na ... a vyberte Odpojit.

    Snímek obrazovky, který ukazuje, jak odpojit připojenou doménu

Požadavky

Připojení e-mailové domény 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 naformátujte následujícím způsobem:

/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 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 vytvořte požadavek PATCH pomocí následující adresy URL a textu 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 vytvořte požadavek PATCH pomocí následující adresy URL a textu 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

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-mailové domény 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 naformátujte následujícím způsobem:

/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();
patch.LinkedDomains.Clear();
CommunicationServiceResource result = await communicationServiceResource.UpdateAsync(patch);

Požadavky

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-mailové domény 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 naformátujte následujícím způsobem:

/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 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

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-mailové domény 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

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-mailové domény 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

  • Seznámení s e-mailovou klientskou knihovnou