Azure Functions のアプリケーション設定のリファレンス

[アーティクル]
12/05/2022

関数アプリのアプリ設定には、その関数アプリのすべての関数に影響する構成オプションが含まれています。ローカルで実行する場合、これらの設定は、ローカルの環境変数としてアクセスされます。この記事では、関数アプリで使用できるアプリケーション設定の一覧を紹介します。

関数アプリの設定は、いくつかの方法で追加、更新、削除できます。

関数アプリの設定に変更を加えるためには、関数アプリを再起動する必要があります。

host.json ファイルと local.settings.json ファイルには、他の関数アプリ構成オプションもあります。例の接続文字列の値は、読みやすくするために省略されています。

注意

アプリケーション設定を使用して、host.json ファイル自体を変更することなく、host.json 設定値をオーバーライドできます。これは、特定の環境の特定の host.json 設定を構成または変更する必要がある場合に便利です。これにより、プロジェクトを再発行しなくても、host.json 設定を変更できます。詳細については、host.json のリファレンスに関する記事をご覧ください。関数アプリの設定に変更を加えるためには、関数アプリを再起動する必要があります。

APPINSIGHTS_INSTRUMENTATIONKEY

Application Insights のインストルメンテーションキー。 APPINSIGHTS_INSTRUMENTATIONKEY と APPLICATIONINSIGHTS_CONNECTION_STRING の両方を使用することはできません。可能な場合は、APPLICATIONINSIGHTS_CONNECTION_STRING を使用します。 Application Insights がソブリンクラウドで実行されている場合は、APPLICATIONINSIGHTS_CONNECTION_STRING を使用する必要があります。詳細については、Azure Functions で監視を構成する方法に関するページを参照してください。

Key	値の例
APPINSIGHTS_INSTRUMENTATIONKEY	`55555555-af77-484b-9032-64f83bb83bb`

Note

インストルメンテーションキーのインジェストのサポートは、2025 年 3 月 31 日に終了します。インストルメンテーションキーのインジェストは引き続き機能しますが、この機能の更新プログラムやサポートは提供されなくなります。接続文字列に移行することで、新機能をご利用いただけます。

APPLICATIONINSIGHTS_CONNECTION_STRING

Application Insights の接続文字列。可能であれば、APPINSIGHTS_INSTRUMENTATIONKEY の代わりに APPLICATIONINSIGHTS_CONNECTION_STRING を使用します。次の場合は、APPLICATIONINSIGHTS_CONNECTION_STRING を使用する必要があります。

お使いの関数アプリで接続文字列を使用した追加のカスタマイズサポートが必要な場合。
カスタムエンドポイントを必要とするソブリンクラウドで Application Insights インスタンスが実行されている場合。

詳細については、接続文字列に関するページを参照してください。

Key	値の例
APPLICATIONINSIGHTS_CONNECTION_STRING	`InstrumentationKey=...`

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

既定では、Functions プロキシは、ショートカットを使用して、同じ関数アプリ内の関数にプロキシから直接 API 呼び出しを送信します。このショートカットは、新しい HTTP 要求を作成する代わりに使用されます。この設定を使用すると、そのショートカット動作を無効にすることができます。

Key	値	説明
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	`true`	ローカル関数アプリ内の関数を指すバックエンド URL を使用した呼び出しは、その関数に直接送信されません。代わりに、要求は、関数アプリの HTTP フロントエンドに戻されます。
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	`false`	ローカル関数アプリ内の関数を指すバックエンド URL を使用した呼び出しは、その関数に直接転送されます。これが既定値です。

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

この設定は、文字 %2F がバックエンド URL に挿入されたときにこれをルートパラメーターでスラッシュとしてデコードするかどうかを制御します。

Key	値	説明
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	`true`	エンコードされたスラッシュを含むルートパラメーターがデコードされます。
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	`false`	すべてのルートパラメーターは変更されずに渡されます。これは既定の動作です。

たとえば、myfunction.com ドメインの関数アプリ用の proxies.json ファイルを考えてみます。

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES が true に設定されている場合、URL example.com/api%2ftest は example.com/api/test に解決されます。既定では、URL は example.com/test%2fapi のまま変更されません。詳細については、Functions プロキシに関するページを参照してください。

AZURE_FUNCTIONS_ENVIRONMENT

Functions ランタイムのバージョン 2.x 以降では、ランタイム環境に基づいてアプリの動作を構成します。この値は初期化時に読み取られ、任意の値に設定できます。ランタイムによって受け入れられるのは、Development、Staging、および Production の値のみです。 Azure での実行時にこのアプリケーション設定が存在しない場合、環境は Production と見なされます。 Azure のランタイム環境を Production 以外のものに変更する必要がある場合は、ASPNETCORE_ENVIRONMENT の代わりにこの設定を使用します。ローカルコンピューターで実行している場合は、Azure Functions Core Tools により AZURE_FUNCTIONS_ENVIRONMENT が Development に設定されます。local.settings.json ファイルでこれをオーバーライドすることはできません。詳細については、「環境別の起動のクラスとメソッド」を参照してください。

AzureFunctionsJobHost__*

Functions ランタイムのバージョン 2.x 以降では、現在の環境の host.json 設定をアプリケーション設定でオーバーライドできます。これらのオーバーライドは、AzureFunctionsJobHost__path__to__setting という名前のアプリケーション設定として表されます。詳細については、「host.json 値をオーバーライドする」を参照してください。

AzureFunctionsWebHost__hostid

