Поделиться через

Использование библиотек Azure (SDK) для Python

Библиотеки Azure с открытым кодом для Python упрощают подготовку, управление и использование ресурсов Azure из кода приложения Python.

Подробности, которые вы действительно хотите знать

Необязательные, но по-прежнему интересные детали

  • Так как Azure CLI написан в Python и использует библиотеки управления, вы можете сделать что-либо с помощью команд Azure CLI, которые можно также сделать из скрипта Python. Команды CLI предоставляют множество полезных функций, таких как выполнение нескольких задач вместе, автоматическая обработка асинхронных операций, форматирование выходных данных, таких как строки подключения и многое другое. Таким образом, использование интерфейса командной строки (или его эквивалента Azure PowerShell) для сценариев автоматического создания и управления может быть удобнее, чем написание эквивалентного кода Python, если вы не хотите иметь гораздо более точный уровень контроля над процессом.

  • Библиотеки Azure для Python основаны на базовом API Azure REST API, чтобы использовать эти API с помощью знакомых Python парадигм. Однако при необходимости можно всегда использовать REST API непосредственно из кода Python.

  • Исходный код библиотек Azure можно найти в https://github.com/Azure/azure-sdk-for-python. Как проект с открытым исходным кодом, вклады приветствуются!

  • Хотя библиотеки можно использовать с интерпретаторами, такими как IronPython и Jython, которые корпорация Майкрософт не тестирует, могут возникнуть изолированные проблемы и несовместимости.

  • Исходный репозиторий для справочной документации по API библиотеки находится на https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

  • Начиная с 2019 года корпорация Майкрософт обновила библиотеки Azure Python для совместного использования общих облачных шаблонов, таких как протоколы проверки подлинности, ведение журнала, трассировка, транспортные протоколы, буферные ответы и повторные попытки. Обновленные библиотеки соответствуют рекомендациям current Azure SDK.

    • 31 марта 2023 г. корпорация Майкрософт отставила поддержку Azure SDK библиотек, которые не соответствуют текущим рекомендациям Azure SDK. Хотя старые библиотеки по-прежнему могут использоваться за 31 марта 2023 года, они больше не получают официальную поддержку и обновления от Корпорации Майкрософт. Дополнительные сведения см. в уведомлении Обновление библиотек Azure SDK.

    • Чтобы избежать отсутствия обновлений безопасности и производительности Azure SDKs, обновите библиотеки latest Azure SDK до 31 марта 2023 года.

    • Чтобы проверить, какие библиотеки Python затронуты, см. раздел Устаревшие версии Azure SDK для Python.

  • Дополнительные сведения о рекомендациях Майкрософт, применимых к библиотекам, см. в руководстве Python. Введение.

Создание ресурсов Azure и управление ими с помощью библиотек управления

Библиотеки пакета SDK management (или плоскости управления), имена всех которых начинаются с azure-mgmt-, помогают создавать, настраивать и управлять ресурсами Azure из скриптов Python. Все службы Azure имеют соответствующие библиотеки управления. Дополнительные сведения см. в разделе контрольной плоскости и плоскости данных Azure.

С помощью библиотек управления можно создавать сценарии конфигурации и развертывания, чтобы выполнять те же задачи, которые можно выполнять с помощью портала Azure или Azure CLI. (Как отмечалось ранее, Azure CLI написаны в Python и используют библиотеки управления для реализации различных команд.

В следующих примерах показано, как использовать некоторые основные библиотеки управления:

Дополнительные сведения о работе с каждой библиотекой управления см. в файле README.md или README.rst в папке проекта библиотеки в репозитории SDK GitHub. Дополнительные фрагменты кода также можно найти в документации reference и Azure Samples.

Миграция из старых библиотек управления

Если вы переносите код из более старых версий библиотек управления, ознакомьтесь со следующими сведениями:

Подключение и использование ресурсов Azure с клиентскими библиотеками

Библиотеки клиента (или "data plane") пакета SDK помогают создавать Python-код приложения для взаимодействия с уже развёрнутыми службами. Клиентские библиотеки существуют только для тех служб, которые поддерживают клиентский API.

Статья Example: использование Azure Storage предоставляет базовую иллюстрацию использования клиентской библиотеки.

Различные службы Azure также предоставляют примеры, использующие эти библиотеки. См. следующие страницы индекса для других ссылок:

Дополнительную информацию о работе с каждой клиентской библиотекой см. в файлах README.md или README.rst, расположенных в папке проекта библиотеки в репозитории GitHub SDK. Дополнительные фрагменты кода также можно найти в документации reference и Azure Samples.

Получите помощь и свяжитесь с командой SDK

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

Настройте локальную среду разработки, чтобы можно было легко использовать любую из библиотек Azure для Python.

Настройка локальной среды разработки >>>

  • Last updated on