Azure SDK for Python のプロキシを構成する方法

  • [アーティクル]

組織でインターネット リソースにアクセスするためにプロキシ サーバーを使用する必要がある場合は、Azure SDK for Python を使用するためにプロキシ サーバー情報を含む環境変数を設定する必要があります。 環境変数 (HTTP_PROXYとHTTPS_PROXY) を設定すると、Azure SDK for Python は実行時にプロキシ サーバーを使用します。

プロキシ サーバーの URL には、ユーザー名とパスワードの組み合わせが省略可能な形式 http[s]://[username:password@]<ip_address_or_domain>:<port>/ があります。

その後、環境変数を使用して、プロキシをグローバルに構成できます。あるいは、proxies という名前の引数を、個々のクライアント コンストラクターまたは操作メソッドに渡すことによって、プロキシを指定することができます。

グローバル構成

スクリプトまたはアプリ用にプロキシをグローバルに構成するには、サーバーの URL を使用して HTTP_PROXY または HTTPS_PROXY 環境変数を定義します。 これらの変数は、任意のバージョンの Azure ライブラリで動作します。 これはHTTPS_PROXYプロキシではなく、要求のhttps://プロキシを意味HTTPSします。

パラメーター use_env_settings=False をクライアント オブジェクト コンストラクターまたは操作メソッドに渡すと、これらの環境変数は無視されます。

コマンド ラインから設定する

rem Non-authenticated HTTP server:
set HTTP_PROXY=http://10.10.1.10:1180

rem Authenticated HTTP server:
set HTTP_PROXY=http://username:password@10.10.1.10:1180

rem Non-authenticated HTTPS server:
set HTTPS_PROXY=http://10.10.1.10:1180

rem Authenticated HTTPS server:
set HTTPS_PROXY=http://username:password@10.10.1.10:1180

Python コードで設定する

カスタム構成を必要とせず、環境変数を使用してプロキシ設定を設定できます。

import os
os.environ["HTTP_PROXY"] = "http://10.10.1.10:1180"

# Alternate URL and variable forms:
# os.environ["HTTP_PROXY"] = "http://username:password@10.10.1.10:1180"
# os.environ["HTTPS_PROXY"] = "http://10.10.1.10:1180"
# os.environ["HTTPS_PROXY"] = "http://username:password@10.10.1.10:1180"

カスタム構成

クライアントごとまたはメソッドごとの Python コードで設定する

カスタム構成の場合は、特定のクライアント オブジェクトまたは操作メソッドのプロキシを指定できます。 という名前 proxiesの引数を持つプロキシ サーバーを指定します。

たとえば、例: Azure storage の使用に関する記事の以下のコードでは、BlobClient コンストラクターとユーザー資格情報を使用して HTTPS プロキシを指定します。 この場合、オブジェクトは、azure. core に基づく、azure.storage.blob ライブラリから取得されます。

from azure.identity import DefaultAzureCredential

# Import the client object from the SDK library
from azure.storage.blob import BlobClient

credential = DefaultAzureCredential()

storage_url = "https://<storageaccountname>.blob.core.windows.net"

blob_client = BlobClient(storage_url, container_name="blob-container-01",
    blob_name="sample-blob.txt", credential=credential,
    proxies={ "https": "https://username:password@10.10.1.10:1180" }
)

# Other forms that the proxy URL might take:
# proxies={ "http": "http://10.10.1.10:1180" }
# proxies={ "http": "http://username:password@10.10.1.10:1180" }
# proxies={ "https": "https://10.10.1.10:1180" }