Szybki start: tworzenie zasobów usług komunikacyjnych i zarządzanie nimi

Rozpocznij pracę z usługami Azure Communication Services, aprowizuj swój pierwszy zasób usług komunikacyjnych. Zasoby usług Communication Services można aprowizować za pośrednictwem witryny Azure Portal lub zestawu SDK zarządzania platformy .NET. Zestaw SDK zarządzania i witryna Azure Portal umożliwiają tworzenie, konfigurowanie, aktualizowanie i usuwanie zasobów oraz interfejsu za pomocą usługi Azure Resource Manager, usługi wdrażania i zarządzania platformy Azure. Wszystkie funkcje dostępne w zestawach SDK są dostępne w witrynie Azure Portal.

Ostrzeżenie

Należy pamiętać, że nie można jednocześnie utworzyć grupy zasobów jako zasobu dla usług Azure Communication Services. Podczas tworzenia zasobu należy użyć grupy zasobów, która została już utworzona.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.

Pamiętaj, że jeśli planujesz korzystanie z numerów telefonów, nie możesz użyć bezpłatnego konta wersji próbnej. Sprawdź, czy subskrypcja spełnia wszystkie wymagania, jeśli planujesz kupić numery telefonów przed utworzeniem zasobu.

Utwórz zasób usług Azure Communication Services

Aby utworzyć zasób usług Azure Communication Services, najpierw zaloguj się do witryny Azure Portal. W lewym górnym rogu strony wybierz pozycję + Utwórz zasób.

Wprowadź ciąg Communication (Komunikacja ) w polu Wyszukaj dane wejściowe witryny Marketplace lub na pasku wyszukiwania w górnej części portalu.

Wybierz pozycję Usługi komunikacyjne w wynikach, a następnie wybierz pozycję Utwórz.

Teraz możesz skonfigurować zasób usług Communication Services. Na pierwszej stronie procesu tworzenia zostanie wyświetlony monit o określenie:

• Subskrypcja
• Grupa zasobów (można utworzyć nową lub wybrać istniejącą grupę zasobów)
• Nazwa zasobu usług komunikacyjnych
• Lokalizacja geograficzna zasobu zostanie skojarzona z

W następnym kroku można przypisać tagi do zasobu. Tagi mogą służyć do organizowania zasobów platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz dokumentację tagowania zasobów.

Na koniec możesz przejrzeć konfigurację i utworzyć zasób. Należy pamiętać, że ukończenie wdrożenia potrwa kilka minut.

Zarządzanie zasobem usług Komunikacyjnych

Aby zarządzać zasobem usług Communication Services, przejdź do witryny Azure Portal i wyszukaj i wybierz pozycję Azure Communication Services.

Na stronie Usługi komunikacyjne wybierz nazwę zasobu.

Strona Przegląd zasobu zawiera opcje podstawowego zarządzania, takie jak przeglądanie, zatrzymywanie, uruchamianie, ponowne uruchamianie i usuwanie. Więcej opcji konfiguracji można znaleźć w menu po lewej stronie zasobu.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Instalowanie interfejsu wiersza polecenia platformy Azure

Jeśli planujesz korzystanie z numerów telefonów, nie możesz użyć bezpłatnego konta wersji próbnej. Sprawdź, czy subskrypcja spełnia wszystkie wymagania, jeśli planujesz kupić numery telefonów przed utworzeniem zasobu.

Utwórz zasób usług Azure Communication Services

Aby utworzyć zasób usług Azure Communication Services, zaloguj się do interfejsu wiersza polecenia platformy Azure. Możesz zalogować się, uruchamiając polecenie z poziomu terminalu az login i podając swoje poświadczenia. Uruchom następujące polecenie, aby utworzyć zasób:

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

Jeśli chcesz wybrać określoną subskrypcję, możesz również określić flagę --subscription i podać identyfikator subskrypcji.

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

Zasób usług Communication Services można skonfigurować przy użyciu następujących opcji:

• Grupa zasobów
• Nazwa zasobu usług komunikacyjnych
• Lokalizacja geograficzna zasobu zostanie skojarzona z

W następnym kroku można przypisać tagi do zasobu. Tagi mogą służyć do organizowania zasobów platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz dokumentację tagowania zasobów.

Zarządzanie zasobem usług Komunikacyjnych

