Microsoft.App sessionPools 2024-10-02-preview (英語)

2025-05-13

Bicep リソース定義

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

リソースグループの - リソースグループのデプロイコマンド参照

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

リソースの形式

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

resource symbolicname 'Microsoft.App/sessionPools@2024-10-02-preview' = {
  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'
          resources: {
            cpu: int
            memory: 'string'
          }
        }
      ]
      ingress: {
        targetPort: int
      }
      registryCredentials: {
        identity: 'string'
        passwordSecretRef: 'string'
        server: 'string'
        username: 'string'
      }
    }
    dynamicPoolConfiguration: {
      cooldownPeriodInSeconds: int
      executionType: 'string'
    }
    environmentId: 'string'
    managedIdentitySettings: [
      {
        identity: 'string'
        lifecycle: 'string'
      }
    ]
    poolManagementType: 'string'
    scaleConfiguration: {
      maxConcurrentSessions: int
      readySessionInstances: int
    }
    secrets: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    sessionNetworkConfiguration: {
      status: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.App/sessionPools

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

CustomContainerTemplate

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

ダイナミックプール構成

名前	説明	価値
クールダウン期間(秒)	セッションのクールダウン期間 (秒単位)。	整数 (int)
実行タイプ	セッションプールの実行の種類。	「タイミング」

EnvironmentVar (環境変数)

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

ManagedIdentitySetting

名前	説明	価値
アイデンティティ	セッションプールに割り当てられているユーザー割り当てマネージド 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 の

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

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

セッションコンテナ

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

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

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

セッションイングレス

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

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

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

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

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

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

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

SessionRegistryCredentials

名前	説明	価値
アイデンティティ	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": "2024-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",
          "resources": {
            "cpu": "int",
            "memory": "string"
          }
        }
      ],
      "ingress": {
        "targetPort": "int"
      },
      "registryCredentials": {
        "identity": "string",
        "passwordSecretRef": "string",
        "server": "string",
        "username": "string"
      }
    },
    "dynamicPoolConfiguration": {
      "cooldownPeriodInSeconds": "int",
      "executionType": "string"
    },
    "environmentId": "string",
    "managedIdentitySettings": [
      {
        "identity": "string",
        "lifecycle": "string"
      }
    ],
    "poolManagementType": "string",
    "scaleConfiguration": {
      "maxConcurrentSessions": "int",
      "readySessionInstances": "int"
    },
    "secrets": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "sessionNetworkConfiguration": {
      "status": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.App/sessionPools

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

CustomContainerTemplate

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

ダイナミックプール構成

名前	説明	価値
クールダウン期間(秒)	セッションのクールダウン期間 (秒単位)。	整数 (int)
実行タイプ	セッションプールの実行の種類。	「タイミング」

EnvironmentVar (環境変数)

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

ManagedIdentitySetting

名前	説明	価値
アイデンティティ	セッションプールに割り当てられているユーザー割り当てマネージド 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 の

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

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

セッションコンテナ

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

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

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

セッションイングレス

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

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

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

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

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

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

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

SessionRegistryCredentials

名前	説明	価値
アイデンティティ	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@2024-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"
            resources = {
              cpu = int
              memory = "string"
            }
          }
        ]
        ingress = {
          targetPort = int
        }
        registryCredentials = {
          identity = "string"
          passwordSecretRef = "string"
          server = "string"
          username = "string"
        }
      }
      dynamicPoolConfiguration = {
        cooldownPeriodInSeconds = int
        executionType = "string"
      }
      environmentId = "string"
      managedIdentitySettings = [
        {
          identity = "string"
          lifecycle = "string"
        }
      ]
      poolManagementType = "string"
      scaleConfiguration = {
        maxConcurrentSessions = int
        readySessionInstances = int
      }
      secrets = [
        {
          name = "string"
          value = "string"
        }
      ]
      sessionNetworkConfiguration = {
        status = "string"
      }
    }
  }
}

プロパティ値

Microsoft.App/sessionPools

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

CustomContainerTemplate

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

ダイナミックプール構成

名前	説明	価値
クールダウン期間(秒)	セッションのクールダウン期間 (秒単位)。	整数 (int)
実行タイプ	セッションプールの実行の種類。	「タイミング」

EnvironmentVar (環境変数)

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

ManagedIdentitySetting

名前	説明	価値
アイデンティティ	セッションプールに割り当てられているユーザー割り当てマネージド 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 の

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

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

セッションコンテナ

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

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

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

セッションイングレス

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

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

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

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

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

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

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

SessionRegistryCredentials

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

追跡リソースタグ

名前	説明	価値

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

名前	説明	価値

ユーザー割り当て識別子

名前	説明	価値

次の方法で共有

Microsoft.App sessionPools 2024-10-02-preview (英語)

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.App/sessionPools

CustomContainerTemplate

ダイナミックプール構成

EnvironmentVar (環境変数)

ManagedIdentitySetting

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

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

セッションコンテナ

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

セッションイングレス

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

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

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

SessionRegistryCredentials

追跡リソースタグ

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

ユーザー割り当て識別子

使用例

Azure 検証済みモジュール

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

リソースの形式

プロパティ値

Microsoft.App/sessionPools

CustomContainerTemplate

ダイナミックプール構成

EnvironmentVar (環境変数)

ManagedIdentitySetting

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

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

セッションコンテナ

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

セッションイングレス

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

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

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

SessionRegistryCredentials

追跡リソースタグ

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

ユーザー割り当て識別子

使用例

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

リソースの形式

プロパティ値

Microsoft.App/sessionPools

CustomContainerTemplate

ダイナミックプール構成

EnvironmentVar (環境変数)

ManagedIdentitySetting

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

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

セッションコンテナ

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

セッションイングレス

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

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

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

SessionRegistryCredentials

追跡リソースタグ

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

ユーザー割り当て識別子

フィードバック

その他のリソース

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