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 i interfejsu przy użyciu nowej 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
Należy pamiętać, że 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.
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 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 możesz przejrzeć konfigurację i utworzyć 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 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ę, az login uruchamiając polecenie z poziomu terminalu i podać 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 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 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:
- 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 z tego przewodnika Szybki start 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. 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. 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. 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. Aby uzyskać więcej informacji, zobacz tworzenie jednostki usługi i zarządzanie 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 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 uwierzytelnienie 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 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
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.
- Instalowanie modułu 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.
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. 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
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 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. 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 AppSettings 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 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.
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.
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 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