特定の関数アプリのホスト ID を設定します。これは、一意の ID にする必要があります。この設定は、自動的に生成された、アプリのホスト ID 値をオーバーライドします。この設定は、同じストレージアカウントを共有する関数アプリ間でホスト ID の競合を防ぐ必要がある場合にのみ使用します。

ホスト ID は、1 から 32 文字で、小文字、数字、ダッシュのみを含み、先頭または末尾がダッシュではなく、連続するダッシュを含まないようにする必要があります。 ID を生成する簡単な方法は、GUID を取得し、ダッシュを除外し、小文字化することです。たとえば、GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 を値 1835d7b55c984790815d072cc94c6f71 に変換します。

Key	値の例
AzureFunctionsWebHost__hostid	`myuniquefunctionappname123456789`

詳細については、「ホスト ID に関する考慮事項」を参照してください。

AzureWebJobsDashboard

ログの保存と、それらをポータルの [モニター] タブに表示する、オプションのストレージアカウントの接続文字列です。この設定は、Azure Functions ランタイムのバージョン 1.x を対象とするアプリに対してのみ有効です。このストレージアカウントは、blob、キュー、およびテーブルをサポートする汎用的なものである必要があります。詳しくは、「ストレージアカウントの要件」をご覧ください。

Key	値の例
AzureWebJobsDashboard	`DefaultEndpointsProtocol=https;AccountName=...`

注意

より良いパフォーマンスとエクスペリエンスのために、ランタイムのバージョン 2.x 以降では、AzureWebJobsDashboard ではなく APPINSIGHTS_INSTRUMENTATIONKEY と App Insights を使用します。

AzureWebJobsDisableHomepage

true は、関数アプリのルート URL 用に表示される既定のランディングページを無効にすることを意味します。既定値は false です。

Key	値の例
AzureWebJobsDisableHomepage	`true`

このアプリ設定を省略するか、false に設定した場合、URL <functionappname>.azurewebsites.net の応答に対し、次の例のようなものが表示されます。

関数アプリのランディングページ

AzureWebJobsDotNetReleaseCompilation

true は、.NET コードのコンパイルにリリースモードを使用することを意味し、false は、デバッグモードを使用することを意味します。既定値は true です。

Key	値の例
AzureWebJobsDotNetReleaseCompilation	`true`

AzureWebJobsFeatureFlags

有効にするベータ機能のコンマ区切りの一覧です。これらのフラグで有効となるベータ機能は本番には適しませんが、公開前の実験的な使用には有効にすることができます。

Key	値の例
AzureWebJobsFeatureFlags	`feature1,feature2,EnableProxies`

この一覧に EnableProxies を追加すると、Azure API Management への移行を計画中に Functions ランタイムのバージョン 4.x でプロキシを再有効化することができます。詳細については、「Functions v4.x でプロキシを再度有効にする」を参照してください。

AzureWebJobsKubernetesSecretName

キーを格納するために使用される Kubernetes Secrets リソースを示します。 Kubernetes での実行時にのみサポートされます。 AzureWebJobsSecretStorageType を kubernetes に設定する必要があります。 AzureWebJobsKubernetesSecretName が設定されていない場合、リポジトリは読み取り専用と見なされます。この場合は、デプロイの前に値を生成する必要があります。 Kubernetes にデプロイすると、Azure Functions Core Tools によって値が自動的に生成されます。

Key	値の例
AzureWebJobsKubernetesSecretName	`<SECRETS_RESOURCE>`

詳細については、「シークレットリポジトリ」を参照してください。

AzureWebJobsSecretStorageKeyVaultClientId

キーが格納されているコンテナーへのアクセスに使用するユーザー割り当てマネージド ID またはアプリ登録のクライアント ID。 AzureWebJobsSecretStorageType を keyvault に設定する必要があります。バージョン 4.x 以降のバージョンの Functions ランタイムでサポートされています。

Key	値の例
AzureWebJobsSecretStorageKeyVaultClientId	`<CLIENT_ID>`

詳細については、「シークレットリポジトリ」を参照してください。

AzureWebJobsSecretStorageKeyVaultClientSecret

キーが格納されているコンテナーへのアクセスに使用するユーザー割り当てマネージド ID またはアプリ登録のクライアント ID のシークレット。 AzureWebJobsSecretStorageType を keyvault に設定する必要があります。バージョン 4.x 以降のバージョンの Functions ランタイムでサポートされています。

Key	値の例
AzureWebJobsSecretStorageKeyVaultClientSecret	`<CLIENT_SECRET>`

詳細については、「シークレットリポジトリ」を参照してください。

AzureWebJobsSecretStorageKeyVaultName

キーを格納するために使用されるキーコンテナーインスタンスの名前。この設定は、Functions ランタイムのバージョン 3.x でのみサポートされています。バージョン 4.x の場合は、代わりに AzureWebJobsSecretStorageKeyVaultUri を使用します。 AzureWebJobsSecretStorageType を keyvault に設定する必要があります。

コンテナーには、ホスティングリソースのシステム割り当てマネージド ID に対応するアクセスポリシーが必要です。アクセスポリシーでは、Get、Set、List、Delete というシークレットのアクセス許可を、その ID に付与することを必要としています。
ローカルで実行している場合は、開発者 ID が使用され、設定は local.settings.json file に含まれている必要があります。

Key	値の例
AzureWebJobsSecretStorageKeyVaultName	`<VAULT_NAME>`

詳細については、「シークレットリポジトリ」を参照してください。

