Rychlý start: Přidání spravovaných domén Azure do e-mailové komunikační služby

Tento článek popisuje, jak zřídit službu Azure Managed Domain for Email Communication Service ve službě Azure Communication Services.

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• E-mailový prostředek služby Azure Communication Services vytvořený a připravený k přidání domén. Viz Začínáme s vytvářením prostředku pro e-mailovou komunikaci.

Zřízení spravované domény Azure

1. Otevřete stránku Přehled prostředku e-mailové komunikace, který jste vytvořili v části Začínáme s vytvářením prostředku pro e-mailovou komunikaci.

2. Vytvořte spravovanou doménu Azure pomocí jedné z následujících možností.

   • (Možnost 1) Klikněte na tlačítko Přidat 1 v části Přidat bezplatnou subdoménu Azure. Pokračujte krokem 3.

   

   • (Možnost 2) Na levém navigačním panelu klikněte na Zřídit domény .

   

   • Na horním navigačním panelu klikněte na Přidat doménu .
   • V rozevíracím seznamu vyberte doménu Azure.

3. Počkejte, až se nasazení dokončí.

   

4. Po vytvoření domény se zobrazí zobrazení seznamu s novou doménou.

   

5. Kliknutím na název zřízené domény otevřete stránku přehledu pro typ prostředku domény.

   

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Instalace Azure CLI
• Vytvořte e-mailovou komunikační službu.

Vytvoření prostředku domény

Pokud chcete vytvořit prostředek domény, přihlaste se k Azure CLI. Můžete se přihlásit spuštěním az login příkazu z terminálu a zadat své přihlašovací údaje. Pokud chcete prostředek vytvořit, spusťte následující příkaz:

az communication email domain create --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management AzureManaged

Pokud chcete vybrat konkrétní předplatné, můžete také zadat --subscription příznak a zadat ID předplatného.

az communication email domain create --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management AzureManaged --subscription "<subscriptionId>"

Prostředek domény můžete nakonfigurovat s následujícími možnostmi:

• Skupina prostředků
• Název prostředku e-mailové komunikace
• Zeměpisná oblast, ke které bude prostředek přidružený
• Název prostředku domény:
  • V případě domén Azure by měl být název AzureManagedDomain.
• Hodnota vlastnosti Domain management.
  • U domén Azure by tato hodnota měla být AzureManaged.

V dalším kroku můžete přiřadit značky k prostředku domény. Značky se dají použít k uspořádání prostředků domény. Další informace o značkách najdete v dokumentaci k označování prostředků.

Správa prostředku domény

Pokud chcete do prostředku domény přidat značky, spusťte následující příkazy. Můžete také cílit na konkrétní předplatné.

az communication email domain update --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1"

az communication email domain update --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --subscription "<subscriptionId>"

Pokud chcete zobrazit seznam všech prostředků domény v dané službě pro e-mailovou komunikaci, použijte následující příkaz:

az communication email domain list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Pokud chcete zobrazit všechny informace o daném prostředku domény, použijte následující příkaz:

az communication email domain show --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Vyčištění prostředku domény

Pokud chcete vyčistit a odebrat prostředek domény, můžete ho odstranit spuštěním následujícího příkazu.

az communication email domain delete --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Poznámka:

Odstranění prostředku je trvalé a žádná data, včetně filtrů event gridu, telefonních čísel nebo jiných dat svázaných s vaším prostředkem, je možné obnovit, pokud prostředek odstraníte.

Informace o dalších příkazech najdete v tématu Domain CLI.

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Nejnovější verze sady .NET Core SDK pro váš operační systém.
• Získejte nejnovější verzi sady .NET Identity SDK.
• Získejte nejnovější verzi sady .NET Management SDK.

Instalace sady SDK

Nejprve do projektu C# zahrňte sadu SDK pro správu komunikačních služeb:

using Azure.ResourceManager.Communication;

Subscription ID

Potřebujete znát ID vašeho předplatného Azure. Můžete ho získat z portálu:

1. Přihlaste se ke svému účtu Azure.
2. Výběr předplatných na levém bočním panelu
3. Vyberte, které předplatné je potřeba.
4. Klikněte na Přehled.
5. Vyberte ID předplatného.

V tomto rychlém startu předpokládáme, že jste ID předplatného uložili do proměnné prostředí s názvem AZURE_SUBSCRIPTION_ID.

Ověřování

Pokud chcete komunikovat s prostředkem domény, musíte se nejprve ověřit v Azure.

Ověření klienta

Výchozí možností vytvoření ověřeného klienta je použití DefaultAzureCredential. Vzhledem k tomu, že všechna rozhraní API pro správu procházejí stejným koncovým bodem, aby bylo možné pracovat s prostředky, je potřeba vytvořit pouze jeden ArmClient nejvyšší úrovně.

Pokud se chcete ověřit v Azure a vytvořit ArmClient, proveďte následující kód:

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Resources;
...
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Interakce s prostředky Azure

Teď, když jste ověřeni.

Pro každý z následujících příkladů přiřadíme prostředky domény ke stávající službě e-mailové komunikace.

Pokud potřebujete vytvořit e-mailovou komunikační službu, můžete to udělat pomocí webu Azure Portal.

Vytvoření prostředku domény

Při vytváření prostředku domény musíte zadat název skupiny prostředků, název e-mailové komunikační služby, název prostředku a DomainManagement.

Poznámka:

