Rychlý start: Vytvoření a správa prostředků e-mailové komunikační služby

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma

Vytvoření prostředku e-mailové komunikace pomocí portálu

1. Otevřete Azure Portal a vytvořte nový prostředek.

2. Vyhledejte e-mailové komunikační služby.

   

3. Vyberte E-mailové komunikační služby a stiskněte Vytvořit.

   

4. Na kartě Základy zadejte požadované informace:

   • Vyberte existující předplatné Azure.

   • Vyberte existující skupinu prostředků nebo vytvořte novou kliknutím na odkaz Vytvořit nový .

   • Zadejte platný název prostředku.

   • Vyberte oblast, ve které musí být prostředek dostupný.

   • Jako umístění dat vyberte USA.

   • Pokud chcete přidat značky, klikněte na Další: Značky

   • Přidejte všechny páry název/hodnota.

     

5. Klikněte na Další: Zkontrolovat a vytvořit.

6. Počkejte, až ověření projde, a potom klikněte na Vytvořit.

7. Počkejte na dokončení nasazení a kliknutím na Přejít k prostředku otevřete přehled e-mailové komunikační služby.

   

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Instalace Azure CLI

Vytvoření prostředku e-mailových komunikačních služeb

Pokud chcete vytvořit prostředek e-mailové komunikační služby, přihlaste se k Azure CLI. Můžete se přihlásit spuštěním az login příkazu z terminálu a zadat své přihlašovací údaje. Pokud chcete prostředek vytvořit, spusťte následující příkaz:

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

Pokud chcete vybrat konkrétní předplatné, můžete také zadat --subscription příznak a zadat ID předplatného.

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

Prostředek e-mailové komunikace můžete nakonfigurovat s následujícími možnostmi:

• Skupina prostředků
• Název prostředku e-mailové komunikace
• Zeměpisná oblast, ke které bude prostředek přidružený

V dalším kroku můžete k prostředku přiřadit značky. Značky se dají použít k uspořádání vašich e-mailových prostředků Azure. Další informace o značkách najdete v dokumentaci k označování prostředků.

Správa prostředku e-mailových komunikačních služeb

Pokud chcete do prostředku e-mailové komunikace přidat značky, spusťte následující příkazy. Můžete také cílit na konkrétní předplatné.

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

Pokud chcete zobrazit seznam všech prostředků e-mailové komunikační služby v dané skupině prostředků, použijte následující příkaz:

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

Pokud chcete zobrazit všechny informace o daném prostředku e-mailové komunikační služby, použijte následující příkaz. Můžete také cílit na konkrétní předplatné.

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

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

Vyčištění prostředku

Pokud chcete vyčistit a odebrat předplatné e-mailové komunikační služby, můžete odstranit prostředek nebo skupinu prostředků. Prostředek e-mailové komunikace můžete odstranit spuštěním následujícího příkazu.

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

Odstraněním skupiny prostředků se odstraní také všechny ostatní prostředky, které jsou k ní přidružené.

Informace o dalších příkazech najdete v tématu Rozhraní příkazového řádku pro komunikaci s e-mailem.

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Nejnovější verze sady .NET Core SDK pro váš operační systém.
• Získejte nejnovější verzi sady .NET Identity SDK.
• Získejte nejnovější verzi sady .NET Management SDK.

Instalace sady SDK

Nejprve do projektu C# zahrňte sadu SDK pro správu komunikačních služeb:

using Azure.ResourceManager.Communication;

Subscription ID

Budete muset znát ID vašeho předplatného Azure. Můžete ho získat z portálu:

1. Přihlaste se ke svému účtu Azure.
2. Výběr předplatných na levém bočním panelu
3. Vyberte, které předplatné je potřeba.
4. Klikněte na Přehled.
5. Vyberte ID předplatného.

V tomto rychlém startu předpokládáme, že jste ID předplatného uložili do proměnné prostředí s názvem AZURE_SUBSCRIPTION_ID.

Ověřování

Pokud chcete komunikovat se službou Azure Communication Services, musíte se nejprve ověřit v Azure.

Ověření klienta

Výchozí možností vytvoření ověřeného klienta je použití DefaultAzureCredential. Vzhledem k tomu, že všechna rozhraní API pro správu procházejí stejným koncovým bodem, aby bylo možné pracovat s prostředky, je potřeba vytvořit pouze jeden ArmClient nejvyšší úrovně.

Pokud se chcete ověřit v Azure a vytvořit ArmClient, proveďte následující kód:

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://video2.skills-academy.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Interakce s prostředky Azure

Teď, když jste ověřeni.

Pro každý z následujících příkladů přiřadíme prostředky e-mailových služeb existující skupině prostředků.

Pokud potřebujete vytvořit skupinu prostředků, můžete to udělat pomocí webu Azure Portal nebo sady SDK Azure Resource Manageru.

Vytvoření prostředku e-mailových služeb

Při vytváření prostředku e-mailové služby zadáte název skupiny prostředků a název prostředku.

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

Správa prostředku e-mailových komunikačních služeb

Aktualizace prostředku e-mailových komunikačních služeb

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

Výpis všech prostředků e-mailové komunikační služby podle skupiny prostředků

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

Výpis všech prostředků e-mailové komunikace podle předplatného

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

Vyčištění prostředku

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

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Instalace modulu Azure Az PowerShell

Vytvoření prostředku e-mailové komunikační služby

Pokud chcete vytvořit prostředek e-mailové komunikace, přihlaste se ke svému účtu Azure pomocí Connect-AzAccount následujícího příkazu a zadejte své přihlašovací údaje.

PS C:\> Connect-AzAccount

Nejprve pomocí následujícího příkazu nainstalujte modul Az.Communication Azure Communication Services.

PS C:\> Install-Module Az.Communication

Pokud chcete prostředek vytvořit, spusťte následující příkaz:

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

Pokud chcete vybrat konkrétní předplatné, můžete také zadat --subscription příznak a zadat ID předplatného.

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

Prostředek komunikační služby můžete nakonfigurovat s následujícími možnostmi:

• Skupina prostředků
• Název prostředku e-mailové komunikace
• Zeměpisná oblast, ke které bude prostředek přidružený

V dalším kroku můžete k prostředku přiřadit značky. Značky se dají použít k uspořádání vašich e-mailových prostředků Azure. Další informace o značkách najdete v dokumentaci k označování prostředků.

Správa prostředku e-mailových komunikačních služeb

Pokud chcete do prostředku e-mailové komunikace přidat značky, spusťte následující příkazy. Můžete také cílit na konkrétní předplatné.

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

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

Pokud chcete zobrazit seznam všech prostředků e-mailové komunikace v daném předplatném, použijte následující příkaz:

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

Pokud chcete zobrazit seznam všech informací o daném prostředku, použijte následující příkaz:

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

Vyčištění prostředku

Pokud chcete vyčistit a odebrat e-mailové komunikační služby, můžete odstranit prostředek e-mailové komunikace spuštěním následujícího příkazu:

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