AzureWebJobsSecretStorageKeyVaultTenantId

キーが格納されているコンテナーへのアクセスに使用されるアプリ登録のテナント ID。 AzureWebJobsSecretStorageType を keyvault に設定する必要があります。バージョン 4.x 以降のバージョンの Functions ランタイムでサポートされています。詳細については、「シークレットリポジトリ」を参照してください。

Key	値の例
AzureWebJobsSecretStorageKeyVaultTenantId	`<TENANT_ID>`

AzureWebJobsSecretStorageKeyVaultUri

キーを格納するために使用されるキーコンテナーインスタンスのURI。バージョン 4.x 以降のバージョンの Functions ランタイムでサポートされています。キーの格納にキーコンテナーインスタンスを使用する場合は、この設定をお勧めします。 AzureWebJobsSecretStorageType を keyvault に設定する必要があります。

AzureWebJobsSecretStorageKeyVaultUri の値は、https:// を含む、[Key Vault overview](Key Vault の概要) タブに表示されている、[Vault URI](コンテナー URI) の完全な値である必要があります。

Key	値の例
AzureWebJobsSecretStorageKeyVaultUri	`https://<VAULT_NAME>.vault.azure.net`

詳細については、「Azure Functions の Key Vault 参照を使用する」を参照してください。

AzureWebJobsSecretStorageSas

キーの格納に使用される 2番目のストレージアカウントの Blob Storage SAS URL。既定では、Functions は AzureWebJobsStorage に設定されたアカウントを使用します。このシークレットストレージオプションを使用する場合は、AzureWebJobsSecretStorageType が明示的に設定されていないこと、または、blob に設定されていることを確認してください。詳細については、「シークレットリポジトリ」を参照してください。

Key	値の例
AzureWebJobsSecretStorageSas	`<BLOB_SAS_URL>`

AzureWebJobsSecretStorageType

キーの保存に使用するリポジトリまたはプロバイダーを指定します。キーは、常に関数アプリに固有のシークレットを使用して、格納される前に暗号化されます。

キー	Value	説明
AzureWebJobsSecretStorageType	`blob`	キーは、`AzureWebJobsStorage` 設定によって指定されたアカウントの Blob Storage コンテナーに格納されます。これは、`AzureWebJobsSecretStorageType` が設定されていない場合の既定の動作です。別のストレージアカウントを指定するには、`AzureWebJobsSecretStorageSas` 設定を使用して、2 番目のストレージアカウントの SAS URL を指定します。
AzureWebJobsSecretStorageType	`files`	キーは、ファイルシステムに保存されます。これは、Functions v1. x の既定値です。
AzureWebJobsSecretStorageType	`keyvault`	キーは、`AzureWebJobsSecretStorageKeyVaultName` によって設定されるキーコンテナーインスタンスに格納されます。
Kubernetes シークレット	`kubernetes`	Kubernetes で Functions ランタイムを実行する場合にのみサポートされます。 `AzureWebJobsKubernetesSecretName` が設定されていない場合、リポジトリは読み取り専用と見なされます。この場合は、デプロイの前に値を生成する必要があります。 Kubernetes にデプロイすると、Azure Functions Core Tools によって値が自動的に生成されます。

詳細については、「シークレットリポジトリ」を参照してください。

AzureWebJobsStorage

Azure Functions ランタイムでは、このストレージアカウント接続文字列は通常の操作に使用されます。このストレージアカウントの使用方法としては、キー管理、タイマートリガー管理、Event Hubs チェックポイントなどがあります。このストレージアカウントは、blob、キュー、およびテーブルをサポートする汎用的なものである必要があります。「ストレージアカウント」および「ストレージアカウントの要件」を参照してください。

Key	値の例
AzureWebJobsStorage	`DefaultEndpointsProtocol=https;AccountName=...`

AzureWebJobs_TypeScriptPath

Typescript で使用されるコンパイラへのパスです。必要に応じて、既定値はオーバーライドできます。

Key	値の例
AzureWebJobs_TypeScriptPath	`%HOME%\typescript`

DOCKER_SHM_SIZE

Python ワーカーが共有メモリを使用している場合の共有メモリのサイズ (バイト単位) を設定します。詳細については、「共有メモリ」を参照してください。

Key	値の例
DOCKER_SHM_SIZE	`268435456`

上記の値は、最大 256 MB の共有メモリサイズを設定します。

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED はに設定する必要があります。

FUNCTION_APP_EDIT_MODE

Azure portal での編集が有効になっているかどうかを決定します。有効な値は "readwrite" および "readonly" です。

Key	値の例
FUNCTION_APP_EDIT_MODE	`readonly`

FUNCTIONS_EXTENSION_VERSION

関数アプリをホストする Functions ランタイムのバージョンです。メジャーバージョンのチルダ (~) は、そのメジャーバージョンの最新バージョンを使用することを意味します (例: "~3")。同じメジャーバージョンの新しいバージョンが使用できる場合、それらは関数アプリに自動的にインストールされています。特定のバージョンにアプリを固定するには、完全なバージョン番号 (例: "3.0.12345") を使用します。既定値は "~3" です。 ~1 の値は、アプリをバージョン 1.x のランタイムに固定します。詳細については、「Azure Functions ランタイムバージョンをターゲットにする方法」をご覧ください。値が ~4 の場合、.NET 6.0 をサポートするランタイムのバージョン 4.x でアプリが実行されます。

Key	値の例
FUNCTIONS_EXTENSION_VERSION	`~4`

