Szybki start: jak połączyć zweryfikowaną domenę poczty e-mail
Z tego przewodnika Szybki start dowiesz się, jak połączyć zweryfikowaną domenę w usługach Azure Communication Services w celu wysyłania wiadomości e-mail.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
- Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
- Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
- Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
Połączenie domenę poczty e-mail do zasobu usługi komunikacyjnej
Na stronie Omówienie zasobu usługi Azure Communication Service kliknij pozycję Domeny na panelu nawigacji po lewej stronie w obszarze Poczta e-mail.
Wybierz jedną z poniższych opcji
Kliknij Połączenie domenę na górnym pasku nawigacyjnym.
Kliknij Połączenie domenę na ekranie powitalnym.
Wybierz jedną ze zweryfikowanych domen, filtrując
- Subskrypcja
- Grupa zasobów
- Usługa poczty e-mail
- Zweryfikowana domena
Uwaga
Zezwalamy tylko na łączenie domen w tej samej lokalizacji geograficznej. Upewnij się, że lokalizacja danych dla zasobu komunikacji i zasobu komunikacji poczty e-mail wybranego podczas tworzenia zasobu jest taka sama.
Kliknij Połączenie
Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej
Na stronie Omówienie zasobu usługi Azure Communication Service kliknij pozycję Domeny na panelu nawigacji po lewej stronie w obszarze Poczta e-mail.
Wybierz Połączenie domeny kliknij przycisk ... a następnie kliknij przycisk Rozłącz.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
- Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
- Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
- Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
Połączenie domenę poczty e-mail do zasobu usługi komunikacyjnej
Zastąp element {subscription-id}, {resource-group-name}, {communication-services-resource-name}i {linked-domain-resource-id} w przykładowym żądaniu.
Identyfikator zasobu połączonej domeny powinien mieć następujący format.
/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Communication/emailServices/{email-service-name}/domains/{domain-name}
Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.
Po wypełnieniu tych wartości wykonaj żądanie PATCH do następującego adresu URL żądania i treści żądania.
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}"]
}
}
Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej
Zastąp element {subscription-id}, {resource-group-name}i {communication-services-resource-name} w przykładowym żądaniu.
Po wypełnieniu tych wartości należy wysłać żądanie PATCH do następującego adresu URL żądania i treści żądania.
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": []
}
}
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
- Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
- Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
- Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
- Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe:
AZURE_CLIENT_ID,AZURE_TENANT_IDiAZURE_CLIENT_SECRET.
Instalowanie wymaganych pakietów
dotnet add package Azure.ResourceManager.Communication
Inicjowanie klienta zarządzania
Ustaw zmienną środowiskową AZURE_SUBSCRIPTION_ID przy użyciu identyfikatora subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.
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());
Połączenie domenę poczty e-mail do zasobu usługi komunikacyjnej
Zastąp element <subscription-id>, <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.
Identyfikator zasobu połączonej domeny powinien mieć następujący format.
/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>
Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.
Po wypełnieniu tych wartości uruchom przykładowy kod.
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);
Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej
Zastąp element <subscription-id>, <resource-group-name>i <azure-communication-services-resource-name> w przykładowym kodzie.
Po wypełnieniu tych wartości uruchom przykładowy kod.
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);
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
- Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
- Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
- Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
- Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe:
AZURE_CLIENT_ID,AZURE_TENANT_IDiAZURE_CLIENT_SECRET.
Instalowanie wymaganych pakietów
npm install @azure/arm-communication
npm install @azure/identity
Inicjowanie klienta zarządzania
Zastąp pole w przykładowym kodzie identyfikatorem subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.
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);
Połączenie domenę poczty e-mail do zasobu usługi komunikacyjnej
Zastąp element <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.
Identyfikator zasobu połączonej domeny powinien mieć następujący format.
/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>
Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.
Po wypełnieniu tych wartości uruchom przykładowy kod.
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
);
Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej
Zastąp element <resource-group-name>i <azure-communication-services-resource-name> w przykładowym kodzie.
Po wypełnieniu tych wartości uruchom przykładowy kod.
const parameters = {
dataLocation: "United States",
location: "Global"
};
const result = await client.communicationServices.beginCreateOrUpdateAndWait(
"<resource-group-name>",
"<azure-communication-services-resource-name>",
parameters
);
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
- Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
- Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
- Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
- Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe:
AZURE_CLIENT_ID,AZURE_TENANT_IDiAZURE_CLIENT_SECRET.
Instalowanie wymaganych pakietów
Dodaj następującą zależność do elementu pom.xml.
<dependency>
<groupId>com.azure.resourcemanager</groupId>
<artifactId>azure-resourcemanager-communication</artifactId>
<version>2.0.0</version>
</dependency>
Inicjowanie klienta zarządzania
Ustaw zmienną środowiskową AZURE_SUBSCRIPTION_ID przy użyciu identyfikatora subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
TokenCredential credential = new DefaultAzureCredentialBuilder()
.authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
.build();
CommunicationManager manager = CommunicationManager
.authenticate(credential, profile);
Połączenie domenę poczty e-mail do zasobu usługi komunikacyjnej
Zastąp element <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.
Identyfikator zasobu połączonej domeny powinien mieć następujący format.
/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>
Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.
Po wypełnieniu tych wartości uruchom przykładowy kod.
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();
Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej
Zastąp element <resource-group-name>i <azure-communication-services-resource-name> w przykładowym kodzie.
Po wypełnieniu tych wartości uruchom przykładowy kod.
manager
.communicationServices()
.define("<azure-communication-services-resource-name>")
.withRegion("Global")
.withExistingResourceGroup("<resource-group-name>")
.withDataLocation("United States")
.create();
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
- Zasób usług Azure Email Communication Services jest gotowy do aprowizacji domen. Rozpocznij tworzenie zasobu komunikacji e-mail.
- Domena zarządzana platformy Azure lub domena niestandardowa aprowizowana i gotowa do wysyłania wiadomości e-mail. Ta domena musi zostać w pełni zweryfikowana przed podjęciem próby połączenia jej z zasobem usługi komunikacji.
- Zasób usług Azure Communication Services. Utwórz zasoby usług komunikacyjnych.
- Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i wpisu tajnego klienta aplikacji Microsoft Entra jako następujące zmienne środowiskowe:
AZURE_CLIENT_ID,AZURE_TENANT_IDiAZURE_CLIENT_SECRET.
Instalowanie wymaganych pakietów
pip install azure-mgmt-communication
pip install azure-identity
Inicjowanie klienta zarządzania
Zastąp pole w przykładowym kodzie identyfikatorem subskrypcji subskrypcji, w których znajdują się zasoby domeny i poczty e-mail. Uruchom przykładowy kod, aby zainicjować klienta zarządzania.
from azure.mgmt.communication import CommunicationServiceManagementClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>"
client = CommunicationServiceManagementClient(credential, subscription_id)
Połączenie domenę poczty e-mail do zasobu usługi komunikacyjnej
Zastąp element <resource-group-name>, <azure-communication-services-resource-name>i <linked-domain-resource-id> w przykładowym kodzie.
Identyfikator zasobu połączonej domeny powinien mieć następujący format.
/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Communication/emailServices/<email-service-name>/domains/<domain-name>
Jeśli używasz domeny zarządzanej platformy Azure, domain-name jest to "AzureManagedDomain". Powinna email-service-name to być ta sama usługa poczty e-mail, która była używana do aprowizacji domeny.
Po wypełnieniu tych wartości uruchom przykładowy kod.
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()
Odłączanie domeny poczty e-mail od zasobu usługi komunikacyjnej
Zastąp element <resource-group-name> i <azure-communication-services-resource-name> w przykładowym kodzie.
Po wypełnieniu tych wartości uruchom przykładowy kod.
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()
Następne kroki
Powiązane artykuły
- Zapoznaj się z biblioteką klienta poczty e-mail