sessionPools の Microsoft.App

Bicep リソース定義

sessionPools リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/sessionPools リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.App/sessionPools@2025-10-02-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containerType: 'string'
    customContainerTemplate: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          probes: [
            {
              failureThreshold: int
              httpGet: {
                host: 'string'
                httpHeaders: [
                  {
                    name: 'string'
                    value: 'string'
                  }
                ]
                path: 'string'
                port: int
                scheme: 'string'
              }
              initialDelaySeconds: int
              periodSeconds: int
              successThreshold: int
              tcpSocket: {
                host: 'string'
                port: int
              }
              terminationGracePeriodSeconds: int
              timeoutSeconds: int
              type: 'string'
            }
          ]
          resources: {
            cpu: int
            memory: 'string'
          }
        }
      ]
      ingress: {
        targetPort: int
      }
      registryCredentials: {
        identity: 'string'
        passwordSecretRef: 'string'
        server: 'string'
        username: 'string'
      }
    }
    dynamicPoolConfiguration: {
      lifecycleConfiguration: {
        cooldownPeriodInSeconds: int
        lifecycleType: 'string'
        maxAlivePeriodInSeconds: int
      }
    }
    environmentId: 'string'
    managedIdentitySettings: [
      {
        identity: 'string'
        lifecycle: 'string'
      }
    ]
    mcpServerSettings: {
      isMcpServerApiKeyDisabled: bool
      isMcpServerEnabled: bool
    }
    poolManagementType: 'string'
    scaleConfiguration: {
      maxConcurrentSessions: int
      readySessionInstances: int
    }
    secrets: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    sessionNetworkConfiguration: {
      status: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.App/sessionPools

名前	説明	価値
ID	コード内のシークレットや資格情報を保持しないように、他の Azure サービスと対話するためにセッションプールで必要なマネージド ID。	ManagedServiceIdentity の
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 3 最大長 = 63 パターン = `^[a-z][a-z0-9]*$` (必須)
プロパティ	コンテナーアプリセッションプールのリソース固有のプロパティ	セッションプールプロパティ
スコープ	デプロイスコープとは異なるスコープでリソースを作成するときに使用します。	このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

CustomContainerTemplate

名前	説明	価値
コンテナー	セッションプールのセッションのコンテナー定義の一覧。	セッションコンテナ[]
イングレス	セッションプールのイングレス構成。	セッションイングレス
レジストリ資格情報	セッションプールのセッションで使用されるコンテナーのプライベートコンテナーレジストリ資格情報。	SessionRegistryCredentials

ダイナミックプール構成

名前	説明	価値
ライフサイクル設定	動的セッションプール内のセッションのライフサイクル構成	ライフサイクル設定

EnvironmentVar (環境変数)

名前	説明	価値
名前	環境変数の名前。	文字列
secretRef です。	環境変数の値をプルするコンテナーアプリシークレットの名前。	文字列
価値	シークレット以外の環境変数の値。	文字列

ライフサイクル設定

名前	説明	価値
クールダウン期間(秒)	ライフサイクルの種類が "Timed" の場合のセッションのクールダウン期間 (秒単位)。	整数 (int)
ライフサイクルタイプ	セッションプールのライフサイクルの種類。	'OnContainerExit' 「タイミング」
maxAlivePeriodInSeconds (秒数)	ライフサイクルの種類が "OnContainerExit" の場合のセッションの最大有効期間 (秒単位)。	整数 (int)

ManagedIdentitySetting

名前	説明	価値
ID	セッションプールに割り当てられているユーザー割り当てマネージド ID のリソース ID。システム割り当て ID の場合は "system" です。	string (必須)
ライフサイクル	マネージド ID を使用できるセッションプールのライフサイクルステージを選択するために使用します。	「すべて」 '初期化' 「メイン」「なし」

マネージドサービスアイデンティティ

名前	説明	価値
型	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の

McpServerSettings (McpServer設定)

名前	説明	価値
isMcpServerApiKey無効	MCP サーバー API キーが無効になっているかどうかを示します。	ブール (bool)
isMcpServer有効	MCP サーバーが有効になっているかどうかを示します。	ブール (bool)

スケールコンフィギュレーション

名前	説明	価値
maxConcurrentSessions (英語)	同時に行うセッションの最大数。	整数 (int)
readySessionInstances の	準備完了セッションインスタンスの最小数。	整数 (int)

セッションコンテナ

名前	説明	価値
引数	コンテナーの開始コマンド引数。	文字列[]
コマンド	コンテナーの開始コマンド。	文字列[]
環境	コンテナー環境変数。	EnvironmentVar[]
イメージ	コンテナーイメージタグ。	文字列
名前	カスタムコンテナー名。	文字列
probes	コンテナーのプローブの一覧。	セッションプローブ[]
リソース	コンテナーリソースの要件。	セッションコンテナリソース

セッションコンテナリソース

名前	説明	価値
CPUの	コアで必要な CPU (例: 0.5)	整数 (int)
メモリ	必要なメモリ (例: "250Mb" )	文字列

セッションイングレス

名前	説明	価値
ターゲットポート	イングレスからのトラフィックのコンテナー内のターゲットポート	整数 (int)

セッションネットワーク構成

名前	説明	価値
状態	セッションのネットワーク状態。	「EgressDisabled」「EgressEnabled」

セッションプールプロパティ

名前	説明	価値
コンテナタイプ	セッションのコンテナーの種類。	「カスタムコンテナ」「PythonLTS」
カスタムコンテナテンプレート	containerType が CustomContainer の場合のカスタムコンテナー構成。	CustomContainerTemplate の
dynamicPoolConfiguration (動的プール構成)	poolManagementType が動的な場合のプール構成。	ダイナミックプール構成
環境ID	セッションプールの環境のリソース ID。	文字列
managedIdentitySettings	セッションプールに割り当てられているマネージド ID のオプション設定。	ManagedIdentity設定[]
mcpサーバ設定	セッションプールのMCP(モデルコンテキストプロトコル)サーバー設定。	McpServerSettings (McpServer設定)
poolManagementType (プールマネジメントタイプ)	セッションプールのプール管理の種類。	「ダイナミック」「マニュアル」
スケール設定	セッションプールのスケール構成。	スケールコンフィギュレーション
秘密	セッションプールのシークレット。	セッションプールシークレット[]
セッションネットワーク構成	セッションプール内のセッションのネットワーク構成。	セッションネットワーク構成

セッションプールシークレット

名前	説明	価値
名前	シークレット名。	文字列
価値	シークレット値。	糸制約：機密性の高い値。セキュリティで保護されたパラメーターとして渡します。

セッションプローブ

名前	説明	価値
failureThreshold	成功した後に失敗したと見なされるプローブの連続する最小障害。既定値は 3 です。最小値は 1 です。最大値は 10 です。	整数 (int)
httpゲット	HTTPGet は、実行する http 要求を指定します。	SessionProbeHttpGet の
initialDelaySeconds	コンテナーの起動後、liveness probe が開始するまでの秒数。最小値は 1 です。最大値は 60 です。	整数 (int)
periodSeconds	プローブを実行する頻度 (秒単位)。既定値は 10 秒です。最小値は 1 です。最大値は 240 です。	整数 (int)
successThreshold	失敗した後にプローブが成功したと見なされる最小連続成功数。既定値は 1 です。ライブ性と起動には 1 にする必要があります。最小値は 1 です。最大値は 10 です。	整数 (int)
tcpSocketの	TCPSocket は、TCP ポートに関連するアクションを指定します。 TCP フックはまだサポートされていません。	セッションプローブTcpSocket
terminationGracePeriodSeconds	プローブの障害時にポッドを正常に終了する必要がある時間 (秒単位)。猶予期間は、ポッドで実行されているプロセスが終了シグナルを送信してから数秒で、プロセスが強制終了シグナルで強制的に停止される時間です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、ポッドの terminationGracePeriodSeconds が使用されます。それ以外の場合、この値はポッドスペックによって提供される値をオーバーライドします。値は負以外の整数である必要があります。値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。これはアルファフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最大値は 3600 秒 (1 時間) です。	整数 (int)
timeoutSeconds	プローブがタイムアウトする秒数。既定値は 1 秒です。最小値は 1 です。最大値は 240 です。	整数 (int)
型	プローブのタイプを示します。 Liveness または Startup にすることができ、Readiness プローブはセッションではサポートされていません。タイプは、プローブのリスト (SessionProbes) のコンテキスト内の各プローブで一意である必要があります。	「ライブネス」「スタートアップ」

SessionProbeHttpGet の

名前	説明	価値
ホスティング	接続先のホスト名。既定ではポッド IP が使用されます。代わりに httpHeaders で "Host" を設定することをお考えでしょう。	文字列
HTTPヘッダー	要求で設定するカスタムヘッダー。 HTTP では、ヘッダーを繰り返し使用できます。	SessionProbeHttpGetHttpHeadersItem[]
パス	HTTP サーバー上のアクセスのパス。	文字列
ポート	コンテナーでアクセスするポートの名前または番号。数値は 1 ~ 65535 の範囲である必要があります。名前はIANA_SVC_NAMEである必要があります。	int (必須)
scheme	ホストへの接続に使用するスキーム。既定値は HTTP です。	'HTTP' 'HTTPS'

セッションプローブHttpGetHttpヘッダーアイテム

名前	説明	価値
名前	ヘッダーフィールド名	string (必須)
価値	ヘッダーフィールドの値	string (必須)

セッションプローブTcpSocket

名前	説明	価値
ホスティング	省略可能: 接続先のホスト名。既定ではポッド IP が使用されます。	文字列
ポート	コンテナーでアクセスするポートの番号または名前。数値は 1 ~ 65535 の範囲である必要があります。名前はIANA_SVC_NAMEである必要があります。	int (必須)

SessionRegistryCredentials

名前	説明	価値
ID	Azure Container Registry での認証に使用するマネージド ID。ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。システム割り当て ID の場合は、'system' を使用します	文字列
passwordSecretRef	レジストリログインパスワードを含むシークレットの名前	文字列
サーバー	コンテナーレジストリサーバー。	文字列
ユーザー名	コンテナーレジストリのユーザー名。	文字列

追跡リソースタグ

名前	説明	価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前	説明	価値

ユーザー割り当て識別子

名前	説明	価値

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュールを使用して、このリソースの種類をデプロイできます。

モジュール	説明
アプリセッションプールの	アプリセッションプール用の AVM リソースモジュール

ARM テンプレートリソース定義

sessionPools リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/sessionPools リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.App/sessionPools",
  "apiVersion": "2025-10-02-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "containerType": "string",
    "customContainerTemplate": {
      "containers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "probes": [
            {
              "failureThreshold": "int",
              "httpGet": {
                "host": "string",
                "httpHeaders": [
                  {
                    "name": "string",
                    "value": "string"
                  }
                ],
                "path": "string",
                "port": "int",
                "scheme": "string"
              },
              "initialDelaySeconds": "int",
              "periodSeconds": "int",
              "successThreshold": "int",
              "tcpSocket": {
                "host": "string",
                "port": "int"
              },
              "terminationGracePeriodSeconds": "int",
              "timeoutSeconds": "int",
              "type": "string"
            }
          ],
          "resources": {
            "cpu": "int",
            "memory": "string"
          }
        }
      ],
      "ingress": {
        "targetPort": "int"
      },
      "registryCredentials": {
        "identity": "string",
        "passwordSecretRef": "string",
        "server": "string",
        "username": "string"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": "int",
        "lifecycleType": "string",
        "maxAlivePeriodInSeconds": "int"
      }
    },
    "environmentId": "string",
    "managedIdentitySettings": [
      {
        "identity": "string",
        "lifecycle": "string"
      }
    ],
    "mcpServerSettings": {
      "isMcpServerApiKeyDisabled": "bool",
      "isMcpServerEnabled": "bool"
    },
    "poolManagementType": "string",
    "scaleConfiguration": {
      "maxConcurrentSessions": "int",
      "readySessionInstances": "int"
    },
    "secrets": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "sessionNetworkConfiguration": {
      "status": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.App/sessionPools

名前	説明	価値
apiVersion (英語)	API のバージョン	'2025-10-02-プレビュー'
ID	コード内のシークレットや資格情報を保持しないように、他の Azure サービスと対話するためにセッションプールで必要なマネージド ID。	ManagedServiceIdentity の
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 3 最大長 = 63 パターン = `^[a-z][a-z0-9]*$` (必須)
プロパティ	コンテナーアプリセッションプールのリソース固有のプロパティ	セッションプールプロパティ
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
型	リソースの種類	「Microsoft.App/sessionPools」

CustomContainerTemplate

名前	説明	価値
コンテナー	セッションプールのセッションのコンテナー定義の一覧。	セッションコンテナ[]
イングレス	セッションプールのイングレス構成。	セッションイングレス
レジストリ資格情報	セッションプールのセッションで使用されるコンテナーのプライベートコンテナーレジストリ資格情報。	SessionRegistryCredentials

ダイナミックプール構成

名前	説明	価値
ライフサイクル設定	動的セッションプール内のセッションのライフサイクル構成	ライフサイクル設定

EnvironmentVar (環境変数)

名前	説明	価値
名前	環境変数の名前。	文字列
secretRef です。	環境変数の値をプルするコンテナーアプリシークレットの名前。	文字列
価値	シークレット以外の環境変数の値。	文字列

ライフサイクル設定

名前	説明	価値
クールダウン期間(秒)	ライフサイクルの種類が "Timed" の場合のセッションのクールダウン期間 (秒単位)。	整数 (int)
ライフサイクルタイプ	セッションプールのライフサイクルの種類。	'OnContainerExit' 「タイミング」
maxAlivePeriodInSeconds (秒数)	ライフサイクルの種類が "OnContainerExit" の場合のセッションの最大有効期間 (秒単位)。	整数 (int)

ManagedIdentitySetting

名前	説明	価値
ID	セッションプールに割り当てられているユーザー割り当てマネージド ID のリソース ID。システム割り当て ID の場合は "system" です。	string (必須)
ライフサイクル	マネージド ID を使用できるセッションプールのライフサイクルステージを選択するために使用します。	「すべて」 '初期化' 「メイン」「なし」

マネージドサービスアイデンティティ

名前	説明	価値
型	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の

McpServerSettings (McpServer設定)

名前	説明	価値
isMcpServerApiKey無効	MCP サーバー API キーが無効になっているかどうかを示します。	ブール (bool)
isMcpServer有効	MCP サーバーが有効になっているかどうかを示します。	ブール (bool)

スケールコンフィギュレーション

名前	説明	価値
maxConcurrentSessions (英語)	同時に行うセッションの最大数。	整数 (int)
readySessionInstances の	準備完了セッションインスタンスの最小数。	整数 (int)

セッションコンテナ

名前	説明	価値
引数	コンテナーの開始コマンド引数。	文字列[]
コマンド	コンテナーの開始コマンド。	文字列[]
環境	コンテナー環境変数。	EnvironmentVar[]
イメージ	コンテナーイメージタグ。	文字列
名前	カスタムコンテナー名。	文字列
probes	コンテナーのプローブの一覧。	セッションプローブ[]
リソース	コンテナーリソースの要件。	セッションコンテナリソース

セッションコンテナリソース

名前	説明	価値
CPUの	コアで必要な CPU (例: 0.5)	整数 (int)
メモリ	必要なメモリ (例: "250Mb" )	文字列

セッションイングレス

名前	説明	価値
ターゲットポート	イングレスからのトラフィックのコンテナー内のターゲットポート	整数 (int)

セッションネットワーク構成

名前	説明	価値
状態	セッションのネットワーク状態。	「EgressDisabled」「EgressEnabled」

セッションプールプロパティ

名前	説明	価値
コンテナタイプ	セッションのコンテナーの種類。	「カスタムコンテナ」「PythonLTS」
カスタムコンテナテンプレート	containerType が CustomContainer の場合のカスタムコンテナー構成。	CustomContainerTemplate の
dynamicPoolConfiguration (動的プール構成)	poolManagementType が動的な場合のプール構成。	ダイナミックプール構成
環境ID	セッションプールの環境のリソース ID。	文字列
managedIdentitySettings	セッションプールに割り当てられているマネージド ID のオプション設定。	ManagedIdentity設定[]
mcpサーバ設定	セッションプールのMCP(モデルコンテキストプロトコル)サーバー設定。	McpServerSettings (McpServer設定)
poolManagementType (プールマネジメントタイプ)	セッションプールのプール管理の種類。	「ダイナミック」「マニュアル」
スケール設定	セッションプールのスケール構成。	スケールコンフィギュレーション
秘密	セッションプールのシークレット。	セッションプールシークレット[]
セッションネットワーク構成	セッションプール内のセッションのネットワーク構成。	セッションネットワーク構成

セッションプールシークレット

名前	説明	価値
名前	シークレット名。	文字列
価値	シークレット値。	糸制約：機密性の高い値。セキュリティで保護されたパラメーターとして渡します。

セッションプローブ

名前	説明	価値
failureThreshold	成功した後に失敗したと見なされるプローブの連続する最小障害。既定値は 3 です。最小値は 1 です。最大値は 10 です。	整数 (int)
httpゲット	HTTPGet は、実行する http 要求を指定します。	SessionProbeHttpGet の
initialDelaySeconds	コンテナーの起動後、liveness probe が開始するまでの秒数。最小値は 1 です。最大値は 60 です。	整数 (int)
periodSeconds	プローブを実行する頻度 (秒単位)。既定値は 10 秒です。最小値は 1 です。最大値は 240 です。	整数 (int)
successThreshold	失敗した後にプローブが成功したと見なされる最小連続成功数。既定値は 1 です。ライブ性と起動には 1 にする必要があります。最小値は 1 です。最大値は 10 です。	整数 (int)
tcpSocketの	TCPSocket は、TCP ポートに関連するアクションを指定します。 TCP フックはまだサポートされていません。	セッションプローブTcpSocket
terminationGracePeriodSeconds	プローブの障害時にポッドを正常に終了する必要がある時間 (秒単位)。猶予期間は、ポッドで実行されているプロセスが終了シグナルを送信してから数秒で、プロセスが強制終了シグナルで強制的に停止される時間です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、ポッドの terminationGracePeriodSeconds が使用されます。それ以外の場合、この値はポッドスペックによって提供される値をオーバーライドします。値は負以外の整数である必要があります。値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。これはアルファフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最大値は 3600 秒 (1 時間) です。	整数 (int)
timeoutSeconds	プローブがタイムアウトする秒数。既定値は 1 秒です。最小値は 1 です。最大値は 240 です。	整数 (int)
型	プローブのタイプを示します。 Liveness または Startup にすることができ、Readiness プローブはセッションではサポートされていません。タイプは、プローブのリスト (SessionProbes) のコンテキスト内の各プローブで一意である必要があります。	「ライブネス」「スタートアップ」

SessionProbeHttpGet の

名前	説明	価値
ホスティング	接続先のホスト名。既定ではポッド IP が使用されます。代わりに httpHeaders で "Host" を設定することをお考えでしょう。	文字列
HTTPヘッダー	要求で設定するカスタムヘッダー。 HTTP では、ヘッダーを繰り返し使用できます。	SessionProbeHttpGetHttpHeadersItem[]
パス	HTTP サーバー上のアクセスのパス。	文字列
ポート	コンテナーでアクセスするポートの名前または番号。数値は 1 ~ 65535 の範囲である必要があります。名前はIANA_SVC_NAMEである必要があります。	int (必須)
scheme	ホストへの接続に使用するスキーム。既定値は HTTP です。	'HTTP' 'HTTPS'

セッションプローブHttpGetHttpヘッダーアイテム

名前	説明	価値
名前	ヘッダーフィールド名	string (必須)
価値	ヘッダーフィールドの値	string (必須)

セッションプローブTcpSocket

名前	説明	価値
ホスティング	省略可能: 接続先のホスト名。既定ではポッド IP が使用されます。	文字列
ポート	コンテナーでアクセスするポートの番号または名前。数値は 1 ~ 65535 の範囲である必要があります。名前はIANA_SVC_NAMEである必要があります。	int (必須)

SessionRegistryCredentials

名前	説明	価値
ID	Azure Container Registry での認証に使用するマネージド ID。ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。システム割り当て ID の場合は、'system' を使用します	文字列
passwordSecretRef	レジストリログインパスワードを含むシークレットの名前	文字列
サーバー	コンテナーレジストリサーバー。	文字列
ユーザー名	コンテナーレジストリのユーザー名。	文字列

追跡リソースタグ

名前	説明	価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前	説明	価値

ユーザー割り当て識別子

名前	説明	価値

使用例

Terraform (AzAPI プロバイダー) リソース定義

sessionPools リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/sessionPools リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/sessionPools@2025-10-02-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containerType = "string"
      customContainerTemplate = {
        containers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            probes = [
              {
                failureThreshold = int
                httpGet = {
                  host = "string"
                  httpHeaders = [
                    {
                      name = "string"
                      value = "string"
                    }
                  ]
                  path = "string"
                  port = int
                  scheme = "string"
                }
                initialDelaySeconds = int
                periodSeconds = int
                successThreshold = int
                tcpSocket = {
                  host = "string"
                  port = int
                }
                terminationGracePeriodSeconds = int
                timeoutSeconds = int
                type = "string"
              }
            ]
            resources = {
              cpu = int
              memory = "string"
            }
          }
        ]
        ingress = {
          targetPort = int
        }
        registryCredentials = {
          identity = "string"
          passwordSecretRef = "string"
          server = "string"
          username = "string"
        }
      }
      dynamicPoolConfiguration = {
        lifecycleConfiguration = {
          cooldownPeriodInSeconds = int
          lifecycleType = "string"
          maxAlivePeriodInSeconds = int
        }
      }
      environmentId = "string"
      managedIdentitySettings = [
        {
          identity = "string"
          lifecycle = "string"
        }
      ]
      mcpServerSettings = {
        isMcpServerApiKeyDisabled = bool
        isMcpServerEnabled = bool
      }
      poolManagementType = "string"
      scaleConfiguration = {
        maxConcurrentSessions = int
        readySessionInstances = int
      }
      secrets = [
        {
          name = "string"
          value = "string"
        }
      ]
      sessionNetworkConfiguration = {
        status = "string"
      }
    }
  }
}

