Freigeben über

Schnellstart: Verwalten von Domänenunterdrückungslisten in Azure Communication Services mithilfe der Verwaltungsclientbibliotheken

  • Artikel

Wichtig

Die in diesem Artikel beschriebenen Funktionen befinden sich derzeit in der öffentlichen Vorschauphase. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Dieser Schnellstart behandelt den Prozess zum Verwalten von Domänenunterdrückungslisten in Azure Communication Services mithilfe der Azure Communication Services-Verwaltungsclientbibliotheken.

Voraussetzungen

Installieren der erforderlichen Pakete

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

Initialisieren des Verwaltungsclients

Legen Sie die Umgebungsvariable AZURE_SUBSCRIPTION_ID mit der Abonnement-ID des Abonnements fest, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;

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

Hinzufügen einer Unterdrückungsliste zu einer Domänenressource

Um zu verhindern, dass Ihre E-Mail-Nachrichten an bestimmte Adressen gesendet werden, richtet der erste Schritt eine Unterdrückungsliste in Ihrer Domänenressource ein.

Aktualisieren Sie das Codebeispiel mit dem Ressourcengruppennamen, dem E-Mail-Dienstnamen und dem Domänenressourcennamen, für den Sie die Unterdrückungsliste erstellen möchten. Diese Informationen finden Sie im Portal, indem Sie zu der Domänenressource navigieren, die Sie beim Einrichten der Voraussetzungen erstellt haben. Der Titel der Ressource ist <your-email-service-name>/<your-domain-name>. Den Namen der Ressourcengruppe und die Abonnement-ID finden Sie in den Grundlagen-Abschnitten der Domänenressourcenübersicht. Wählen Sie einen beliebigen Namen für ihre Unterdrückungslistenressource aus, und aktualisieren Sie dieses Feld auch im Beispiel.

Stellen Sie für den Listennamen sicher, dass sie mit dem Absenderbenutzernamen der MailFrom-Adresse identisch ist, von der Sie E-Mails unterdrücken möchten. Diese MailFrom-Adressen finden Sie im Abschnitt "MailFrom-Adressen" Ihrer Domänenressource im Portal. Beispielsweise haben Sie möglicherweise eine MailFrom-Adresse, die wie "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net" aussieht. Der Absenderbenutzername für diese Adresse wäre "donotreply", damit ein Listenname von "donotreply" verwendet werden sollte.

Im Codebeispiel wird die Unterdrückungsliste erstellt und in der suppressionListResource Variable für zukünftige Vorgänge gespeichert.

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

Wenn Sie E-Mails von allen Absenderbenutzernamen in einer bestimmten Domäne unterdrücken möchten, können Sie eine leere Zeichenfolge für den Listennamen übergeben.

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

suppressionListResource.Update(WaitUntil.Completed, suppressionListData);

Hinzufügen einer Adresse zu einer Unterdrückungsliste

Nachdem Sie die Unterdrückungsliste eingerichtet haben, können Sie nun bestimmte E-Mail-Adressen hinzufügen, an die Sie verhindern möchten, dass Ihre E-Mail-Nachrichten gesendet werden.

Aktualisieren Sie das Codebeispiel mit der Adress-ID der Unterdrückungsliste. Jede von Ihnen hinzugefügte Adress-ID der Unterdrückungsliste muss eindeutig sein. Wir empfehlen die Verwendung von GUID. Aktualisieren Sie die E-Mail-Adresse, die Sie für den Empfang Ihrer Nachrichten sperren möchten.

Wenn Sie der Unterdrückungsliste mehrere Adressen hinzufügen möchten, müssen Sie dieses Codebeispiel mehrmals wiederholen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrückt haben. Ihre E-Mail wird nicht an die unterdrückte Adresse gesendet.

Wenn Sie versuchen, eine E-Mail von einem Absenderbenutzernamen zu senden, der nicht unterdrückt wird, wird die E-Mail trotzdem erfolgreich gesendet.

Entfernen einer Adresse aus einer Unterdrückungsliste

Um eine Adresse aus der Unterdrückungsliste zu entfernen, erstellen Sie die SuppressionListAddressResource in den vorherigen Codebeispielen gezeigte, und rufen Sie die Delete Methode auf.