Vlastnost Location je vždy global.

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation
string domainName = "AzureManagedDomain";
CommunicationDomainResourceData data = new CommunicationDomainResourceData(new AzureLocation("Global"))
{
    DomainManagement = DomainManagement.AzureManaged,
};
ArmOperation<CommunicationDomainResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, domainName, data);            
CommunicationDomainResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
CommunicationDomainResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Správa prostředků domény

Aktualizace prostředku domény

...
// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "AzureManagedDomain";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
CommunicationDomainResourcePatch patch = new CommunicationDomainResourcePatch()
{
    Tags =
    {
    ["newTag"] = "newVal",
    },
};
ArmOperation<CommunicationDomainResource> lro = await communicationDomainResource.UpdateAsync(WaitUntil.Completed, patch);
CommunicationDomainResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
CommunicationDomainResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Seznam podle e-mailové služby

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation and iterate over the result
await foreach (CommunicationDomainResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    CommunicationDomainResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Získání prostředku domény

// this example assumes you already have this EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation
string domainName = "AzureManagedDomain";
bool result = await collection.ExistsAsync(domainName);

Console.WriteLine($"Succeeded: {result}");

Vyčištění prostředku domény

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "AzureManagedDomain";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
await communicationDomainResource.DeleteAsync(WaitUntil.Completed);

Console.WriteLine($"Succeeded");

Poznámka:

Odstranění prostředku je trvalé a žádná data, včetně filtrů event gridu, telefonních čísel nebo jiných dat svázaných s vaším prostředkem, je možné obnovit, pokud prostředek odstraníte.

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Instalace modulu Azure Az PowerShell
• Vytvořte e-mailovou komunikační službu.

Vytvoření prostředku domény

Pokud chcete vytvořit prostředek domény, přihlaste se ke svému účtu Azure pomocí Connect-AzAccount následujícího příkazu a zadejte své přihlašovací údaje.

PS C:\> Connect-AzAccount

Nejprve pomocí následujícího příkazu nainstalujte modul Az.Communication Azure Communication Services.

PS C:\> Install-Module Az.Communication

Spuštěním následujícího příkazu vytvořte prostředek spravované domény Azure:

PS C:\> New-AzEmailServiceDomain -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -Name AzureManagedDomain -DomainManagement AzureManaged

Prostředek domény můžete nakonfigurovat s následujícími možnostmi:

• Skupina prostředků
• Název prostředku e-mailové komunikace.
• Název prostředku domény:
  • Pro domény Azure by měl být název – AzureManagedDomain.
• Hodnota vlastnosti Domain management.
  • U domén Azure by tato hodnota měla být AzureManaged.

V dalším kroku můžete přiřadit značky k prostředku domény. Značky se dají použít k uspořádání prostředků domény. Další informace o značkách najdete v dokumentaci k označování prostředků.

Správa prostředku domény

Pokud chcete do prostředku domény přidat značky, spusťte následující příkazy. Můžete také cílit na konkrétní předplatné.

PS C:\> Update-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}

PS C:\> Update-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID

Pokud chcete zobrazit seznam všech prostředků domény v dané službě pro e-mailovou komunikaci, použijte následující příkaz:

PS C:\> Get-AzEmailServiceDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Pokud chcete zobrazit seznam všech informací o daném prostředku domény, použijte následující příkaz:

PS C:\> Get-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Vyčištění prostředku domény

Pokud chcete vyčistit a odebrat prostředek domény, můžete prostředek domény odstranit spuštěním následujícího příkazu:

PS C:\> Remove-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Poznámka:

Odstranění prostředku je trvalé a žádná data, včetně filtrů event gridu, telefonních čísel nebo jiných dat svázaných s vaším prostředkem, je možné obnovit, pokud prostředek odstraníte.

Spravované domény Azure ve srovnání s vlastními doménami

Před zřízením spravované domény Azure si projděte následující tabulku a rozhodněte se, který typ domény nejlépe vyhovuje vašim potřebám.

	Spravované domény Azure	Vlastní domény
Profesionálové:	- Nastavení je rychlé a snadné – Nevyžaduje se žádné ověření domény.	- E-maily se odesílají z vaší vlastní domény.
Nevýhody:	– Doména odesílatele není přizpůsobená a nelze ji změnit. – Uživatelská jména odesílatelů nejde přizpůsobit - Velmi omezený svazek pro odesílání – Sledování zapojení uživatelů nejde povolit.	- Vyžaduje ověření záznamů domény. - Delší nastavení pro ověření

Omezení služby

Spravované domény Azure i vlastní domény podléhají omezením služeb. Limity služeb zahrnují omezení selhání, rychlosti a velikosti. Další informace najdete v tématu Omezení služeb pro e-mail služby Azure Communication Services>.

Ověřování odesílatele pro spravovanou doménu Azure

Služba Azure Communication Services automaticky nakonfiguruje požadované ověřovací protokoly e-mailu pro e-mail, jak je popsáno v osvědčených postupech pro ověřování e-mailů.

Vaše e-mailová doména je teď připravená k odesílání e-mailů.

Další kroky

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

• Odeslání e-mailu pomocí služby Azure Communication Service

Související články

• Seznamte se s klientskou knihovnou e-mailu.
• Zkontrolujte limity selhání e-mailu, omezení rychlosti a omezení velikosti v omezeních služby pro e-mail služby Azure Communication Services>.
• Naučte se odesílat e-maily s vlastními ověřenými doménami v rychlém startu: Jak přidat vlastní ověřené e-mailové domény.