Descrição geral dos APIs e ferramentas do Batch

O processamento de cargas de trabalho paralelas com o Azure Batch é geralmente realizado através de programação, utilizando uma das APIs do Batch. A sua aplicação ou serviço de cliente pode utilizar as Batch APIs para comunicar com o serviço Batch. Com as APIs do Batch, pode criar e gerir conjuntos de nós de computação, máquinas virtuais ou serviços cloud. Pode, então, agendar tarefas para serem executadas nesses nós.

Você pode processar com eficiência cargas de trabalho de grande escala para a sua organização ou fornecer uma interface de serviço para os seus clientes, para que eles possam executar trabalhos e tarefas — a pedido ou de acordo com um cronograma — numa, centenas ou até milhares de unidades. Também pode utilizar o Azure Batch como parte de um fluxo de trabalho maior, gerido por ferramentas como o Azure Data Factory.

Sugestão

Para saber mais sobre os recursos e o fluxo de trabalho usados no Lote do Azure, consulte Fluxo de trabalho e recursos do serviço em lote.

Contas do Azure para desenvolvimento do Batch

Quando desenvolver soluções do Batch, irá utilizar as seguintes contas na subscrição do Azure:

• Conta de lote do Azure: os recursos do Lote do Azure, incluindo pools, nós de computação, trabalhos e tarefas, estão associados a uma Conta de lote do Azure. Quando a aplicação faz um pedido ao serviço Batch, autentica o pedido com o nome de conta do Azure Batch, o URL da conta e uma chave de acesso ou um token do Microsoft Entra. Você pode criar uma conta em lote no portal do Azure ou programaticamente.
• Conta de armazenamento: o Batch inclui suporte interno para trabalhar com arquivos no Armazenamento do Azure. Quase todos os cenários do Batch utilizam o Armazenamento Blob do Azure para armazenar provisoriamente os programas que as suas tarefas executam e os dados que processam, bem como para o armazenamento dos dados de saída que geram. Cada conta de lote geralmente é associada a uma conta de armazenamento correspondente.

APIs de nível de serviço e de gerenciamento

O Azure Batch tem dois conjuntos de APIs, um para o nível de serviço e outro para o nível de gerenciamento. A nomenclatura é muitas vezes semelhante, mas eles retornam resultados diferentes.

Somente as ações das APIs de gerenciamento são rastreadas no log de atividades. As APIs de nível de serviço ignoram a camada de Gerenciamento de Recursos do Azure (management.azure.com) e não são registradas.

Por exemplo, a API de serviço em lote para excluir um pool é direcionada diretamente para a conta de lote: DELETE {batchUrl}/pools/{poolId}

Considerando que a API de gerenciamento de lote para excluir um pool é direcionada para a camada management.azure.com: DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}

APIs de serviços em lote

As suas aplicações e serviços podem emitir chamadas diretas de API REST ou utilizar uma ou mais das bibliotecas de cliente seguintes para executar e gerir as cargas de trabalho do Azure Batch.

API (Interface de Programação de Aplicações)	Referência da API	Descarregar	Guia de Aprendizagem	Amostras de código	Mais informações
REST do Batch	Azure REST API - Documentos	N/A	-	-	Versões suportadas
Lote .NET	SDK do Azure para .NET - Documentos	NuGet	Tutoriais	GitHub	Notas de lançamento
Python em lote	SDK do Azure para Python - Documentos	PyPI	Tutoriais	GitHub	Leia-me
JavaScript em lote	SDK do Azure para JavaScript - Documentos	NPM	Tutoriais	-	Leia-me
Java em lote	SDK do Azure para Java - Documentos	Maven	-	GitHub	Leia-me

APIs de Gestão de Lotes

As APIs do Azure Resource Manager para o Batch concedem acesso programático às contas do Batch. Ao utilizar estas APIs, pode gerir, através de programação, contas, quotas, pacotes de aplicações e outros recursos do Batch através do fornecedor Microsoft.Batch.

API (Interface de Programação de Aplicações)	Referência da API	Descarregar	Guia de Aprendizagem	Amostras de código
Gestão de Lotes REST	Azure REST API - Documentos	-	-	GitHub
Gestão de Batch .NET	SDK do Azure para .NET - Documentos	NuGet	Tutoriais	GitHub
Python de Gestão de Batch	SDK do Azure para Python - Documentos	PyPI	-	-
Gestão de Lote em JavaScript	SDK do Azure para JavaScript - Documentos	NPM	-	-
Gestão de Lotes Java	SDK do Azure para Java - Documentos	Maven	-	-

Ferramentas de linha de comandos do Batch

Estas ferramentas da linha de comandos fornecem a mesma funcionalidade que o serviço de Batch e as APIs de Gestão do Batch:

• Cmdlets do Batch PowerShell: os cmdlets do Azure Batch no módulo Azure PowerShell permitem-lhe gerir recursos do Batch com o PowerShell.
• CLI do Azure: a CLI do Azure é um conjunto de ferramentas para várias plataformas que fornece comandos shell para interagir com vários serviços do Azure, incluindo o serviço do Batch e o serviço de Gestão do Batch. Para obter mais informações, consulte Gerenciar recursos em lote com a CLI do Azure.

Outras ferramentas para programação da aplicação

Essas ferramentas adicionais podem ser úteis para criar e depurar seus aplicativos e serviços em lote.

• Portal do Azure: pode criar, monitorizar e eliminar conjuntos, trabalhos e tarefas do Batch no portal do Azure. Você pode exibir informações de status para esses e outros recursos enquanto executa seus trabalhos e até mesmo baixar arquivos dos nós de computação em seus pools. Por exemplo, pode descarregar o stderr.txt de uma tarefa falhada durante a resolução de problemas. Também pode transferir ficheiros de Ambiente de Trabalho Remoto (RDP) que pode utilizar para iniciar sessão em nós de computação.
• Azure Batch Explorer: O Batch Explorer é uma ferramenta de cliente independente, com muitos recursos, para ajudar a criar, depurar e monitorizar aplicações Azure Batch. Transfira um pacote de instalação para Mac, Linux ou Windows.
• Azure Storage Explorer: Embora não seja estritamente uma ferramenta do Azure Batch, o Storage Explorer pode ser útil ao desenvolver e depurar suas soluções em lote.

Recursos adicionais

• Para saber mais sobre o registo de eventos da sua aplicação em lote, consulte Métricas, alertas e logs em lote para avaliação e monitorização de diagnóstico.
• Para obter informações de referência sobre eventos gerados pelo serviço Batch, consulte Batch Analytics.
• Para obter informações sobre variáveis de ambiente para nós de computação, consulte Variáveis de ambiente de tempo de execução do Azure Batch.

Próximos passos

• Saiba mais sobre o fluxo de trabalho do serviço Batch e os recursos primários, como pools, nós, jobs e tarefas.
• Introdução à biblioteca do Azure Batch para .NET para saber como utilizar C# e a biblioteca .NET do Batch para executar uma carga de trabalho simples utilizando um fluxo de trabalho Batch comum. Uma versão Python e um tutorial JavaScript também estão disponíveis.
• Transfira as amostras de código no GitHub para ver como tanto o C# como o Python pode interagir com o Batch para agendar e processar amostras de cargas de trabalho.