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

Обычно обработка параллельных рабочих нагрузок, использующих пакетную службу Azure, выполняется программным способом с помощью API-интерфейсов пакетной службы.Processing parallel workloads with Azure Batch is typically done programmatically by using one of the Batch APIs. Ваше клиентское приложение или служба могут использовать API-интерфейсы пакетной службы для взаимодействия с пакетной службой.Your client application or service can use the Batch APIs to communicate with the Batch service. С помощью API-интерфейсов пакетной службы можно создавать пулы вычислительных узлов виртуальные машины или облачные службы, а также управлять этими ресурсами.With the Batch APIs, you can create and manage pools of compute nodes, either virtual machines or cloud services. Вы можете запланировать выполнение заданий и задач на этих узлах.You can then schedule jobs and tasks to run on those nodes.

Вы можете эффективно обрабатывать крупномасштабные рабочие нагрузки в своей организации или предоставлять внешние интерфейсы служб клиентам, чтобы они могли выполнять задания и задачи (по требованию или по расписанию) на одном, сотнях или тысячах узлов.You can efficiently process large-scale workloads for your organization, or provide a service front end to your customers so that they can run jobs and tasks--on demand, or on a schedule--on one, hundreds, or even thousands of nodes. Кроме того, пакетную службу Azure можно использовать как часть более крупного рабочего процесса под управлением таких средств, как фабрика данных Azure.You can also use Azure Batch as part of a larger workflow, managed by tools such as Azure Data Factory.

Совет

Дополнительные сведения о функциях и рабочих процессах, используемых в пакетной службе Azure, см. в статье Рабочий процесс и ресурсы пакетной службы.To learn more about the features and workflow used in Azure Batch, see Batch service workflow and resources.

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

При разработке решений с использованием пакетной службы требуются следующие учетные записи в вашей подписке Azure:When you develop Batch solutions, you use the following accounts in your Azure subscription:

  • Учетная запись пакетной службы — это ресурсы пакетной службы Azure, в том числе пулы, вычислительные узлы, задания и задачи, связанные с учетной записью пакетной службы Azure.Batch account - Azure Batch resources, including pools, compute nodes, jobs, and tasks, are associated with an Azure Batch account. Когда приложение отправляет запрос к пакетной службе, выполняется проверка подлинности запроса с использованием имени учетной записи пакетной службы Azure, URL-адреса учетной записи и ключа доступа или токена Azure Active Directory.When your application makes a request against the Batch service, it authenticates the request using the Azure Batch account name, the URL of the account, and either an access key or an Azure Active Directory token. Вы можете создать учетную запись пакетной службы на портале Azure или программным способом.You can create a Batch account in the Azure portal or programmatically.
  • Учетная запись хранения. В пакетную службу встроена поддержка работы с файлами в службе хранилища Azure.Storage account - Batch includes built-in support for working with files in Azure Storage. При работе с пакетной службой хранилище BLOB-объектов Azure используется преимущественно не только для промежуточного хранения файлов программ и данных (запускаются и обрабатываются задачами соответственно), но и для хранения выходных данных (результаты выполнения задач).Nearly every Batch scenario uses Azure Blob storage for staging the programs that your tasks run and the data that they process, and for the storage of output data that they generate. Каждая учетная запись пакетной службы обычно связана с соответствующей учетной записью хранения.Each Batch account is usually associated with a corresponding storage account.

Интерфейсы API уровня обслуживания и управленияService-level and management-level APIs

Пакетная служба Azure имеет два набора API: один для уровня обслуживания и один для уровня управления.Azure Batch has two sets of APIs, one for the service level and one for the management level. Их названия часто похожи, но они возвращают разные результаты.The naming is often similar, but they return different results.

В журнале действий будут записываться только действия из API управления.Only actions from the management APIs are tracked in the activity log. API уровня обслуживания обходят уровень управления ресурсами Azure (management.azure.com) и не регистрируются в журнале.Service level APIs bypass the Azure Resource Management layer (management.azure.com) and are not logged.

Например, API уровня обслуживания для удаления пула работает непосредственно с учетной записью пакетной службы: DELETE {batchUrl}/pools/{poolId}For example, the Batch service API to delete a pool is targeted directly on the batch account: DELETE {batchUrl}/pools/{poolId}

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

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

Приложения и службы могут напрямую вызывать REST API или использовать следующие клиентские библиотеки для выполнения рабочих нагрузок пакетной службы Azure и управления ими.Your applications and services can issue direct REST API calls or use one or more of the following client libraries to run and manage your Azure Batch workloads.

