Sdílet prostřednictvím

Rychlý start: Správa seznamů potlačení domény ve službě Azure Communication Services pomocí klientských knihoven pro správu

  • Článek

Důležité

Funkce popsané v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Tento rychlý start popisuje proces správy seznamů potlačení domény ve službě Azure Communication Services pomocí klientských knihoven pro správu služeb Azure Communication Services.

Požadavky

Instalace požadovaných balíčků

dotnet add package Azure.ResourceManager.Communication
dotnet add package Azure.Identity

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 Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;

ArmClient client = new ArmClient(new DefaultAzureCredential());

Přidání seznamu potlačení k prostředku domény

Pokud chcete blokovat odesílání e-mailových zpráv na určité adresy, prvním krokem je nastavení seznamu potlačení ve vašem prostředku domény.

Aktualizujte ukázku kódu názvem skupiny prostředků, názvem e-mailové služby a názvem prostředku domény, pro který chcete vytvořit seznam potlačení. Tyto informace najdete na portálu tak, že přejdete k prostředku domény, který jste vytvořili při nastavování požadavků. Název zdroje je <your-email-service-name>/<your-domain-name>. Název skupiny prostředků a ID předplatného najdete v části Základy v přehledu prostředků domény. Zvolte libovolný název prostředku seznamu potlačení a aktualizujte toto pole také v ukázce.

U názvu seznamu se ujistěte, že je stejné jako uživatelské jméno odesílatele adresy MailFrom, ze které chcete potlačit e-maily. Tyto adresy MailFrom najdete v části Adresy MailFrom vašeho prostředku domény na portálu. Můžete mít například adresu MailFrom, která vypadá takto: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Uživatelské jméno odesílatele pro tuto adresu by bylo "donotreply", takže by se měl použít název seznamu "donotreply".

Ukázka kódu vytvoří seznam potlačení a uloží ho suppressionListResource do proměnné pro budoucí operace.

string subscriptionId = "<your-subscription-id>"; // Found in the essentials section of the domain resource portal overview
string resourceGroupName = "<your-resource-group-name>"; // Found in the essentials section of the domain resource portal overview
string emailServiceName = "<your-email-service-name>"; // Found in the first part of the portal domain resource title
string domainResourceName = "<your-domain-name>"; // Found in the second part of the portal domain resource title
string suppressionListResourceName = "<your-suppression-list-resource-name>";

ResourceIdentifier suppressionListResourceId = SuppressionListResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName);
SuppressionListResource suppressionListResource = client.GetSuppressionListResource(suppressionListResourceId);

SuppressionListResourceData suppressionListData = new SuppressionListResourceData()
{
    ListName = "<your-sender-username>", // Should match the sender username of the MailFrom address you would like to suppress emails from
};

suppressionListResource.Update(WaitUntil.Completed, suppressionListData);

Pokud chcete potlačit e-maily ze všech uživatelských jmen odesílatele v konkrétní doméně, můžete předat prázdný řetězec pro název seznamu.

SuppressionListResourceData suppressionListData = new SuppressionListResourceData()
{
    ListName = "",
};

suppressionListResource.Update(WaitUntil.Completed, suppressionListData);

Přidání adresy do seznamu potlačení

Po nastavení seznamu potlačení teď můžete přidat konkrétní e-mailové adresy, do kterých chcete zabránit odesílání e-mailových zpráv.

Aktualizujte ukázku kódu pomocí ID adresy seznamu potlačení. Každé ID adresy seznamu potlačení, které přidáte, musí být jedinečné. Doporučujeme použít identifikátor GUID. Aktualizujte také e-mailovou adresu, kterou chcete blokovat přijímání zpráv.

Pokud chcete do seznamu potlačení přidat více adres, musíte tento vzorový kód opakovat několikrát.

string suppressionListAddressId = "<your-suppression-list-address-id>";

ResourceIdentifier suppressionListAddressResourceId = SuppressionListAddressResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName, suppressionListAddressId);
SuppressionListAddressResource suppressionListAddressResource = client.GetSuppressionListAddressResource(suppressionListAddressResourceId);

SuppressionListAddressResourceData suppressionListAddressData = new SuppressionListAddressResourceData()
{
    Email = "<email-address-to-suppress>" // Should match the email address you would like to block from receiving your messages
};

suppressionListAddressResource.Update(WaitUntil.Completed, suppressionListAddressData);

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které jste zvolili k potlačení. Váš e-mail se neodešle na potlačenou adresu.

Pokud se pokusíte odeslat e-mail z uživatelského jména odesílatele, které se nepotlačí, e-mail se pořád úspěšně odešle.

Odebrání adresy ze seznamu potlačení

