Rychlý start: Vytváření a správa prostředků služby Communication Services

Začněte se službou Azure Communication Services zřízením prvního prostředku služby Communication Services. Prostředky služby Communication Services je možné zřizovat prostřednictvím Azure Portal nebo pomocí sady .NET Management SDK. Sada SDK pro správu a Azure Portal umožňují vytvářet, konfigurovat, aktualizovat a odstraňovat prostředky a rozhraní s azure Resource Manager, službou azure pro nasazení a správu. Všechny funkce dostupné v sadách SDK jsou k dispozici v Azure Portal.

Upozornění

Skupinu prostředků není možné vytvořit současně s prostředkem pro Azure Communication Services. Při vytváření prostředku se musí použít skupina prostředků, která už byla vytvořená.

Požadavky

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

Upozorňujeme, že pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Před vytvořením prostředku zkontrolujte, že vaše předplatné splňuje všechny požadavky , pokud plánujete nákup telefonních čísel.

Vytvoření prostředku Azure Communication Services

Pokud chcete vytvořit prostředek Azure Communication Services, nejprve se přihlaste k Azure Portal. V levém horním rohu stránky vyberte + Vytvořit prostředek.

Do pole Hledat na Marketplace nebo do vyhledávacího panelu v horní části portálu zadejte Komunikace.

Ve výsledcích vyberte Communication Services a pak vyberte Vytvořit.

Teď můžete nakonfigurovat prostředek komunikačních služeb. Na první stránce procesu vytváření se zobrazí výzva k zadání:

• Předplatné
• Skupina prostředků (můžete vytvořit novou nebo zvolit existující skupinu prostředků)
• Název prostředku komunikačních služeb
• Geografická 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 je možné použít k uspořádání prostředků Azure. Další informace o značkách najdete v dokumentaci k označování prostředků .

Nakonec můžete zkontrolovat konfiguraci a vytvořit prostředek. Mějte na paměti, že dokončení nasazení bude trvat několik minut.

Správa prostředku Communication Services

Pokud chcete spravovat prostředek Komunikační služby, přejděte na Azure Portal a vyhledejte a vyberte Azure Communication Services.

Na stránce Komunikační služby vyberte název vašeho prostředku.

Stránka Přehled vašeho prostředku obsahuje možnosti pro základní správu, jako je procházení, zastavení, spuštění, restartování a odstranění. Další možnosti konfigurace najdete v nabídce vlevo na stránce prostředku.

Požadavky

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

Pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Před vytvořením prostředku zkontrolujte, že vaše předplatné splňuje všechny požadavky , pokud plánujete nákup telefonních čísel.

Vytvoření prostředku Azure Communication Services

Pokud chcete vytvořit prostředek Azure Communication Services, přihlaste se k Azure CLI. Můžete se přihlásit spuštěním az login příkazu z terminálu a zadáním přihlašovacích údajů. Spuštěním následujícího příkazu vytvořte prostředek:

az communication create --name "<acsResourceName>" --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 create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup> --subscription "<subscriptionId>"

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

• Skupina prostředků
• Název prostředku komunikačních služeb
• Geografická 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 je možné použít k uspořádání prostředků Azure. Další informace o značkách najdete v dokumentaci k označování prostředků.

Správa prostředku Communication Services

Pokud chcete přidat značky k prostředku služby Communication Services, spusťte následující příkazy. Můžete také cílit na konkrétní předplatné.

az communication update --name "<communicationName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"

az communication update --name "<communicationName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>"

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

Informace o dalších příkazech najdete v tématu Azure Communication CLI.

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si zdarma účet.
• 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.

Upozorňujeme, že pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Před vytvořením prostředku zkontrolujte, že vaše předplatné splňuje všechny požadavky , pokud plánujete nákup telefonních čísel.

Instalace sady SDK

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

using Azure.ResourceManager.Communication;

ID předplatného

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

1. Přihlaste se ke svému účtu Azure.
2. Na levém bočním panelu vyberte Předplatná.
3. Vyberte požadované předplatné.
4. Klikněte na Přehled.
5. Vyberte ID předplatného.

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

Authentication

Pokud chcete komunikovat s Azure Communication Services, musíte se nejprve ověřit v Azure. Obvykle to uděláte pomocí identity instančního objektu.

Možnost 1: Spravovaná identita

Pokud váš kód běží v Azure jako služba, nejjednodušším způsobem ověření je získání spravované identity z Azure. Přečtěte si další informace o spravovaných identitách.

Služby Azure, které podporují spravované identity

Jak používat spravované identity pro App Service a Azure Functions

Spravovaná identita přiřazená systémem

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var acsClient = new CommunicationManagementClient(subscriptionId, new ManagedIdentityCredential());

