Udostępnij za pośrednictwem

Szybki start: zarządzanie listami pomijania domen w usługach Azure Communication Services przy użyciu bibliotek klienta zarządzania

  • Artykuł

Ważne

Funkcje opisane w tym artykule są obecnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą być nieobsługiwane lub ograniczone. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.

Ten przewodnik Szybki start obejmuje proces zarządzania listami pomijania domen w usługach Azure Communication Services przy użyciu bibliotek klienckich zarządzania usługami Azure Communication Services.

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • 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.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji usługi Azure Active Directory (AD) jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

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

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

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

Dodawanie listy pomijania do zasobu domeny

Aby zablokować wysyłanie wiadomości e-mail na określone adresy, pierwszym krokiem jest skonfigurowanie listy pomijania w zasobie domeny.

Zaktualizuj przykładowy kod przy użyciu nazwy grupy zasobów, nazwy usługi poczty e-mail i nazwy zasobu domeny, dla której chcesz utworzyć listę pomijania. Znajdź te informacje w portalu, przechodząc do zasobu domeny utworzonego podczas konfigurowania wymagań wstępnych. Tytuł zasobu to <your-email-service-name>/<your-domain-name>. Znajdź nazwę grupy zasobów i identyfikator subskrypcji w sekcjach Podstawy w przeglądzie zasobu domeny. Wybierz dowolną nazwę zasobu listy pomijania i zaktualizuj to pole w przykładzie.

Upewnij się, że nazwa listy jest taka sama jak nazwa użytkownika nadawcy adresu MailFrom, z którego chcesz pominąć wiadomości e-mail. Te adresy MailFrom można znaleźć w sekcji "MailFrom addresses" zasobu domeny w portalu. Na przykład może istnieć adres MailFrom, który wygląda następująco: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Nazwa użytkownika nadawcy dla tego adresu to "donotreply", dlatego należy użyć nazwy listy "donotreply".

Przykładowy kod utworzy listę pomijania i zapisze ją w zmiennej suppressionListResource na potrzeby przyszłych operacji.

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 suppressiontListData = 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, suppressiontListData);

Jeśli chcesz pominąć wiadomości e-mail ze wszystkich nazw użytkowników nadawcy w określonej domenie, możesz przekazać pusty ciąg dla nazwy listy.

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

suppressionListResource.Update(WaitUntil.Completed, suppressiontListData);

Dodawanie adresu do listy pomijania

Po skonfigurowaniu listy pomijania możesz teraz dodać określone adresy e-mail, do których chcesz uniemożliwić wysyłanie wiadomości e-mail.

Zaktualizuj przykładowy kod przy użyciu identyfikatora adresu listy pomijania. Każdy dodany identyfikator adresu listy pomijania musi być unikatowy. Zalecamy używanie identyfikatora GUID. Zaktualizuj również adres e-mail, który chcesz zablokować podczas odbierania wiadomości.

Aby dodać wiele adresów do listy pomijania, należy powtórzyć ten przykład kodu wiele razy.

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

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

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

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy wybraną do pomijania. Wiadomość e-mail nie zostanie wysłana na pominięty adres.

Jeśli spróbujesz wysłać wiadomość e-mail z nazwy użytkownika nadawcy, która nie zostanie pominięta, wiadomość e-mail nadal zostanie pomyślnie wysłana.

Usuwanie adresu z listy pomijania

Aby usunąć adres z listy pomijania, utwórz element SuppressionListAddressResource , jak pokazano w poprzednich przykładach kodu i wywołaj metodę Delete .

suppressionListAddressResource.Delete(WaitUntil.Completed);

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy, którą chcesz pominąć. Wiadomość e-mail zostanie pomyślnie wysłana na wcześniej pominięty adres.

Usuwanie listy pomijania z zasobu domeny

Aby usunąć listę pomijania z zasobu domeny, utwórz obiekt SuppressionListResource , jak pokazano w poprzednich przykładach kodu i wywołaj metodę Delete .

suppressionListResource.Delete(WaitUntil.Completed);

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • 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.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji usługi Azure Active Directory (AD) jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_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>";

const client = new CommunicationServiceManagementClient(credential, subscriptionId);

Dodawanie listy pomijania do zasobu domeny

Aby zablokować wysyłanie wiadomości e-mail na określone adresy, pierwszym krokiem jest skonfigurowanie listy pomijania w zasobie domeny.