プロパティ値

Microsoft.App/sessionPools

名前	説明	価値
ID	コード内のシークレットや資格情報を保持しないように、他の Azure サービスと対話するためにセッションプールで必要なマネージド ID。	ManagedServiceIdentity の
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 3 最大長 = 63 パターン = `^[a-z][a-z0-9]*$` (必須)
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
プロパティ	コンテナーアプリセッションプールのリソース固有のプロパティ	セッションプールプロパティ
タグ	リソースタグ	タグ名と値のディクショナリ。
型	リソースの種類	「Microsoft.App/sessionPools@2025-10-02-preview」

CustomContainerTemplate

名前	説明	価値
コンテナー	セッションプールのセッションのコンテナー定義の一覧。	セッションコンテナ[]
イングレス	セッションプールのイングレス構成。	セッションイングレス
レジストリ資格情報	セッションプールのセッションで使用されるコンテナーのプライベートコンテナーレジストリ資格情報。	SessionRegistryCredentials

ダイナミックプール構成

名前	説明	価値
ライフサイクル設定	動的セッションプール内のセッションのライフサイクル構成	ライフサイクル設定

EnvironmentVar (環境変数)

名前	説明	価値
名前	環境変数の名前。	文字列
secretRef です。	環境変数の値をプルするコンテナーアプリシークレットの名前。	文字列
価値	シークレット以外の環境変数の値。	文字列

