Dela via


Snabbstart: Så här ansluter du en verifierad e-postdomän

Den här snabbstarten beskriver hur du ansluter en verifierad domän i Azure Communication Services för att skicka e-post.

Förutsättningar

Ansluta en e-postdomän till en kommunikationstjänstresurs

  1. På översiktssidan för Azure Communication Service-resursen går du till den vänstra navigeringspanelen under E-post och klickar på Domäner.

    Skärmbild som visar den vänstra navigeringspanelen för länkning av e-postdomäner.

  2. Välj ett av följande alternativ:

    • I det övre navigeringsfältet klickar du på Anslut domän.

    • På välkomstskärmen klickar du på Anslut domän.

      Skärmbild som visar hur du ansluter en av dina verifierade e-postdomäner.

  3. Välj en av de verifierade domänerna genom att filtrera:

    • Abonnemang
    • Resursgrupp
    • E-posttjänst
    • Verifierad domän

    Skärmbild som visar hur du filtrerar och väljer en av de verifierade e-postdomänerna som ska anslutas.

Kommentar

Du kan bara ansluta domäner i samma geografiska område. Kontrollera att dataplatsen för kommunikationsresursen och e-postkommunikationsresursen som du valde när resursen skapades finns i samma geografiska område.

  1. Klicka på Anslut.

    Skärmbild som visar att en av de verifierade e-postdomänerna nu är ansluten.

Kommentar

Vi gör det möjligt för kunder att länka upp till 100 anpassade domäner till en enda kommunikationstjänstresurs. Alla e-postadresser som konfigurerats under dessa anpassade domäner är tillgängliga för kommunikationstjänstresursen. Du kan bara länka verifierade anpassade domäner.

Koppla från en e-postdomän från kommunikationstjänstresursen

  1. På sidan Resursöversikt för Azure Communication Services klickar du på Domäner i den vänstra navigeringspanelen under E-post.

  2. Välj Anslutna domäner och klicka sedan på ... och välj Koppla från.

    Skärmbild som visar hur du kopplar från den anslutna domänen.

Förutsättningar

Ansluta en e-postdomän till en kommunikationstjänstresurs

{subscription-id}Ersätt , {resource-group-name}, {communication-services-resource-name}och {linked-domain-resource-id} i exempelbegäran.

Formatera det länkade domänresurs-ID:t på följande sätt:

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

Om du använder en Azure Managed Domain domain-name är "AzureManagedDomain". email-service-name Bör vara samma e-posttjänst som du använde för att etablera domänen.

När dessa värden har fyllts i gör du en PATCH-begäran med hjälp av följande URL och brödtext för begäran.

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

Koppla från en e-postdomän från kommunikationstjänstresursen

{subscription-id}Ersätt , {resource-group-name}och {communication-services-resource-name} i exempelbegäran.

När dessa värden har fyllts i gör du en PATCH-begäran med hjälp av följande URL och brödtext för begäran.

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

Förutsättningar

Installera de paket som krävs

dotnet add package Azure.ResourceManager.Communication

Initiera hanteringsklienten

Ange miljövariabeln AZURE_SUBSCRIPTION_ID med prenumerations-ID för prenumerationen som domän- och e-postresurserna finns i. Kör kodexemplet för att initiera hanteringsklienten.

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

Ansluta en e-postdomän till en kommunikationstjänstresurs

<subscription-id>Ersätt , <resource-group-name>, <azure-communication-services-resource-name>och <linked-domain-resource-id> i exempelkoden.

Formatera det länkade domänresurs-ID:t på följande sätt:

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

Om du använder en Azure Managed Domain domain-name är det "AzureManagedDomain". email-service-name Bör vara samma e-posttjänst som du använde för att etablera domänen.

När dessa värden har fyllts i kör du exempelkoden.

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

Koppla från en e-postdomän från kommunikationstjänstresursen

<subscription-id>Ersätt , <resource-group-name>och <azure-communication-services-resource-name> i exempelkoden.

När dessa värden har fyllts i kör du exempelkoden.

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

Förutsättningar

Installera de paket som krävs

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

Initiera hanteringsklienten

Ersätt fältet i exempelkoden med prenumerations-ID:t för prenumerationen som dina domän- och e-postresurser finns i. Kör kodexemplet för att initiera hanteringsklienten.

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

Ansluta en e-postdomän till en kommunikationstjänstresurs

<resource-group-name>Ersätt , <azure-communication-services-resource-name>och <linked-domain-resource-id> i exempelkoden.

Formatera det länkade domänresurs-ID:t på följande sätt:

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

Om du använder en Azure Managed Domain domain-name är "AzureManagedDomain". email-service-name Bör vara samma e-posttjänst som du använde för att etablera domänen.

När dessa värden har fyllts i kör du exempelkoden.

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

Koppla från en e-postdomän från kommunikationstjänstresursen

<resource-group-name>Ersätt , och <azure-communication-services-resource-name> i exempelkoden.

När dessa värden har fyllts i kör du exempelkoden.

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

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

Förutsättningar

Installera de paket som krävs

Lägg till följande beroende i .pom.xml

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

Initiera hanteringsklienten

Ange miljövariabeln AZURE_SUBSCRIPTION_ID med prenumerations-ID för prenumerationen som domän- och e-postresurserna finns i. Kör kodexemplet för att initiera hanteringsklienten.

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

Ansluta en e-postdomän till en kommunikationstjänstresurs

<resource-group-name>Ersätt , <azure-communication-services-resource-name>och <linked-domain-resource-id> i exempelkoden.

Det länkade domänresurs-ID:t ska vara i följande format.

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

Om du använder en Azure Managed Domain domain-name är "AzureManagedDomain". email-service-name Bör vara samma e-posttjänst som du använde för att etablera domänen.

När dessa värden har fyllts i kör du exempelkoden.

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

Koppla från en e-postdomän från kommunikationstjänstresursen

<resource-group-name>Ersätt , och <azure-communication-services-resource-name> i exempelkoden.

När dessa värden har fyllts i kör du exempelkoden.

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

Förutsättningar

Installera de paket som krävs

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

Initiera hanteringsklienten

Ersätt fältet i exempelkoden med prenumerations-ID:t för prenumerationen som dina domän- och e-postresurser finns i. Kör kodexemplet för att initiera hanteringsklienten.

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

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

client = CommunicationServiceManagementClient(credential, subscription_id)

Ansluta en e-postdomän till en kommunikationstjänstresurs

<resource-group-name>Ersätt , <azure-communication-services-resource-name>och <linked-domain-resource-id> i exempelkoden.

Det länkade domänresurs-ID:t ska vara i följande format.

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

Om du använder en Azure Managed Domain domain-name är "AzureManagedDomain". email-service-name Bör vara samma e-posttjänst som du använde för att etablera domänen.

När dessa värden har fyllts i kör du exempelkoden.


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

Koppla från en e-postdomän från kommunikationstjänstresursen

<resource-group-name> Ersätt och <azure-communication-services-resource-name> i exempelkoden.

När dessa värden har fyllts i kör du exempelkoden.


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

Nästa steg