次のランタイムのメジャーバージョン値がサポートされています。

値	ランタイムターゲット	解説
`~4`	4.x	推奨
`~3`	3.x	サポート終了 2022 年 12 月 13 日
`~2`	2.x	サポートされなくなった
`~1`	1.x	サポートされています

FUNCTIONS_V2_COMPATIBILITY_MODE

この設定により、関数アプリはバージョン 3.x ランタイムでバージョン 2.x 互換モードで実行できるようになります。この設定は、関数アプリをランタイムのバージョン 2.x から 3.x にアップグレードした後で問題が発生した場合にのみ使用してください。

重要

この設定は、アプリケーションをバージョン 3.x で正常に動作するように更新するときに、短期的な回避策としてのみ使用することを目的としています。 2.x ランタイムがサポートされている限り、この設定はサポートされます。この設定を使用せずにバージョン 3.x でアプリを実行できない問題が発生した場合は、問題を報告してください。

FUNCTIONS_EXTENSION_VERSION はに設定する必要があります。

Key	値の例
FUNCTIONS_V2_COMPATIBILITY_MODE	`true`

FUNCTIONS_WORKER_PROCESS_COUNT

言語ワーカープロセスの最大数を指定します。既定値は 1 です。許容される最大値は 10 です。関数呼び出しは、言語ワーカープロセス間で均等に分散されます。言語ワーカープロセスは、WORKER_PROCESS_COUNT によって設定されたカウントに達するまで、10 秒ごとに生成されます。複数の言語ワーカープロセスの使用は、スケーリングと同じではありません。 CPU にバインドされた呼び出しと I/O にバインドされた呼び出しがワークロードに混在している場合は、この設定を使用することを検討してください。この設定は、プロセス (dotnet) で実行されている .NET を除くすべての言語ランタイムに適用されます。

Key	値の例
FUNCTIONS_WORKER_PROCESS_COUNT	`2`

FUNCTIONS_WORKER_RUNTIME

ワーカーランタイムが関数アプリに読み込む言語。これは、アプリケーションで使用されている言語に対応します (たとえば、dotnet)。 Azure Functions Runtime のバージョン 2.x 以降では、特定の関数アプリでサポートできる言語は 1 つだけです。

Key	値の例
FUNCTIONS_WORKER_RUNTIME	`node`

有効な値:

値	言語
`dotnet`	C# (クラスライブラリ) C# (スクリプト)
`dotnet-isolated`	C# (分離ワーカープロセス)
`java`	Java
`node`	JavaScript TypeScript
`powershell`	PowerShell
`python`	Python

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

この設定を使用すると、Python ワーカーが共有メモリを使用してスループットを向上できます。 Python 関数アプリがメモリのボトルネックに達すると、共有メモリが有効になります。

Key	値の例
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED	`1`

この設定を有効にした場合、DOCKER_SHM_SIZE の設定を使用して共有メモリサイズを設定できます。詳細については、「共有メモリ」を参照してください。

MDMaxBackgroundUpgradePeriod

PowerShell 関数アプリの管理対象の依存関係のバックグラウンド更新期間を制御します。既定値は 7.00:00:00 (毎週) です。

各 PowerShell ワーカープロセスは、そのプロセスの開始時に PowerShell ギャラリーでモジュールのアップグレードのチェックを開始し、その後は MDMaxBackgroundUpgradePeriod ごとにチェックします。 PowerShell ギャラリーで利用可能になった新しいモジュールバージョンは、ファイルシステムにインストールされ、PowerShell ワーカーが使用できるになります。この値を小さくすると、関数アプリは新しいモジュールバージョンを早く取得できますが、アプリリソースの使用量 (ネットワーク I/O、CPU、ストレージ) も増加します。この値を大きくすると、アプリリソースの使用量は減少しますが、アプリへの新しいモジュールバージョンの配信が遅れる可能性があります。

Key	値の例
MDMaxBackgroundUpgradePeriod	`7.00:00:00`

詳細については、「依存関係の管理」を参照してください。

MDNewSnapshotCheckPeriod

管理対象の依存関係のアップグレードがインストールされているかどうかを各 PowerShell ワーカーが確認する頻度を指定します。既定の頻度は 01:00:00 (毎時) です。

新しいモジュールバージョンがファイルシステムにインストールされたら、すべての PowerShell ワーカープロセスを再起動する必要があります。 PowerShell ワーカーを再起動すると、現在の関数の実行が中断される可能性があるため、アプリの可用性がその影響を受けます。すべての PowerShell ワーカープロセスが再起動されるまで、関数呼び出しでは、前のモジュールバージョンまたは新しいモジュールバージョンのいずれかが使用される可能性があります。すべての PowerShell ワーカーの再起動は MDNewSnapshotCheckPeriod 以内に完了します。

各 MDNewSnapshotCheckPeriod 内で、PowerShell ワーカーにより、管理対象の依存関係のアップグレードがインストールされているかどうかが確認されます。アップグレードがインストールされると、再起動が開始されます。この値を大きくすると、再起動による中断の頻度は減少します。ただし、大きくすることにより、関数呼び出しで古いまたは新しいモジュールバージョンが非決定的に使用される可能性がある期間が長くなる恐れもあります。

Key	値の例
MDNewSnapshotCheckPeriod	`01:00:00`

詳細については、「依存関係の管理」を参照してください。

MDMinBackgroundUpgradePeriod

