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

  • Статья

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

Основные сведения

Дополнительные сведения

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

  • Библиотеки Azure для Python основаны на базовом REST API Azure, что позволяет использовать эти 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 года мы обновили библиотеки Python Azure для совместного использования общих облачных шаблонов, таких как протоколы проверки подлинности, ведение журнала, трассировка, транспортные протоколы, буферные ответы и повторные попытки. Обновленные библиотеки соответствуют текущим рекомендациям по пакету SDK Для Azure.

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

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

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

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

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

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

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

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

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

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

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

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

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

В статье , пример. Использование служба хранилища Azure предоставляет базовую иллюстрацию использования клиентской библиотеки.

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

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

Получение справки и связь с разработчиками SDK

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

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

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