Démarrage rapide : Créer et gérer des ressources du service de communication Email

Bien démarrer avec Email en provisionnant votre première ressource du service de communication Email. Provisionnez des ressources du service de communication par e-mail dans le portail Azure ou en utilisant la bibliothèque de client de gestion .NET. La bibliothèque de client de gestion et le portail Azure vous permettent de créer, configurer, mettre à jour et supprimer vos ressources et votre interface en utilisant le service de gestion et de déploiement d’Azure : Azure Resource Manager. Toutes les fonctions disponibles dans les bibliothèques de client sont accessibles dans le portail Azure.

Avertissement

Notez qu’il n’est pas possible de créer un groupe de ressources en même temps qu’une ressource pour Azure Communication Services. Lors de la création d’une ressource, un groupe de ressources qui a déjà été créé doit être utilisé.

Prérequis

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.

Créer la ressource Email Communications Service en utilisant le portail

1. Ouvrez le portail Azure pour créer une ressource.

2. Recherchez Service de communication Email.

   

3. Sélectionnez Email Communication Services, puis appuyez sur Créer

   

4. Entrez les informations requises sous l’onglet Informations de base :

   • Sélectionnez un abonnement Azure existant.

   • Sélectionnez un groupe de ressources existant ou créez-en un en cliquant sur le lien Créer.

   • Spécifiez un nom valide pour la ressource.

   • Sélectionnez la région dans laquelle la ressource doit être disponible.

   • Sélectionnez États-Unis comme emplacement des données.

   • Pour ajouter des étiquettes, cliquez sur Suivant : Étiquettes

   • Ajoutez les paires nom/valeur.

     

5. Cliquez sur Suivant : Vérifier + créer.

6. Attendez que la validation réussisse, puis cliquez sur Créer.

7. Attendez que le déploiement se termine, puis cliquez sur Accéder à la ressource pour ouvrir la vue d’ensemble Service de communication par e-mail.

   

Prérequis

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.
• Installer l’interface de ligne de commande Azure

Créer une ressource Email Communication Services

Pour créer une ressource Email Communication Services, connectez-vous à Azure CLI. Vous pouvez vous connecter en exécutant la commande az login à partir du terminal et fournir vos informations d’identification. Pour créer la ressource, exécutez la commande suivante :

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

Si vous souhaitez sélectionner un abonnement particulier, vous pouvez également spécifier l’indicateur --subscription et fournir l’ID d’abonnement.

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

Vous pouvez configurer votre ressource Email Communication Services avec les options suivantes :

• Le groupe de ressources
• Nom de la ressource Email Communication Services
• Zone géographique à laquelle associer la ressource

À l’étape suivante, vous pouvez attribuer des étiquettes à la ressource. Les étiquettes peuvent être utiles pour organiser vos ressources Azure Email. Pour plus d’informations sur les étiquettes, consultez la documentation sur l’étiquetage des ressources.

Gérer votre ressource Email Communication Services

Pour ajouter des balises à votre ressource Email Communication Services, exécutez les commandes suivantes. Vous pouvez également cibler un abonnement spécifique.

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

Pour répertorier toutes vos ressources Email Communication Services dans un groupe de ressources donné, utilisez la commande suivante :

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

Pour montrer toutes les informations d’une ressource Email Communication Service spécifique, utilisez la commande suivante. Vous pouvez également cibler un abonnement spécifique.

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

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

Nettoyer des ressources

Si vous voulez nettoyer et supprimer un abonnement Email Communication Services, vous pouvez supprimer la ressource ou le groupe de ressources. Vous pouvez supprimer votre ressource Email Communication en exécutant la commande suivante.

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

La suppression du groupe de ressources efface également les autres ressources qui y sont associées.

Remarque

La suppression d’une ressource est définitive, et aucune donnée, y compris les filtres d’événements, les numéros de téléphone ou autres informations liées à la ressource, ne peut être récupérée une fois la ressource supprimée.

Pour obtenir plus d’informations sur d’autres commandes, consultez CLI Email Communication.

Prérequis

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.
• Dernière version du kit SDK .NET Core pour votre système d’exploitation.
• Procurez-vous la dernière version du SDK .NET Identity.
• Procurez-vous la dernière version du SDK .NET Management.

Installation du SDK

Tout d’abord, incluez le SDK Communication Services Management dans votre projet C# :

using Azure.ResourceManager.Communication;

Identifiant d’abonnement

Vous devez connaître l’ID de votre abonnement Azure. Vous pouvez l’obtenir à partir du portail :

