Snabbstart: Skapa och hantera Communication Services resurser

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

Observera att du inte kan använda det kostnadsfria utvärderingskontot om du planerar att använda telefonnummer. Kontrollera att din prenumeration uppfyller alla krav om du planerar att köpa telefonnummer innan du skapar din resurs.

Skapa Azure Communication Services resurs

Om du vill Azure Communication Services en resurs loggar du först in på Azure Portal. I det övre vänstra hörnet på sidan väljer du + Skapa en resurs.

Ange Kommunikation i antingen Indata för Sök på Marketplace eller i sökfältet högst upp i portalen.

Välj Communication Services i resultaten och välj sedan Skapa.

Nu kan du konfigurera Communication Services resurs. På den första sidan i processen för att skapa uppmanas du att ange:

• Prenumerationen
• Resursgruppen (du kan skapa en ny eller välja en befintlig resursgrupp)
• Namnet på den Communication Services resursen
• Det geografiska område som resursen kommer att associeras med

I nästa steg kan du tilldela taggar till resursen. Taggar kan användas för att organisera dina Azure-resurser. Mer information om taggar finns i dokumentationen om resurstaggar.

Slutligen kan du granska konfigurationen och skapa resursen. Observera att distributionen tar några minuter att slutföra.

Hantera din Communication Services resurs

Om du vill Communication Services resurs går du till Azure Portaloch söker efter och väljer Azure Communication Services.

På Communication Services väljer du namnet på din resurs.

Översiktssidan för din resurs innehåller alternativ för grundläggande hantering, till exempel bläddra, stoppa, starta, starta om och ta bort. Du hittar fler konfigurationsalternativ på resurssidans vänstra meny.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Installera Azure CLI

Observera att om du planerar att använda telefonnummer kan du inte använda det kostnadsfria utvärderingskontot. Kontrollera att din prenumeration uppfyller alla krav om du planerar att köpa telefonnummer innan du skapar din resurs.

Skapa Azure Communication Services resurs

Om du vill Azure Communication Services en resurs loggar du in på Azure CLI. Du kan göra detta via terminalen med kommandot az login och ange dina autentiseringsuppgifter. Kör följande kommando för att skapa resursen:

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

Om du vill välja en specifik prenumeration kan du också ange flaggan --subscription och ange prenumerations-ID:t.

az communication create --name "<communicationName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup> --subscription "<subscriptionID>"

Du kan konfigurera Communication Services resurs med följande alternativ:

• Resursgruppen
• Namnet på Communication Services resursen
• Det geografiska område som resursen ska associeras med

I nästa steg kan du tilldela taggar till resursen. Taggar kan användas för att organisera dina Azure-resurser. Mer information om taggar finns i dokumentationen om resurstaggning.

Hantera din Communication Services resurs

Om du vill lägga till taggar Communication Services din resurs kör du följande kommandon. Du kan även rikta en viss prenumeration.

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

Information om ytterligare kommandon finns i az communication.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Den senaste versionen .NET Core SDK för ditt operativsystem.
• Hämta den senaste versionen av .NET Identity SDK.
• Hämta den senaste versionen av .NET Management SDK.

Observera att om du planerar att använda telefonnummer kan du inte använda det kostnadsfria utvärderingskontot. Kontrollera att din prenumeration uppfyller alla krav om du planerar att köpa telefonnummer innan du skapar din resurs.

Installera SDK

Börja med att inkludera Communication Services Management SDK i C#-projektet:

using Azure.ResourceManager.Communication;

Prenumerations-ID:t

Du måste känna till ID:t för din Azure-prenumeration. Detta kan köpas från portalen:

1. Logga in på ditt Azure-konto
2. Välj Prenumerationer i den vänstra sidopanelen
3. Välj den prenumeration som behövs
4. Klicka på Översikt
5. Välj ditt prenumerations-ID

I den här snabbstarten antar vi att du har lagrat prenumerations-ID:t i en miljövariabel med namnet AZURE_SUBSCRIPTION_ID .

Autentisering

För att kommunicera Azure Communication Services måste du först autentisera dig mot Azure. Du gör vanligtvis detta med hjälp av en tjänsthuvudnamnsidentitet.

Alternativ 1: Hanterad identitet

Om din kod körs som en tjänst i Azure är det enklaste sättet att autentisera att skaffa en hanterad identitet från Azure. Läs mer om hanterade identiteter.