Pokud chcete odebrat adresu ze seznamu potlačení, vytvořte SuppressionListAddressResource adresu, jak je znázorněno v předchozích ukázkách kódu, a volejte metodu Delete .

suppressionListAddressResource.Delete(WaitUntil.Completed);

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které se rozhodnete potlačit. E-mail se úspěšně odešle na dříve potlačenou adresu.

Odebrání seznamu potlačení z prostředku domény

Pokud chcete odebrat seznam potlačení z prostředku domény, vytvořte SuppressionListResource seznam, jak je znázorněno v předchozích ukázkách kódu, a volejte metodu Delete .

suppressionListResource.Delete(WaitUntil.Completed);

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

const client = new CommunicationServiceManagementClient(credential, subscriptionId);

Přidání seznamu potlačení k prostředku domény

Pokud chcete blokovat odesílání e-mailových zpráv na určité adresy, prvním krokem je nastavení seznamu potlačení ve vašem prostředku domény.

Aktualizujte ukázku kódu názvem skupiny prostředků, názvem e-mailové služby a názvem prostředku domény, pro který chcete vytvořit seznam potlačení. Tyto informace najdete na portálu tak, že přejdete k prostředku domény, který jste vytvořili při nastavování požadavků. Název zdroje je <your-email-service-name>/<your-domain-name>. Název skupiny prostředků a ID předplatného najdete v části Základy v přehledu prostředků domény. Zvolte libovolný název prostředku seznamu potlačení a aktualizujte toto pole také v ukázce.

U názvu seznamu se ujistěte, že je stejné jako uživatelské jméno odesílatele adresy MailFrom, ze které chcete potlačit e-maily. Tyto adresy MailFrom najdete v části Adresy MailFrom vašeho prostředku domény na portálu. Můžete mít například adresu MailFrom, která vypadá takto: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Uživatelské jméno odesílatele pro tuto adresu by bylo "donotreply", takže by se měl použít název seznamu "donotreply".

const resourceGroupName = "<your-resource-group-name>"; // Found in the essentials section of the domain resource portal overview
const emailServiceName = "<your-email-service-name>"; // Found in the first part of the portal domain resource title
const domainResourceName = "<your-domain-name>"; // Found in the second part of the portal domain resource title
const suppressionListResourceName = "<your-suppression-list-resource-name>";

parameters = { 
    "listName": "<your-sender-username>", // Should match the sender username of the MailFrom address you would like to suppress emails from
}

await client.suppressionLists.createOrUpdate(
    resourceGroupName,
    emailServiceName,
    domainResourceName,
    suppressionListResourceName,
    parameters
);

Pokud chcete potlačit e-maily ze všech uživatelských jmen odesílatele v konkrétní doméně, můžete předat prázdný řetězec pro název seznamu.

parameters = { 
    "listName": "",
}

await client.suppressionLists.createOrUpdate(
    resourceGroupName,
    emailServiceName,
    domainResourceName,
    suppressionListResourceName,
    parameters
);

Přidání adresy do seznamu potlačení

Po nastavení seznamu potlačení teď můžete přidat konkrétní e-mailové adresy, do kterých chcete zabránit odesílání e-mailových zpráv.

Aktualizujte ukázku kódu pomocí ID adresy seznamu potlačení. Každé ID adresy seznamu potlačení, které přidáte, musí být jedinečné. Doporučujeme použít identifikátor GUID. Aktualizujte také e-mailovou adresu, kterou chcete blokovat přijímání zpráv.

Pokud chcete do seznamu potlačení přidat více adres, musíte tento vzorový kód opakovat několikrát.

const suppressionListAddressId = "<your-suppression-list-address-id>";

parameters = { 
    "email": "<email-address-to-suppress>" // Should match the email address you would like to block from receiving your messages
}

await client.suppressionListAddresses.createOrUpdate(
    resourceGroupName,
    emailServiceName,
    domainResourceName,
    suppressionListResourceName,
    suppressionListAddressId,
    parameters
);

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které jste zvolili k potlačení. Váš e-mail se neodešle na potlačenou adresu.

Pokud se pokusíte odeslat e-mail z uživatelského jména odesílatele, které se nepotlačí, e-mail se pořád úspěšně odešle.

Odebrání adresy ze seznamu potlačení

delete Voláním metody suppressionListAddresses odeberte adresu ze seznamu potlačení.

await client.suppressionListAddresses.delete(
    resourceGroupName,
    emailServiceName,
    domainResourceName,
    suppressionListResourceName,
    suppressionListAddressId
);

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které se rozhodnete potlačit. E-mail se úspěšně odešle na dříve potlačenou adresu.

