Общие сведения об API-интерфейсах и средствах пакетной службы

  • Статья

Обычно обработка параллельных рабочих нагрузок, использующих пакетную службу Azure, выполняется программным способом с помощью API-интерфейсов пакетной службы. Ваше клиентское приложение или служба могут использовать API-интерфейсы пакетной службы для взаимодействия с пакетной службой. С помощью API-интерфейсов пакетной службы можно создавать пулы вычислительных узлов виртуальные машины или облачные службы, а также управлять этими ресурсами. Вы можете запланировать выполнение заданий и задач на этих узлах.

Вы можете эффективно обрабатывать крупномасштабные рабочие нагрузки в своей организации или предоставлять внешние интерфейсы служб клиентам, чтобы они могли выполнять задания и задачи (по требованию или по расписанию) на одном, сотнях или тысячах узлов. Кроме того, пакетную службу Azure можно использовать как часть более крупного рабочего процесса под управлением таких средств, как фабрика данных Azure.

Совет

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

Учетные записи Azure для разработки с помощью пакетной службы

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

  • Учетная запись пакетной службы — это ресурсы пакетной службы Azure, в том числе пулы, вычислительные узлы, задания и задачи, связанные с учетной записью пакетной службы Azure. Когда приложение отправляет запрос к пакетной службе, выполняется проверка подлинности запроса с использованием имени учетной записи пакетной службы Azure, URL-адреса учетной записи и ключа доступа или маркера Microsoft Entra. Вы можете создать учетную запись пакетной службы на портале Azure или программным способом.
  • Учетная запись хранения. В пакетную службу встроена поддержка работы с файлами в службе хранилища Azure. При работе с пакетной службой хранилище BLOB-объектов Azure используется преимущественно не только для промежуточного хранения файлов программ и данных (запускаются и обрабатываются задачами соответственно), но и для хранения выходных данных (результаты выполнения задач). Каждая учетная запись пакетной службы обычно связана с соответствующей учетной записью хранения.

Интерфейсы API уровня обслуживания и управления

Пакетная служба Azure имеет два набора API: один для уровня обслуживания и один для уровня управления. Их названия часто похожи, но они возвращают разные результаты.

В журнале действий будут записываться только действия из API управления. API уровня обслуживания обходят уровень управления ресурсами Azure (management.azure.com) и не регистрируются в журнале.

Например, API уровня обслуживания для удаления пула работает непосредственно с учетной записью пакетной службы: DELETE {batchUrl}/pools/{poolId}

В отличие от вышеуказанного программного интерфейса, API управления пакетной службы для удаления пула работает со слоем management.azure.com: DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}

API-интерфейсы пакетной службы

Приложения и службы могут напрямую вызывать REST API или использовать следующие клиентские библиотеки для выполнения рабочих нагрузок пакетной службы Azure и управления ими.

API Справочник по API Загрузка Учебник Примеры кода Дополнительная информация
Пакетная служба (REST) Azure REST API — документация Неприменимо - - Поддерживаемые версии
Пакетная служба (.NET) Пакет Azure SDK для .NET — документация NuGet Руководство GitHub Заметки о выпуске
Пакетная служба Python Пакет Azure SDK для Python — документация PyPI Руководство GitHub Файл сведений
JavaScript пакетной службы Пакет Azure SDK для JavaScript — документация npm Руководство - Файл сведений
Java для пакетной службы Пакет Azure SDK для Java — документация Maven - GitHub Файл сведений

API-интерфейсы для управления пакетной службой

API-интерфейсы Azure Resource Manager для пакетной службы предоставляют программный доступ к учетным записям пакетной службы. Применяя эти API, можно программно управлять учетными записями пакетной службы, квотами, пакетами приложений и другими ресурсами через поставщик Microsoft.Batch.

API Справочник по API Загрузка Учебник Примеры кода
REST для управления пакетной службой Azure REST API — документация - - GitHub
Библиотека .NET для управления пакетной службой Пакет Azure SDK для .NET — документация NuGet Руководство GitHub
Python для управления пакетной службой Пакет Azure SDK для Python — документация PyPI - -
JavaScript для управления пакетной службой Пакет Azure SDK для JavaScript — документация npm - -
Java для управления пакетной службой Пакет Azure SDK для Java — документация Maven - -

Программы командной строки пакетной службы

Эти программы командной строки обеспечивают ту же функциональность, что и API-интерфейсы пакетной службы и службы управления пакетной службой.

Другие средства для разработки приложений

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

  • Портал Azure. На портале Azure можно создавать, отслеживать и удалять пулы, задания и задачи пакетной службы. Во время выполнения заданий можно просмотреть сведения о состоянии этих и других ресурсов, а также скачать файлы из вычислительных узлов в пулах. Например, при устранении неполадок можно скачать файл stderr.txt задачи, завершившейся сбоем. Кроме того, можно скачать файлы удаленного рабочего стола, которые можно использовать для входа на вычислительные узлы.
  • Azure Batch Explorer — это бесплатный автономный клиентский инструмент с множеством функций для создания, отладки и мониторинга приложений пакетной службы Azure. Скачайте пакет установки для Mac, Linux или Windows.
  • Обозреватель службы хранилища Azure. Строго говоря, этот обозреватель не является средством пакетной службы Azure, но это полезный инструмент для разработки и отладки соответствующих пакетных решений.

Дополнительные ресурсы

Следующие шаги