Creación y administración de recursos de Email Communication Service

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

Creación del recurso de Email Communications Services mediante el portal

1. Abra Azure Portal para crear un nuevo recurso.

2. Busque Email Communication Services.

   

3. Seleccione Email Communication Services y haga clic en Crear.

   

4. Escriba la información necesaria en la pestaña Aspectos básicos :

   • Seleccione una suscripción de Azure existente.

   • Seleccione un grupo de recursos existente o, para crear uno nuevo, haga clic en el vínculo Crear nuevo .

   • Proporcione un nombre válido para el recurso.

   • Seleccione la región donde el recurso debe estar disponible.

   • Seleccione Estados Unidos como ubicación de datos.

   • Para agregar etiquetas, haga clic en Siguiente: Etiquetas

   • Agregue cualquier par nombre-valor.

     

5. Haga clic en Siguiente: Revisar y crear.

6. Espere a que se complete la validación y haga clic en Crear.

7. Espere a que finalice la implementación y haga clic en Ir al recurso para abrir la información general de Email Communication Service.

   

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Instale la CLI de Azure.

Creación de un recurso de Email Communication Services

Para crear un recurso de Email Communication Services, inicie sesión en la CLI de Azure. Para iniciar sesión, ejecute el comando az login desde el terminal y proporcione sus credenciales. Para crear el recurso, ejecute el siguiente comando:

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

Si desea seleccionar una suscripción específica, también puede especificar la --subscription marca y proporcionar el identificador de suscripción.

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

Puede configurar el recurso de Email Communication Services con las siguientes opciones:

• El grupo de recursos.
• El nombre del recurso de Email Communication Services.
• La geografía que se va a asociar al recurso.

En el paso siguiente, puede asignar etiquetas al recurso. Después, puede usar etiquetas para organizar los recursos de Azure Email. Para más información sobre las etiquetas, consulte la documentación sobre las etiquetas de recursos.

Administración del recurso de Email Communication Services

Para agregar etiquetas al recurso de Email Communication Services, ejecute los siguientes comandos. También puede tener como destino una suscripción específica.

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

Para enumerar todos los recursos de Email Communication Service en un grupo de recursos determinado, use el siguiente comando:

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

Para mostrar toda la información de un recurso de Servicio de comunicación por correo electrónico determinado, use el siguiente comando. También puede tener como destino una suscripción específica.

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

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

Limpieza del recurso

Si desea limpiar y quitar una suscripción de Email Communication Services, puede eliminar el recurso o el grupo de recursos. Para eliminar el recurso de comunicación por correo electrónico, ejecute el siguiente comando.

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

Al eliminar el grupo de recursos, también se elimina cualquier otro recurso que esté asociado a él.

Para obtener información sobre otros comandos, consulte La CLI de comunicación por correo electrónico.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• La versión más reciente del SDK de .NET Core para su sistema operativo.
• Obtenga la versión más reciente del SDK de .NET Identity.
• Obtenga la versión más reciente del SDK de administración de .NET.

Instalar el SDK

En primer lugar, incluya el SDK de administración de Communication Services en el proyecto de C#:

using Azure.ResourceManager.Communication;

Id. de suscripción

Necesita saber el identificador de su suscripción a Azure. Puede adquirir el identificador desde el portal:

1. Inicie sesión en su cuenta de Azure.
2. Seleccione Suscripciones en la barra lateral izquierda.
3. Seleccione la suscripción que sea necesaria.
4. Haga clic en Información general.
5. Seleccione el identificador de suscripción.

En este inicio rápido, se supone que ha almacenado el identificador de suscripción en una variable de entorno denominada AZURE_SUBSCRIPTION_ID.

Autenticación

Para comunicarse con Azure Communication Services, primero debe autenticarse en Azure.

Autenticar el cliente

La opción predeterminada para crear un cliente autenticado es usar DefaultAzureCredential. Puesto que todas las API de administración pasan por el mismo punto de conexión, para interactuar con los recursos, solo tiene que crear un nivel ArmClientsuperior.

Para autenticarse en Azure y crear un ArmClient, realice el código siguiente:

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

Interacción con recursos de Azure

Ahora ya está autenticado.

Para cada uno de los ejemplos siguientes, asignamos nuestros recursos de Servicios de correo electrónico a un grupo de recursos existente.

Si necesita crear un grupo de recursos, puede hacerlo mediante Azure Portal o el SDK de Azure Resource Manager.

Creación de un recurso de Servicios de correo electrónico

Al crear un recurso de Servicios de correo electrónico, especifique el nombre del grupo de recursos y el nombre del recurso.

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

Administración del recurso de Email Communication Services

Actualización de un recurso de 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}");

Enumerar todos los recursos de Email Communication Service por grupo de recursos

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

Enumerar todos los recursos de Email Communication Service por suscripción

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

Limpieza del recurso

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

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Instale Azure Az PowerShell.

Creación de un recurso de Email Communication Service

Para crear un recurso de Email Communication Service, inicie sesión en su cuenta de Azure con el Connect-AzAccount comando siguiente y proporcione sus credenciales.

PS C:\> Connect-AzAccount

En primer lugar, instale el módulo Az.Communication de Azure Communication Services con el siguiente comando.

PS C:\> Install-Module Az.Communication

Para crear un recurso, ejecute el siguiente comando:

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

Si desea seleccionar una suscripción específica, también puede especificar la --subscription marca y proporcionar el identificador de suscripción.

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

Puede configurar el recurso de Communication Services con las opciones siguientes:

• El grupo de recursos.
• El nombre del recurso de Email Communication Services.
• Geografía que se va a asociar al recurso.

En el paso siguiente, puede asignar etiquetas al recurso. Use etiquetas para organizar los recursos de Azure Email. Para obtener más información sobre las etiquetas, consulte el etiquetado de recursos.

Administración del recurso de Email Communication Services

Para agregar etiquetas al recurso de Email Communication Services, ejecute los siguientes comandos. También puede tener como destino una suscripción específica.

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

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

Para enumerar todos los recursos de Email Communication Service en una suscripción determinada, use el siguiente comando:

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

Para mostrar toda la información de un recurso determinado, use el siguiente comando:

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

Limpieza del recurso

Si desea limpiar y quitar un recurso de Email Communication Services, puede eliminar el recurso de comunicación por correo electrónico ejecutando el siguiente comando:

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