APIAPI Справочник по APIAPI reference СкачиваниеDownload УчебникTutorial Примеры кодаCode samples Дополнительные сведенияMore info
Пакетная служба (REST)Batch REST Azure REST API — документацияAzure REST API - Docs НедоступноN/A - - Поддерживаемые версииSupported versions
Пакетная служба (.NET)Batch .NET Пакет Azure SDK для .NET — документацияAzure SDK for .NET - Docs NuGetNuGet РуководствоTutorial GitHubGitHub Заметки о выпускеRelease notes
Пакетная служба PythonBatch Python Пакет Azure SDK для Python — документацияAzure SDK for Python - Docs PyPIPyPI РуководствоTutorial GitHubGitHub Файл сведенийReadme
JavaScript пакетной службыBatch JavaScript Пакет Azure SDK для JavaScript — документацияAzure SDK for JavaScript - Docs npmnpm РуководствоTutorial - Файл сведенийReadme
Java для пакетной службыBatch Java Пакет Azure SDK для Java — документацияAzure SDK for Java - Docs MavenMaven - GitHubGitHub Файл сведенийReadme

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

API-интерфейсы Azure Resource Manager для пакетной службы предоставляют программный доступ к учетным записям пакетной службы.The Azure Resource Manager APIs for Batch provide programmatic access to Batch accounts. Применяя эти API, можно программно управлять учетными записями пакетной службы, квотами, пакетами приложений и другими ресурсами через поставщик Microsoft.Batch.Using these APIs, you can programmatically manage Batch accounts, quotas, application packages, and other resources through the Microsoft.Batch provider.

APIAPI Справочник по APIAPI reference СкачиваниеDownload УчебникTutorial Примеры кодаCode samples
REST для управления пакетной службойBatch Management REST Azure REST API — документацияAzure REST API - Docs - - GitHubGitHub
Библиотека .NET для управления пакетной службойBatch Management .NET Пакет Azure SDK для .NET — документацияAzure SDK for .NET - Docs NuGetNuGet РуководствоTutorial GitHubGitHub
Python для управления пакетной службойBatch Management Python Пакет Azure SDK для Python — документацияAzure SDK for Python - Docs PyPIPyPI - -
JavaScript для управления пакетной службойBatch Management JavaScript Пакет Azure SDK для JavaScript — документацияAzure SDK for JavaScript - Docs npmnpm - -
Java для управления пакетной службойBatch Management Java Пакет Azure SDK для Java — документацияAzure SDK for Java - Docs MavenMaven - -

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

Эти программы командной строки обеспечивают ту же функциональность, что и API-интерфейсы пакетной службы и службы управления пакетной службой.These command-line tools provide the same functionality as the Batch service and Batch Management APIs:

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

Эти дополнительные средства можно использовать для создания и отладки приложений и служб пакетной службы.These additional tools may be helpful for building and debugging your Batch applications and services.

  • Портал Azure: На портале Azure можно создавать, отслеживать и удалять пулы, задания и задачи пакетной службы.Azure portal: You can create, monitor, and delete Batch pools, jobs, and tasks in the Azure portal. Во время выполнения заданий можно просмотреть сведения о состоянии этих и других ресурсов, а также скачать файлы из вычислительных узлов в пулах.You can view status information for these and other resources while you run your jobs, and even download files from the compute nodes in your pools. Например, при устранении неполадок можно скачать файл stderr.txt задачи, завершившейся сбоем.For example, you can download a failed task's stderr.txt while troubleshooting. Кроме того, можно скачать файлы удаленного рабочего стола, которые можно использовать для входа на вычислительные узлы.You can also download Remote Desktop (RDP) files that you can use to log in to compute nodes.
  • Azure Batch Explorer. Batch Explorer (ранее BatchLabs) — это бесплатное автономное клиентское средство с множеством функций для создания, отладки и мониторинга приложений в пакетной службе Azure.Azure Batch Explorer: Batch Explorer (formerly called BatchLabs) is a free, rich-featured, standalone client tool to help create, debug, and monitor Azure Batch applications. Скачайте пакет установки для Mac, Linux или Windows.Download an installation package for Mac, Linux, or Windows.
  • Azure Batch Shipyard. Batch Shipyard — это средство, способствующее подготовке, выполнению и отслеживанию контейнерной пакетной обработки и высокопроизводительных рабочих нагрузок в пакетной службе Azure.Azure Batch Shipyard: Batch Shipyard is a tool to help provision, execute, and monitor container-based batch processing and HPC workloads on Azure Batch.
  • Обозреватель службы хранилища. Строго говоря, этот обозреватель не является средством пакетной службы Azure, но это полезный инструмент для разработки и отладки соответствующих решений.Azure Storage Explorer: While not strictly an Azure Batch tool, the Storage Explorer is another valuable tool to have while you are developing and debugging your Batch solutions.

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

Дальнейшие действияNext steps