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

関数アプリのアプリケーション設定には、その関数アプリのすべての関数に影響するグローバル構成オプションが含まれています。App settings in a function app contain global configuration options that affect all functions for that function app. ローカルで実行する場合、これらの設定は、ローカルの環境変数としてアクセスされます。When you run locally, these settings are accessed as local environment variables. この記事では、関数アプリで使用できるアプリケーション設定の一覧を紹介します。This article lists the app settings that are available in function apps.

関数アプリの設定は、いくつかの方法で追加、更新、削除できます。There are several ways that you can add, update, and delete function app settings:

host.json ファイルと local.settings.json ファイルには、他のグローバル構成オプションもあります。There are other global configuration options in the host.json file and in the local.settings.json file.

APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY

Application Insights を使用している場合の Application Insights インストルメンテーション キーです。The Application Insights instrumentation key if you're using Application Insights. Azure Functions を監視する」を参照してください。See Monitor Azure Functions.

キーKey 値の例Sample value
APPINSIGHTS_INSTRUMENTATIONKEYAPPINSIGHTS_INSTRUMENTATIONKEY 5dbdd5e9-af77-484b-9032-64f83bb83bb5dbdd5e9-af77-484b-9032-64f83bb83bb

AZURE_FUNCTIONS_ENVIRONMENTAZURE_FUNCTIONS_ENVIRONMENT

Functions ランタイムのバージョン 2.x では、ランタイム環境に基づいてアプリの動作を構成します。In version 2.x of the Functions runtime, configures app behavior based on the runtime environment. この値は、初期化中に読み取られますThis value is read during initialization. AZURE_FUNCTIONS_ENVIRONMENT は任意の値に設定することができますが、次の 3 つの値がサポートされています。DevelopmentStagingProductionYou can set AZURE_FUNCTIONS_ENVIRONMENT to any value, but three values are supported: Development, Staging, and Production. AZURE_FUNCTIONS_ENVIRONMENT が設定されていない場合、既定では、ローカル環境では Development になり、Azure では Production になります。When AZURE_FUNCTIONS_ENVIRONMENT isn't set, it defaults to Development on a local environment and Production on Azure. この設定は、ランタイム環境を設定するために、ASPNETCORE_ENVIRONMENT の代わりに使用する必要があります。This setting should be used instead of ASPNETCORE_ENVIRONMENT to set the runtime environment.

AzureWebJobsDashboardAzureWebJobsDashboard

ログの保存と、それらをポータルの [モニター] タブに表示する、オプションのストレージ アカウントの接続文字列です。Optional storage account connection string for storing logs and displaying them in the Monitor tab in the portal. このストレージ アカウントは、blob、キュー、およびテーブルをサポートする汎用的なものである必要があります。The storage account must be a general-purpose one that supports blobs, queues, and tables. ストレージ アカウント」および「ストレージ アカウントの要件」を参照してください。See Storage account and Storage account requirements.

キーKey 値の例Sample value
AzureWebJobsDashboardAzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

ヒント

パフォーマンスとエクスペリエンスのために、AzureWebJobsDashboard ではなく APPINSIGHTS_INSTRUMENTATIONKEY と App Insights を使用して監視することをお勧めします。For performance and experience, it is recommended to use APPINSIGHTS_INSTRUMENTATIONKEY and App Insights for monitoring instead of AzureWebJobsDashboard

AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage

true は、関数アプリのルート URL 用に表示される既定のランディング ページを無効にすることを意味します。true means disable the default landing page that is shown for the root URL of a function app. 既定値は false です。Default is false.

キーKey 値の例Sample value
AzureWebJobsDisableHomepageAzureWebJobsDisableHomepage truetrue

このアプリ設定を省略するか、false に設定した場合、URL <functionappname>.azurewebsites.net の応答に対し、次の例のようなものが表示されます。When this app setting is omitted or set to false, a page similar to the following example is displayed in response to the URL <functionappname>.azurewebsites.net.

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

AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation

true は、.NET コードのコンパイルにリリース モードを使用することを意味し、false は、デバッグ モードを使用することを意味します。true means use Release mode when compiling .NET code; false means use Debug mode. 既定値は true です。Default is true.

キーKey 値の例Sample value
AzureWebJobsDotNetReleaseCompilationAzureWebJobsDotNetReleaseCompilation truetrue

AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags

有効にするベータ機能のコンマ区切りの一覧です。A comma-delimited list of beta features to enable. これらのフラグで有効となるベータ機能は本番には適しませんが、公開前の実験的な使用には有効にすることができます。Beta features enabled by these flags are not production ready, but can be enabled for experimental use before they go live.

キーKey 値の例Sample value
AzureWebJobsFeatureFlagsAzureWebJobsFeatureFlags feature1,feature2feature1,feature2

AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType

キーの保存に使用するリポジトリまたはプロバイダーを指定します。Specifies the repository or provider to use for key storage. 現時点でサポートされているリポジトリは、BLOB ストレージ ("Blob") およびローカル ファイル システム ("Files") です。Currently, the supported repositories are blob storage ("Blob") and the local file system ("Files"). 既定では、バージョン 2 では BLOB、バージョン 1 ではファイル システムが使用されます。The default is blob in version 2 and file system in version 1.

キーKey 値の例Sample value
AzureWebJobsSecretStorageTypeAzureWebJobsSecretStorageType ファイルFiles

AzureWebJobsStorageAzureWebJobsStorage

Azure Functions ランタイムは、HTTP によってトリガーされる関数を除くすべての関数で、このストレージ アカウントの接続文字列を使用します。The Azure Functions runtime uses this storage account connection string for all functions except for HTTP triggered functions. このストレージ アカウントは、blob、キュー、およびテーブルをサポートする汎用的なものである必要があります。The storage account must be a general-purpose one that supports blobs, queues, and tables. ストレージ アカウント」および「ストレージ アカウントの要件」を参照してください。See Storage account and Storage account requirements.

キーKey 値の例Sample value
AzureWebJobsStorageAzureWebJobsStorage DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath

Typescript で使用されるコンパイラへのパスです。Path to the compiler used for TypeScript. 必要に応じて、既定値はオーバーライドできます。Allows you to override the default if you need to.

キーKey 値の例Sample value
AzureWebJobs_TypeScriptPathAzureWebJobs_TypeScriptPath %HOME%\typescript%HOME%\typescript

FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE

Azure portal での編集が有効になっているかどうかを決定します。Dictates whether editing in the Azure portal is enabled. 有効な値は "readwrite" および "readonly" です。Valid values are "readwrite" and "readonly".

キーKey 値の例Sample value
FUNCTION_APP_EDIT_MODEFUNCTION_APP_EDIT_MODE readonlyreadonly

FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION

この関数アプリで使用する Functions ランタイムのバージョンです。The version of the Functions runtime to use in this function app. メジャー バージョンのチルダ (例: "~2") は、そのメジャー バージョンの最新バージョンを使用することを意味します。A tilde with major version means use the latest version of that major version (for example, "~2"). 同じメジャー バージョンの新しいバージョンが使用できる場合、それらは関数アプリに自動的にインストールされています。When new versions for the same major version are available, they are automatically installed in the function app. 特定のバージョンにアプリを固定するには、完全なバージョン番号 (例: "2.0.12345") を使用します。To pin the app to a specific version, use the full version number (for example, "2.0.12345"). 既定値は "~2" です。Default is "~2". ~1 の値は、アプリをバージョン 1.x のランタイムに固定します。A value of ~1 pins your app to version 1.x of the runtime.

キーKey 値の例Sample value
FUNCTIONS_EXTENSION_VERSIONFUNCTIONS_EXTENSION_VERSION ~2~2

FUNCTIONS_WORKER_PROCESS_COUNTFUNCTIONS_WORKER_PROCESS_COUNT

言語ワーカー プロセスの最大数を指定します。既定値は 1 です。Specifies the maximum number of language worker processes, with a default value of 1. 許容される最大値は 10 です。The maximum value allowed is 10. 関数呼び出しは、言語ワーカー プロセス間で均等に分散されます。Function invocations are evenly distributed among language worker processes. 言語ワーカー プロセスは、FUNCTIONS_WORKER_PROCESS_COUNT によって設定されたカウントに達するまで、10 秒ごとに生成されます。Language worker processes are spawned every 10 seconds until the count set by FUNCTIONS_WORKER_PROCESS_COUNT is reached. 複数の言語ワーカー プロセスの使用は、スケーリングと同じではありません。Using multiple language worker processes is not the same as scaling. CPU にバインドされた呼び出しと I/O にバインドされた呼び出しがワークロードに混在している場合は、この設定を使用することを検討してください。Consider using this setting when your workload has a mix of CPU-bound and I/O-bound invocations. この設定はすべての非 .NET 言語に適用されます。This setting applies to all non-.NET languages.

キーKey 値の例Sample value
FUNCTIONS_WORKER_PROCESS_COUNTFUNCTIONS_WORKER_PROCESS_COUNT 22

FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME

ワーカー ランタイムが関数アプリに読み込む言語。The language worker runtime to load in the function app. これは、アプリケーションで使用されている言語に対応します (たとえば、"dotnet")。This will correspond to the language being used in your application (for example, "dotnet"). 関数の言語が混在する場合、関数ごとに対応するワーカー ランタイム値を設定して、関数を複数のアプリに公開する必要があります。For functions in multiple languages you will need to publish them to multiple apps, each with a corresponding worker runtime value. 有効な値は、dotnet (C#/F#)、node (JavaScript/TypeScript)、java (Java)、powershell (PowerShell)、python (Python) です。Valid values are dotnet (C#/F#), node (JavaScript/TypeScript), java (Java), powershell (PowerShell), and python (Python).

キーKey 値の例Sample value
FUNCTIONS_WORKER_RUNTIMEFUNCTIONS_WORKER_RUNTIME dotnetdotnet

WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING

使用量および Premium プランのみ。For consumption & Premium plans only. 関数アプリのコードと構成が格納されているストレージ アカウントの接続文字列です。Connection string for storage account where the function app code and configuration are stored. Function App を作成する」を参照してください。See Create a function app.

キーKey 値の例Sample value
WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGWEBSITE_CONTENTAZUREFILECONNECTIONSTRING DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key]

WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE

使用量および Premium プランのみ。For consumption & Premium plans only. 関数アプリ コードと構成へのファイル パスです。The file path to the function app code and configuration. WEBSITE_CONTENTAZUREFILECONNECTIONSTRING と共に使用されます。Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. 既定は、関数アプリ名で始まる一意文字列です。Default is a unique string that begins with the function app name. Function App を作成する」を参照してください。See Create a function app.

キーKey 値の例Sample value
WEBSITE_CONTENTSHAREWEBSITE_CONTENTSHARE functionapp091999e2functionapp091999e2

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

関数アプリがスケールアウトできる最大のインスタンス数です。The maximum number of instances that the function app can scale out to. 既定は無制限です。Default is no limit.

注意

この設定は、プレビュー機能です。5 以下の値を設定した場合にのみ、信頼して使用できます。This setting is a preview feature - and only reliable if set to a value <= 5

キーKey 値の例Sample value
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUTWEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT 55

WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION

既定値は "8.11.1" です。Default is "8.11.1".

キーKey 値の例Sample value
WEBSITE_NODE_DEFAULT_VERSIONWEBSITE_NODE_DEFAULT_VERSION 8.11.18.11.1

WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE

マウントされたパッケージ ファイルから関数アプリを実行できるようにします。Enables your function app to run from a mounted package file.

キーKey 値の例Sample value
WEBSITE_RUN_FROM_PACKAGEWEBSITE_RUN_FROM_PACKAGE 11

有効な値は、展開パッケージ ファイルの場所に解決される URL、または 1 です。Valid values are either a URL that resolves to the location of a deployment package file, or 1. 1 に設定した場合、パッケージは d:\home\data\SitePackages フォルダーに存在する必要があります。When set to 1, the package must be in the d:\home\data\SitePackages folder. この設定で zip デプロイを使用すると、パッケージは自動的にこの場所にアップロードされます。When using zip deployment with this setting, the package is automatically uploaded to this location. プレビューでは、この設定は WEBSITE_RUN_FROM_ZIP という名前でした。In preview, this setting was named WEBSITE_RUN_FROM_ZIP. 詳細については、パッケージ ファイルからの関数の実行に関するページを参照してください。For more information, see Run your functions from a package file.

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

既定では、Functions プロキシは新しい HTTP 要求を作成するのではなく、同じ Function App 内の関数にプロキシから直接 API 呼び出しを送信するためのショートカットを使用します。By default Functions proxies will utilize a shortcut to send API calls from proxies directly to functions in the same Function App, rather than creating a new HTTP request. この設定を使用すると、その動作を無効にすることができます。This setting allows you to disable that behavior.

キーKey Value 説明Description
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL truetrue ローカル Function App 内の関数を指すバックエンド URL を使用した呼び出しは、関数に直接送信されるのではなく、Function App の HTTP フロント エンドに戻されるようになりますCalls with a backend url pointing to a function in the local Function App will no longer be sent directly to the function, and will instead be directed back to the HTTP front end for the Function App
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALLAZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL falsefalse これが既定値です。This is the default value. ローカル Function App 内の関数を指すバックエンド URL を使用した呼び出しは、その関数に直接転送されるようになりますCalls with a backend url pointing to a function in the local Function App will be forwarded directly to that Function

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

この設定は、スラッシュがバックエンド URL に挿入されたときに、%2F をルート パラメーターでスラッシュとしてデコードするかどうかを制御します。This setting controls whether %2F is decoded as slashes in route parameters when they are inserted into the backend URL.

キーKey Value 説明Description
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES truetrue エンコードされたスラッシュがルート パラメーターに含まれている場合、それらがデコードされます。Route parameters with encoded slashes will have them decoded. example.com/api%2ftestexample.com/api/test になります。example.com/api%2ftest will become example.com/api/test
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHESAZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES falsefalse これは既定の動作です。This is the default behavior. すべてのルート パラメーターが、変更されることなく渡されますAll route parameters will be passed along unchanged

Example

次に示すのは、URL myfunction.com にある関数アプリ内の proxies.json の例ですHere is an example proxies.json in a function app at the URL myfunction.com

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}
URL のデコードURL Decoding 入力Input OutputOutput
truetrue myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test/apiexample.com/test/api
falsefalse myfunction.com/test%2fapimyfunction.com/test%2fapi example.com/test%2fapiexample.com/test%2fapi

次の手順Next steps

アプリケーション設定の更新方法Learn how to update app settings

host.json ファイルのグローバル設定を参照するSee global settings in the host.json file

App Service アプリの他のアプリ設定を参照するSee other app settings for App Service apps