Spravovaná identita přiřazená uživatelem

ClientId spravované identity, kterou jste vytvořili, se musí explicitně předat do objektu ManagedIdentityCredential .

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var managedIdentityCredential = new ManagedIdentityCredential("AZURE_CLIENT_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, managedIdentityCredential);

Možnost 2: Instanční objekt

Místo použití spravované identity můžete chtít provést ověření v Azure pomocí instančního objektu, který spravujete sami. Další informace o vytváření a správě instančního objektu v Azure Active Directory najdete v dokumentaci.

Po vytvoření instančního objektu budete muset z Azure Portal shromáždit následující informace:

• ID klienta
• Tajný klíč klienta
• ID tenanta

Tyto hodnoty uložte do proměnných prostředí s názvy AZURE_CLIENT_ID, AZURE_CLIENT_SECRETa AZURE_TENANT_ID v uvedeném pořadí. Potom můžete vytvořit klienta pro správu komunikačních služeb následujícím způsobem:

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, new EnvironmentCredential());

Možnost 3: Identita uživatele

Pokud chcete volat Azure jménem interaktivního uživatele a nechcete používat identitu služby, můžete k vytvoření klienta Azure Communication Services Management použít následující kód. Otevře se okno prohlížeče, ve které se uživateli zobrazí výzva k zadání přihlašovacích údajů msa nebo Azure AD.

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var communicationServiceClient = new CommunicationManagementClient(subscriptionId, new InteractiveBrowserCredential());

Správa prostředků komunikačních služeb

Interakce s prostředky Azure

Teď, když jste ověřeni, můžete pomocí klienta pro správu volat rozhraní API.

U každého z následujících příkladů přiřadíme prostředky služby Communication Services existující skupině prostředků.

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

Vytvoření a správa prostředku Komunikační služby

K provádění operací s prostředky komunikačních služeb je možné použít naši instanci klienta Sady SDK pro správu komunikačních služeb (Azure.ResourceManager.Communication.CommunicationManagementClient).

Vytvoření prostředku Communication Services

Při vytváření prostředku Communication Services zadáte název skupiny prostředků a název prostředku. Všimněte si Location , že vlastnost bude vždy globala ve verzi Public Preview DataLocation musí být UnitedStateshodnota .

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates"  };
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Aktualizace prostředku komunikačních služeb

...
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates" };
resource.Tags.Add("environment","test");
resource.Tags.Add("department","tech");
// Use existing resource name and new resource object
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Vypsat všechny prostředky komunikačních služeb

var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
    Console.WriteLine(resource.Name);
}

Odstranění prostředku komunikačních služeb

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);

Správa klíčů a připojovacích řetězců

Každý prostředek communication services má dvojici přístupových klíčů a odpovídajících připojovacích řetězců. K těmto klíčům je možné získat přístup pomocí sady SDK pro správu a pak je používat jiné sady SDK služby Communication Services k ověření v Azure Communication Services.

Získání přístupových klíčů k prostředku služby Communication Services

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keys = await acsClient.CommunicationService.ListKeysAsync(resourceGroupName, resourceName);

Console.WriteLine(keys.Value.PrimaryConnectionString);
Console.WriteLine(keys.Value.SecondaryConnectionString);

Opětovné vygenerování přístupového klíče pro prostředek Komunikační služby

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keyParams = new RegenerateKeyParameters { KeyType = KeyType.Primary };
var keys = await acsClient.CommunicationService.RegenerateKeyAsync(resourceGroupName, resourceName, keyParams);

Console.WriteLine(keys.Value.PrimaryKey);

Požadavky

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

Upozorňujeme, že pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Před vytvořením prostředku zkontrolujte, že vaše předplatné splňuje všechny požadavky , pokud plánujete nákup telefonních čísel.

Vytvoření prostředku Azure Communication Services

Pokud chcete vytvořit prostředek Azure Communication Services, přihlaste se k Azure CLI. Můžete to udělat prostřednictvím terminálu pomocí Connect-AzAccount příkazu a zadáním přihlašovacích údajů.

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

PS C:\> Install-Module Az.Communication

Spuštěním následujícího příkazu vytvořte prostředek:

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global

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

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -SubscriptionId SubscriptionID

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

• Skupina prostředků
• Název prostředku komunikačních služeb
• Geografická 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 je možné použít k uspořádání prostředků Azure. Další informace o značkách najdete v dokumentaci k označování prostředků .

Správa prostředku Communication Services

Pokud chcete přidat značky k prostředku služby Communication Services, spusťte následující příkazy. Můžete také cílit na konkrétní předplatné.

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

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