Odebrání seznamu potlačení z prostředku domény

delete Voláním metody suppressionList odeberte seznam potlačení z prostředku domény.

await client.suppressionLists.delete(
    resourceGroupName,
    emailServiceName,
    domainResourceName,
    suppressionListResourceName
);

Požadavky

Instalace požadovaných balíčků

Přidejte do svého pom.xmlsouboru následující závislosti .

<dependency>
    <groupId>com.azure.resourcemanager</groupId>
    <artifactId>azure-resourcemanager-communication</artifactId>
    <version>2.2.0</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.11.1</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.

Na začátek souboru přidejte následující importy.

import com.azure.core.credential.TokenCredential;
import com.azure.core.management.AzureEnvironment;
import com.azure.core.management.profile.AzureProfile;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.resourcemanager.communication.CommunicationManager;

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řidání seznamu potlačení k prostředku domény

Pokud chcete blokovat odesílání e-mailových zpráv na určité adresy, prvním krokem je nastavení seznamu potlačení ve vašem prostředku domény.

Aktualizujte ukázku kódu názvem skupiny prostředků, názvem e-mailové služby a názvem prostředku domény, pro který chcete vytvořit seznam potlačení. Tyto informace najdete na portálu tak, že přejdete k prostředku domény, který jste vytvořili při nastavování požadavků. Název zdroje je <your-email-service-name>/<your-domain-name>. Název skupiny prostředků a ID předplatného najdete v části Základy v přehledu prostředků domény. Zvolte libovolný název prostředku seznamu potlačení a aktualizujte toto pole také v ukázce.

U názvu seznamu se ujistěte, že je stejné jako uživatelské jméno odesílatele adresy MailFrom, ze které chcete potlačit e-maily. Tyto adresy MailFrom najdete v části Adresy MailFrom vašeho prostředku domény na portálu. Můžete mít například adresu MailFrom, která vypadá takto: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Uživatelské jméno odesílatele pro tuto adresu by bylo "donotreply", takže by se měl použít název seznamu "donotreply".

String resourceGroupName = "<your-resource-group-name>"; // Found in the essentials section of the domain resource portal overview
String emailServiceName = "<your-email-service-name>"; // Found in the first part of the portal domain resource title
String domainResourceName = "<your-domain-name>"; // Found in the second part of the portal domain resource title
String suppressionListResourceName = "<your-suppression-list-resource-name>";

manager.suppressionLists().define(suppressionListResourceName)
    .withExistingDomain(resourceGroupName, emailServiceName, domainResourceName)
    .withListName("<your-sender-username>") // Should match the sender username of the MailFrom address you would like to suppress emails from
    .create();

Pokud chcete potlačit e-maily ze všech uživatelských jmen odesílatele v konkrétní doméně, můžete předat prázdný řetězec pro název seznamu.

manager.suppressionLists().define(suppressionListResourceName)
    .withExistingDomain(resourceGroupName, emailServiceName, domainResourceName)
    .withListName("")
    .create();

Přidání adresy do seznamu potlačení

Po nastavení seznamu potlačení teď můžete přidat konkrétní e-mailové adresy, do kterých chcete zabránit odesílání e-mailových zpráv.

Aktualizujte ukázku kódu pomocí ID adresy seznamu potlačení. Každé ID adresy seznamu potlačení, které přidáte, musí být jedinečné. Doporučujeme použít identifikátor GUID. Aktualizujte také e-mailovou adresu, kterou chcete blokovat přijímání zpráv.

Pokud chcete do seznamu potlačení přidat více adres, musíte tento vzorový kód opakovat několikrát.

String suppressionListAddressId = "<your-suppression-list-address-id>";

manager.suppressionListAddresses().define(suppressionListAddressId)
    .withExistingSuppressionList(resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName)
    .withEmail("<email-address-to-suppress>") // Should match the email address you would like to block from receiving your messages
    .create();

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které jste zvolili k potlačení. Váš e-mail se neodešle na potlačenou adresu.

Pokud se pokusíte odeslat e-mail z uživatelského jména odesílatele, které se nepotlačí, e-mail se pořád úspěšně odešle.

Odebrání adresy ze seznamu potlačení

delete Voláním metody suppressionListAddresses odeberte adresu ze seznamu potlačení.

manager.suppressionListAddresses()
    .delete(resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName, suppressionListAddressId);

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které se rozhodnete potlačit. E-mail se úspěšně odešle na dříve potlačenou adresu.

Odebrání seznamu potlačení z prostředku domény

delete Voláním metody suppressionLists odeberte seznam potlačení z prostředku domény.

manager.suppressionLists()
    .delete(resourceGroupName, emailServiceName, domainResourceName, suppressionListResourceName);