ライフサイクル設定

名前	説明	価値
クールダウン期間(秒)	ライフサイクルの種類が "Timed" の場合のセッションのクールダウン期間 (秒単位)。	整数 (int)
ライフサイクルタイプ	セッションプールのライフサイクルの種類。	'OnContainerExit' 「タイミング」
maxAlivePeriodInSeconds (秒数)	ライフサイクルの種類が "OnContainerExit" の場合のセッションの最大有効期間 (秒単位)。	整数 (int)

ManagedIdentitySetting

名前	説明	価値
ID	セッションプールに割り当てられているユーザー割り当てマネージド ID のリソース ID。システム割り当て ID の場合は "system" です。	string (必須)
ライフサイクル	マネージド ID を使用できるセッションプールのライフサイクルステージを選択するために使用します。	「すべて」 '初期化' 「メイン」「なし」

マネージドサービスアイデンティティ

名前	説明	価値
型	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の

McpServerSettings (McpServer設定)

名前	説明	価値
isMcpServerApiKey無効	MCP サーバー API キーが無効になっているかどうかを示します。	ブール (bool)
isMcpServer有効	MCP サーバーが有効になっているかどうかを示します。	ブール (bool)

スケールコンフィギュレーション

名前	説明	価値
maxConcurrentSessions (英語)	同時に行うセッションの最大数。	整数 (int)
readySessionInstances の	準備完了セッションインスタンスの最小数。	整数 (int)