Zaktualizuj przykładowy kod przy użyciu nazwy grupy zasobów, nazwy usługi poczty e-mail i nazwy zasobu domeny, dla której chcesz utworzyć listę pomijania. Znajdź te informacje w portalu, przechodząc do zasobu domeny utworzonego podczas konfigurowania wymagań wstępnych. Tytuł zasobu to <your-email-service-name>/<your-domain-name>. Znajdź nazwę grupy zasobów i identyfikator subskrypcji w sekcjach Podstawy w przeglądzie zasobu domeny. Wybierz dowolną nazwę zasobu listy pomijania i zaktualizuj to pole w przykładzie.

Upewnij się, że nazwa listy jest taka sama jak nazwa użytkownika nadawcy adresu MailFrom, z którego chcesz pominąć wiadomości e-mail. Te adresy MailFrom można znaleźć w sekcji "MailFrom addresses" zasobu domeny w portalu. Na przykład może istnieć adres MailFrom, który wygląda następująco: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Nazwa użytkownika nadawcy dla tego adresu to "donotreply", dlatego należy użyć nazwy listy "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
);

Jeśli chcesz pominąć wiadomości e-mail ze wszystkich nazw użytkowników nadawcy w określonej domenie, możesz przekazać pusty ciąg dla nazwy listy.

parameters = { 
    "listName": "",
}

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

Dodawanie adresu do listy pomijania

Po skonfigurowaniu listy pomijania możesz teraz dodać określone adresy e-mail, do których chcesz uniemożliwić wysyłanie wiadomości e-mail.

Zaktualizuj przykładowy kod przy użyciu identyfikatora adresu listy pomijania. Każdy dodany identyfikator adresu listy pomijania musi być unikatowy. Zalecamy używanie identyfikatora GUID. Zaktualizuj również adres e-mail, który chcesz zablokować podczas odbierania wiadomości.

Aby dodać wiele adresów do listy pomijania, należy powtórzyć ten przykład kodu wiele razy.

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

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy wybraną do pomijania. Wiadomość e-mail nie zostanie wysłana na pominięty adres.

Jeśli spróbujesz wysłać wiadomość e-mail z nazwy użytkownika nadawcy, która nie zostanie pominięta, wiadomość e-mail nadal zostanie pomyślnie wysłana.

Usuwanie adresu z listy pomijania

Wywołaj metodę w poleceniu delete suppressionListAddresses , aby usunąć adres z listy pomijania.

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

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy, którą chcesz pominąć. Wiadomość e-mail zostanie pomyślnie wysłana na wcześniej pominięty adres.

Usuwanie listy pomijania z zasobu domeny

Wywołaj metodę w suppressionList poleceniu delete , aby usunąć listę pomijania z zasobu domeny.

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

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • 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.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji usługi Azure Active Directory (AD) jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

Dodaj następujące zależności do elementu pom.xml.

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

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.

Dodaj następujące importy w górnej części pliku.

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;

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

Dodawanie listy pomijania do zasobu domeny

Aby zablokować wysyłanie wiadomości e-mail na określone adresy, pierwszym krokiem jest skonfigurowanie listy pomijania w zasobie domeny.

Zaktualizuj przykładowy kod przy użyciu nazwy grupy zasobów, nazwy usługi poczty e-mail i nazwy zasobu domeny, dla której chcesz utworzyć listę pomijania. Znajdź te informacje w portalu, przechodząc do zasobu domeny utworzonego podczas konfigurowania wymagań wstępnych. Tytuł zasobu to <your-email-service-name>/<your-domain-name>. Znajdź nazwę grupy zasobów i identyfikator subskrypcji w sekcjach Podstawy w przeglądzie zasobu domeny. Wybierz dowolną nazwę zasobu listy pomijania i zaktualizuj to pole w przykładzie.

Upewnij się, że nazwa listy jest taka sama jak nazwa użytkownika nadawcy adresu MailFrom, z którego chcesz pominąć wiadomości e-mail. Te adresy MailFrom można znaleźć w sekcji "MailFrom addresses" zasobu domeny w portalu. Na przykład może istnieć adres MailFrom, który wygląda następująco: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Nazwa użytkownika nadawcy dla tego adresu to "donotreply", dlatego należy użyć nazwy listy "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();

Jeśli chcesz pominąć wiadomości e-mail ze wszystkich nazw użytkowników nadawcy w określonej domenie, możesz przekazać pusty ciąg dla nazwy listy.

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

Dodawanie adresu do listy pomijania

Po skonfigurowaniu listy pomijania możesz teraz dodać określone adresy e-mail, do których chcesz uniemożliwić wysyłanie wiadomości e-mail.

Zaktualizuj przykładowy kod przy użyciu identyfikatora adresu listy pomijania. Każdy dodany identyfikator adresu listy pomijania musi być unikatowy. Zalecamy używanie identyfikatora GUID. Zaktualizuj również adres e-mail, który chcesz zablokować podczas odbierania wiadomości.

