次の方法で共有

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