Шаг 3. Настройка для миграции на REST API версии 3 или клиентский пакет SDK

Статья
06/30/2023

этапы миграции 2

Важно!

Переход со Службы мультимедиа Azure версии 2 на версию 3 больше не требуется, так как прекращение поддержки API версии 2 будет соответствовать прекращению использования Служб мультимедиа Azure. Дополнительные сведения см. в руководстве по прекращению использования Служб мультимедиа Azure .

Ниже описаны действия, которые необходимо выполнить, чтобы настроить окружение для использования API-интерфейса Службы мультимедиа версии 3.

Модель пакета SDK

API версии 2 содержало два разных клиентских пакета SDK: один для API управления, который позволял программно создавать учетные записи, и один для управления ресурсами.

Ранее для настройки своей учетной записи AMS разработчики работали с идентификатором клиента субъекта-службы Azure и секретом клиента, а также с определенной конечной точкой REST API версии 2.

API версии 3 создан на основе Azure Resource Management (ARM). Он использует для подключения к API идентификаторы и ключи субъекта-службы Azure Active Directory (Azure AD). Поэтому, чтобы подключиться к API, разработчикам понадобится создать субъекты-службы или управляемые удостоверения. API версии 3 использует стандартные конечные точки ARM, а также аналогичные и последовательные модели для всех остальных служб Azure.

Клиенты, которые ранее для управления учетными записями в версии 2 использовали API управления ARM версии 2015-10-01, должны теперь использовать API управления ARM версии 2020-05-01 (или более позднюю), поскольку она поддерживает доступ к API версии 3.

Создание учетной записи Служб мультимедиа для тестирования

Найдите на портале идентификаторы клиента и подписки и создайте учетную запись Служб мультимедиа. Затем выберите проверку подлинности для доступа к API и проверку подлинности субъекта-службы, чтобы создать идентификатор и секреты приложения Azure Active Directory для этой тестовой учетной записи.

Создание учетной записи Служб мультимедиа. Получение учетных данных для доступа к API Служб мультимедиа.

Скачайте клиентский пакет SDK и настройте окружение

Пакеты SDK доступны для .NET, .NET Core, Node.js, Python, Java и Go.
Интеграция Azure CLI для простых скриптов поддержки.

Примечание

Пакет SDK для PHP сообщества больше не доступен для Служб мультимедиа Azure версии 3. Если вы используете PHP для версии 2, выполните миграцию на REST API непосредственно в коде.

Спецификации OpenAPI

Версия 3 создана на основе унифицированной области API, что позволяет использовать функции управления и операции, встроенные в Azure Resource Manager. Шаблоны Azure Resource Manager можно использовать для создания и развертывания преобразований, конечных точек потоковой передачи, событий потоковой трансляции и т. д.
В документе по спецификации OpenAPI (прежнее название — Swagger) содержится объяснение схемы всех компонентов службы.
Все клиентские пакеты SDK являются производными и создаются на основе спецификации OpenAPI, опубликованной на GitHub. На момент публикации этой статьи последние спецификации OpenAPI хранятся в открытом доступе на GitHub. Версия 2020-05-01 является последним стабильным выпуском.

Ознакомьтесь со страницами справки по REST API.

Следует использовать версию 2020-05-01 или более позднюю.

Дополнительные сведения о настройке окружения см. в статье Подключение к API Служб мультимедиа версии 3 — .NET.

Если вы просто хотите установить последнюю версию пакета SDK с помощью PackageManager, выполните следующую команду:

Install-Package Microsoft.Azure.Management.Media

Чтобы установить последнюю версию пакета SDK с помощью интерфейса командной строки .NET, выполните следующую команду:

dotnet add package Microsoft.Azure.Management.Media

Кроме того, вы можете ознакомиться с полными примерами .NET для различных сценариев в разделе Azure-Samples/media-services-v3-dotnet. Проекты в этом репозитории содержат сведения о том, как реализовать различные сценарии Служб мультимедиа Azure с помощью версии 3.

Начало работы с настройкой кода

Найдите в базе кода экземпляры использования CloudMediaContext, чтобы начать процесс обновления до API версии 3.

В следующем коде показано, как ранее осуществлялся доступ к API версии 2 с помощью пакета SDK для .NET версии 2. Разработчики обычно начинали работу с создания CloudMediaContext, а также экземпляра с объектом AzureAdTokenCredentials.


class Program
	{
	    // Read values from the App.config file.
        private static readonly string _AADTenantDomain =
            ConfigurationManager.AppSettings["AMSAADTenantDomain"];
        private static readonly string _RESTAPIEndpoint =
            ConfigurationManager.AppSettings["AMSRESTAPIEndpoint"];
        private static readonly string _AMSClientId =
            ConfigurationManager.AppSettings["AMSClientId"];
        private static readonly string _AMSClientSecret =
            ConfigurationManager.AppSettings["AMSClientSecret"];

	    private static CloudMediaContext _context = null;

	    static void Main(string[] args)
	    {
        try
        {
            AzureAdTokenCredentials tokenCredentials =
                new AzureAdTokenCredentials(_AADTenantDomain,
                    new AzureAdClientSymmetricKey(_AMSClientId, _AMSClientSecret),
                    AzureEnvironments.AzureCloudEnvironment);

            var tokenProvider = new AzureAdTokenProvider(tokenCredentials);

            _context = new CloudMediaContext(new Uri(_RESTAPIEndpoint), tokenProvider);

Справка и поддержка

Вы можете обратиться к Службам мультимедиа с вопросами или следить за нашими обновлениями одним из следующих способов:

ВОПРОСЫ И ОТВЕТЫ
Stack Overflow. Пометьте вопросы тегом azure-media-services.
@MSFTAzureMedia или используйте @AzureSupport , чтобы запросить поддержку.
Отправьте запрос в службу поддержки через портал Azure.

Поделиться через