Azure-tjänster som stöder hanterade identiteter

Använda hanterade identiteter för App Service och Azure Functions

System tilldelad hanterad identitet

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

Användar tilldelad hanterad identitet

ClientId för den hanterade identiteten som du skapade måste skickas till ManagedIdentityCredential uttryckligen.

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

Alternativ 2: Tjänstens huvudnamn

I stället för att använda en hanterad identitet kanske du vill autentisera till Azure med hjälp av ett huvudnamn för tjänsten som du hanterar själv. Läs mer i dokumentationen om hur du skapar och hanterar ett huvudnamn för tjänsten i Azure Active Directory.

När du har skapat tjänstens huvudnamn måste du samla in följande information om det från Azure Portal:

• Klient-ID
• Klienthemlighet
• Klientorganisations-ID

Lagra dessa värden i AZURE_CLIENT_ID miljövariabler med namnet , respektive AZURE_CLIENT_SECRET AZURE_TENANT_ID . Du kan sedan skapa en Communication Services-hanteringsklient så här:

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

Alternativ 3: Användaridentitet

Om du vill anropa Azure för en interaktiv användares räkning i stället för att använda en tjänstidentitet kan du använda följande kod för att skapa en Azure Communication Services Management-klient. Då öppnas ett webbläsarfönster där användaren uppmanas att ange sina MSA- eller Azure AD-autentiseringsuppgifter.

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

Hantera Communication Services resurser

Interagera med Azure-resurser

Nu när du är autentiserad kan du använda hanteringsklienten för att göra API-anrop.

För vart och ett av följande exempel tilldelar vi våra Communication Services till en befintlig resursgrupp.

Om du behöver skapa en resursgrupp kan du göra det med hjälp av Azure Portal eller Azure Resource Manager SDK.

Skapa och hantera en Communication Services resurs

Vår instans av Communication Services Management SDK-klienten ( Azure.ResourceManager.Communication.CommunicationManagementClient ) kan användas för att utföra åtgärder på Communication Services resurser.

Skapa en Communication Services-resurs

När du skapar Communication Services resurs anger du resursgruppens namn och resursnamn. Observera att Location egenskapen alltid är , och under den offentliga global förhandsversionen måste värdet vara DataLocation 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();

Uppdatera en Communication Services resurs

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

Lista alla Communication Services resurser

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

Ta bort en Communication Services resurs

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

Hantera nycklar och anslutningssträngar

Varje Communication Services resurs har ett par åtkomstnycklar och motsvarande anslutningssträngar. Dessa nycklar kan nås med Management SDK och sedan användas av andra SDK:er Communication Services för att autentisera sig själva för Azure Communication Services.

Hämta åtkomstnycklar för en Communication Services resurs

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

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

Återskapa en åtkomstnyckel för en Communication Services resurs

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

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• Installera Azure Az PowerShell-modulen

Observera att du inte kan använda det kostnadsfria utvärderingskontot om du planerar att använda telefonnummer. Kontrollera att din prenumeration uppfyller alla krav om du planerar att köpa telefonnummer innan du skapar din resurs.

Skapa Azure Communication Services resurs

Om du vill Azure Communication Services en resurs loggar du in på Azure CLI. Du kan göra detta via terminalen med kommandot Connect-AzAccount och ange dina autentiseringsuppgifter.

Installera först modulen Azure Communication Services med följande Az.Communication kommando.

PS C:\> Install-Module Az.Communication

Kör följande kommando för att skapa resursen:

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

Om du vill välja en specifik prenumeration kan du också ange flaggan --subscription och ange prenumerations-ID:t.

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

Du kan konfigurera Communication Services resurs med följande alternativ:

• Resursgruppen
• Namnet på den Communication Services resursen
• Det geografiska område som resursen kommer att associeras med

I nästa steg kan du tilldela taggar till resursen. Taggar kan användas för att organisera dina Azure-resurser. Mer information om taggar finns i dokumentationen om resurstaggar.

Hantera din Communication Services resurs

Om du vill lägga till taggar Communication Services resursresursen kör du följande kommandon. Du kan även rikta in dig på en viss prenumeration.

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

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

Om du vill visa alla Azure Communication Services resurser i en viss prenumeration använder du följande kommando:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Om du vill visa all information om en viss resurs använder du följande kommando:

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