セッションコンテナ

名前	説明	価値
引数	コンテナーの開始コマンド引数。	文字列[]
コマンド	コンテナーの開始コマンド。	文字列[]
環境	コンテナー環境変数。	EnvironmentVar[]
イメージ	コンテナーイメージタグ。	文字列
名前	カスタムコンテナー名。	文字列
probes	コンテナーのプローブの一覧。	セッションプローブ[]
リソース	コンテナーリソースの要件。	セッションコンテナリソース

セッションコンテナリソース

名前	説明	価値
CPUの	コアで必要な CPU (例: 0.5)	整数 (int)
メモリ	必要なメモリ (例: "250Mb" )	文字列

セッションイングレス

名前	説明	価値
ターゲットポート	イングレスからのトラフィックのコンテナー内のターゲットポート	整数 (int)

セッションネットワーク構成

名前	説明	価値
状態	セッションのネットワーク状態。	「EgressDisabled」「EgressEnabled」

セッションプールプロパティ

名前	説明	価値
コンテナタイプ	セッションのコンテナーの種類。	「カスタムコンテナ」「PythonLTS」
カスタムコンテナテンプレート	containerType が CustomContainer の場合のカスタムコンテナー構成。	CustomContainerTemplate の
dynamicPoolConfiguration (動的プール構成)	poolManagementType が動的な場合のプール構成。	ダイナミックプール構成
環境ID	セッションプールの環境のリソース ID。	文字列
managedIdentitySettings	セッションプールに割り当てられているマネージド ID のオプション設定。	ManagedIdentity設定[]
mcpサーバ設定	セッションプールのMCP(モデルコンテキストプロトコル)サーバー設定。	McpServerSettings (McpServer設定)
poolManagementType (プールマネジメントタイプ)	セッションプールのプール管理の種類。	「ダイナミック」「マニュアル」
スケール設定	セッションプールのスケール構成。	スケールコンフィギュレーション
秘密	セッションプールのシークレット。	セッションプールシークレット[]
セッションネットワーク構成	セッションプール内のセッションのネットワーク構成。	セッションネットワーク構成