K zobrazení seznamu všech prostředků Azure Communication Services v daném předplatném použijte následující příkaz:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

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

PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1

Přístup k připojovacím řetězcům a koncovým bodům služby

Připojovací řetězce umožňují, aby se sady SDK služby Communication Services připojily a ověřily v Azure. Ke svým připojovacím řetězcům a koncovým bodům služby Communication Services můžete přistupovat z Azure Portal nebo programově pomocí rozhraní API azure Resource Manager.

Po přechodu na prostředek komunikačních služeb vyberte v navigační nabídce Klíče a zkopírujte připojovací řetězec nebo hodnoty koncového bodu pro použití sadami SDK komunikačních služeb. Mějte na paměti, že máte přístup k primárnímu a sekundárnímu klíči. To může být užitečné ve scénářích, kdy chcete poskytnout dočasný přístup k prostředkům komunikačních služeb třetí straně nebo přípravnému prostředí.

Přístup k připojovacím řetězcům a koncovým bodům služby pomocí Azure CLI

K informacím o klíčích můžete přistupovat také pomocí Azure CLI, jako je vaše skupina prostředků nebo klíče pro konkrétní prostředek.

Nainstalujte Azure CLI a přihlaste se pomocí následujícího příkazu. Abyste se mohli připojit ke svému účtu Azure, budete muset zadat svoje přihlašovací údaje.

az login

Teď máte přístup k důležitým informacím o vašich prostředcích.

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

az communication list-key --name "<acsResourceName>" --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 list --resource-group  "<resourceGroup>"  --subscription "<subscriptionId>"

az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Uložení připojovacího řetězce

Sady SDK služby Communication Services používají připojovací řetězce k autorizaci požadavků zasílaných na službu Communication Services. Připojovací řetězec můžete uložit několika způsoby:

• Aplikace spuštěná na počítači nebo na zařízení může připojovací řetězec uložit do souboruapp.config nebo web.config . Přidejte připojovací řetězec do oddílu AppSettings v těchto souborech.
• Aplikace spuštěná v Azure App Service může připojovací řetězec uložit do App Service nastavení aplikace. Přidejte připojovací řetězec do části Připojovací řetězce na kartě Nastavení aplikace na portálu.
• Připojovací řetězec můžete uložit v Azure Key Vault.
• Pokud aplikaci spouštíte místně, možná budete chtít uložit připojovací řetězec do proměnné prostředí.

Uložení připojovacího řetězce do proměnné prostředí

Pokud chcete nakonfigurovat proměnnou prostředí, otevřete okno konzoly a na následujících kartách vyberte operační systém. Nahraďte <yourconnectionstring> skutečným připojovacím řetězcem.

Windows

Otevřete okno konzoly a zadejte následující příkaz:

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"

Po přidání proměnné prostředí možná bude nutné restartovat všechny spuštěné programy, které budou potřebovat číst tuto proměnnou prostředí, a to včetně okna konzoly. Pokud například jako editor používáte Visual Studio, před spuštěním příkladu visual studio restartujte.

macOS

Upravte soubor .zshrca přidejte proměnnou prostředí:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Po přidání proměnné prostředí spusťte v okně konzoly příkaz source ~/.zshrc, aby se změny projevily. Pokud jste vytvořili proměnnou prostředí s otevřeným prostředím IDE, možná budete muset zavřít a znovu otevřít editor, integrované vývojové prostředí nebo prostředí, abyste k proměnné získali přístup.

Linux

Upravte soubor .bash_profilea přidejte proměnnou prostředí:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Po přidání proměnné prostředí spusťte v okně konzoly příkaz source ~/.bash_profile, aby se změny projevily. Pokud jste vytvořili proměnnou prostředí s otevřeným prostředím IDE, možná budete muset zavřít a znovu otevřít editor, integrované vývojové prostředí nebo prostředí, abyste k proměnné získali přístup.

Vyčištění prostředků

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

az communication delete --name "acsResourceName" --resource-group "resourceGroup"

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

Pokud máte k prostředku přiřazená telefonní čísla při odstranění prostředku, uvolní se z vašeho prostředku automaticky ve stejnou dobu.

Poznámka

Odstranění prostředku je trvalé a po odstranění prostředku není možné obnovit žádná data, včetně filtrů Event Gridu, telefonních čísel nebo jiných dat vázaných na váš prostředek.

Další kroky

V tomto rychlém startu jste se naučili:

• Vytvoření prostředku Communication Services
• Konfigurace zeměpisných údajů a značek prostředků
• Přístup ke klíčům pro tento prostředek
• Odstranění prostředku

Vytvoření prvních přístupových tokenů uživatele