Creare e gestire le risorse del servizio di comunicazione tramite posta elettronica

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.

Creare la risorsa servizio di comunicazione tramite posta elettronica usando il portale

1. Aprire il portale di Azure per creare una nuova risorsa.

2. Cercare Servizi di comunicazione tramite posta elettronica.

   

3. Selezionare Servizi di comunicazione tramite posta elettronica e fare clic su Crea.

   

4. Immettere le informazioni necessarie nella scheda Informazioni di base :

   • Selezionare una sottoscrizione di Azure esistente.

   • Selezionare un gruppo di risorse esistente oppure crearne uno nuovo fare clic sul collegamento Crea nuovo .

   • Specificare un nome valido per la risorsa.

   • Selezionare l'area in cui deve essere disponibile la risorsa.

   • Selezionare Stati Uniti come posizione dei dati.

   • Per aggiungere tag, fare clic su Avanti: Tag

   • Aggiungere eventuali coppie nome/valore.

     

5. Fare clic su Avanti: Rivedi e crea.

6. Attendere il completamento della convalida, quindi fare clic su Crea.

7. Attendere il completamento della distribuzione, quindi fare clic su Vai alla risorsa per aprire la panoramica del servizio di comunicazione tramite posta elettronica.

   

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.
• Installare l'interfaccia della riga di comando di Azure.

Creare una risorsa di Servizi di comunicazione tramite posta elettronica

Per creare una risorsa dei servizi di comunicazione email, accedere alla CLI di Azure. È possibile accedere eseguendo il comando az login dal terminale e specificando le credenziali. Per creare la risorsa, eseguire il comando seguente:

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

Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.

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

È possibile configurare la risorsa di Servizi di comunicazione di posta elettronica con le opzioni seguenti:

• Gruppo di risorse.
• Nome della risorsa servizi di comunicazione di posta elettronica.
• Area geografica da associare alla risorsa.

Nel passaggio successivo è possibile assegnare tag alla risorsa. È quindi possibile usare i tag per organizzare le risorse di Posta elettronica di Azure. Per altre informazioni sui tag, vedere la documentazione relativa all'assegnazione di tag alle risorse.

Gestire la risorsa di Servizi di comunicazione di posta elettronica

Per aggiungere tag alla risorsa di Servizi di comunicazione di posta elettronica, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.

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

Per elencare tutte le risorse del servizio di comunicazione di posta elettronica in un determinato gruppo di risorse, usare il comando seguente:

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

Per visualizzare tutte le informazioni relative a una determinata risorsa servizio di comunicazione tramite posta elettronica, usare il comando seguente. È anche possibile specificare come destinazione una sottoscrizione specifica.

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

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

Pulire la risorsa

Se si vuole pulire e rimuovere una sottoscrizione di Servizi di comunicazione tramite posta elettronica, è possibile eliminare la risorsa o il gruppo di risorse. È possibile eliminare la risorsa di comunicazione tramite posta elettronica eseguendo il comando seguente.

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

Eliminando il gruppo di risorse vengono eliminate anche tutte le altre risorse associate.

Per informazioni su altri comandi, vedere Interfaccia della riga di comando di comunicazione tramite posta elettronica.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.
• La versione più recente di .NET Core SDK per il sistema operativo.
• Ottenere la versione più recente dell’SDK di identità per .NET.
• Ottenere la versione più recente dell’SDK di gestione per .NET.

Installazione dell'SDK

Includere prima di tutto l’SDK di gestione di Servizi di comunicazione nel progetto C#:

using Azure.ResourceManager.Communication;

ID sottoscrizione

È necessario conoscere l'ID della sottoscrizione di Azure. È possibile acquisire l'ID dal portale:

1. Accedi al tuo account Azure.
2. Selezionare Sottoscrizioni nella barra laterale sinistra.
3. Selezionare la sottoscrizione necessaria.
4. Fare clic su Panoramica.
5. Selezionare l'ID sottoscrizione.

In questa guida introduttiva si presuppone che l'ID sottoscrizione sia stato archiviato in una variabile di ambiente denominata AZURE_SUBSCRIPTION_ID.

Autenticazione

Per comunicare con Servizi di comunicazione di Azure, è prima necessario eseguire l'autenticazione in Azure.

Autenticare il client

L'opzione predefinita per creare un client autenticato consiste nell'usare DefaultAzureCredential. Poiché tutte le API di gestione passano attraverso lo stesso endpoint, per interagire con le risorse, è necessario creare un solo livello ArmClientsuperiore.

Per eseguire l'autenticazione in Azure e creare un ArmClient, eseguire il codice seguente:

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

Interagire con le risorse di Azure

Dopo aver eseguito l'autenticazione.

Per ognuno degli esempi seguenti, le risorse di Servizi di posta elettronica vengono assegnate a un gruppo di risorse esistente.

Se è necessario creare un gruppo di risorse, è possibile farlo usando il portale di Azure o l’SDK di Azure Resource Manager.

Creare una risorsa di Servizi di posta elettronica

Quando si crea una risorsa di Servizi di posta elettronica, specificare il nome del gruppo di risorse e il nome della risorsa.

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

Gestire la risorsa di Servizi di comunicazione di posta elettronica

Aggiornare una risorsa di Servizi di comunicazione tramite posta elettronica

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

Elencare tutte le risorse del servizio di comunicazione di posta elettronica in base al gruppo di risorse

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

Elencare tutte le risorse del servizio di comunicazione tramite posta elettronica per sottoscrizione

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

Pulire la risorsa

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

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.
• Installare Azure Az PowerShell.

Creare una risorsa del servizio di comunicazione email

Per creare una risorsa del servizio di comunicazione tramite posta elettronica, accedere all'account Azure usando il Connect-AzAccount comando seguente e specificare le credenziali.

PS C:\> Connect-AzAccount

Installare prima di tutto il modulo Az.Communication Servizi di comunicazione di Azure usando il comando seguente.

PS C:\> Install-Module Az.Communication

Per creare una risorsa, eseguire il comando seguente:

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

Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.

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

È possibile configurare la risorsa di Servizi di comunicazione con le opzioni seguenti:

• Gruppo di risorse.
• Nome della risorsa servizi di comunicazione di posta elettronica.
• Area geografica da associare alla risorsa.

Nel passaggio successivo è possibile assegnare tag alla risorsa. Usare i tag per organizzare le risorse di Posta elettronica di Azure. Per altre informazioni sui tag, vedere l'assegnazione di tag alle risorse.

Gestire la risorsa di Servizi di comunicazione di posta elettronica

Per aggiungere tag alla risorsa di Servizi di comunicazione di posta elettronica, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.

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

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

Per elencare tutte le risorse del servizio di comunicazione di posta elettronica in una determinata sottoscrizione, usare il comando seguente:

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

Per elencare tutte le informazioni su una determinata risorsa, usare il comando seguente:

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

Pulire la risorsa

Se si vuole pulire e rimuovere una risorsa di Servizi di comunicazione tramite posta elettronica, è possibile eliminare la risorsa di comunicazione tramite posta elettronica eseguendo il comando seguente:

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