セッションプールシークレット

名前	説明	価値
名前	シークレット名。	文字列
価値	シークレット値。	糸制約：機密性の高い値。セキュリティで保護されたパラメーターとして渡します。

セッションプローブ

名前	説明	価値
failureThreshold	成功した後に失敗したと見なされるプローブの連続する最小障害。既定値は 3 です。最小値は 1 です。最大値は 10 です。	整数 (int)
httpゲット	HTTPGet は、実行する http 要求を指定します。	SessionProbeHttpGet の
initialDelaySeconds	コンテナーの起動後、liveness probe が開始するまでの秒数。最小値は 1 です。最大値は 60 です。	整数 (int)
periodSeconds	プローブを実行する頻度 (秒単位)。既定値は 10 秒です。最小値は 1 です。最大値は 240 です。	整数 (int)
successThreshold	失敗した後にプローブが成功したと見なされる最小連続成功数。既定値は 1 です。ライブ性と起動には 1 にする必要があります。最小値は 1 です。最大値は 10 です。	整数 (int)
tcpSocketの	TCPSocket は、TCP ポートに関連するアクションを指定します。 TCP フックはまだサポートされていません。	セッションプローブTcpSocket
terminationGracePeriodSeconds	プローブの障害時にポッドを正常に終了する必要がある時間 (秒単位)。猶予期間は、ポッドで実行されているプロセスが終了シグナルを送信してから数秒で、プロセスが強制終了シグナルで強制的に停止される時間です。この値は、プロセスの予想されるクリーンアップ時間よりも長く設定します。この値が nil の場合、ポッドの terminationGracePeriodSeconds が使用されます。それ以外の場合、この値はポッドスペックによって提供される値をオーバーライドします。値は負以外の整数である必要があります。値 0 は、強制終了信号を介して直ちに停止することを示します (シャットダウンする機会はありません)。これはアルファフィールドであり、ProbeTerminationGracePeriod 機能ゲートを有効にする必要があります。最大値は 3600 秒 (1 時間) です。	整数 (int)
timeoutSeconds	プローブがタイムアウトする秒数。既定値は 1 秒です。最小値は 1 です。最大値は 240 です。	整数 (int)
型	プローブのタイプを示します。 Liveness または Startup にすることができ、Readiness プローブはセッションではサポートされていません。タイプは、プローブのリスト (SessionProbes) のコンテキスト内の各プローブで一意である必要があります。	「ライブネス」「スタートアップ」