suppressionListAddressResource.Delete(WaitUntil.Completed);

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrücken möchten. Ihre E-Mail wird erfolgreich an die zuvor unterdrückte Adresse gesendet.

Entfernen einer Unterdrückungsliste aus einer Domänenressource

Um eine Unterdrückungsliste aus der Domänenressource zu entfernen, erstellen Sie die SuppressionListResource in den vorherigen Codebeispielen gezeigte, und rufen Sie die Delete Methode auf.

suppressionListResource.Delete(WaitUntil.Completed);

Voraussetzungen

Installieren der erforderlichen Pakete

npm install @azure/arm-communication
npm install @azure/identity

Initialisieren des Verwaltungsclients

Ersetzen Sie das Feld im Beispielcode durch die Abonnement-ID des Abonnements, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

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

Hinzufügen einer Unterdrückungsliste zu einer Domänenressource

Um zu verhindern, dass Ihre E-Mail-Nachrichten an bestimmte Adressen gesendet werden, richtet der erste Schritt eine Unterdrückungsliste in Ihrer Domänenressource ein.

Aktualisieren Sie das Codebeispiel mit dem Ressourcengruppennamen, dem E-Mail-Dienstnamen und dem Domänenressourcennamen, für den Sie die Unterdrückungsliste erstellen möchten. Diese Informationen finden Sie im Portal, indem Sie zu der Domänenressource navigieren, die Sie beim Einrichten der Voraussetzungen erstellt haben. Der Titel der Ressource ist <your-email-service-name>/<your-domain-name>. Den Namen der Ressourcengruppe und die Abonnement-ID finden Sie in den Grundlagen-Abschnitten der Domänenressourcenübersicht. Wählen Sie einen beliebigen Namen für ihre Unterdrückungslistenressource aus, und aktualisieren Sie dieses Feld auch im Beispiel.

Stellen Sie für den Listennamen sicher, dass sie mit dem Absenderbenutzernamen der MailFrom-Adresse identisch ist, von der Sie E-Mails unterdrücken möchten. Diese MailFrom-Adressen finden Sie im Abschnitt "MailFrom-Adressen" Ihrer Domänenressource im Portal. Beispielsweise haben Sie möglicherweise eine MailFrom-Adresse, die wie "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net" aussieht. Der Absenderbenutzername für diese Adresse wäre "donotreply", damit ein Listenname von "donotreply" verwendet werden sollte.

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

Wenn Sie E-Mails von allen Absenderbenutzernamen in einer bestimmten Domäne unterdrücken möchten, können Sie eine leere Zeichenfolge für den Listennamen übergeben.

parameters = { 
    "listName": "",
}

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

Hinzufügen einer Adresse zu einer Unterdrückungsliste

Nachdem Sie die Unterdrückungsliste eingerichtet haben, können Sie nun bestimmte E-Mail-Adressen hinzufügen, an die Sie verhindern möchten, dass Ihre E-Mail-Nachrichten gesendet werden.

Aktualisieren Sie das Codebeispiel mit der Adress-ID der Unterdrückungsliste. Jede von Ihnen hinzugefügte Adress-ID der Unterdrückungsliste muss eindeutig sein. Wir empfehlen die Verwendung von GUID. Aktualisieren Sie die E-Mail-Adresse, die Sie für den Empfang Ihrer Nachrichten sperren möchten.

Wenn Sie der Unterdrückungsliste mehrere Adressen hinzufügen möchten, müssen Sie dieses Codebeispiel mehrmals wiederholen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrückt haben. Ihre E-Mail wird nicht an die unterdrückte Adresse gesendet.

Wenn Sie versuchen, eine E-Mail von einem Absenderbenutzernamen zu senden, der nicht unterdrückt wird, wird die E-Mail trotzdem erfolgreich gesendet.

Entfernen einer Adresse aus einer Unterdrückungsliste

Rufen Sie die delete Methode auf suppressionListAddresses auf, um eine Adresse aus der Unterdrückungsliste zu entfernen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrücken möchten. Ihre E-Mail wird erfolgreich an die zuvor unterdrückte Adresse gesendet.

Entfernen einer Unterdrückungsliste aus einer Domänenressource

Rufen Sie die delete Methode auf suppressionList auf, um eine Unterdrückungsliste aus der Domänenressource zu entfernen.

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