Aby dodać tagi do zasobu usług Communication Services, uruchom następujące polecenia. Możesz również wybrać konkretną subskrypcję.

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

Aby uzyskać informacje na temat innych poleceń, zobacz Interfejs wiersza polecenia usługi Azure Communication.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Najnowsza wersja zestawu .NET Core SDK dla systemu operacyjnego.
• Pobierz najnowszą wersję zestawu .NET Identity SDK.
• Pobierz najnowszą wersję zestawu .NET Management SDK.

Pamiętaj, że jeśli planujesz korzystanie z numerów telefonów, nie możesz użyć bezpłatnego konta wersji próbnej. Sprawdź, czy subskrypcja spełnia wszystkie wymagania, jeśli planujesz kupić numery telefonów przed utworzeniem zasobu.

Instalowanie zestawu SDK

Najpierw uwzględnij zestaw SDK zarządzania usługami komunikacyjnymi w projekcie języka C#:

using Azure.ResourceManager.Communication;

Identyfikator subskrypcji

Musisz znać identyfikator subskrypcji platformy Azure. Można to uzyskać w portalu:

1. Zaloguj się do konta platformy Azure
2. Wybierz pozycję Subskrypcje na pasku bocznym po lewej stronie
3. Wybierz dowolną wymaganą subskrypcję
4. Kliknij pozycję Przegląd
5. Wybierz identyfikator subskrypcji

W tym przewodniku Szybki start założono, że identyfikator subskrypcji został zapisany w zmiennej środowiskowej o nazwie AZURE_SUBSCRIPTION_ID.

Uwierzytelnianie

Aby komunikować się z usługami Azure Communication Services, musisz najpierw uwierzytelnić się na platformie Azure. Zazwyczaj można to zrobić przy użyciu tożsamości jednostki usługi.

Opcja 1. Tożsamość zarządzana

Jeśli kod działa jako usługa na platformie Azure, najprostszym sposobem uwierzytelniania jest uzyskanie tożsamości zarządzanej z platformy Azure. Dowiedz się więcej o tożsamościach zarządzanych.

Usługi platformy Azure obsługujące tożsamości zarządzane

Jak używać tożsamości zarządzanych dla usług App Service i Azure Functions

Tożsamość zarządzana przypisana przez system

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

Tożsamość zarządzana przypisana przez użytkownika

ClientId utworzonej tożsamości zarządzanej musi zostać przekazana ManagedIdentityCredential jawnie.

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

Opcja 2. Jednostka usługi

Zamiast korzystać z tożsamości zarządzanej, możesz chcieć uwierzytelnić się na platformie Azure przy użyciu jednostki usługi, którą zarządzasz samodzielnie. Dowiedz się więcej, korzystając z dokumentacji dotyczącej tworzenia jednostki usługi i zarządzania nią w usłudze Microsoft Entra ID.

Po utworzeniu jednostki usługi należy zebrać następujące informacje z witryny Azure Portal:

• Client ID
• Client Secret (Wpis tajny klienta)
• Identyfikator dzierżawy

Zapisz te wartości w zmiennych środowiskowych o nazwie AZURE_CLIENT_ID, AZURE_CLIENT_SECRETi AZURE_TENANT_ID odpowiednio. Następnie możesz utworzyć klienta zarządzania usługami komunikacyjnymi w następujący sposób:

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

Opcja 3. Tożsamość użytkownika

Jeśli chcesz wywołać platformę Azure w imieniu użytkownika interaktywnego, zamiast używać tożsamości usługi, możesz użyć następującego kodu, aby utworzyć klienta zarządzania usługami Azure Communication Services. Spowoduje to otwarcie okna przeglądarki w celu wyświetlenia monitu użytkownika o podanie poświadczeń MSA lub 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());

Zarządzanie zasobami usług komunikacyjnych

Interakcja z zasobami platformy Azure

Po uwierzytelnienie możesz użyć klienta zarządzania do tworzenia wywołań interfejsu API.

Dla każdego z poniższych przykładów przypiszemy zasoby usług Komunikacyjnych do istniejącej grupy zasobów.

Jeśli musisz utworzyć grupę zasobów, możesz to zrobić przy użyciu witryny Azure Portal lub zestawu SDK usługi Azure Resource Manager.

Tworzenie zasobu usług komunikacyjnych i zarządzanie nim