SessionProbeHttpGet の

名前	説明	価値
ホスティング	接続先のホスト名。既定ではポッド IP が使用されます。代わりに httpHeaders で "Host" を設定することをお考えでしょう。	文字列
HTTPヘッダー	要求で設定するカスタムヘッダー。 HTTP では、ヘッダーを繰り返し使用できます。	SessionProbeHttpGetHttpHeadersItem[]
パス	HTTP サーバー上のアクセスのパス。	文字列
ポート	コンテナーでアクセスするポートの名前または番号。数値は 1 ~ 65535 の範囲である必要があります。名前はIANA_SVC_NAMEである必要があります。	int (必須)
scheme	ホストへの接続に使用するスキーム。既定値は HTTP です。	'HTTP' 'HTTPS'

セッションプローブHttpGetHttpヘッダーアイテム

名前	説明	価値
名前	ヘッダーフィールド名	string (必須)
価値	ヘッダーフィールドの値	string (必須)

セッションプローブTcpSocket

名前	説明	価値
ホスティング	省略可能: 接続先のホスト名。既定ではポッド IP が使用されます。	文字列
ポート	コンテナーでアクセスするポートの番号または名前。数値は 1 ~ 65535 の範囲である必要があります。名前はIANA_SVC_NAMEである必要があります。	int (必須)