Voraussetzungen

Installieren der erforderlichen Pakete

Fügen Sie Ihrer pom.xml die folgenden Abhängigkeiten hinzu.

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

Initialisieren des Verwaltungsclients

Legen Sie die Umgebungsvariable AZURE_SUBSCRIPTION_ID mit der Abonnement-ID des Abonnements fest, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden.

Fügen Sie die folgenden Importe am Anfang der Datei hinzu.

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;

Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
TokenCredential credential = new DefaultAzureCredentialBuilder()
        .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
        .build();

CommunicationManager manager = CommunicationManager
        .authenticate(credential, profile);

Hinzufügen einer Unterdrückungsliste zu einer Domänenressource

Um zu verhindern, dass Ihre E-Mail-Nachrichten an bestimmte Adressen gesendet werden, richtet der erste Schritt eine Unterdrückungsliste in Ihrer Domänenressource ein.

Aktualisieren Sie das Codebeispiel mit dem Ressourcengruppennamen, dem E-Mail-Dienstnamen und dem Domänenressourcennamen, für den Sie die Unterdrückungsliste erstellen möchten. Diese Informationen finden Sie im Portal, indem Sie zu der Domänenressource navigieren, die Sie beim Einrichten der Voraussetzungen erstellt haben. Der Titel der Ressource ist <your-email-service-name>/<your-domain-name>. Den Namen der Ressourcengruppe und die Abonnement-ID finden Sie in den Grundlagen-Abschnitten der Domänenressourcenübersicht. Wählen Sie einen beliebigen Namen für ihre Unterdrückungslistenressource aus, und aktualisieren Sie dieses Feld auch im Beispiel.

Stellen Sie für den Listennamen sicher, dass sie mit dem Absenderbenutzernamen der MailFrom-Adresse identisch ist, von der Sie E-Mails unterdrücken möchten. Diese MailFrom-Adressen finden Sie im Abschnitt "MailFrom-Adressen" Ihrer Domänenressource im Portal. Beispielsweise haben Sie möglicherweise eine MailFrom-Adresse, die wie "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net" aussieht. Der Absenderbenutzername für diese Adresse wäre "donotreply", damit ein Listenname von "donotreply" verwendet werden sollte.

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

Wenn Sie E-Mails von allen Absenderbenutzernamen in einer bestimmten Domäne unterdrücken möchten, können Sie eine leere Zeichenfolge für den Listennamen übergeben.

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

Hinzufügen einer Adresse zu einer Unterdrückungsliste

Nachdem Sie die Unterdrückungsliste eingerichtet haben, können Sie nun bestimmte E-Mail-Adressen hinzufügen, an die Sie verhindern möchten, dass Ihre E-Mail-Nachrichten gesendet werden.

Aktualisieren Sie das Codebeispiel mit der Adress-ID der Unterdrückungsliste. Jede von Ihnen hinzugefügte Adress-ID der Unterdrückungsliste muss eindeutig sein. Wir empfehlen die Verwendung von GUID. Aktualisieren Sie die E-Mail-Adresse, die Sie für den Empfang Ihrer Nachrichten sperren möchten.

Wenn Sie der Unterdrückungsliste mehrere Adressen hinzufügen möchten, müssen Sie dieses Codebeispiel mehrmals wiederholen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrückt haben. Ihre E-Mail wird nicht an die unterdrückte Adresse gesendet.

Wenn Sie versuchen, eine E-Mail von einem Absenderbenutzernamen zu senden, der nicht unterdrückt wird, wird die E-Mail trotzdem erfolgreich gesendet.

Entfernen einer Adresse aus einer Unterdrückungsliste

Rufen Sie die delete Methode auf suppressionListAddresses auf, um eine Adresse aus der Unterdrückungsliste zu entfernen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrücken möchten. Ihre E-Mail wird erfolgreich an die zuvor unterdrückte Adresse gesendet.

Entfernen einer Unterdrückungsliste aus einer Domänenressource

Rufen Sie die delete Methode auf suppressionLists auf, um eine Unterdrückungsliste aus der Domänenressource zu entfernen.

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

Voraussetzungen

Installieren der erforderlichen Pakete

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

Initialisieren des Verwaltungsclients

