Quickstart: Communication Services-resources maken en beheren

Ga aan de slag met Azure Communication Services door uw eerste Communication Services-resource te provisioneren. Communication Services-resources kunnen worden ingericht via Azure Portal of met de .NET-beheer-SDK. Met de beheer-SDK en Azure Portal kunt u uw resources en interface maken, configureren, bijwerken en verwijderen met Azure Resource Manager, de implementatie- en beheerservice van Azure. Alle functies die beschikbaar zijn in de SDK's zijn beschikbaar in Azure Portal.

Waarschuwing

Houd er rekening mee dat het niet mogelijk is om tegelijkertijd een resourcegroep te maken als een resource voor Azure Communication Services. Wanneer u een resource maakt, moet een resourcegroep die al is gemaakt, worden gebruikt.

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken

Als u van plan bent om telefoonnummers te gebruiken, kunt u het gratis proefaccount niet gebruiken. Controleer of uw abonnement voldoet aan alle vereisten als u van plan bent telefoonnummers aan te schaffen voordat u uw resource maakt.

Azure Communication Services-resource maken

Als u een Azure SignalR Service-resource wilt maken, meldt u zich eerst aan bij de Azure-portal. Selecteer in de linkerbovenhoek van de startpagina de optie + Een resource maken.

Voer Communicatie in Zoek in de Marketplace invoer of in de zoekbalk bovenaan de portal.

Selecteer Communication Services in de resultaten en selecteer vervolgens Maken.

U kunt nu uw Communication Services-resource configureren. Op de eerste pagina van het proces maken, wordt u gevraagd het volgende op te geven:

• Het abonnement
• De resourcegroep (u kunt een nieuwe maken of een bestaande resourcegroep kiezen)
• De naam van de Communication Services-resource
• De geografie waaraan de resource wordt gekoppeld

In de volgende stap kunt u tags toewijzen aan de resource. Tags kunnen worden gebruikt voor het organiseren van uw Azure-resources. Zie de documentatie van resource-tagging voor meer informatie over tags.

Ten slotte kunt u uw configuratie controleren en de resource Maken. Houd er rekening mee dat het enkele minuten duurt voordat de implementatie is voltooid.

Een Communication Services-resource maken.

Als u uw Communication Services-resource wilt beheren, gaat u naar de Azure Portalen zoekt en selecteert u Azure Communication Services.

Selecteer op de pagina Communication Services de naam van uw resource.

De pagina Overzicht voor de web-app bevat opties voor basisbeheer, zoals browsen, stoppen, starten, opnieuw starten en verwijderen. Meer configuratie opties vindt u in het menu links van de resource pagina.

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken
• Azure CLI installeren

Als u van plan bent om telefoonnummers te gebruiken, kunt u het gratis proefaccount niet gebruiken. Controleer of uw abonnement voldoet aan alle vereisten als u van plan bent telefoonnummers aan te schaffen voordat u uw resource maakt.

Azure Communication Services-resource maken

Meld u aan bij Azure CLI om een Azure Communication Services-resource te maken. U kunt zich aanmelden bij het uitvoeren van de az login opdracht vanuit de terminal en uw referenties opgeven. Voer de volgende opdracht uit om de resource te maken:

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

Als u een specifiek abonnement wilt selecteren, kunt u ook de --subscription vlag opgeven en de abonnements-id opgeven.

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

U kunt uw Communication Services-resource configureren met de volgende opties:

• De resourcegroep
• De naam van de Communication Services-resource
• De geografie waaraan de resource wordt gekoppeld

In de volgende stap kunt u tags toewijzen aan de resource. Tags kunnen worden gebruikt voor het organiseren van uw Azure-resources. Zie de documentatie voor het taggen van resources voor meer informatie over tags.

Een Communication Services-resource maken.

Voer de volgende opdrachten uit om tags toe te voegen aan uw Communication Services-resource. U kunt ook een specifiek abonnement instellen.

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

Zie Azure Communication CLI voor meer informatie over andere opdrachten.

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken
• De nieuwste versie van .NET Core SDK voor uw besturingssysteem.
• Download de nieuwste versie van de .NET Identity SDK.
• Download de nieuwste versie van de .NET Management SDK.

Als u van plan bent om telefoonnummers te gebruiken, kunt u het gratis proefaccount niet gebruiken. Controleer of uw abonnement voldoet aan alle vereisten als u van plan bent telefoonnummers aan te schaffen voordat u uw resource maakt.

De SDK installeren

Neem eerst de Communication Services Management SDK op in uw C#-project:

using Azure.ResourceManager.Communication;

Abonnements-id

U hebt de ID van uw Azure-abonnement nodig. U vindt deze in het portaal:

1. Meld u aan bij uw Azure-account
2. Selecteer Abonnementen in de zijbalk aan de linkerzijde
3. Selecteer het abonnement dat u nodig hebt
4. Klik op Overzicht
5. Selecteer uw Abonnements-ID

In deze quickstart wordt ervan uitgegaan dat u de abonnements-ID hebt opgeslagen in een omgevingsvariabele met de naam AZURE_SUBSCRIPTION_ID.

