Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Začněte se službou Azure Communication Services tím, že zřídíte svůj první prostředek služby Communication Services. Prostředky komunikačních služeb můžete zřídit prostřednictvím webu Azure Portal nebo pomocí sady SDK pro správu .NET. Sada SDK pro správu a Azure Portal umožňují vytvářet, konfigurovat, aktualizovat a odstraňovat prostředky a rozhraní pomocí služby pro nasazení a správu: Azure Resource Manager. Všechny funkce dostupné v sadách SDK jsou k dispozici na webu Azure Portal.
Varování
Skupinu prostředků nemůžete vytvořit současně s prostředkem pro Azure Communication Services. Před vytvořením prostředku je potřeba nejprve vytvořit skupinu prostředků.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
Pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Zkontrolujte, zda vaše předplatné splňuje všechny požadavky, pokud plánujete koupit telefonní čísla před vytvořením prostředku.
Vytvoření prostředku Azure Communication Services pomocí webu Azure Portal
Pokud chcete vytvořit prostředek Azure Communication Services, nejprve se přihlaste k webu Azure Portal. V levém horním rohu stránky vyberte + Vytvořit prostředek.
Zadejte Komunikace buď do vstupního pole Hledat na Marketplace, nebo do vyhledávacího panelu v horní části portálu.
Ve výsledcích vyberte Komunikační služby a pak vyberte Vytvořit.
Teď můžete nakonfigurovat prostředek komunikační služby. Na první stránce procesu vytvoření musíte zadat:
- Předplatné.
- Skupina prostředků (můžete vytvořit novou nebo zvolit existující skupinu prostředků).
- Název prostředku Komunikační služby.
- Zeměpisná oblast přidružená k prostředku
V dalším kroku můžete k prostředku přiřadit tagy. Značky můžete použít k uspořádání prostředků Azure. Další informace o značkách najdete v tématu Použití značek k uspořádání prostředků Azure a hierarchie správy.
Nakonec zkontrolujte konfiguraci a kliknutím na Vytvořit nasaďte prostředek. Dokončení nasazení trvá několik minut.
Správa prostředku komunikačních služeb
Pokud chcete spravovat prostředek Komunikační služby, přihlaste se k webu 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 základní správy, jako je procházení, zastavení, spuštění, restartování a odstranění. Další možnosti konfigurace naleznete v nabídce vlevo na stránce vašeho prostředku.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Nainstalujte Azure CLI.
Pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Zkontrolujte, jestli vaše předplatné splňuje všechny požadavky , pokud před vytvořením prostředku plánujete koupit telefonní čísla.
Vytvoření prostředku Azure Communication Services pomocí Azure CLI
Pokud chcete vytvořit prostředek Azure Communication Services, přihlaste se k Azure CLI. Spuštěním az login
příkazu z terminálu se můžete přihlásit a zadat přihlašovací údaje.
Pro vytvoření prostředku spusťte následující příkaz:
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 komunikační služby můžete nakonfigurovat s následujícími možnostmi:
- Skupina prostředků
- Název prostředku komunikačních služeb
- Zeměpisná oblast přidružená k prostředku
V dalším kroku můžete k prostředku přiřadit tagy. Značky můžete použít k uspořádání prostředků Azure. Další informace o značkách najdete v tématu Použití značek k uspořádání prostředků Azure a hierarchie správy.
Spravujte prostředky Komunikačních služeb
Pokud chcete do prostředku služby Communication Services přidat značky, 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ření účtu zdarma
- Nejnovější verze .NET Core SDK pro váš operační systém.
- Získejte nejnovější verzi .NET Identity SDK.
- Získejte nejnovější verzi sady .NET Management SDK.
Pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Zkontrolujte, jestli vaše předplatné splňuje všechny požadavky , pokud před vytvořením prostředku plánujete koupit telefonní čísla.
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
Potřebujete znát ID vašeho předplatného Azure. Získejte ID předplatného z portálu:
- Přihlaste se ke svému účtu na webu Azure Portal.
- Na levém bočním panelu vyberte Předplatná.
- Vyberte předplatné, které chcete použít.
- Klikněte na Přehled.
- Vyberte SVÉ ID předplatného.
Aby příklady fungovaly, je potřeba uložit ID předplatného 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. Můžete to ověřit pomocí identity servisního principálu.
Možnost 1: Spravovaná identita
Pokud je váš kód spuštěný jako služba v Azure, nejjednodušší způsob, jak ověřit, je získat spravovanou identitu z Azure. Další informace naleznete v tématu:
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
Klientské ID spravované identity, kterou jste vytvořili, musí být explicitně předáno 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: Principál služby
Místo použití spravované identity se můžete ověřit v Azure pomocí instančního objektu, který spravujete. Další podrobnosti naleznete na stránce vytváření a správa služebního principálu v Microsoft Entra ID.
Po vytvoření aplikačního objektu potřebujete z Azure portálu shromáždit následující informace:
- ID klienta
- Tajný klíč klienta
- ID nájemníka
Tyto hodnoty uložte jako proměnné prostředí s názvem AZURE_CLIENT_ID
, AZURE_CLIENT_SECRET
a AZURE_TENANT_ID
v uvedeném pořadí. Klienta pro správu komunikačních služeb pak můžete vytvořit takto:
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 místo použití identity služby, můžete pomocí následujícího kódu vytvořit klienta pro správu služeb Azure Communication Services. Otevře se okno prohlížeče, které uživatele vyzve k zadání přihlašovacích údajů MSA nebo Microsoft Entra.
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
Po ověření můžete pomocí klienta pro správu provádět volání rozhraní API.
Pro každý z následujících příkladů přiřadíme prostředky komunikačních služeb existující skupině prostředků.
Pokud potřebujete vytvořit skupinu prostředků, můžete použít Azure Portal nebo sadu SDK Azure Resource Manageru.
Vytvoření a správa prostředku Komunikační služby
K provádění operací s prostředky komunikačních služeb můžete použít instanci klienta sady SDK pro správu komunikačních služeb (Azure.ResourceManager.Communication.CommunicationManagementClient
).
Vytvořte prostředek Communication Services
Při vytváření prostředku služby Communication Services zadejte název skupiny prostředků a název prostředku. Vlastnost Location
je vždy global
, a během veřejné verze preview musí mít DataLocation
hodnotu UnitedStates
.
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 služby Communication Services
...
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();
Výpis všech prostředků komunikačních služeb
var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
Console.WriteLine(resource.Name);
}
Odstranit prostředek Komunikační služby
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);
Správa klíčů a připojovací řetězec
Každý prostředek komunikační služby má pár přístupových klíčů a odpovídající připojovací řetězec. K těmto klíčům můžete přistupovat pomocí sady SDK pro správu a pak je zpřístupnit ostatním sadám SDK komunikačních služeb, aby se ověřily ve službě Azure Communication Services.
Získání přístupových klíčů pro prostředek 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 služby Communication Services
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ření účtu zdarma
- Nainstalujte modul Azure Az PowerShell.
Pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Zkontrolujte, jestli vaše předplatné splňuje všechny požadavky, pokud plánujete koupit telefonní čísla před vytvořením prostředku.
Vytvoření prostředku Azure Communication Services pomocí PowerShellu
Pokud chcete vytvořit prostředek Azure Communication Services, přihlaste se k Azure CLI. Prostředek můžete vytvořit 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
Prostředek vytvoříte spuštěním následujícího příkazu:
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 zadat ID předplatného.
PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -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 komunikačních služeb
- Zeměpisná oblast, která se má přidružit ke zdroji
V dalším kroku můžete k prostředku přiřadit značky. Značky můžete použít k uspořádání prostředků Azure. Další informace najdete v tématu Použití značek k uspořádání prostředků Azure a hierarchie správy.
Správa prostředku Komunikační služby
Pokud chcete do prostředku služby Communication Services přidat značky, 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
Pokud chcete zobrazit seznam všech prostředků služeb Azure Communication Services pro dané předplatné, použijte následující příkaz:
PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID
K výpisu všech informací o daném prostředku použijte následující příkaz:
PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1
Získejte přístup k připojovacím řetězcům a koncovým bodům služby
Připojovací řetězce umožňují sadám SDK komunikačních služeb připojit se k Azure a ověřit je. Ke svým komunikačním službám můžete přistupovat ke spojovacím řetězcům a koncovým bodům služby prostřednictvím Azure Portálu nebo programově pomocí API Azure Resource Manager.
Po přechodu na prostředek služby Communication Services vyberte Klíče z navigační nabídky a zkopírujte připojovací řetězec nebo koncový bod pro použití v SDK komunikačních služeb. Máte přístup k primárním a sekundárním klíčům. Tyto klíče jsou užitečné, pokud chcete poskytnout dočasný přístup k prostředkům komunikačních služeb do jiného nebo přípravného prostředí.
Přístup ke svým 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, musíte zadat svoje přihlašovací údaje.
az login
Teď máte přístup k důležitým informacím o 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žte připojovací řetězec
Sady SDK komunikačních služeb používají připojovací řetězec k autorizaci požadavků provedených ve službě Communication Services. Máte několik možností, jak uložit připojovacího řetězce:
- Aplikace spuštěná na ploše nebo na zařízení může uložit připojovací řetězec do souboru app.config nebo web.config. Přidejte připojovací řetězec do části AppSettings v těchto souborech.
- Aplikace spuštěná ve službě Aplikace Azure Může ukládat připojovací řetězec v nastavení aplikace služby App Service. 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 ve službě Azure Key Vault. Připojovací řetězec můžete dále bezpečně spravovat.
- Pokud aplikaci spouštíte místně, můžete chtít uložit připojovací řetězec do proměnné prostředí.
Uložte připojovací řetězec 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>
svým skutečným připojovacím řetězcem.
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á budete muset restartovat všechny spuštěné programy, které čtou proměnnou prostředí, včetně okna konzoly. Pokud například jako editor používáte Sadu Visual Studio, restartujte sadu Visual Studio před spuštěním příkladu.
Vyčištění prostředků
Pokud chcete vyčistit a odebrat předplatné služby Communication Services, můžete odstranit prostředek nebo skupinu prostředků. Pokud chcete odstranit komunikační prostředek, spusťte následující příkaz.
az communication delete --name "acsResourceName" --resource-group "resourceGroup"
Odstraněním skupiny prostředků se odstraní také všechny ostatní prostředky, které jsou k ní přidružené.
Pokud máte při odstranění prostředku přiřazená nějaká telefonní čísla, budou tato telefonní čísla automaticky uvolněna z vašeho prostředku současně.
Poznámka:
Odstranění prostředku je trvalé. Pokud prostředek odstraníte, není možné obnovit žádná deletovaná data, včetně filtrů služby Event Grid, telefonních čísel nebo jiných dat svázaných s vaším prostředkem.
Další kroky
Tento článek popisuje, jak:
- Vytvořte prostředek komunikačních služeb
- Konfigurace geografie a štítků prostředků
- Přístup ke klíčům pro tento prostředek
- Odstraňte prostředek