Compartir a través de


Inicio rápido: Creación y administración de recursos de Email Communication Service

Aprovisione su primer recurso de Email Communication Service a fin de empezar a usar el correo electrónico. Los recursos de Email Communication Service se pueden aprovisionar mediante Azure Portal o con la biblioteca cliente de administración de .NET. La biblioteca cliente de administración y Azure Portal le permiten crear, configurar, actualizar y eliminar los recursos y la interfaz con el servicio de implementación y administración de Azure: Azure Resource Manager. Todas las funcionalidades disponibles en las bibliotecas cliente están disponibles en Azure Portal.

Advertencia

Observe que no es posible crear un grupo de recursos al mismo tiempo que un recurso para Azure Communication Services. Al crear un recurso, se debe usar un grupo de recursos que ya se ha creado.

Requisitos previos

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

  1. Vaya a Azure Portal para crear un nuevo recurso.

  2. Busque Email Communication Services.

    Captura de pantalla que muestra cómo buscar Email Communication Service en el marketplace.

  3. Seleccione Email Communication Services y presione Crear.

    Captura de pantalla que muestra el vínculo Crear para crear una instancia de Email Communication Service.

  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 cree uno nuevo haciendo clic en el vínculo Crear nuevo.

    • Proporcione un nombre válido para el recurso.

    • Seleccione la región en la que el recurso tiene que estar disponible.

    • Seleccione Estados Unidos como ubicación de datos.

    • Para agregar etiquetas, haga clic en Siguiente: Etiquetas.

    • Agregue cualquier par nombre-valor.

      Captura de pantalla que muestra un resumen sobre cómo revisar y crear una instancia de Email Communication Service.

  5. Haga clic en Siguiente: Review + create (Revisar y crear).

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

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

    Captura de pantalla que muestra la información general del recurso Email Communication Service.

Requisitos previos

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 quiere seleccionar una suscripción específica, también puede especificar la marca --subscription y proporcionar el identificador de la 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 a la que se asociará el recurso

En el paso siguiente, puede asignar etiquetas al recurso. Las etiquetas se pueden usar 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 usar una suscripción específica como destino.

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 Email Communication Service determinado, use el siguiente comando. También puede usar una suscripción específica como destino.

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.

Nota:

La eliminación de recursos es permanente y, si los elimina, no se puede recuperar ningún dato, filtros de Event Grid, números de teléfono u otros datos vinculados a los recursos incluidos.

Para obtener información sobre otros comandos, consulte CLI de comunicación por Email.

Requisitos previos

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

Deberá saber el identificador de su suscripción a Azure. Se puede adquirir en el portal:

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

En este inicio rápido, se supone que ha almacenado el identificador de la 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. Dado que todas las API de administración pasan por el mismo punto de conexión, con el fin de interactuar con los recursos, solo se debe crear un ArmClient de nivel superior.

Para autenticarse en Azure y crear un ArmClient, haga lo 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.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 los recursos de Azure

Ahora ya está autenticado.

Para cada uno de los ejemplos siguientes, asignaremos nuestros recursos de Email Services 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 Email Services

Al crear un recurso de Email Services, especificará el nombre del grupo de recursos y el nombre del recurso.

Nota:

La propiedad Location siempre es global y, durante la versión preliminar pública, el valor de DataLocation debe ser 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 = "11112222-3333-4444-5555-666677778888";
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 = "11112222-3333-4444-5555-666677778888";
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 = "11112222-3333-4444-5555-666677778888";
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 = "11112222-3333-4444-5555-666677778888";
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 = "11112222-3333-4444-5555-666677778888";
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");

Nota:

La eliminación de recursos es permanente y, si los elimina, no se puede recuperar ningún dato, filtros de Event Grid, números de teléfono u otros datos vinculados a los recursos incluidos.

Requisitos previos

Creación de un recurso de Email Communication Service

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

PS C:\> Connect-AzAccount

En primer lugar, asegúrese de instalar el módulo Azure Communication Services Az.Communication con el siguiente comando.

PS C:\> Install-Module Az.Communication

Para crear el recurso, ejecute el siguiente comando:

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

Si quiere seleccionar una suscripción específica, también puede especificar la marca --subscription y proporcionar el identificador de la 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
  • La geografía a la que se asociará el recurso

En el paso siguiente, puede asignar etiquetas al recurso. Las etiquetas se pueden usar 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 usar una suscripción específica como destino.

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

Nota:

La eliminación de recursos es permanente y, si los elimina, no se puede recuperar ningún dato, filtros de Event Grid, números de teléfono u otros datos vinculados a los recursos incluidos.

Pasos siguientes