Verificatie

Als u wilt communiceren met Azure Communication Services, moet u zichzelf eerst verifiëren bij Azure. Doorgaans doet u dit met behulp van een service-principal-identiteit.

Optie 1: Beheerde identiteit

Als uw code als een service wordt uitgevoerd in Azure, is de eenvoudigste manier om te verifiëren om een beheerde identiteit te verkrijgen van Azure. Meer informatie over beheerde identiteiten.

Azure-services die beheerde identiteiten ondersteunen

Beheerde identiteiten gebruiken voor App Service en Azure Functions

Door het systeem toegewezen beheerde identiteit

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

Door de gebruiker toegewezen beheerde identiteit

De ClientId van de beheerde identiteit die u hebt gemaakt, moet expliciet worden doorgegeven aan de 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);

Optie 2: Service-principal

In plaats van een beheerde identiteit te gebruiken, kunt u zich bij Azure verifiëren met behulp van een service-principal die u zelf beheert. Meer informatie over het maken en beheren van een service-principal in Microsoft Entra ID.

Nadat u de service-principal hebt gemaakt, moet u de volgende informatie in het Azure-portaal:

• Client ID
• Client Secret
• Tenant ID

Sla deze waarden op in omgevingsvariabelen en geef ze respectievelijk de naam AZURE_CLIENT_ID, AZURE_CLIENT_SECRET en AZURE_TENANT_ID. U kunt vervolgens een client voor Communication Services-beheer maken als volgt:

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

Optie 3: Gebruikersidentiteit

Als u Azure namens een interactieve gebruiker wilt aanroepen, in plaats van een service-identiteit te gebruiken, kunt u de volgende code gebruiken om een client voor Azure Communication Services-beheer te maken. Hiermee opent u een browservenster om de gebruiker te vragen om zijn of haar MSA- of Microsoft Entra-referenties.

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

Communication Services-resources beheren

Interactie met Azure-resources

Wanneer u geverifieerd bent, kunt u uw beheerclient gebruiken voor API-aanroepen.

Voor elk van de volgende voorbeelden wijzen we onze Communication Services-resources toe aan een bestaande resourcegroep.

Als u een resourcegroep wilt maken, kunt u dit doen met behulp van Azure Portal of de Azure Resource Manager SDK.

Een Communication Services-resource maken en beheren

Ons exemplaar van de Communication Services Management SDK-client (Azure.ResourceManager.Communication.CommunicationManagementClient) kan worden gebruikt om bewerkingen uit te voeren op Communication Services-resources.

Een Communication Services-resource maken

Wanneer u een Communication Services-resource maakt, geeft u de naam van de resourcegroep en de naam van de resource op. Houd er rekening mee dat de eigenschap Location altijd global zal zijn, en dat tijdens de openbare preview de waarde DataLocationUnitedStates moet zijn.

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

Een Communication Services-resource bijwerken

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

Een lijst met alle Communication Services-resources maken

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

Een Communication Services-resource verwijderen

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

Sleutels en verbindingsreeksen beheren

Elke Communication Services-resource heeft een paar toegangssleutels en bijbehorende verbindingsreeksen. Deze sleutels kunnen worden geopend met de Management SDK en vervolgens worden gebruikt door andere Communication Services SDK's om zichzelf te verifiëren bij Azure Communication Services.

Toegangssleutels voor een Communication Services-resource ophalen

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

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

Een toegangssleutel voor een Communication Services-resource opnieuw genereren

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

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken
• De Azure Az PowerShell-module installeren

Als u van plan bent om telefoonnummers te gebruiken, kunt u het gratis proefaccount niet gebruiken. Controleer of uw abonnement voldoet aan alle vereisten als u van plan bent telefoonnummers aan te schaffen voordat u uw resource maakt.

Azure Communication Services-resource maken

Meld u aan bij Azure CLI om een Azure Communication Services-resource te maken. U kunt dit doen via de terminal met behulp van de Connect-AzAccount opdracht en uw referenties opgeven.

Zorg er eerst voor dat u de Azure Communication Services-module Az.Communication installeert met behulp van de volgende opdracht.

PS C:\> Install-Module Az.Communication

Voer de volgende opdracht uit om de resource te maken:

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

Als u een specifiek abonnement wilt selecteren, kunt u ook de --subscription vlag opgeven en de abonnements-id opgeven.

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

U kunt uw Communication Services-resource configureren met de volgende opties:

• De resourcegroep
• De naam van de Communication Services-resource
• De geografie waaraan de resource wordt gekoppeld

In de volgende stap kunt u tags toewijzen aan de resource. Tags kunnen worden gebruikt voor het organiseren van uw Azure-resources. Zie de documentatie van resource-tagging voor meer informatie over tags.

Een Communication Services-resource maken.

Voer de volgende opdrachten uit om tags toe te voegen aan uw Communication Services-resource. U kunt ook een specifiek abonnement instellen.

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

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

