Criar e gerenciar recursos do Serviço de Comunicação de Email

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

Criar o recurso do Serviço de Comunicações de Email usando o portal

1. Abra o portal do Azure para criar um novo recurso.

2. Pesquise serviços de comunicação por email.

   

3. Selecione Serviços de Comunicação de Email e clique em Criar.

   

4. Insira as informações necessárias na guia Noções básicas :

   • Selecione uma assinatura existente do Azure.

   • Selecione um grupo de recursos existente ou crie um novo clique no link Criar novo .

   • Forneça um nome válido para o recurso.

   • Selecione a região em que o recurso precisa estar disponível.

   • Selecione Estados Unidos como o local dos dados.

   • Para adicionar marcas, clique em Avançar: Marcas

   • Adicione quaisquer pares nome/valor.

     

5. Clique em Próximo: Examinar + criar.

6. Aguarde a conclusão da validação e clique em Criar.

7. Aguarde a conclusão da Implantação e clique em Ir para o Recurso para abrir a visão geral do Serviço de Comunicação de Email.

   

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Instale a CLI do Azure.

Criar recurso dos Serviços de Comunicação de Email

Para criar um recurso dos Serviços de Comunicação por Email, entre na CLI do Azure. Para se conectar, execute o comando az login no terminal e forneça suas credenciais. Para criar o recurso, execute o seguinte comando:

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

Se você quiser selecionar uma assinatura específica, também poderá especificar o --subscription sinalizador e fornecer a ID da assinatura.

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

Você pode configurar seu recurso dos Serviços de Comunicação de Email com as seguintes opções:

• O grupo de recursos.
• O nome do recurso de Serviços de Comunicação por Email.
• A geografia a ser associada ao recurso.

Na próxima etapa, você pode atribuir marcas ao recurso. Em seguida, você pode usar tags para organizar seus recursos de Email do Azure. Para obter mais informações sobre marcas, consulte a documentação de marcação de recursos.

Gerenciar seu recurso dos Serviços de Comunicação de Email

Para adicionar marcas ao recurso dos Serviços de Comunicação de Email, execute os comandos a seguir. Você também pode direcionar uma assinatura 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 listar todos os recursos do Serviço de Comunicação de Email em um determinado grupo de recursos, use o seguinte comando:

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

Para mostrar todas as informações em um determinado recurso do Serviço de Comunicação de Email, use o comando a seguir. Você também pode direcionar uma assinatura específica.

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

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

Limpar recurso

Se você quiser limpar e remover uma assinatura dos Serviços de Comunicação por Email, poderá excluir o recurso ou o grupo de recursos. Você pode excluir o recurso de comunicação de email executando o comando a seguir.

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

Excluir o grupo de recursos também exclui todos os recursos associados a ele.

Para obter informações sobre outros comandos, consulte a CLI de Comunicação por Email.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• A versão mais recente do SDK do .NET Core para o seu sistema operacional.
• Obtenha a última versão do SDK de Identidade do .NET.
• Obtenha a última versão do SDK do Gerenciamento do .NET.

Instalar o SDK

Primeiro, inclua o SDK de Gerenciamento dos Serviços de Comunicação no seu projeto C#:

using Azure.ResourceManager.Communication;

ID da assinatura

Você precisa saber a ID da sua assinatura do Azure. Você pode adquirir a ID do portal:

1. Entre em sua conta do Azure.
2. Selecione Assinaturas na barra lateral esquerda.
3. Selecione qualquer assinatura necessária.
4. Clique em Visão Geral.
5. Selecione a sua ID de Assinatura.

Neste início rápido, presumimos que você armazenou a ID da assinatura em uma variável de ambiente chamada AZURE_SUBSCRIPTION_ID.

Autenticação

Para se comunicar com os Serviços de Comunicação do Azure, primeiro você precisa se autenticar no Azure.

Autenticar o Cliente

A opção padrão para criar um cliente autenticado é usar DefaultAzureCredential. Como todas as APIs de gerenciamento passam pelo mesmo ponto de extremidade, para interagir com recursos, você só precisa criar um nível ArmClientsuperior.

Para autenticar no Azure e criar um ArmClient, faça o seguinte código:

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

Interagir com recursos do Azure

Agora que você está autenticado.

Para cada um dos exemplos a seguir, atribuimos nossos recursos dos Serviços de Email a um grupo de recursos existente.

Se precisar criar um grupo de recursos, você poderá fazer isso usando o portal do Azure ou o SDK do Azure Resource Manager.

Criar um recurso dos Serviços de Email

Ao criar um recurso dos Serviços de Email, especifique o nome do grupo de recursos e o nome do 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}");

Gerenciar seu recurso dos Serviços de Comunicação de Email

Atualizar um recurso dos Serviços de Comunicação de Email

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

Listar todos os recursos do Serviço de Comunicação de Email 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");

Listar todos os recursos do Serviço de Comunicação de Email por assinatura

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

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

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Instale o Azure Az PowerShell.

Criar recurso do Serviço de Comunicação por Email

Para criar um recurso do Serviço de Comunicação por Email, entre em sua conta do Azure usando o comando Connect-AzAccount seguir e forneça suas credenciais.

PS C:\> Connect-AzAccount

Primeiro, instale o módulo Az.Communication dos Serviços de Comunicação do Azure usando o comando a seguir.

PS C:\> Install-Module Az.Communication

Para criar um recurso, execute o seguinte comando:

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

Se você quiser selecionar uma assinatura específica, também poderá especificar o --subscription sinalizador e fornecer a ID da assinatura.

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

Configure o recurso dos Serviços de Comunicação com as seguintes opções:

• O grupo de recursos.
• O nome do recurso de Serviços de Comunicação por Email.
• A geografia a ser associada ao recurso.

Na próxima etapa, você pode atribuir marcas ao recurso. Use tags para organizar os recursos de Email no Azure. Para obter mais informações sobre tags, consulte o tagueamento de recursos.

Gerenciar seu recurso dos Serviços de Comunicação de Email

Para adicionar marcas ao recurso dos Serviços de Comunicação de Email, execute os comandos a seguir. Você também pode direcionar uma assinatura 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 listar todos os recursos do Serviço de Comunicação por Email em uma determinada assinatura, use o seguinte comando:

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

Para listar todas as informações em um determinado recurso, use o seguinte comando:

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

Limpar recurso

Se você quiser limpar e remover um recurso dos Serviços de Comunicação por Email, poderá excluir o recurso de comunicação por email executando o seguinte comando:

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