Tworzenie zasobu usług komunikacyjnych
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 przy użyciu usługi wdrażania i zarządzania: Azure Resource Manager. Wszystkie funkcje dostępne w zestawach SDK są dostępne w witrynie Azure Portal.
Ostrzeżenie
Nie można jednocześnie utworzyć grupy zasobów jako zasobu dla usług Azure Communication Services. Przed utworzeniem zasobu należy najpierw utworzyć grupę zasobów.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
Jeśli planujesz używać 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.
Tworzenie zasobu usług Azure Communication Services przy użyciu witryny Azure Portal
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ź Komunikacja w pole Wyszukaj w Marketplace lub użyj paska wyszukiwania na górze 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 należy określić:
- Subskrypcja.
- Grupa zasobów (można utworzyć nową lub wybrać istniejącą grupę zasobów).
- Nazwa zasobu usług komunikacyjnych.
- Lokalizacja geograficzna skojarzona z zasobem.
W następnym kroku można przypisać tagi do zasobu. Tagi umożliwiają organizowanie zasobów platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagów.
Na koniec przejrzyj konfigurację i kliknij przycisk Utwórz , aby wdrożyć zasób. Wdrożenie trwa kilka minut.
Zarządzanie zasobem usług Komunikacyjnych
Aby zarządzać zasobem usług Communication Services, zaloguj się 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. Aby uzyskać więcej opcji konfiguracji, zobacz menu po lewej stronie strony zasobów.
Wymagania wstępne
- Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
- Zainstaluj Azure CLI.
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.
Tworzenie zasobu usług Azure Communication Services przy użyciu interfejsu wiersza polecenia platformy Azure
Aby utworzyć zasób usług Azure Communication Services, zaloguj się do interfejsu wiersza polecenia platformy Azure. Możesz zalogować się, uruchamiając polecenie az login w terminalu i podając swoje poświadczenia.
Aby utworzyć zasób, uruchom następujące polecenie:
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 skojarzona z zasobem
W następnym kroku można przypisać tagi do zasobu. Tagi umożliwiają organizowanie zasobów platformy Azure. Aby uzyskać więcej informacji na temat tagów, zobacz Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagó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.
Jeśli planujesz używać 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.
Instalacja 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. Pobierz identyfikator subskrypcji z portalu:
- Zaloguj się do swojego konta w witrynie Azure Portal.
- Na lewym pasku bocznym wybierz pozycję Subskrypcje.
- Wybierz subskrypcję, której chcesz użyć.
- Kliknij pozycję Przegląd.
- Wybierz swój identyfikator subskrypcji.
Aby przykłady działały, musisz przechowywać identyfikator subskrypcji 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. Można to uwierzytelnić przy użyciu tożsamości usługi głównej.
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. Aby uzyskać więcej informacji, zobacz:
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: Podmiot usługi
Zamiast używać tożsamości zarządzanej, możesz uwierzytelnić się na platformie Azure przy użyciu zarządzanej jednostki usługi. Aby uzyskać więcej informacji, zobacz tworzenie jednostki usługi i zarządzanie nią w usłudze Microsoft Entra ID.
Po utworzeniu głównego obiektu usługi należy zdobyć następujące informacje o nim z portalu Azure.
- Client ID
- Client Secret (Wpis tajny klienta)
- Identyfikator najemcy
Zapisz te wartości jako zmienne środowiskowe o nazwach 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 uwierzytelnieniu możesz użyć klienta zarządzania do tworzenia wywołań interfejsu API.
Dla każdego z poniższych przykładów przypisujemy nasze zasoby usług komunikacyjnych do istniejącej grupy zasobów.
Jeśli musisz utworzyć grupę zasobów, możesz użyć witryny Azure Portal lub zestawu SDK usługi Azure Resource Manager.
Tworzenie zasobu usług komunikacyjnych i zarządzanie nim
Możesz użyć wystąpienia klienta zestawu SDK zarządzania usługami komunikacyjnymi (Azure.ResourceManager.Communication.CommunicationManagementClient) do wykonywania operacji na zasobach usług Komunikacyjnych.
Tworzenie zasobu usług Communication Services
Podczas tworzenia zasobu usług komunikacyjnych określ nazwę grupy zasobów i nazwę zasobu. Właściwość Location jest zawsze global, 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ć przy użyciu zestawu SDK zarządzania, a następnie udostępnić je innym zestawom SDK usług komunikacyjnych w celu uwierzytelnienia 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.
- Zainstaluj moduł Azure Az programu PowerShell.
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.
Tworzenie zasobu usług Azure Communication Services przy użyciu programu PowerShell
Aby utworzyć zasób usług Azure Communication Services, zaloguj się do interfejsu wiersza polecenia platformy Azure. Za pomocą terminalu możesz utworzyć zasób przy użyciu Connect-AzAccount polecenia i podaniu poświadczeń.
Najpierw zainstaluj moduł Az.Communication Azure Communication Services przy użyciu następującego polecenia.
PS C:\> Install-Module Az.Communication
Aby utworzyć zasób, uruchom następujące polecenie:
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 do skojarzenia z zasobem
W następnym kroku można przypisać tagi do zasobu. Tagi umożliwiają organizowanie zasobów platformy Azure. Aby uzyskać więcej informacji, zobacz Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagó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 dla 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
Parametry połączenia 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 Communication Services wybierz pozycję Klucze z menu nawigacji i skopiuj wartości Parametry połączenia lub Punkt końcowy do użycia przez zestawy SDK usług Komunikacyjnych. Masz dostęp do kluczy podstawowych i pomocniczych. Te klucze są przydatne, gdy chcesz zapewnić tymczasowy dostęp do zasobów usług komunikacyjnych w środowisku przejściowym lub innej firmy.
Uzyskaj dostęp do Twoich parametrów połączenia i punktów końcowych usługi za pomocą Azure CLI.
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 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>"
Przechowaj ciąg 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 AppSettings w tych plikach.
- Aplikacja działająca w usłudze Azure App Service może przechowywać ciąg połączenia w ustawieniach aplikacji w usłudze App Service. Dodaj parametry połączenia do sekcji Parametry połączenia na karcie Ustawienia aplikacji w portalu.
- Możesz przechowywać parametry połączenia w usłudze Azure Key Vault. Możesz dodatkowo bezpiecznie zarządzać parametry połączenia.
- Jeśli używasz aplikacji lokalnie, możesz przechowywać parametry połączenia w zmiennej środowiskowej.
Przechowaj ciąg znaków połączenia w zmiennej środowiskowej
Aby skonfigurować zmienną środowiskową, otwórz okno konsoli i wybierz system operacyjny z poniższych kart. Zastąp <yourconnectionstring> rzeczywistym ciągiem połączenia.
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.
Czyszczenie zasobów
Jeśli chcesz wyczyścić i usunąć subskrypcję usług Komunikacyjnych, możesz usunąć zasób lub grupę zasobów. Aby usunąć zasób komunikacji, uruchom 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. Jeśli usuniesz zasób, nie można odzyskać usuniętych 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 artykule opisano, jak:
- Utwórz zasób usług Communication Services
- Konfigurowanie lokalizacji geograficznej zasobów i tagów
- Uzyskiwanie dostępu do kluczy dla tego zasobu
- Usuwanie zasobu