Aby dodać wiele adresów do listy pomijania, należy powtórzyć ten przykład kodu wiele razy.

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

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy wybraną do pomijania. Wiadomość e-mail nie zostanie wysłana na pominięty adres.

Jeśli spróbujesz wysłać wiadomość e-mail z nazwy użytkownika nadawcy, która nie zostanie pominięta, wiadomość e-mail nadal zostanie pomyślnie wysłana.

Usuwanie adresu z listy pomijania

Wywołaj metodę w poleceniu delete suppressionListAddresses , aby usunąć adres z listy pomijania.

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

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy, którą chcesz pominąć. Wiadomość e-mail zostanie pomyślnie wysłana na wcześniej pominięty adres.

Usuwanie listy pomijania z zasobu domeny

Wywołaj metodę w suppressionLists poleceniu delete , aby usunąć listę pomijania z zasobu domeny.

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

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • 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.
  • Do uwierzytelniania używamy jednostki usługi. Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji usługi Azure Active Directory (AD) jako następujące zmienne środowiskowe: AZURE_CLIENT_ID, AZURE_TENANT_IDi AZURE_CLIENT_SECRET.

Instalowanie wymaganych pakietów

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

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.

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

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

mgmt_client = CommunicationServiceManagementClient(credential, subscription_id)

Dodawanie listy pomijania do zasobu domeny

Aby zablokować wysyłanie wiadomości e-mail na określone adresy, pierwszym krokiem jest skonfigurowanie listy pomijania w zasobie domeny.

Zaktualizuj przykładowy kod przy użyciu nazwy grupy zasobów, nazwy usługi poczty e-mail i nazwy zasobu domeny, dla której chcesz utworzyć listę pomijania. Znajdź te informacje w portalu, przechodząc do zasobu domeny utworzonego podczas konfigurowania wymagań wstępnych. Tytuł zasobu to <your-email-service-name>/<your-domain-name>. Znajdź nazwę grupy zasobów i identyfikator subskrypcji w sekcjach Podstawy w przeglądzie zasobu domeny. Wybierz dowolną nazwę zasobu listy pomijania i zaktualizuj to pole w przykładzie.

Upewnij się, że nazwa listy jest taka sama jak nazwa użytkownika nadawcy adresu MailFrom, z którego chcesz pominąć wiadomości e-mail. Te adresy MailFrom można znaleźć w sekcji "MailFrom addresses" zasobu domeny w portalu. Na przykład może istnieć adres MailFrom, który wygląda następująco: "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net". Nazwa użytkownika nadawcy dla tego adresu to "donotreply", dlatego należy użyć nazwy listy "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
        }
    },
)

Jeśli chcesz pominąć wiadomości e-mail ze wszystkich nazw użytkowników nadawcy w określonej domenie, możesz przekazać pusty ciąg dla nazwy listy.

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

Dodawanie adresu do listy pomijania

Po skonfigurowaniu listy pomijania możesz teraz dodać określone adresy e-mail, do których chcesz uniemożliwić wysyłanie wiadomości e-mail.

Zaktualizuj przykładowy kod przy użyciu identyfikatora adresu listy pomijania. Każdy dodany identyfikator adresu listy pomijania musi być unikatowy. Zalecamy używanie identyfikatora GUID. Zaktualizuj również adres e-mail, który chcesz zablokować podczas odbierania wiadomości.

Aby dodać wiele adresów do listy pomijania, należy powtórzyć ten przykład kodu wiele razy.

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
        }
    },
)

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy, którą chcesz pominąć. Wiadomość e-mail nie zostanie wysłana na pominięty adres.

Jeśli spróbujesz wysłać wiadomość e-mail z nazwy użytkownika nadawcy, która nie zostanie pominięta, wiadomość e-mail nadal zostanie pomyślnie wysłana.

Usuwanie adresu z listy pomijania

Wywołaj metodę w poleceniu delete suppression_list_addresses , aby usunąć adres z listy pomijania.

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

Teraz możesz spróbować wysłać wiadomość e-mail na pominięty adres z TryEmail sekcji zasobu usługi komunikacji lub przy użyciu jednego z zestawów SDK poczty e-mail. Pamiętaj, aby wysłać wiadomość e-mail przy użyciu adresu MailFrom z nazwą użytkownika nadawcy wybraną do pomijania. Wiadomość e-mail zostanie pomyślnie wysłana na wcześniej pominięty adres.

Usuwanie listy pomijania z zasobu domeny

Wywołaj metodę w suppression_lists poleceniu delete , aby usunąć listę pomijania z zasobu domeny.

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