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
- Úč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-mailové domény k prostředku komunikační služby
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.
Vyberte jednu z následujících možností:
Filtrováním vyberte jednu z ověřených domén:
- Předplatné
- Skupina prostředků
- E-mailová služba
- Ověřená doména
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.
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
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- 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-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
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- 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_ID
aAZURE_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-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
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- 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_ID
aAZURE_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-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
- Úč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_ID
aAZURE_CLIENT_SECRET
.
Instalace požadovaných balíčků
Přidejte do svého pom.xml
souboru 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
- Úč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_ID
aAZURE_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-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()