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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы создать ресурс Служб коммуникации 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.

После создания субъекта-службы необходимо собрать следующие сведения об этом из портал 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

Чтобы создать ресурс Служб коммуникации 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 ресурсов для данной подписки, используйте следующую команду:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

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

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