Legen Sie die Umgebungsvariable AZURE_SUBSCRIPTION_ID mit der Abonnement-ID des Abonnements fest, in dem sich Ihre Domäne und E-Mail-Ressourcen befinden. Führen Sie das Codebeispiel aus, um den Verwaltungsclient zu initialisieren.

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

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

mgmt_client = CommunicationServiceManagementClient(credential, subscription_id)

Hinzufügen einer Unterdrückungsliste zu einer Domänenressource

Um zu verhindern, dass Ihre E-Mail-Nachrichten an bestimmte Adressen gesendet werden, richtet der erste Schritt eine Unterdrückungsliste in Ihrer Domänenressource ein.

Aktualisieren Sie das Codebeispiel mit dem Ressourcengruppennamen, dem E-Mail-Dienstnamen und dem Domänenressourcennamen, für den Sie die Unterdrückungsliste erstellen möchten. Diese Informationen finden Sie im Portal, indem Sie zu der Domänenressource navigieren, die Sie beim Einrichten der Voraussetzungen erstellt haben. Der Titel der Ressource ist <your-email-service-name>/<your-domain-name>. Den Namen der Ressourcengruppe und die Abonnement-ID finden Sie in den Grundlagen-Abschnitten der Domänenressourcenübersicht. Wählen Sie einen beliebigen Namen für ihre Unterdrückungslistenressource aus, und aktualisieren Sie dieses Feld auch im Beispiel.

Stellen Sie für den Listennamen sicher, dass sie mit dem Absenderbenutzernamen der MailFrom-Adresse identisch ist, von der Sie E-Mails unterdrücken möchten. Diese MailFrom-Adressen finden Sie im Abschnitt "MailFrom-Adressen" Ihrer Domänenressource im Portal. Beispielsweise haben Sie möglicherweise eine MailFrom-Adresse, die wie "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net" aussieht. Der Absenderbenutzername für diese Adresse wäre "donotreply", damit ein Listenname von "donotreply" verwendet werden sollte.

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

Wenn Sie E-Mails von allen Absenderbenutzernamen in einer bestimmten Domäne unterdrücken möchten, können Sie eine leere Zeichenfolge für den Listennamen übergeben.

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

Hinzufügen einer Adresse zu einer Unterdrückungsliste

Nachdem Sie die Unterdrückungsliste eingerichtet haben, können Sie nun bestimmte E-Mail-Adressen hinzufügen, an die Sie verhindern möchten, dass Ihre E-Mail-Nachrichten gesendet werden.

Aktualisieren Sie das Codebeispiel mit der Adress-ID der Unterdrückungsliste. Jede von Ihnen hinzugefügte Adress-ID der Unterdrückungsliste muss eindeutig sein. Wir empfehlen die Verwendung von GUID. Aktualisieren Sie die E-Mail-Adresse, die Sie für den Empfang Ihrer Nachrichten sperren möchten.

Wenn Sie der Unterdrückungsliste mehrere Adressen hinzufügen möchten, müssen Sie dieses Codebeispiel mehrmals wiederholen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrücken möchten. Ihre E-Mail wird nicht an die unterdrückte Adresse gesendet.

Wenn Sie versuchen, eine E-Mail von einem Absenderbenutzernamen zu senden, der nicht unterdrückt wird, wird die E-Mail trotzdem erfolgreich gesendet.

Entfernen einer Adresse aus einer Unterdrückungsliste

Rufen Sie die delete Methode auf suppression_list_addresses auf, um eine Adresse aus der Unterdrückungsliste zu entfernen.

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

Sie können jetzt versuchen, eine E-Mail an die unterdrückte Adresse aus dem TryEmail Abschnitt Ihrer Kommunikationsdienstressource oder mithilfe einer der E-Mail-SDKs zu senden. Stellen Sie sicher, dass Sie die E-Mail mithilfe der MailFrom-Adresse mit dem Absenderbenutzernamen senden, den Sie unterdrückt haben. Ihre E-Mail wird erfolgreich an die zuvor unterdrückte Adresse gesendet.

Entfernen einer Unterdrückungsliste aus einer Domänenressource

Rufen Sie die delete Methode auf suppression_lists auf, um eine Unterdrückungsliste aus der Domänenressource zu entfernen.

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