Sdílet prostřednictvím


Použití knihoven Azure (SDK) pro Python

Opensourcové knihovny Azure pro Python zjednodušují zřizování, správu a používání prostředků Azure z kódu aplikace Pythonu.

Podrobnosti, které opravdu chcete znát

Non-essential, ale stále zajímavé podrobnosti

  • Vzhledem k tomu, že Rozhraní příkazového řádku Azure je napsané v Pythonu pomocí knihoven pro správu, všechno, co můžete dělat s příkazy Azure CLI, můžete také provádět ze skriptu Pythonu. Příkazy rozhraní příkazového řádku poskytují mnoho užitečných funkcí, jako je provádění více úloh společně, automatické zpracování asynchronních operací, formátování výstupu, jako jsou připojovací řetězec atd. Použití rozhraní příkazového řádku (nebo jeho ekvivalentu, Azure PowerShellu) pro automatizované vytváření a skripty pro správu může být pohodlnější než psaní ekvivalentního kódu Pythonu, pokud nechcete mít mnohem přesnější stupeň kontroly nad procesem.

  • Knihovny Azure pro Python vycházejí z podkladového rozhraní Azure REST API, které umožňují používat tato rozhraní API prostřednictvím známých paradigmat Pythonu. V případě potřeby ale můžete rozhraní REST API vždy používat přímo z kódu Pythonu.

  • Zdrojový kód knihoven Azure najdete na webu https://github.com/Azure/azure-sdk-for-python. Jako opensourcový projekt jsou příspěvky vítány!

  • I když můžete knihovny používat s interprety, jako je IronPython a Jython, na které netestujeme, můžete narazit na izolované problémy a nekompatibility.

  • Zdrojové úložiště pro referenční dokumentaci k rozhraní API knihovny se nachází na https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

  • Od roku 2019 jsme aktualizovali knihovny Azure Pythonu tak, aby sdílely běžné cloudové vzory, jako jsou ověřovací protokoly, protokolování, trasování, přenosové protokoly, odpovědi ve vyrovnávací paměti a opakování. Aktualizované knihovny odpovídají aktuálním pokynům k sadě Azure SDK.

    • Dne 31. března 2023 jsme vyřadili podporu knihoven sady Azure SDK, které nevyhovují aktuálním pokynům sady Azure SDK. Starší knihovny se sice dají používat i po 31. březnu 2023, ale už nebudou od Microsoftu dostávat oficiální podporu a aktualizace. Další informace najdete v oznámení o aktualizaci knihoven sady Azure SDK.

    • Pokud se chcete vyhnout chybějícím aktualizacím zabezpečení a výkonu sad SDK Azure, upgradujte do 31. března 2023 na nejnovější knihovny sady Azure SDK.

    • Informace o ovlivněných knihovnách Pythonu najdete v tématu Vyřazené verze sady Azure SDK pro Python.

  • Podrobnosti o pokynech, které platí pro knihovny, najdete v pokynech pro Python: Úvod.

Vytváření a správa prostředků Azure pomocí knihoven pro správu

Knihovny pro správu (neboli "rovina správy") sady SDK, jejichž názvy začínají azure-mgmt-, pomáhají vytvářet, konfigurovat a jinak spravovat prostředky Azure ze skriptů Pythonu. Všechny služby Azure mají odpovídající knihovny pro správu. Další informace najdete v tématu Rovina řízení Azure a rovina dat.

Pomocí knihoven pro správu můžete psát skripty konfigurace a nasazení, které provádějí stejné úlohy, které můžete provádět prostřednictvím webu Azure Portal nebo Azure CLI. (Jak jsme si poznamenali dříve, Azure CLI je napsaný v Pythonu a používá knihovny pro správu k implementaci různých příkazů.)

Následující příklady ukazují, jak používat některé z primárních knihoven pro správu:

Podrobnosti o práci s každou knihovnou pro správu najdete v souboru README.md nebo README.rst umístěném ve složce projektu knihovny v úložišti GITHub sady SDK. Další fragmenty kódu najdete také v referenční dokumentaci a ukázkách Azure.

Migrace ze starších knihoven pro správu

Pokud migrujete kód ze starších verzí knihoven pro správu, projděte si následující podrobnosti:

Připojení a používání prostředků Azure s klientskými knihovnami

Klientské knihovny sady SDK (neboli "rovina dat") pomáhají psát kód aplikace Pythonu pro interakci s již zřízenými službami. Klientské knihovny existují pouze pro služby, které podporují klientské rozhraní API.

Příklad: Použití služby Azure Storage obsahuje základní ilustraci použití klientské knihovny.

Různé služby Azure také poskytují příklady použití těchto knihoven. Další odkazy najdete na následujících stránkách indexu:

Podrobnosti o práci s každou klientskou knihovnou najdete v souboru README.md nebo README.rst umístěném ve složce projektu knihovny v úložišti GitHub sady SDK. Další fragmenty kódu najdete také v referenční dokumentaci a ukázkách Azure.

Získání nápovědy a připojení k týmu sady SDK

Další krok

Důrazně doporučujeme jednorázově nastavit místní vývojové prostředí, abyste mohli snadno používat některou z knihoven Azure pro Python.