Přehled rozhraní API a nástrojů služby Batch
Zpracování paralelních úloh službou Azure Batch se obvykle provádí programově pomocí jednoho z rozhraní API služby Batch. Vaše klientská aplikace nebo služba může používat rozhraní API služby Batch ke komunikaci se službou Batch. Pomocí rozhraní API služby Batch můžete vytvořit a spravovat fondy výpočetních uzlů – virtuální počítače nebo cloudové služby. Pak můžete plánovat úlohy a úkoly, které se mají v těchto uzlech spouštět.
Ve vaší organizaci můžete efektivně zpracovávat rozsáhlé úlohy nebo poskytovat zákazníkům front-end služby, aby mohli spouštět úlohy a úkoly – na vyžádání nebo podle plánu – na jednom, stovkách nebo dokonce tisících uzlů. Službu Azure Batch můžete také používat jako součást rozsáhlejšího pracovního postupu spravovaného nástroji, například Azure Data Factory.
Tip
Další informace o funkcích a pracovních postupech používaných ve službě Azure Batch najdete v tématu Pracovní postup a prostředky služby Batch.
Účty Azure pro vývoj pro službu Batch
Při vývoji řešení ve službě Batch používáte následující účty předplatného Azure:
- Účet Batch: Prostředky Azure Batch, včetně fondů, výpočetních uzlů, úloh a úkolů, jsou přidružené k účtu Azure Batch. Pokud vaše aplikace odešle požadavek na službu Batch, ověří se tato žádost pomocí názvu účtu Azure Batch, adresy URL účtu a přístupové klávesy, nebo tokenu Microsoft Entra. Účet Batch můžete vytvořit na webu Azure Portal nebo programově.
- Účet úložiště: Služba Batch zahrnuje integrovanou podporu pro práci se soubory ve službě Azure Storage. Téměř každý scénář služby Batch používá úložiště objektů blob v Azure – pro přípravu programů, které budou vaše úkoly spouštět, a dat, která budou zpracovávat, a také pro ukládání generovaných výstupních dat. Každý účet Batch je obvykle přidružený k odpovídajícímu účtu úložiště.
Rozhraní API na úrovni služeb a na úrovni správy
Azure Batch má dvě sady rozhraní API, jednu pro úroveň služby a jednu pro úroveň správy. Pojmenování je často podobné, ale vrací různé výsledky.
V protokolu aktivit se sledují jenom akce z rozhraní API pro správu. Rozhraní API na úrovni služeb obcházejí vrstvu azure Resource Management (management.azure.com) a nejsou protokolována.
Například rozhraní API služby Batch pro odstranění fondu je cílené přímo na účet Batch: DELETE {batchUrl}/pools/{poolId}
Vzhledem k tomu, že rozhraní API pro správu služby Batch pro odstranění fondu je cílem management.azure.com vrstvy: DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}
Rozhraní API služby Batch
Vaše aplikace a služby mohou provádět přímá volání rozhraní REST API nebo používat jednu nebo více následujících klientských knihoven ke spuštění a správě úloh služby Azure Batch.
rozhraní API | Reference rozhraní API | Stáhnout | Kurz | Ukázky kódu | Další informace |
---|---|---|---|---|---|
Batch REST | Azure REST API – Dokumentace | – | - | - | Podporované verze |
Batch .NET | Azure SDK pro .NET – Docs | NuGet | Kurz | GitHub | Zpráva k vydání verze |
Batch Python | Azure SDK pro Python – Dokumentace | PyPI | Kurz | GitHub | Soubor Readme |
Batch JavaScript | Azure SDK pro JavaScript – Docs | npm | Kurz | - | Soubor Readme |
Batch Java | Azure SDK pro Javu – Dokumentace | Maven | - | GitHub | Soubor Readme |
Rozhraní API služby Batch Management
Rozhraní API Azure Resource Manageru pro službu Batch poskytují programový přístup k účtům Batch. Pomocí těchto rozhraní API můžete prostřednictvím kódu programu spravovat účty Batch, kvóty, balíčky aplikací a další prostředky přes zprostředkovatele Microsoft.Batch.
rozhraní API | Reference rozhraní API | Stáhnout | Kurz | Ukázky kódu |
---|---|---|---|---|
Správa služby Batch pomocí REST | Azure REST API – Dokumentace | - | - | GitHub |
Knihovna Batch Management .NET | Azure SDK pro .NET – Docs | NuGet | Kurz | GitHub |
Správa služby Batch pomocí Pythonu | Azure SDK pro Python – Dokumentace | PyPI | - | - |
Batch Management JavaScript | Azure SDK pro JavaScript – Docs | npm | - | - |
Správa služby Batch pomocí Javy | Azure SDK pro Javu – Dokumentace | Maven | - | - |
Nástroje příkazového řádku služby Batch
Tyto nástroje příkazového řádku poskytují stejné funkce jako rozhraní API služby Batch a služby Batch Management:
- Rutiny prostředí PowerShell služby Batch: Rutiny služby Azure Batch vám v modulu Azure PowerShell umožňují spravovat prostředky Batch v prostředí PowerShell.
- Azure CLI: Azure CLI je sada nástrojů pro různé platformy, která poskytuje příkazy prostředí pro komunikaci s řadou služeb Azure, včetně služby Batch a služby Batch Management. Další informace najdete v tématu Správa prostředků Batch pomocí Azure CLI.
Další nástroje pro vývoj aplikací
Tyto další nástroje můžou být užitečné pro vytváření a ladění aplikací a služeb Batch.
- Azure Portal: Na webu Azure Portal můžete vytvářet, monitorovat a odstraňovat fondy, úlohy a úkoly služby Batch. Během spouštění úloh můžete zobrazit informace o stavu těchto a dalších prostředků a dokonce stahovat soubory z výpočetních uzlů ve fondech. Například při řešení potíží si můžete stáhnout soubor
stderr.txt
neúspěšné úlohy. Můžete si také stáhnout soubory vzdálené plochy (RDP), které lze použít k přihlášení do výpočetních uzlů. - Azure Batch Explorer: Batch Explorer je bezplatný samostatný klientský nástroj, který vám pomůže vytvářet, ladit a monitorovat aplikace Azure Batch. Můžete si stáhnout instalační balíček pro Mac, Linux nebo Windows.
- Průzkumník služby Azure Storage: I když není výhradně nástrojem Azure Batch, může být Průzkumník služby Storage užitečné při vývoji a ladění řešení Batch.
Další materiály
- Další informace o protokolování událostí z aplikace Batch najdete v tématu Metriky, upozornění a protokoly služby Batch pro diagnostické vyhodnocení a monitorování.
- Referenční informace o událostech vyvolaých službou Batch najdete v tématu Batch Analytics.
- Informace oproměnných
Další kroky
- Seznamte se s pracovním postupem služby Batch a primárními prostředky , jako jsou fondy, uzly, úlohy a úkoly.
- V kapitole Začínáme s knihovnou Azure Batch pro .NET zjistíte, jak použít C# a knihovnu Batch .NET ke spuštění jednoduché úlohy s použitím běžného pracovního postupu služby Batch. K dispozici je také verze Pythonu a javascriptový kurz.
- Stáhněte si ukázky kódu na GitHubu a podívejte se, jak můžou jazyk C# i Python komunikovat přes rozhraní se službou Batch při plánování a zpracování ukázkových úloh.