SessionRegistryCredentials

名前	説明	価値
ID	Azure Container Registry での認証に使用するマネージド ID。ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。システム割り当て ID の場合は、'system' を使用します	文字列
passwordSecretRef	レジストリログインパスワードを含むシークレットの名前	文字列
サーバー	コンテナーレジストリサーバー。	文字列
ユーザー名	コンテナーレジストリのユーザー名。	文字列

追跡リソースタグ

名前	説明	価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前	説明	価値

ユーザー割り当て識別子

名前	説明	価値

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-11-11

次の方法で共有

sessionPools の Microsoft.App

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.App/sessionPools

CustomContainerTemplate

ダイナミックプール構成

EnvironmentVar (環境変数)

ライフサイクル設定

ManagedIdentitySetting

マネージドサービスアイデンティティ

McpServerSettings (McpServer設定)

スケールコンフィギュレーション

セッションコンテナ

セッションコンテナリソース

セッションイングレス

セッションネットワーク構成

セッションプールプロパティ

セッションプールシークレット

セッションプローブ

SessionProbeHttpGet の

セッションプローブHttpGetHttpヘッダーアイテム

セッションプローブTcpSocket

SessionRegistryCredentials

追跡リソースタグ

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

ユーザー割り当て識別子

使用例

Azure 検証済みモジュール