Nasze wystąpienie klienta zestawu SDK zarządzania usługami komunikacyjnymi (Azure.ResourceManager.Communication.CommunicationManagementClient) może służyć do wykonywania operacji na zasobach usług komunikacyjnych.

Tworzenie zasobu usług Communication Services

Podczas tworzenia zasobu usług Communication Services określisz nazwę grupy zasobów i nazwę zasobu. Należy pamiętać, że Location właściwość zawsze będzie mieć globalwartość , a w publicznej wersji zapoznawczej DataLocation wartość musi mieć wartość 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();

Aktualizowanie zasobu usług komunikacyjnych

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

Wyświetlanie listy wszystkich zasobów usług komunikacyjnych

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

Usuwanie zasobu usług komunikacyjnych

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

Zarządzanie kluczami i parametry połączenia

Każdy zasób usług komunikacyjnych ma parę kluczy dostępu i odpowiednie parametry połączenia. Dostęp do tych kluczy można uzyskać za pomocą zestawu SDK zarządzania, a następnie używany przez inne zestawy SDK usług komunikacyjnych do uwierzytelniania się w usługach Azure Communication Services.

Uzyskiwanie kluczy dostępu dla zasobu usług komunikacyjnych

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

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

Ponowne generowanie klucza dostępu dla zasobu usług komunikacyjnych

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

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Instalowanie modułu Azure Az programu PowerShell

Pamiętaj, że jeśli planujesz korzystanie z numerów telefonów, nie możesz użyć bezpłatnego konta wersji próbnej. Sprawdź, czy subskrypcja spełnia wszystkie wymagania, jeśli planujesz kupić numery telefonów przed utworzeniem zasobu.

Utwórz zasób usług Azure Communication Services

Aby utworzyć zasób usług Azure Communication Services, zaloguj się do interfejsu wiersza polecenia platformy Azure. Możesz to zrobić za pośrednictwem terminalu Connect-AzAccount przy użyciu polecenia i podania poświadczeń.

Najpierw upewnij się, że moduł Azure Communication Services Az.Communication został zainstalowany przy użyciu następującego polecenia.

PS C:\> Install-Module Az.Communication

Uruchom następujące polecenie, aby utworzyć zasób:

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

Jeśli chcesz wybrać określoną subskrypcję, możesz również określić flagę --subscription i podać identyfikator subskrypcji.

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

Zasób usług Communication Services można skonfigurować przy użyciu następujących opcji:

• Grupa zasobów
• Nazwa zasobu usług komunikacyjnych
• Lokalizacja geograficzna zasobu zostanie skojarzona z

W następnym kroku można przypisać tagi do zasobu. Tagi mogą służyć do organizowania zasobów platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz dokumentację tagowania zasobów.

Zarządzanie zasobem usług Komunikacyjnych

Aby dodać tagi do zasobu usług Communication Services, uruchom następujące polecenia. Możesz również wybrać konkretną subskrypcję.

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

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

Aby wyświetlić listę wszystkich zasobów usług Azure Communication Services w danej subskrypcji, użyj następującego polecenia:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Aby wyświetlić listę wszystkich informacji dotyczących danego zasobu, użyj następującego polecenia:

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

Uzyskiwanie dostępu do parametry połączenia i punktów końcowych usługi

Połączenie ciągi jonowe umożliwiają zestawom SDK usług komunikacyjnych łączenie się i uwierzytelnianie z platformą Azure. Dostęp do usług Communication Services parametry połączenia i punktów końcowych usługi można uzyskać z poziomu witryny Azure Portal lub programowo za pomocą interfejsów API usługi Azure Resource Manager.

Po przejściu do zasobu usług Komunikacyjnych wybierz pozycję Klucze z menu nawigacji i skopiuj ciąg Połączenie ion lub wartości punktu końcowego do użycia przez zestawy SDK usług komunikacyjnych. Masz dostęp do kluczy podstawowych i pomocniczych. Może to być przydatne, gdy chcesz zapewnić tymczasowy dostęp do zasobów usług komunikacyjnych w środowisku innej firmy lub środowisku przejściowym.

Uzyskiwanie dostępu do parametry połączenia i punktów końcowych usługi przy użyciu interfejsu wiersza polecenia platformy Azure

Możesz również uzyskać dostęp do kluczowych informacji przy użyciu interfejsu wiersza polecenia platformy Azure, takiego jak grupa zasobów lub klucze dla określonego zasobu.