Požadavky

Instalace požadovaných balíčků

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

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.

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

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

mgmt_client = CommunicationServiceManagementClient(credential, subscription_id)

Přidání seznamu potlačení k prostředku domény

Pokud chcete blokovat odesílání e-mailových zpráv na určité adresy, prvním krokem je nastavení seznamu potlačení ve vašem prostředku domény.

Aktualizujte ukázku kódu názvem skupiny prostředků, názvem e-mailové služby a názvem prostředku domény, pro který chcete vytvořit seznam potlačení. Tyto informace najdete na portálu tak, že přejdete k prostředku domény, který jste vytvořili při nastavování požadavků. Název zdroje je <your-email-service-name>/<your-domain-name>. Název skupiny prostředků a ID předplatného najdete v části Základy v přehledu prostředků domény. Zvolte libovolný název prostředku seznamu potlačení a aktualizujte toto pole také v ukázce.

U názvu seznamu se ujistěte, že je stejné jako uživatelské jméno odesílatele adresy MailFrom, ze které chcete potlačit e-maily. Tyto adresy MailFrom najdete v části Adresy MailFrom vašeho prostředku domény na portálu. Můžete mít například adresu MailFrom, která vypadá takto: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Uživatelské jméno odesílatele pro tuto adresu by bylo "donotreply", takže by se měl použít název seznamu "donotreply".

resource_group_name = "<your-resource-group-name>"; # Found in the essentials section of the domain resource portal overview
email_service_name = "<your-email-service-name>"; # Found in the first part of the portal domain resource title
domain_resource_name = "<your-domain-name>"; # Found in the second part of the portal domain resource title
suppression_list_resource_name = "<your-suppression-list-resource-name>";

mgmt_client.suppression_lists.create_or_update(
    resource_group_name,
    email_service_name,
    domain_resource_name,
    suppression_list_resource_name,
    parameters={
        "properties": {
            "listName": "<your-sender-username>" # Should match the sender username of the MailFrom address you would like to suppress emails from
        }
    },
)

Pokud chcete potlačit e-maily ze všech uživatelských jmen odesílatele v konkrétní doméně, můžete předat prázdný řetězec pro název seznamu.

mgmt_client.suppression_lists.create_or_update(
    resource_group_name,
    email_service_name,
    domain_resource_name,
    suppression_list_resource_name,
    parameters={
        "properties": {
            "listName": ""
        }
    },
)

Přidání adresy do seznamu potlačení

Po nastavení seznamu potlačení teď můžete přidat konkrétní e-mailové adresy, do kterých chcete zabránit odesílání e-mailových zpráv.

Aktualizujte ukázku kódu pomocí ID adresy seznamu potlačení. Každé ID adresy seznamu potlačení, které přidáte, musí být jedinečné. Doporučujeme použít identifikátor GUID. Aktualizujte také e-mailovou adresu, kterou chcete blokovat přijímání zpráv.

Pokud chcete do seznamu potlačení přidat více adres, musíte tento vzorový kód opakovat několikrát.

suppression_list_address_id = "<your-suppression-list-address-id>";

mgmt_client.suppression_list_addresses.create_or_update(
    resource_group_name,
    email_service_name,
    domain_resource_name,
    suppression_list_resource_name,
    suppression_list_address_id,
    parameters={
        "properties": {
            "email": "<email-address-to-suppress>" # Should match the email address you would like to block from receiving your messages
        }
    },
)

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které se rozhodnete potlačit. Váš e-mail se neodešle na potlačenou adresu.

Pokud se pokusíte odeslat e-mail z uživatelského jména odesílatele, které se nepotlačí, e-mail se pořád úspěšně odešle.

Odebrání adresy ze seznamu potlačení

delete Voláním metody suppression_list_addresses odeberte adresu ze seznamu potlačení.

mgmt_client.suppression_list_addresses.delete(
    resource_group_name,
    email_service_name,
    domain_resource_name,
    suppression_list_resource_name,
    suppression_list_address_id
)

Teď můžete zkusit odeslat e-mail na potlačenou adresu z TryEmail oddílu prostředku komunikační služby nebo pomocí některé ze sad SDK e-mailu. Nezapomeňte odeslat e-mail pomocí adresy MailFrom s uživatelským jménem odesílatele, které jste zvolili k potlačení. E-mail se úspěšně odešle na dříve potlačenou adresu.

Odebrání seznamu potlačení z prostředku domény

delete Voláním metody suppression_lists odeberte seznam potlačení z prostředku domény.

mgmt_client.suppression_lists.delete(
    resource_group_name,
    email_service_name,
    domain_resource_name,
    suppression_list_resource_name
)