ARM テンプレート リソース定義

リソースの形式

プロパティ値

Microsoft.App/sessionPools

CustomContainerTemplate

ダイナミックプール構成

EnvironmentVar (環境変数)

ライフサイクル設定

ManagedIdentitySetting

マネージドサービスアイデンティティ

McpServerSettings (McpServer設定)

スケールコンフィギュレーション

セッションコンテナ

セッションコンテナリソース

セッションイングレス

セッションネットワーク構成

セッションプールプロパティ

セッションプールシークレット

セッションプローブ

SessionProbeHttpGet の

セッションプローブHttpGetHttpヘッダーアイテム

セッションプローブTcpSocket

SessionRegistryCredentials

追跡リソースタグ

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

ユーザー割り当て識別子

使用例

Terraform (AzAPI プロバイダー) リソース定義

リソースの形式

プロパティ値

Microsoft.App/sessionPools

CustomContainerTemplate

ダイナミックプール構成

EnvironmentVar (環境変数)

ライフサイクル設定

ManagedIdentitySetting

マネージドサービスアイデンティティ

McpServerSettings (McpServer設定)

スケールコンフィギュレーション

セッションコンテナ

セッションコンテナリソース

セッションイングレス

セッションネットワーク構成

セッションプールプロパティ

セッションプールシークレット

セッションプローブ

SessionProbeHttpGet の

セッションプローブHttpGetHttpヘッダーアイテム

セッションプローブTcpSocket

SessionRegistryCredentials

ARM テンプレートリソース定義