Erstellen und Verwalten von E-Mail-Kommunikationsdienstressourcen

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.

Erstellen der Ressource "E-Mail-Kommunikationsdienst" über das Portal

1. Öffnen Sie das Azure-Portal , um eine neue Ressource zu erstellen.

2. Suchen Sie nach E-Mail-Kommunikationsdiensten.

   

3. Wählen Sie E-Mail-Kommunikationsdienste aus und klicken Sie auf Erstellen.

   

4. Geben Sie die erforderlichen Informationen auf der Registerkarte Grundlagen ein:

   • Wählen Sie ein Azure-Abonnement aus.

   • Wählen Sie eine vorhandene Ressourcengruppe aus, oder klicken Sie zum Erstellen einer neuen Ressourcengruppe auf den Link Neu erstellen .

   • Geben Sie einen gültigen Namen für die Ressource an.

   • Wählen Sie die Region aus, in der die Ressource verfügbar sein muss.

   • Wählen Sie USA als Datenspeicherort aus.

   • Um Tags hinzuzufügen, klicken Sie auf Weiter: Tags

   • Fügen Sie beliebige Name-Wert-Paare hinzu.

     

5. Klicken Sie auf Weiter: Überprüfen und erstellen.

6. Warten Sie, bis die Validierung abgeschlossen ist, und klicken Sie dann auf Erstellen.

7. Warten Sie, bis die Bereitstellung abgeschlossen ist, und klicken Sie dann auf Zu Ressource wechseln , um die Übersicht über den E-Mail-Kommunikationsdienst zu öffnen.

   

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
• Installieren Sie Azure CLI.

Erstellen einer Ressource für E-Mail-Kommunikationsdienste

Melden Sie sich bei der Azure CLI an, um eine E-Mail Communication Services-Ressource zu erstellen. Sie können sich beim Ausführen des az login-Befehls vom Terminal anmelden und Ihre Anmeldeinformationen bereitstellen. Führen Sie zum Erstellen der Ressource den folgenden Befehl aus:

az communication email create --name "<EmailServiceName>" --___location "Global" --data-___location "United States" --resource-group "<resourceGroup>"

Wenn Sie ein bestimmtes Abonnement auswählen möchten, können Sie auch das --subscription Kennzeichen angeben und die Abonnement-ID angeben.

az communication email create --name "<EmailServiceName>" --___location "Global" --data-___location "United States" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Sie können Ihre E-Mail-Kommunikationsdienste-Ressource mit den folgenden Optionen konfigurieren:

• Die Ressourcengruppe.
• Der Name der E-Mail-Kommunikationsdienste-Ressource.
• Die Geografie, die der Ressource zugeordnet werden soll.

Im nächsten Schritt können Sie der Ressource Tags zuweisen. Anschließend können Sie Tags verwenden, um Ihre Azure E-Mail-Ressourcen zu organisieren. Weitere Informationen zu Tags finden Sie in der Dokumentation zum Anwenden von Tags auf Ressourcen.

Verwalten Ihrer E-Mail-Kommunikationsdienste-Ressource

Führen Sie die folgenden Befehle aus, um Ihrer E-Mail-Kommunikationsdienste-Ressource Tags hinzuzufügen. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

az communication email update --name "<EmailServiceName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Verwenden Sie den folgenden Befehl, um alle Ihre E-Mail-Kommunikationsdienstressourcen in einer bestimmten Ressourcengruppe aufzulisten:

az communication email list --resource-group "<resourceGroup>"

Verwenden Sie den folgenden Befehl, um alle Informationen zu einer bestimmten E-Mail-Kommunikationsdienstressource anzuzeigen. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

az communication email show --name "<EmailServiceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Ressource bereinigen

Wenn Sie ein E-Mail-Kommunikationsdienste-Abonnement bereinigen und entfernen möchten, können Sie die Ressource oder Ressourcengruppe löschen. Sie können Ihre E-Mail-Kommunikationsressource löschen, indem Sie den folgenden Befehl ausführen.

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

Wenn Sie die Ressourcengruppe löschen, werden auch alle anderen Ressourcen gelöscht, die ihr zugeordnet sind.

Weitere Informationen zu anderen Befehlen finden Sie unter CLI für die E-Mail-Kommunikation.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
• Die aktuelle Version des .NET Core SDK für Ihr Betriebssystem.
• Rufen Sie die neueste Version des .NET-Identitäts-SDK ab.
• Rufen Sie die neueste Version des .NET-VerwaltungsSDK ab.

Das SDK installieren

Fügen Sie zunächst die Communication Services-Verwaltungs-SDK in das C#-Projekt ein:

using Azure.ResourceManager.Communication;

Abonnement-ID

Sie müssen die ID Ihres Azure-Abonnements kennen. Sie können die ID über das Portal abrufen:

1. Melden Sie sich bei Ihrem Azure-Konto an.
2. Wählen Sie in der linken Seitenleiste Abonnements aus.
3. Wählen Sie aus, welches Abonnement erforderlich ist.
4. Klicken Sie auf Übersicht.
5. Wählen Sie die ID für Ihr Abonnement aus.