Gebruik de volgende opdracht om alle Azure Communication Services-resources in een bepaald abonnement weer te geven:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Als u alle informatie over een bepaalde resource wilt weergeven, gebruikt u de volgende opdracht:

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

Toegang tot uw verbindingsreeksen en service-eindpunten

Verbinding maken ion-tekenreeksen kunnen de Communication Services-SDK's verbinding maken en verifiëren bij Azure. U hebt toegang tot uw verbindingsreeksen voor Communication Services en service-eindpunten van de Azure Portal of programmatisch met Azure Resource Manager-API‘s

Nadat u naar uw Communication Services-resource hebt genaapt, selecteert u Sleutels in het navigatiemenu en kopieert u de Verbinding maken iontekenreeks of eindpuntwaarden voor gebruik door de Communication Services-SDK's. U hebt toegang tot primaire en secundaire sleutels. Dit kan handig zijn wanneer u tijdelijke toegang tot uw Communication Services-resources wilt bieden aan een externe of faseringsomgeving.

Toegang tot uw verbindingsreeks s en service-eindpunten met behulp van Azure CLI

U kunt ook toegang krijgen tot belangrijke informatie met behulp van Azure CLI, zoals uw resourcegroep of de sleutels voor een specifieke resource.

Installeer Azure CLI en gebruik de volgende opdracht om u aan te melden. U moet uw referenties opgeven om verbinding te maken met uw Azure-account.

az login

U hebt nu toegang tot belangrijke informatie over uw resources.

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

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

Als u een specifiek abonnement wilt selecteren, kunt u ook de --subscription vlag opgeven en de abonnements-id opgeven.

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

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

Uw verbindingsreeks bijwerken

Communication Services SDK's gebruiken verbindingsreeks s om aanvragen voor Communication Services te autoriseren. U hebt verschillende mogelijkheden om uw verbindingsreeks op te slaan:

• Een toepassing die wordt uitgevoerd op het bureaublad of op een apparaat kan de verbindingsreeks opslaan in een bestand app.config of web.config. Voeg de verbindingsreeks toe aan de sectie AppSettings in deze bestanden.
• Een toepassing die wordt uitgevoerd in een Azure App Service kan de verbindingsreeks opslaan in de App Service-toepassingsinstellingen. Voeg de verbindingsreeks toe aan de sectie Verbindingsreeksen van het tabblad Toepassingsinstellingen in de portal.
• U kunt uw verbindingsreeks opslaan in Azure Key Vault.
• Als u uw toepassing lokaal uitvoert, wilt u mogelijk uw verbindingsreeks opslaan in een omgevingsvariabele.

De verbindingsreeks naar een omgevingsvariabele schrijven

Als u een omgevingsvariabele wilt configureren, opent u een consolevenster en selecteert u het besturingssysteem op de onderstaande tabbladen. Vervang <yourconnectionstring> door de feitelijke verbindingsreeks.

Windows

Open een consolevenster en voer de volgende opdracht in:

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"

Nadat u de omgevingsvariabele hebt toegevoegd, moet u mogelijk alle actieve programma's die de omgevingsvariabele lezen opnieuw opstarten, inclusief het consolevenster. Als u Visual Studio bijvoorbeeld gebruikt als editor, start u Visual Studio opnieuw voordat u het voorbeeld uitvoert.

MacOS

Bewerk uw .zshrc en voeg de omgevingsvariabele toe:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Nadat u de omgevingsvariabele toevoegt, voert u source ~/.zshrc uit vanuit het consolevenster om de wijzigingen van kracht te laten worden. Als u de omgevingsvariabele hebt gemaakt met uw IDE open, moet u de editor, IDE of shell mogelijk sluiten en opnieuw openen om toegang te krijgen tot de variabele.

Linux

Bewerk uw .bash_profile en voeg de omgevingsvariabele toe:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Nadat u de omgevingsvariabele toevoegt, voert u source ~/.bash_profile uit vanuit het consolevenster om de wijzigingen van kracht te laten worden. Als u de omgevingsvariabele hebt gemaakt met uw IDE open, moet u de editor, IDE of shell mogelijk sluiten en opnieuw openen om toegang te krijgen tot de variabele.

Resources opschonen

Als u een Communication Services-abonnement wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. U kunt uw communicatieresource verwijderen door de volgende opdracht uit te voeren.

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

Als u de resourcegroep verwijdert, worden ook alle andere resources verwijderd die eraan zijn gekoppeld.

Als er telefoonnummers aan uw resource zijn toegewezen bij het verwijderen van resources, worden de telefoonnummers automatisch vrijgegeven uit uw resource.

Notitie

Het verwijderen van resources is permanent en er kunnen geen gegevens, waaronder event grid-filters, telefoonnummers of andere gegevens die aan uw resource zijn gekoppeld, worden hersteld als u de resource verwijdert.

Volgende stappen

In deze Snelstart hebt u de volgende zaken geleerd:

• Een Communication Services-resource maken
• Resourcegeografie en -tags configureren
• Toegang tot de sleutels voor die resource
• De resource verwijderen

Uw eerste gebruikers-toegangstokens maken