Zainstaluj interfejs wiersza polecenia platformy Azure i użyj następującego polecenia, aby się zalogować. Musisz podać poświadczenia, aby nawiązać połączenie z kontem platformy Azure.

az login

Teraz możesz uzyskać dostęp do ważnych informacji o zasobach.

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

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

Jeśli chcesz wybrać określoną subskrypcję, możesz również określić flagę --subscription i podać identyfikator subskrypcji.

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

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

Przechowywanie parametry połączenia

Zestawy SDK usług Komunikacyjnych używają parametry połączenia do autoryzowania żądań wysyłanych do usług Komunikacyjnych. Istnieje kilka opcji przechowywania parametry połączenia:

• Aplikacja działająca na pulpicie lub na urządzeniu może przechowywać parametry połączenia w pliku app.config lub web.config. Dodaj parametry połączenia do sekcji App Ustawienia w tych plikach.
• Aplikacja działająca w usłudze aplikacja systemu Azure może przechowywać parametry połączenia w ustawieniach aplikacji usługi App Service. Dodaj parametry połączenia do sekcji Ciągi Połączenie ion na karcie Application Ustawienia w portalu.
• Możesz przechowywać parametry połączenia w usłudze Azure Key Vault.
• Jeśli używasz aplikacji lokalnie, możesz przechowywać parametry połączenia w zmiennej środowiskowej.

Przechowywanie parametry połączenia w zmiennej środowiskowej

Aby skonfigurować zmienną środowiskową, otwórz okno konsoli i wybierz system operacyjny z poniższych kart. Zastąp <yourconnectionstring> element rzeczywistym parametry połączenia.

Windows

Otwórz okno konsoli i wprowadź następujące polecenie:

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"

Po dodaniu zmiennej środowiskowej może być konieczne ponowne uruchomienie wszystkich uruchomionych programów, które odczytują zmienną środowiskową, w tym okno konsoli. Jeśli na przykład używasz programu Visual Studio jako edytora, uruchom ponownie program Visual Studio przed uruchomieniem przykładu.

macOS

.zshrcEdytuj zmienną środowiskową i dodaj zmienną środowiskową:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Po dodaniu zmiennej środowiskowej uruchom polecenie source ~/.zshrc z okna konsoli, aby zmiany zostały uwzględnione. Jeśli zmienna środowiskowa została utworzona przy otwartym środowisku IDE, może być konieczne zamknięcie i ponowne otwarcie edytora, środowiska IDE lub powłoki w celu uzyskania dostępu do zmiennej.

Linux

.bash_profileEdytuj zmienną środowiskową i dodaj zmienną środowiskową:

export COMMUNICATION_SERVICES_CONNECTION_STRING="<yourConnectionString>"

Po dodaniu zmiennej środowiskowej uruchom polecenie source ~/.bash_profile z okna konsoli, aby zmiany zostały uwzględnione. Jeśli zmienna środowiskowa została utworzona przy otwartym środowisku IDE, może być konieczne zamknięcie i ponowne otwarcie edytora, środowiska IDE lub powłoki w celu uzyskania dostępu do zmiennej.

Czyszczenie zasobów

Jeśli chcesz wyczyścić i usunąć subskrypcję usług Komunikacyjnych, możesz usunąć zasób lub grupę zasobów. Zasób komunikacji można usunąć, uruchamiając następujące polecenie.

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

Usunięcie grupy zasobów powoduje również usunięcie wszelkich innych skojarzonych z nią zasobów.

Jeśli po usunięciu zasobu masz jakiekolwiek numery telefonów przypisane do zasobu, numery telefonów są automatycznie zwalniane z zasobu w tym samym czasie.

Uwaga

Usuwanie zasobów jest trwałe i nie można odzyskać żadnych danych, w tym filtrów usługi Event Grid, numerów telefonów lub innych danych powiązanych z zasobem.

Następne kroki

W tym przewodniku Szybki start pokazano, jak wykonać następujące działania:

• Tworzenie zasobu usług Communication Services
• Konfigurowanie lokalizacji geograficznej zasobów i tagów
• Uzyskiwanie dostępu do kluczy dla tego zasobu
• Usuwanie zasobu

Tworzenie pierwszych tokenów dostępu użytkownika