In dieser Schnellstartanleitung wird davon ausgegangen, dass Sie die Abonnement-ID in einer Umgebungsvariablen mit dem Namen AZURE_SUBSCRIPTION_ID.

Authentifizierung

Für die Kommunikation mit Azure Communication Services müssen Sie sich zunächst bei Azure authentifizieren.

Authentifizieren des Clients

Die Standardoption zum Erstellen eines authentifizierten Clients besteht darin, DefaultAzureCredentialzu verwenden. Da alle Verwaltungs-APIs denselben Endpunkt durchlaufen, müssen Sie nur eine oberste Ebene ArmClienterstellen, um mit Ressourcen zu interagieren.

Führen Sie den folgenden Code aus, um sich bei Azure zu authentifizieren und einen zu ArmClienterstellen:

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
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);

Interagieren mit Azure-Ressourcen

Nun haben Sie sich authentifiziert.

Für jedes der folgenden Beispiele weisen wir unsere E-Mail-Services-Ressourcen einer vorhandenen Ressourcengruppe zu.

Wenn Sie eine Ressourcengruppe erstellen müssen, können Sie dazu das Azure-Portal oder das Azure Resource Manager-SDK verwenden.

Erstellen einer E-Mail-Services-Ressource

Geben Sie beim Erstellen einer E-Mail-Services-Ressource den Namen der Ressourcengruppe und den Ressourcennamen an.

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

// get the collection of this EmailServiceResource
EmailServiceResourceCollection collection = resourceGroupResource.GetEmailServiceResources();

// invoke the operation
string emailServiceName = "MyEmailServiceResource";
EmailServiceResourceData data = new EmailServiceResourceData(new AzureLocation("Global"))
{
    DataLocation = "United States",
};
ArmOperation<EmailServiceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, emailServiceName, data);
EmailServiceResource 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
EmailServiceResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Verwalten Ihrer E-Mail-Kommunikationsdienste-Ressource

Aktualisieren einer E-Mail-Kommunikationsdienste-Ressource

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

// invoke the operation
EmailServiceResourcePatch patch = new EmailServiceResourcePatch()
{
    Tags =
    {
    ["newTag"] = "newVal",
    },
};
ArmOperation<EmailServiceResource> lro = await emailServiceResource.UpdateAsync(WaitUntil.Completed, patch);
EmailServiceResource 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
EmailServiceResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Auflisten aller E-Mail-Kommunikationsdienst-Ressourcen nach Ressourcengruppe

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

// get the collection of this EmailServiceResource
EmailServiceResourceCollection collection = resourceGroupResource.GetEmailServiceResources();

// invoke the operation and iterate over the result
await foreach (EmailServiceResource 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
    EmailServiceResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Auflisten aller E-Mail-Kommunikationsdienst-Ressourcen nach Abonnement

// this example assumes you already have this SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (EmailServiceResource item in subscriptionResource.GetEmailServiceResourcesAsync())
{
    // 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
    EmailServiceResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Ressource bereinigen

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

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

Console.WriteLine($"Succeeded");

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
• Installieren Sie Azure Az PowerShell.

Erstellen einer Ressource für den E-Mail-Kommunikationsdienst

Um eine E-Mail-Kommunikationsdienstressource zu erstellen, melden Sie sich mit Connect-AzAccount dem folgenden Befehl bei Ihrem Azure-Konto an, und geben Sie Ihre Anmeldeinformationen ein.

PS C:\> Connect-AzAccount

Installieren Sie zunächst das Azure Communication Services-Modul Az.Communication mithilfe des folgenden Befehls.

PS C:\> Install-Module Az.Communication

Führen Sie den folgenden Befehl aus, um eine Ressource zu erstellen:

PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates

Wenn Sie ein bestimmtes Abonnement auswählen möchten, können Sie auch das --subscription Kennzeichen angeben und die Abonnement-ID angeben.

PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates -SubscriptionId SubscriptionID

Sie können Ihre Communication Services-Ressource mit den folgenden Optionen konfigurieren:

• Die Ressourcengruppe.
• Der Name der E-Mail-Kommunikationsdienste-Ressource.
• Die Geografie, die der Ressource zugeordnet werden soll.

Im nächsten Schritt können Sie der Ressource Tags zuweisen. Verwenden Sie Tags, um Ihre Azure E-Mail-Ressourcen zu organisieren. Weitere Informationen zu Tags finden Sie unter Ressourcenkennzeichnung.

Verwalten Ihrer E-Mail-Kommunikationsdienste-Ressource

Führen Sie die folgenden Befehle aus, um Ihrer E-Mail-Kommunikationsdienste-Ressource Tags hinzuzufügen. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

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

Verwenden Sie den folgenden Befehl, um alle Ihre E-Mail-Kommunikationsdienst-Ressourcen in einem bestimmten Abonnement aufzulisten:

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

Verwenden Sie den folgenden Befehl, um alle Informationen zu einer bestimmten Ressource aufzulisten:

PS C:\> Get-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Ressource bereinigen

Wenn Sie eine E-Mail-Kommunikationsdienstressource bereinigen und entfernen möchten, können Sie die E-Mail-Kommunikationsressource löschen, indem Sie den folgenden Befehl ausführen:

PS C:\> Remove-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1