管理対象の依存関係のアップグレードに関する前回のチェックの後、別のアップグレードチェックが開始されるまでの期間。既定値は 1.00:00:00 (毎日) です。

ワーカーの頻繁な再起動によってモジュールのアップグレードが過剰にならないように、任意のワーカーで直近 MDMinBackgroundUpgradePeriod 以内にモジュールのアップグレード確認が開始されているときは、その確認は行われません。

Key	値の例
MDMinBackgroundUpgradePeriod	`1.00:00:00`

詳細については、「依存関係の管理」を参照してください。

PIP_INDEX_URL

この設定を使用すると、Python Package Index のベース URL (既定では https://pypi.org/simple) をオーバーライドできます。この設定は、PEP 503 (単純なリポジトリ API) に準拠しているパッケージインデックスリポジトリにある、または同じ形式に従うローカルディレクトリにあるカスタム依存関係を使用してリモートビルドを実行する必要がある場合に使用します。

Key	値の例
PIP_INDEX_URL	`http://my.custom.package.repo/simple`

詳細は、--index-url については pip ドキュメントを、カスタム依存関係の使用については Python 開発者リファレンスを参照してください。

PIP_EXTRA_INDEX_URL

この設定の値は、--index-url に加えて使用する、Python アプリのカスタムパッケージの追加のインデックス URL を示します。この設定は、追加のパッケージインデックスにあるカスタム依存関係を使用してリモートビルドを実行する必要がある場合に使用します。 --index-url と同じ規則に従う必要があります。

Key	値の例
PIP_EXTRA_INDEX_URL	`http://my.custom.package.repo/simple`

詳細は、--extra-index-url については pip ドキュメントを、カスタム依存関係については Python 開発者リファレンスを参照してください。

PYTHON_ISOLATE_WORKER_DEPENDENCIES (プレビュー)

この構成は Python 関数アプリに固有です。モジュール読み込み順序の優先順位を定義します。 Python 関数アプリでモジュール競合に関する問題が生じたとき (protobuf、tensorflow、grpcio をプロジェクトで使用しているときなど)、このアプリ設定を 1 に構成すると問題が解決します。既定では、この値は 0 に設定されます。このフラグは現在プレビューの段階です。

キー	値	説明
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`0`	Python ライブラリを内部 Python ワーカーの依存関係から読み込むことを優先します。 requirements.txt で定義されているサードパーティライブラリはシャドウされる場合があります。
PYTHON_ISOLATE_WORKER_DEPENDENCIES	`1`	Python ライブラリを requirements.txt で定義されているアプリケーションのパッケージから読み込むことを優先します。これにより、ライブラリが内部 Python ワーカーのライブラリと衝突することがなくなります。

PYTHON_ENABLE_DEBUG_LOGGING

Python 関数アプリでデバッグレベルのログ記録を有効にします。 1 の値を指定すると、デバッグレベルのログ記録が有効になります。この設定がないか、値が 0 である場合、情報以上のレベルのログのみが Python ワーカーから Functions ホストに送信されます。この設定は、Python 関数の実行をデバッグまたはトレースするときに使用します。

Python 関数をデバッグするとき、必要に応じて、host.json ファイルでデバッグまたはトレースログレベルも設定してください。詳しくは、Azure Functions で監視を構成する方法に関するページを参照してください。

PYTHON_ENABLE_WORKER_EXTENSIONS

この構成は Python 関数アプリに固有です。これを 1 に設定することで、ワーカーは requirements.txt で定義されている 1で読み込みが可能になります。これにより、関数アプリはサードパーティ製パッケージによって提供される新機能にアクセスできます。また、アプリでの関数の読み込みと呼び出しの動作が変更される場合もあります。選択する拡張機能は、それを使用するリスクが生じるので、信頼できるものであることを確認してください。 Azure Functions は、あらゆる拡張機能に対して明示的な保証をしません。拡張機能の使い方については、拡張機能のマニュアルページまたは readme ドキュメントを参照してください。既定では、この値は 0 に設定されます。

キー	値	説明
PYTHON_ENABLE_WORKER_EXTENSIONS	`0`	Python ワーカー拡張機能を無効にします。
PYTHON_ENABLE_WORKER_EXTENSIONS	`1`	Python ワーカーが requirements.txt から拡張機能を読み込めるようにします。

PYTHON_THREADPOOL_THREAD_COUNT

関数呼び出しを実行するために Python 言語ワーカーによって使用されるスレッドの最大数を指定します。Python バージョン 3.8 以前では、既定値 1 を使用します。 Python バージョン 3.9 以降では、値は None に設定されます。この設定は、実行中に設定されるスレッドの数を保証するものではないことに注意してください。この設定により、Python では、スレッドの数を指定された値に増やすことができます。この設定は、Python 関数アプリにのみ適用されます。また、この設定は、コルーチンではなく、同期関数の呼び出しに適用されます。

Key	値の例	最大値
PYTHON_THREADPOOL_THREAD_COUNT	2	32

SCALE_CONTROLLER_LOGGING_ENABLED

"この設定は現在プレビューの段階です。 "

この設定は、Azure Functions スケールコントローラーからのログ記録を制御します。詳細については、スケールコントローラーのログに関するセクションを参照してください。

Key	値の例
SCALE_CONTROLLER_LOGGING_ENABLED	`AppInsights:Verbose`

このキーの値は <DESTINATION>:<VERBOSITY> の形式で指定されます。これは次のように定義されます。

プロパティ説明

<DESTINATION> ログの送信先。有効な値は AppInsights と Blob です。
AppInsights を使用する場合は、関数アプリで Application Insights が有効になっていることを確認してください。
宛先を Blob に設定すると、AzureWebJobsStorage アプリケーション設定で設定されている既定のストレージアカウントの azure-functions-scale-controller という名前の BLOB コンテナーにログが作成されます。

<VERBOSITY> ログ記録のレベルを指定します。サポートされている値は、None、Warning、および Verbose です。
Verbose に設定すると、スケールコントローラーは、すべてのワーカー数の変更の理由と、それらの決定の要因となるトリガーに関する情報をログに記録します。詳細ログには、トリガー警告と、スケールコントローラーの実行前と実行後にトリガーによって使用されたハッシュが含まれます。

プロパティ	説明
`<DESTINATION>`	ログの送信先。有効な値は `AppInsights` と `Blob` です。 `AppInsights` を使用する場合は、関数アプリで Application Insights が有効になっていることを確認してください。宛先を `Blob` に設定すると、`AzureWebJobsStorage` アプリケーション設定で設定されている既定のストレージアカウントの `azure-functions-scale-controller` という名前の BLOB コンテナーにログが作成されます。
`<VERBOSITY>`	ログ記録のレベルを指定します。サポートされている値は、`None`、`Warning`、および `Verbose` です。 `Verbose` に設定すると、スケールコントローラーは、すべてのワーカー数の変更の理由と、それらの決定の要因となるトリガーに関する情報をログに記録します。詳細ログには、トリガー警告と、スケールコントローラーの実行前と実行後にトリガーによって使用されたハッシュが含まれます。

ヒント

スケールコントローラーのログを有効にしたままにすると、関数アプリの監視にかかるかもしれないコストに影響することに注意してください。スケールコントローラーの動作を理解するのに十分なデータを収集するまでログ記録を有効にし、その後は無効にすることを検討してください。

SCM_LOGSTREAM_TIMEOUT

ストリーミングログに接続されているときのタイムアウトを秒単位で制御します。既定値は 7,200 (2 時間) です。

Key	値の例
SCM_LOGSTREAM_TIMEOUT	`1800`

上記のサンプル値 1800 では、タイムアウトが 30 分に設定されます。詳細については、「ストリーミングログを有効にする」を参照してください。

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

イベントドリブンスケーリングプランに関数アプリのコードと構成が格納されているストレージアカウントの接続文字列です。詳細については、「Function App を作成する」を参照してください。

Key	値の例
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	`DefaultEndpointsProtocol=https;AccountName=...`

この設定は、Windows と Linux の両方で従量課金と Premiun のプランのアプリに必須です。 Functions によって動的にスケーリングされない Dedicated プランのアプリには必須ではありません。

この設定を変更または削除すると、関数アプリが起動しなくなることがあります。詳細については、こちらのトラブルシューティング記事を参照してください。

WEBSITE_CONTENTOVERVNET

1 の値を指定すると、ストレージアカウントを仮想ネットワークに制限している場合に、関数アプリをスケーリングできます。ストレージアカウントを仮想ネットワークに制限する場合は、この設定を有効にする必要があります。詳細については、「ストレージアカウントを仮想ネットワークに制限する」を参照してください。

Key	値の例
WEBSITE_CONTENTOVERVNET	`1`

Premium および Dedicated (App Service) プラン (Standard 以上) でサポートされています。従量課金プランで実行している場合はサポートされません。

WEBSITE_CONTENTSHARE

イベントドリブンスケーリングプラン内の関数アプリコードと構成へのファイルパス。 WEBSITE_CONTENTAZUREFILECONNECTIONSTRING と共に使用されます。既定は、関数アプリ名で始まる、ランタイムによって生成される一意文字列です。「Function App を作成する」を参照してください。

Key	値の例
WEBSITE_CONTENTSHARE	`functionapp091999e2`

この設定は、Windows と Linux の両方で従量課金と Premium のプランのアプリに必須です。 Functions によって動的にスケーリングされない Dedicated プランのアプリには必須ではありません。

デプロイ時に Azure Resource Manager (ARM) テンプレートを使用して関数アプリを作成する場合は、次の考慮事項が適用されます。

メインの関数アプリまたはスロット内の任意のアプリに WEBSITE_CONTENTSHARE 値を設定しない場合、一意の共有値が自動的に生成されます。これは、ARM テンプレートのデプロイでお勧めしている方法です。
WEBSITE_CONTENTSHARE 値を事前定義の共有に設定する必要があるシナリオが存在します。たとえば、セキュリティで保護されたストレージアカウントを仮想ネットワークで使用する場合などです。この場合、メインの関数アプリと各デプロイスロットのアプリに一意の共有名を設定する必要があります。
WEBSITE_CONTENTSHARE はスロット設定にしないでください。
WEBSITE_CONTENTSHARE を指定する場合、値は共有名に関するこちらのガイダンスに従っている必要があります。

詳細については、関数アプリのリソースデプロイを自動化する方法に関するページを参照してください。

WEBSITE_DNS_SERVER

IP アドレスの解決時にアプリによって使用される DNS サーバーを設定します。この設定は、Azure DNS Private Zones やプライベートエンドポイントなど、特定のネットワーク機能を使用する場合に必要になることがよくあります。

Key	値の例
WEBSITE_DNS_SERVER	`168.63.129.16`

WEBSITE_ENABLE_BROTLI_ENCODING

圧縮のために既定の gzip 圧縮ではなく、Brotli エンコーディングが使用されるかどうかを制御します。 WEBSITE_ENABLE_BROTLI_ENCODING が 1 に設定されている場合は Brotli エンコーディングが使用され、それ以外の場合は gzip エンコーディングが使用されます。

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

アプリがスケールアウトできる最大のインスタンス数です。既定は無制限です。

重要

この設定は、プレビューの段階です。スケールアウトの制限に推奨される、関数で最大にスケールアウトするためのアプリプロパティが追加されています。

Key	値の例
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	`5`

WEBSITE_NODE_DEFAULT_VERSION

Windows のみ。 Windows で関数アプリを実行するときに使用する Node.js のバージョンを設定します。チルダ (~) を使用して、ランタイムがターゲットメジャーバージョンの利用可能な最新バージョンを使用するようにする必要があります。たとえば、~10 に設定すると、最新バージョンの Node.js 10 が使用されます。メジャーバージョンがチルダ付きで対象になっている場合は、マイナーバージョンを手動で更新する必要はありません。

Key	値の例
WEBSITE_NODE_DEFAULT_VERSION	`~10`

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

既定では、関数アプリのバージョン設定は各スロットに固有です。この設定は、デプロイスロットを使用して関数をアップグレードするときに使用されます。これにより、スワップ後にバージョンが変更されるために発生する予期しない動作を防ぐことができます。運用環境とスロットで 0 に設定して、すべてのバージョン設定もスワップされるようにします。詳細については、「スロットを使用したアップグレード」を参照してください。

Key	値の例
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	`0`

WEBSITE_RUN_FROM_PACKAGE

マウントされたパッケージファイルから関数アプリを実行できるようにします。

Key	値の例
WEBSITE_RUN_FROM_PACKAGE	`1`

有効な値は、展開パッケージファイルの場所に解決される URL、または 1 です。 1 に設定した場合、パッケージは d:\home\data\SitePackages フォルダーに存在する必要があります。この設定で zip デプロイを使用すると、パッケージは自動的にこの場所にアップロードされます。プレビューでは、この設定は WEBSITE_RUN_FROM_ZIP という名前でした。詳細については、パッケージファイルからの関数の実行に関するページを参照してください。

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING と WEBSITE_CONTENTSHARE 設定には、アプリを適切に起動できることを確認する追加の検証チェックがあります。ネットワーク制約やその他の制限要因により、関数アプリがダウンストリームのストレージアカウントまたは Key Vault を適切に呼び出せない場合、アプリケーション設定の作成は失敗します。 WEBSITE_SKIP_CONTENTSHARE_VALIDATION が 1 に設定されている場合、検証チェックはスキップされます。それ以外の場合、値は既定の 0 になり、検証が実行されます。

Key	値の例
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	`1`

検証がスキップされ、なおかつ接続文字列またはコンテンツ共有が無効である場合、アプリは正常に開始できず、HTTP 500 エラーのみを処理します。

WEBSITE_SLOT_NAME

読み取り専用です。現在のデプロイスロットの名前。運用スロットの名前は Production です。

Key	値の例
WEBSITE_SLOT_NAME	`Production`

WEBSITE_TIME_ZONE

関数アプリのタイムゾーンを設定できます。

Key	OS	値の例
WEBSITE_TIME_ZONE	Windows	`Eastern Standard Time`
WEBSITE_TIME_ZONE	Linux	`America/New_York`

CRON 式で使用する既定のタイムゾーンは、協定世界時 (UTC) です。別のタイムゾーンに基づく CRON 式を使うには、Function App 用に WEBSITE_TIME_ZONE という名前のアプリ設定を作成します。

この設定の値は、関数アプリを実行するオペレーティングシステムとプランによって異なります。

オペレーティングシステム	プラン	値
Windows	All	Windows コマンド `tzutil.exe /L` によって指定された各ペアの 2 行目に指定されているように、この値を目的のタイムゾーンの名前に設定します。
Linux	Premium 専用	この値を、tz データベースに関するページに示されている目的のタイムゾーンの名前に設定します。

Note

Linux 従量課金プランでは、現在 WEBSITE_TIME_ZONE はサポートされていません。

たとえば、米国の東部標準時 (Eastern Standard Time (Windows) または America/New_York (Linux)) では現在、標準時では UTC-05:00、夏時間では UTC-04:00 を使用します。タイマートリガーが毎日東部標準時の午前 10 時に発生するように設定するには、関数アプリのアプリ設定を WEBSITE_TIME_ZONE という名前で作成し、その値を Eastern Standard Time (Windows) または America/New_York (Linux) に設定して、次の NCRONTAB 式を使用します。

"0 0 10 * * *"

WEBSITE_TIME_ZONE を使用すると、夏時間などの特定のタイムゾーンでの時間変更や標準時での変更に対応するように、時刻が調整されます。

WEBSITE_VNET_ROUTE_ALL

重要

WEBSITE_VNET_ROUTE_ALL は、vnetRouteAllEnabled configuration setting によって置換されたレガシアプリ設定です。

アプリからのすべての送信トラフィックが仮想ネットワーク経由でルーティングされるかどうかを示します。設定値が 1 の場合は、すべてのトラフィックが仮想ネットワーク経由でルーティングされることを示します。リージョンでの仮想ネットワーク統合の機能を使用する場合は、この設定が必要です。また、仮想ネットワーク NAT ゲートウェイを使用して静的な送信 IP アドレスを定義する場合にも使用されます。

Key	値の例
WEBSITE_VNET_ROUTE_ALL	`1`

App Service サイトの設定

一部の構成は、言語バージョンなど、サイト設定として App Service レベルで維持する必要があります。これらの設定は通常ポータル内で設定され、REST API を使用するか、Azure CLI または Azure PowerShell を使用して行われます。ランタイム言語、OS、バージョンに応じて必要になる可能性があるサイト設定を次に示します。

linuxFxVersion

Linux で実行されている関数アプリの場合は、linuxFxVersion は言語固有のワーカープロセスの言語とバージョンを示します。この情報は、関数アプリを実行するためにインストールされている特定の Linux コンテナーイメージを決定するために、FUNCTIONS_EXTENSION_VERSION とともに使用されます。この設定は、事前定義済みの値またはカスタムイメージ URI に設定できます。

この値は、Linux 関数アプリを作成するときに設定されます。 ARM テンプレートと Bicep のデプロイ、特定のアップグレードシナリオで設定する必要がある場合があります。

有効な linuxFxVersion 値

次の Azure CLI コマンドを使用して、サポートされている Functions ランタイムバージョン別の現在の linuxFxVersion の値の表を表示できます。

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

以前のコマンドでは、Azure CLI のバージョン 2.40 にアップグレードする必要があります。

カスタムイメージ

関数アプリ用に独自のカスタム Linux コンテナーを作成して保守する場合、linuxFxVersion 値も次の例のように DOCKER|<IMAGE_URI> の形式になります。

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

詳しくは、「カスタムコンテナーを使用して Linux で関数を作成する」をご覧ください。

重要

カスタムコンテナーを使用する場合は、コンテナーの基本イメージを、サポートされている最新の基本イメージに更新しておく必要があります。 Azure Functions でサポートされている基本イメージは言語固有であり、言語別の Azure Functions 基本イメージリポジトリにあります。

Functions チームは、これらの基本イメージの毎月の更新プログラムを公開できるよう取り組んでいます。通常の更新プログラムには、Functions ランタイムと言語の両方について、最新のマイナーバージョンの更新プログラムとセキュリティ修正プログラムが含まれます。カスタムコンテナーの場合は、Dockerfile 内の基本イメージを定期的に更新し、カスタムコンテナーの更新されたバージョンを再構築して再デプロイする必要があります。

netFrameworkVersion

C# 関数用の .NET の特定のバージョンを設定します。詳細については、「Azure で関数アプリをアップグレードする」を参照してください。

powerShellVersion

関数を実行する PowerShell の特定のバージョンを設定します。詳細については、「PowerShell のバージョンの変更」を参照してください。

ローカルで実行する場合は、代わりに local.settings.json ファイルの FUNCTIONS_WORKER_RUNTIME_VERSION 設定を使用します。

次のステップ

アプリケーション設定の更新方法

host.json ファイルの構成設定を参照する

App Service アプリの他のアプリ設定を参照する

Azure Functions のアプリケーション設定のリファレンス

APPINSIGHTS_INSTRUMENTATIONKEY

APPLICATIONINSIGHTS_CONNECTION_STRING

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

AZURE_FUNCTIONS_ENVIRONMENT

AzureFunctionsJobHost__*

AzureFunctionsWebHost__hostid

AzureWebJobsDashboard

AzureWebJobsDisableHomepage

AzureWebJobsDotNetReleaseCompilation

AzureWebJobsFeatureFlags

AzureWebJobsKubernetesSecretName

AzureWebJobsSecretStorageKeyVaultClientId

AzureWebJobsSecretStorageKeyVaultClientSecret

AzureWebJobsSecretStorageKeyVaultName

AzureWebJobsSecretStorageKeyVaultTenantId

AzureWebJobsSecretStorageKeyVaultUri

AzureWebJobsSecretStorageSas

AzureWebJobsSecretStorageType

AzureWebJobsStorage

AzureWebJobs_TypeScriptPath

DOCKER_SHM_SIZE

FUNCTION_APP_EDIT_MODE

FUNCTIONS_EXTENSION_VERSION

FUNCTIONS_V2_COMPATIBILITY_MODE

FUNCTIONS_WORKER_PROCESS_COUNT

FUNCTIONS_WORKER_RUNTIME

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

MDMaxBackgroundUpgradePeriod

MDNewSnapshotCheckPeriod

MDMinBackgroundUpgradePeriod

PIP_INDEX_URL

PIP_EXTRA_INDEX_URL

PYTHON_ISOLATE_WORKER_DEPENDENCIES (プレビュー)

PYTHON_ENABLE_DEBUG_LOGGING

PYTHON_ENABLE_WORKER_EXTENSIONS

PYTHON_THREADPOOL_THREAD_COUNT

SCALE_CONTROLLER_LOGGING_ENABLED

SCM_LOGSTREAM_TIMEOUT

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

WEBSITE_CONTENTOVERVNET

WEBSITE_CONTENTSHARE

WEBSITE_DNS_SERVER

WEBSITE_ENABLE_BROTLI_ENCODING

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

WEBSITE_NODE_DEFAULT_VERSION

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

WEBSITE_RUN_FROM_PACKAGE

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

WEBSITE_SLOT_NAME

WEBSITE_TIME_ZONE

WEBSITE_VNET_ROUTE_ALL

App Service サイトの設定

linuxFxVersion

有効な linuxFxVersion 値

カスタム イメージ

netFrameworkVersion

powerShellVersion

次のステップ

その他のリソース

その他のリソース

カスタムイメージ