次の方法で共有


Python 用 Azure ライブラリ (SDK) を使用する

Python 用のオープン ソースの Azure ライブラリにより、Python アプリケーション コードからの Azure リソースのプロビジョニング、管理、および使用が簡略化されます。

本当に知りたい詳細

重要ではありませんが、まだ興味深い詳細

  • Azure CLI は管理ライブラリを使用して Python で記述されているため、Azure CLI コマンドを使用してできることはすべて、Python スクリプトから行うこともできます。 しかし、CLI コマンドは、複数のタスクを一緒に実行する、非同期操作を自動的に処理する、接続文字列などの出力を書式設定するなど、多くの便利な機能を提供します。 そのため、プロセスをより厳密に制御する必要がない限り、CLI (または同等の Azure PowerShell) を使用して、同等の Python コードを記述するよりも、自動化された作成スクリプトと管理スクリプトを使用する方が便利です。

  • Python 用 Azure ライブラリは、基になる Azure REST API の上に構築されているため、使い慣れた Python パラダイムを通じてこれらの API を使用できます。 ただし、必要に応じて、Python コードから REST API を直接使用できます。

  • Azure ライブラリのソース コードは、 https://github.com/Azure/azure-sdk-for-pythonにあります。 オープンソースプロジェクトとして、貢献は歓迎されています!

  • テスト対象ではない IronPython や Jython などのインタープリターでライブラリを使用できますが、分離された問題や非互換性が発生する可能性があります。

  • ライブラリ API リファレンス ドキュメントのソース リポジトリは、 https://github.com/MicrosoftDocs/azure-docs-sdk-python/にあります。

  • 2019 年から、Azure Python ライブラリが更新され、認証プロトコル、ログ記録、トレース、トランスポート プロトコル、バッファー応答、再試行などの一般的なクラウド パターンが共有されました。 更新されたライブラリは、 現在の Azure SDK ガイドラインに準拠しています。

    • 2023 年 3 月 31 日に、現在の Azure SDK ガイドラインに準拠していない Azure SDK ライブラリのサポートは廃止されました。 古いライブラリは 2023 年 3 月 31 日を超えて使用できますが、Microsoft から公式のサポートと更新プログラムを受け取らなくなります。 詳細については、「 Azure SDK ライブラリを更新する」を参照してください。

    • Azure SDK のセキュリティとパフォーマンスの更新プログラムが不足しないようにするには、2023 年 3 月 31 日までに 最新の Azure SDK ライブラリ にアップグレードします。

    • 影響を受ける Python ライブラリを確認するには、「 Azure SDK Deprecated Releases for Python」を参照してください。

  • ライブラリに適用されるガイドラインの詳細については、 Python ガイドライン: 概要を参照してください。

管理ライブラリを使用して Azure リソースを作成および管理する

SDK の 管理 ("管理プレーン") ライブラリ。名前はすべて azure-mgmt- で始まり、Python スクリプトから Azure リソースを作成、構成、管理するのに役立ちます。 すべての Azure サービスには、対応する管理ライブラリがあります。 詳細については、「Azure コントロール プレーンとデータ プレーン」を参照してください。

管理ライブラリを使用すると、構成スクリプトとデプロイ スクリプトを記述して、Azure portal または Azure CLIで実行できるのと同じタスクを実行できます。 (前述のように、Azure CLI は Python で記述され、管理ライブラリを使用してさまざまなコマンドを実装します)。

次の例は、プライマリ管理ライブラリの一部を使用する方法を示しています。

各管理ライブラリの操作の詳細については、SDK GitHub リポジトリのライブラリのプロジェクト フォルダーにある README.md または README.rst ファイルを参照してください。 その他のコード スニペットについては、リファレンス ドキュメントのAzure サンプルを参照してください。

古い管理ライブラリからの移行

古いバージョンの管理ライブラリからコードを移行する場合は、次の詳細を参照してください。

クライアント ライブラリで Azure リソースに接続して使用する

SDK の クライアント (または "データ プレーン") ライブラリは、既にプロビジョニングされているサービスと対話するための Python アプリケーション コードを記述するのに役立ちます。 クライアント ライブラリは、クライアント API をサポートするサービスにのみ存在します。

記事 「例: Azure Storage を使用する」では、クライアント ライブラリを使用する基本的な図を示します。

さまざまな Azure サービスでも、これらのライブラリを使用した例が提供されます。 その他のリンクについては、次のインデックス ページを参照してください。

各クライアント ライブラリの操作の詳細については、SDK の GitHub リポジトリにあるライブラリのプロジェクト フォルダーにある README.md または README.rst ファイルを参照してください。 その他のコード スニペットについては、リファレンス ドキュメントのAzure サンプルを参照してください。

ヘルプを取得して SDK チームと連絡を取る

次のステップ

Python 用の Azure ライブラリを簡単に使用できるように、ローカル開発環境の 1 回限りのセットアップを行うことを強くお勧めします。