Создание ресурса служб коммуникации

Предварительные требования

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .

Если вы планируете использовать номера телефонов, вы не можете использовать бесплатную пробную учетную запись. Убедитесь, что ваша подписка соответствует всем требованиям, если вы планируете приобрести номера телефонов перед созданием ресурса.

Создание ресурса Служб коммуникации Azure с помощью портала Azure

Чтобы создать ресурс Служб коммуникации Azure, сначала войдите на портал Azure. Выберите + Создать ресурс в левом верхнем углу страницы.

Введите Коммуникация в поле Поиск в Маркетплейсе или в строке поиска в верхней части портала.

В результатах выберите Службы коммуникации, а затем нажмите Создать.

Теперь можно настроить ресурс Служб коммуникации. На первой странице процесса создания необходимо указать следующее:

• Подписка.
• Группа ресурсов (можно создать новую или выбрать существующую группу ресурсов).
• Имя ресурса служб коммуникации.
• География, связанная с ресурсом.

На следующем шаге можно назначить ресурсу теги. Теги можно использовать для упорядочивания ресурсов Azure. Дополнительные сведения о тегах см. в статье "Использование тегов для организации ресурсов Azure и иерархии управления".

Наконец, просмотрите конфигурацию и нажмите Создать, чтобы развернуть ресурс. Развертывание занимает несколько минут.

Управление ресурсом Служб коммуникации

Чтобы управлять ресурсом Служб коммуникации, войдите в портал Azure и найдите и выберите Службы коммуникации Azure.

На странице Службы коммуникации выберите имя ресурса.

На странице Обзор ресурса можно выполнять базовые задачи управления: просмотр, завершение работы, запуск, перезагрузку и удаление. Дополнительные параметры конфигурации см. в меню слева страницы ресурсов.

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Установите Azure CLI.

Если вы планируете использовать номера телефонов, вы не можете использовать бесплатную пробную учетную запись. Убедитесь, что ваша подписка соответствует всем требованиям, если вы планируете приобрести номера телефонов перед созданием ресурса.

Создание ресурса Служб коммуникации Azure с помощью Azure CLI

Чтобы создать ресурс Служб коммуникации Azure, войдите в Azure CLI. Вы можете войти в систему, выполнив команду az login из терминала и указав свои учетные данные.

Чтобы создать ресурс, выполните следующую команду:

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

Если вы хотите выбрать определенную подписку, вы также можете определить флаг --subscription и указать идентификатор подписки.

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

Теперь можно настроить ресурс Служб коммуникации с помощью следующих параметров:

• Группа ресурсов
• Имя ресурса Служб коммуникации
• География, связанная с ресурсом

На следующем шаге можно назначить ресурсу теги. Теги можно использовать для упорядочивания ресурсов Azure. Дополнительные сведения о тегах см. в статье "Использование тегов для организации ресурсов Azure и иерархии управления".

Управление ресурсом Служб коммуникации

Чтобы добавить теги в ресурс Служб коммуникации, выполните следующие команды: Вы также можете ориентироваться на конкретную подписку.

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

См. Azure Communication CLI для получения сведений о других командах.

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Последняя версия пакета SDK для .NET Core для вашей операционной системы.
• Получите последнюю версию пакета SDK для .NET Identity.
• Получите последнюю версию пакета SDK управления .NET.

Если вы планируете использовать номера телефонов, вы не можете использовать бесплатную пробную учетную запись. Убедитесь, что ваша подписка соответствует всем требованиям, если вы планируете приобрести номера телефонов перед созданием ресурса.

Установка пакета SDK

Во-первых, добавьте пакет SDK для управления Служб коммуникации в проект C#:

using Azure.ResourceManager.Communication;

Идентификатор подписки

Необходимо знать идентификатор подписки Azure. Получите идентификатор подписки на портале:

1. Войдите в учетную запись в портал Azure.
2. На левой боковой панели выберите "Подписки".
3. Выберите подписку, которую нужно использовать.
4. Щелкните Обзор.
5. Выберите идентификатор подписки.

Для работы примеров необходимо сохранить идентификатор подписки в переменной среды с именем AZURE_SUBSCRIPTION_ID.

Проверка подлинности

Для взаимодействия со Службами коммуникации Azure необходимо сначала пройти проверку подлинности в Azure. Эту проверку подлинности можно выполнить с помощью учетной записи службы.

Вариант 1. Управляемое удостоверение

Если код выполняется в качестве службы в Azure, самый простой способ пройти проверку подлинности — получить управляемое удостоверение Azure. Дополнительные сведения см. в разделе:

• Общие сведения об управляемых удостоверениях.

• Службы Azure, поддерживающие управляемые удостоверения.

• Использование управляемых удостоверений для службы приложений и функций Azure.

Управляемое удостоверение, назначаемое системой

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

Управляемое удостоверение, назначаемое пользователем

ClientId созданного управляемого удостоверения должен быть явно передан 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);

Вариант 2. Служебный принципал

Вместо использования управляемого удостоверения вы можете пройти проверку подлинности в Azure с помощью сервисного принципала, который вы управляете. Дополнительные сведения см. в статье Создание и управление ролью службы в Microsoft Entra ID.

После создания учетной записи службы необходимо собрать следующую информацию о ней из портала Azure:

• Идентификатор клиента
• Секрет клиента
• Идентификатор клиента

Сохраните эти значения в виде переменных среды с именем AZURE_CLIENT_ID, AZURE_CLIENT_SECRETи AZURE_TENANT_IDсоответственно. Затем вы можете создать клиент управления Служб коммуникации следующим образом.

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

Вариант 3. Удостоверение пользователя

Если вместо использования удостоверения службы вы хотите вызвать Azure от имени интерактивного пользователя, можно применить следующий код и создать клиент управления Служб коммуникации Azure. Откроется окно браузера для запроса пользователя на получение учетных данных MSA или 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());

Управление ресурсами служб коммуникации

Взаимодействие с ресурсами Azure

После проверки подлинности вы можете использовать клиент управления для вызова API.

Для каждого из следующих примеров мы назначаем ресурсы служб коммуникации существующей группе ресурсов.

Если вам нужно создать группу ресурсов, можно использовать портал Azure или пакет SDK Для Azure Resource Manager.

Создание ресурсов Служб коммуникации Azure и управление ими

Экземпляр клиента пакета SDK для управления службами коммуникации (Azure.ResourceManager.Communication.CommunicationManagementClient) можно использовать для выполнения операций с ресурсами служб коммуникации.

создать ресурс Служб коммуникации;

При создании ресурса Служб коммуникации укажите имя группы ресурсов и имя ресурса. Свойство Location всегда global, и во время общедоступного предварительного просмотра значение 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();

Обновление ресурса Служб коммуникации

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

Список всех ресурсов Служб коммуникации

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

Удаление ресурса Служб коммуникации

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

Управление ключами и строками подключения

Каждый ресурс Служб коммуникации имеет пару ключей доступа и соответствующие строки подключения. Эти ключи можно получить с помощью пакета SDK для управления, а затем предоставить им доступ к другим пакетам SDK служб коммуникации для проверки подлинности в Службы коммуникации Azure.

Получение ключей доступа для ресурса Служб коммуникации

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

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

Повторное создание ключа доступа для ресурса Служб коммуникации

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

Необходимые компоненты

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Установите модуль Azure Az PowerShell.

Если вы планируете использовать номера телефонов, вы не можете использовать бесплатную пробную учетную запись. Убедитесь, что ваша подписка соответствует всем требованиям, если вы планируете приобрести номера телефонов перед созданием ресурса.

Создание ресурса Служб коммуникации Azure с помощью PowerShell

Чтобы создать ресурс Служб коммуникации Azure, войдите в Azure CLI. Ресурс можно создать через терминал с помощью Connect-AzAccount команды и предоставить учетные данные.

Сначала установите модуль Az.Communication Службы коммуникации Azure с помощью следующей команды.

PS C:\> Install-Module Az.Communication

Чтобы создать ресурс, выполните следующую команду:

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

Если вы хотите выбрать конкретную подписку, можно также указать флаг --subscription и указать идентификатор подписки.

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

Теперь можно настроить ресурс Служб коммуникации с помощью следующих параметров:

• Группа ресурсов
• Имя ресурса Служб коммуникации
• География, связанная с ресурсом

На следующем шаге можно назначить ресурсу теги. Теги можно использовать для упорядочивания ресурсов Azure. Дополнительные сведения см. в статье Использование тегов для упорядочивания ресурсов Azure и создания иерархии управления.

Управление ресурсом Служб коммуникации

Чтобы добавить теги в ресурс Служб коммуникации, выполните следующие команды: Вы также можете нацелить на определённую подписку.

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

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

Чтобы перечислить все ресурсы Azure Communication Services для заданной подписки, используйте следующую команду:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Чтобы получить список всех сведений об определенном ресурсе, используйте следующую команду:

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