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

Požadavky

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

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, jestli vaše předplatné splňuje všechny požadavky.

Vytvoření Azure Communication Services prostředků

Pokud chcete vytvořit 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 vstup Marketplace nebo do panelu hledání v horní části portálu zadejte Komunikace.

Ve Communication Services vyberte Vytvořit a pak vyberte Vytvořit.

Teď můžete nakonfigurovat svůj Communication Services prostředků. Na první stránce procesu vytváření budete vyzváni k zadání:

• Předplatné
• Skupina prostředků (můžete vytvořit novou nebo zvolit existující skupinu prostředků)
• Název prostředku Communication Services
• Zeměpisná oblast, ke které bude prostředek přidružený

V dalším kroku můžete 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 vědomí, že dokončení nasazení bude trvat několik minut.

Správa Communication Services prostředků

Pokud chcete spravovat Communication Services prostředků, přejděte na Azure Portala vyhledejte a vyberte Azure Communication Services.

Na Communication Services vyberte název vašeho prostředku.

Stránka Přehled pro váš prostředek obsahuje možnosti základní správy, 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 účet zdarma.
• Instalace rozhraní příkazového řádku Azure

Mějte na paměti, že pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Ověřte, že vaše předplatné splňuje všechny požadavky , pokud plánujete koupit telefonní čísla před vytvořením prostředku.

Vytvořit prostředek služby Azure Communication Services

Pokud chcete vytvořit prostředek služby Azure Communication Services, Přihlaste se k Azure CLI. To můžete provést pomocí terminálu pomocí az login příkazu a zadáním přihlašovacích údajů. Spusťte následující příkaz pro vytvoření prostředku:

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

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

• Skupina prostředků
• Název prostředku komunikačních služeb
• Zeměpisná oblast, ke které bude prostředek přidružen

V dalším kroku můžete přiřadit značky k prostředku. Značky lze 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 komunikačních služeb

Chcete-li přidat značky do 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 naleznete v tématu AZ Communication.

Požadavky

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

Mějte na paměti, že pokud plánujete používat telefonní čísla, nemůžete použít bezplatný zkušební účet. Ověřte, že vaše předplatné splňuje všechny požadavky , pokud plánujete koupit telefonní čísla před vytvořením prostředku.

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 potřebovat znát ID vašeho předplatného Azure. Dá se získat z portálu:

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

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

Authentication

Abyste mohli komunikovat s komunikačními službami Azure, musíte se nejdřív ověřit v Azure. Obvykle to provedete pomocí identity instančního objektu.

Možnost 1: spravovaná identita

Pokud je váš kód spuštěný jako služba v Azure, nejjednodušší způsob ověřování 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

Použití spravovaných identit 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, je nutné předat ManagedIdentityCredential explicitně.

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žívání spravované identity můžete chtít provést ověření v Azure pomocí instančního objektu, který spravujete sami. Další informace najdete v dokumentaci k vytváření a správě instančního objektu ve službě Azure Active Directory.

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

• ID klienta
• Tajný kód klienta
• ID tenanta

Tyto hodnoty uložte do proměnných prostředí s názvem AZURE_CLIENT_ID , AZURE_CLIENT_SECRET a v AZURE_TENANT_ID uvedeném pořadí. Pak můžete vytvořit klienta pro správu komunikačních služeb 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žívání identity služby, můžete k vytvoření klienta pro správu služby Azure Communication Services použít následující kód. Tím se otevře okno prohlížeče s výzvou k zadání přihlašovacích údajů uživatele 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ů služby Communications Services

Interakce s prostředky Azure

Teď, když jste ověřeni, můžete použít klienta pro správu k volání rozhraní API.

Pro každý z následujících příkladů budeme přiřazovat prostředky služby Communications do existující skupiny prostředků.

Pokud potřebujete vytvořit skupinu prostředků, můžete k tomu použít Azure Portal nebo sadu Azure Resource Manager SDK.

Vytvoření a Správa prostředku komunikačních služeb

Naši instanci klienta sady SDK služby Communications Services ( Azure.ResourceManager.Communication.CommunicationManagementClient ) lze použít k provádění operací s prostředky komunikačních služeb.

Vytvoření prostředku Communication Services

Při vytváření prostředku komunikačních služeb zadáte název skupiny prostředků a název prostředku. Všimněte si, že Location vlastnost bude vždycky global a během veřejné verze Preview DataLocation musí být hodnota 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 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();

Zobrazit seznam všech prostředků služby Communication Services

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 komunikačních služeb má dvojici přístupových klíčů a odpovídajících připojovacích řetězců. K těmto klíčům máte přístup pomocí sady Management SDK a pak je používají jiné sady SDK služby Communications Services k ověřování vůči komunikačním službám Azure.

Získání přístupových klíčů pro prostředek komunikačních služeb

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é generování přístupového klíče pro prostředek komunikačních služeb

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 účet zdarma.
• 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, jestli vaše předplatné splňuje všechny požadavky.

Vytvoření Azure Communication Services prostředků

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

Nejprve pomocí následujícího příkazu Azure Communication Services Az.Communication nainstalujte modul 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 příznak a --subscription zadat ID předplatného.

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

Svůj prostředek Communication Services nakonfigurovat s následujícími možnostmi:

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

V dalším kroku můžete 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 Communication Services prostředků

Pokud chcete do prostředku Communication Services 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

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

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

K zobrazení seznamu všech informací o daném prostředku použijte následující příkaz:

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

az login

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

az communication list-key --name "<communicationName>" --resource-group "<resourceGroup>"

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

az communication list-key --name "<communicationName>" --resource-group "resourceGroup>" --subscription "<subscriptionID>"

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourconnectionstring>"

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourconnectionstring>"

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourconnectionstring>"