1. Connectez-vous à votre compte Azure
2. Sélectionnez Abonnements dans la barre latérale gauche
3. Sélectionnez l’abonnement à utiliser
4. Cliquez sur Vue d’ensemble
5. Sélectionnez votre ID d’abonnement

Dans ce guide de démarrage rapide, nous supposons que vous avez stocké l’ID d’abonnement dans une variable d’environnement appelée AZURE_SUBSCRIPTION_ID.

Authentification

Pour communiquer avec Azure Communication Services, vous devez d’abord vous authentifier auprès d’Azure.

Authentifier le client

L’option par défaut permettant de créer un client authentifié consiste à utiliser DefaultAzureCredential. Du fait que toutes les API de gestion passent par le même point de terminaison, vous ne devez créer qu’un seul ArmClient de niveau supérieur pour interagir avec des ressources.

Pour vous authentifier à Azure et créer un ArmClient, effectuez le code suivant :

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

Interaction avec des ressources Azure

Vous êtes maintenant authentifié.

Dans chacun des exemples suivants, nous attribuons les ressources Email Communication Services à un groupe de ressources existant.

Si vous avez besoin de créer un groupe de ressources, vous pouvez le faire à l’aide du portail Azure ou du kit de développement logiciel (SDK) Azure Resource Manager.

Créer une ressource Email Services

Quand vous créez une ressource Email Communication Services, vous spécifiez le nom du groupe de ressources et le nom de la ressource.

Remarque

La propriété Location est toujours global et, pendant la préversion publique, la valeur DataLocation doit être définie à UnitedStates.

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

Gérer votre ressource Email Communication Services

Mettre à jour une ressource Email Communication Services

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

Répertorier toutes les ressources Email Communication Service par groupe de ressources

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

Répertorier toutes les ressources Email Communication Service par 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");

Nettoyer des ressources

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

Remarque

La suppression d’une ressource est définitive, et aucune donnée, y compris les filtres d’événements, les numéros de téléphone ou autres informations liées à la ressource, ne peut être récupérée une fois la ressource supprimée.

Prérequis

• Compte Azure avec un abonnement actif. Créez un compte gratuitement.
• Installer le module PowerShell Azure Az

Créer une ressource Email Communication Service

Pour créer une ressource Email Communication Services, connectez-vous à votre compte Azure en utilisant le Connect-AzAccount à l’aide de la commande suivante et fournissez vos informations d’identification.

PS C:\> Connect-AzAccount

Tout d’abord, assurez-vous d’installer le module Azure Communication Services Az.Communication à l’aide de la commande suivante.

PS C:\> Install-Module Az.Communication

Pour créer la ressource, exécutez la commande suivante :

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

Si vous souhaitez sélectionner un abonnement particulier, vous pouvez également spécifier l’indicateur --subscription et fournir l’ID d’abonnement.

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

Vous pouvez configurer votre ressource Communication Services avec les options suivantes :

• Le groupe de ressources
• Nom de la ressource Email Communication Services
• Zone géographique à laquelle associer la ressource

À l’étape suivante, vous pouvez attribuer des étiquettes à la ressource. Les étiquettes peuvent être utiles pour organiser vos ressources Azure Email. Pour plus d’informations sur les étiquettes, consultez la documentation sur l’étiquetage des ressources.

Gérer votre ressource Email Communication Services

Pour ajouter des balises à votre ressource Email Communication Services, exécutez les commandes suivantes. Vous pouvez également cibler un abonnement spécifique.

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

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

Pour répertorier toutes vos ressources Email Communication Services dans un abonnement spécifique, utilisez la commande suivante :

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

Pour répertorier toutes les informations d’une ressource donnée, utilisez la commande suivante :

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

Nettoyer des ressources

Si vous souhaitez nettoyer et supprimer une instance Email Communication Services, vous pouvez supprimer votre ressource Email Communication en exécutant la commande suivante :

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

Remarque

La suppression d’une ressource est définitive, et aucune donnée, y compris les filtres d’événements, les numéros de téléphone ou autres informations liées à la ressource, ne peut être récupérée une fois la ressource supprimée.

Étapes suivantes

• Domaines de messagerie et authentification de l’expéditeur pour Azure Communication Services

• Démarrage rapide : Comment connecter un domaine de courrier vérifié

Articles connexes

• Familiarisez-vous avec la bibliothèque de client Email
• Découvrez comment envoyer des e-mails avec des domaines vérifiés personnalisés dans Démarrage rapide : Comment ajouter des domaines de courrier vérifiés personnalisés
• Découvrez comment envoyer des e-mails avec des domaines managés Azure dans Démarrage rapide : Comment ajouter des domaines managés Azure pour envoyer des e-mails