Microsoft.App sessionPools

• Más reciente
• 2025-10-02-vista previa
• 2025-07-01
• 2025-02-02-vista previa
• 2025-01-01
• 2024-10-02-vista previa
• 2024-08-02-avance
• 2024-02-02-vista previa

Definición de recursos de Bicep

El tipo de recurso sessionPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso de Microsoft.App/sessionPools, agregue la siguiente bicep a la plantilla.

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'
  }
}

Valores de propiedad

Microsoft.App/sessionPools

Nombre	Descripción	Importancia
identidad	Identidades administradas necesarias por un grupo de sesiones para interactuar con otros servicios de Azure para no mantener secretos ni credenciales en el código.	managedServiceIdentity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 3 Longitud máxima = 63 Patrón = ^[a-z][a-z0-9]*$ (obligatorio)
Propiedades	Propiedades específicas del recurso del grupo de sesiones de aplicación de contenedor	SessionPoolProperties
scope	Use al crear un recurso en un ámbito diferente del ámbito de implementación.	Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

CustomContainerTemplate

Nombre	Descripción	Importancia
recipientes	Lista de definiciones de contenedor para las sesiones del grupo de sesiones.	sessionContainer[]
ingreso	Configuración de entrada del grupo de sesiones.	sessionIngress de
registryCredentials	Credenciales del registro de contenedor privado para contenedores usados por las sesiones del grupo de sesiones.	sessionRegistryCredentials

DynamicPoolConfiguration

Nombre	Descripción	Importancia
lifecycleConfiguration	Configuración del ciclo de vida de una sesión en el grupo de sesiones dinámicas	lifecycleConfiguration

EnvironmentVar (Var de entorno)

Nombre	Descripción	Importancia
nombre	Nombre de la variable de entorno.	cuerda / cadena
secretRef	Nombre del secreto de aplicación contenedora del que se va a extraer el valor de la variable de entorno.	cuerda / cadena
valor	Valor de variable de entorno no secreto.	cuerda / cadena

Configuración del ciclo de vida

Nombre	Descripción	Importancia
cooldownPeriodInSeconds	El período de enfriamiento de una sesión en segundos cuando el tipo de ciclo de vida es "Timed".	Int
lifecycleType	Tipo de ciclo de vida del grupo de sesiones.	'OnContainerExit' 'Cronometrado'
maxAlivePeriodInSeconds	Período de vida máximo de una sesión en segundos cuando el tipo de ciclo de vida es "OnContainerExit".	Int

ManagedIdentitySetting

Nombre	Descripción	Importancia
identidad	Identificador de recurso de una identidad administrada asignada por el usuario que se asigna al grupo de sesiones o "sistema" para la identidad asignada por el sistema.	string (obligatorio)
ciclo de vida	Use para seleccionar las fases del ciclo de vida de un grupo de sesiones durante el cual la identidad administrada debe estar disponible.	"Todo" 'Inicio' 'Principal' 'Ninguno'

ManagedServiceIdentity

Nombre	Descripción	Importancia
tipo	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).	'Ninguno' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatorio)
identidades asignadas por el usuario	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities

Configuración de McpServer

Nombre	Descripción	Importancia
isMcpServerApiKeyDisabled	Indica si la clave API del servidor MCP está deshabilitada.	bool
isMcpServerEnabled	Indica si el servidor MCP está habilitado.	bool

ScaleConfiguration

Nombre	Descripción	Importancia
maxConcurrentSessions	Recuento máximo de sesiones al mismo tiempo.	Int
readySessionInstances	Recuento mínimo de instancias de sesión listas.	Int

SessionContainer (Contenedor de sesión)

Nombre	Descripción	Importancia
args	Argumentos de comando de inicio de contenedor.	cadena[]
comando	Comando container start.	cadena[]
Entorno	Variables de entorno de contenedor.	EnvironmentVar[]
imagen	Etiqueta de imagen de contenedor.	cuerda / cadena
nombre	Nombre de contenedor personalizado.	cuerda / cadena
probes	Lista de sondeos para el contenedor.	Sonda de sesión[]
recursos	Requisitos de recursos de contenedor.	sessionContainerResources

SessionContainerResources

Nombre	Descripción	Importancia
CPU	CPU necesaria en núcleos, por ejemplo, 0,5	Int
memoria	Memoria necesaria, por ejemplo, "250 Mb"	cuerda / cadena

SessionIngress

Nombre	Descripción	Importancia
targetPort	Puerto de destino en contenedores para el tráfico desde la entrada	Int

SessionNetworkConfiguration

Nombre	Descripción	Importancia
estado	Estado de red de las sesiones.	'EgresoDeshabilitado' 'SalidaHabilitada'

SessionPoolProperties

Nombre	Descripción	Importancia
containerType	Tipo de contenedor de las sesiones.	'Contenedor personalizado' "PythonLTS"
customContainerTemplate	Configuración de contenedor personalizada si containerType es CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	La configuración del grupo si poolManagementType es dinámica.	DynamicPoolConfiguration
environmentId	Identificador de recurso del entorno del grupo de sesiones.	cuerda / cadena
managedIdentitySettings	Configuración opcional de una identidad administrada asignada al grupo de sesiones.	ManagedIdentitySetting[]
Configuración del servidor mcp	La configuración del servidor MCP (Model Context Protocol) del grupo de sesiones.	Configuración de McpServer
poolManagementType	El tipo de administración de grupos del grupo de sesiones.	"Dinámico" 'Manual'
scaleConfiguration	Configuración de escala del grupo de sesiones.	ScaleConfiguration
secretos	Secretos del grupo de sesiones.	SessionPoolSecret[]
sessionNetworkConfiguration	Configuración de red de las sesiones del grupo de sesiones.	SessionNetworkConfiguration

SessionPoolSecret

Nombre	Descripción	Importancia
nombre	Nombre del secreto.	cuerda / cadena
valor	Valor secreto.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.

SessionProbe

Nombre	Descripción	Importancia
failureThreshold	Se han producido errores consecutivos mínimos para que el sondeo se considere erróneo después de haber realizado correctamente. El valor predeterminado es 3. El valor mínimo es 1. El valor máximo es 10.	Int
httpGet (en inglés)	HTTPGet especifica la solicitud HTTP que se va a realizar.	SessionProbeHttpGet
initialDelaySeconds	Número de segundos después de que se haya iniciado el contenedor antes de que se inicien los sondeos de ejecución. El valor mínimo es 1. El valor máximo es 60.	Int
periodSeconds	Frecuencia (en segundos) para realizar el sondeo. El valor predeterminado es de 10 segundos. El valor mínimo es 1. El valor máximo es 240.	Int
successThreshold	Número mínimo de éxitos consecutivos para que el sondeo se considere correcto después de haber producido un error. De manera predeterminada, su valor es 1. Debe ser 1 para la vida y el inicio. El valor mínimo es 1. El valor máximo es 10.	Int
tcpSocket	TCPSocket especifica una acción que implica un puerto TCP. Todavía no se admiten enlaces TCP.	SessionProbeTcpSocket
terminationGracePeriodSeconds	Duración opcional en segundos, el pod debe finalizar correctamente tras un error de sondeo. El período de gracia es la duración en segundos después de que los procesos que se ejecutan en el pod se envíen una señal de terminación y el tiempo en que los procesos se detengan forzadamente con una señal de eliminación. Establezca este valor más largo que el tiempo de limpieza esperado para el proceso. Si este valor es nulo, se usará la terminación del podGracePeriodSeconds. De lo contrario, este valor invalida el valor proporcionado por la especificación de pod. El valor debe ser entero no negativo. El valor cero indica que se detiene inmediatamente a través de la señal de eliminación (sin oportunidad de apagar). Se trata de un campo alfa y requiere habilitar la puerta de características ProbeTerminationGracePeriod. El valor máximo es de 3600 segundos (1 hora)	Int
timeoutSeconds	Número de segundos después del cual el sondeo agota el tiempo de espera. El valor predeterminado es 1 segundo. El valor mínimo es 1. El valor máximo es 240.	Int
tipo	Denota el tipo de sonda. Puede ser de ejecución o de inicio, la sonda de preparación no se admite en las sesiones. El tipo debe ser único para cada sondeo en el contexto de una lista de sondeos (SessionProbes).	"Liveness" 'Inicio'

SessionProbeHttpGet

Nombre	Descripción	Importancia
host	Nombre de host al que conectarse, el valor predeterminado es la dirección IP del pod. Probablemente quiera establecer "Host" en httpHeaders en su lugar.	cuerda / cadena
httpHeaders	Encabezados personalizados que se van a establecer en la solicitud. HTTP permite encabezados repetidos.	SessionProbeHttpGetHttpHeadersItem[]
camino	Ruta de acceso al acceso en el servidor HTTP.	cuerda / cadena
port	Nombre o número del puerto al que se va a acceder en el contenedor. El número debe estar en el intervalo de 1 a 65535. El nombre debe ser un IANA_SVC_NAME.	int (obligatorio)
scheme	Esquema que se va a usar para conectarse al host. El valor predeterminado es HTTP.	'HTTP' 'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nombre	Descripción	Importancia
nombre	Nombre del campo de encabezado	string (obligatorio)
valor	Valor del campo de encabezado	string (obligatorio)

SessionProbeTcpSocket

Nombre	Descripción	Importancia
host	Opcional: nombre de host al que conectarse, el valor predeterminado es la dirección IP del pod.	cuerda / cadena
port	Número o nombre del puerto al que se va a acceder en el contenedor. El número debe estar en el intervalo de 1 a 65535. El nombre debe ser un IANA_SVC_NAME.	int (obligatorio)

SessionRegistryCredentials

Nombre	Descripción	Importancia
identidad	Una identidad administrada que se va a usar para autenticarse con Azure Container Registry. En el caso de las identidades asignadas por el usuario, use el identificador de recurso de identidad asignado por el usuario completo. En el caso de las identidades asignadas por el sistema, use "system"	cuerda / cadena
passwordSecretRef	Nombre del secreto que contiene la contraseña de inicio de sesión del Registro	cuerda / cadena
servidor	Servidor de registro de contenedor.	cuerda / cadena
nombre de usuario	Nombre de usuario del registro de contenedor.	cuerda / cadena

TrackedResourceTags

Nombre	Descripción	Importancia

UserAssignedIdentities

Nombre	Descripción	Importancia

IdentidadAsignadaPorElUsuario

Nombre	Descripción	Importancia

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo	Descripción
Grupo de sesiones de aplicaciones	Módulo de recursos de AVM para el grupo de sesiones de aplicaciones

Definición de recursos de plantilla de ARM

El tipo de recurso sessionPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso de Microsoft.App/sessionPools, agregue el siguiente JSON a la plantilla.

{
  "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"
  }
}

Valores de propiedad

Microsoft.App/sessionPools

Nombre	Descripción	Importancia
apiVersion	La versión de api	'2025-10-02-preview'
identidad	Identidades administradas necesarias por un grupo de sesiones para interactuar con otros servicios de Azure para no mantener secretos ni credenciales en el código.	managedServiceIdentity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 3 Longitud máxima = 63 Patrón = ^[a-z][a-z0-9]*$ (obligatorio)
Propiedades	Propiedades específicas del recurso del grupo de sesiones de aplicación de contenedor	SessionPoolProperties
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.App/sessionPools"

CustomContainerTemplate

Nombre	Descripción	Importancia
recipientes	Lista de definiciones de contenedor para las sesiones del grupo de sesiones.	sessionContainer[]
ingreso	Configuración de entrada del grupo de sesiones.	sessionIngress de
registryCredentials	Credenciales del registro de contenedor privado para contenedores usados por las sesiones del grupo de sesiones.	sessionRegistryCredentials

DynamicPoolConfiguration

Nombre	Descripción	Importancia
lifecycleConfiguration	Configuración del ciclo de vida de una sesión en el grupo de sesiones dinámicas	lifecycleConfiguration

EnvironmentVar (Var de entorno)

Nombre	Descripción	Importancia
nombre	Nombre de la variable de entorno.	cuerda / cadena
secretRef	Nombre del secreto de aplicación contenedora del que se va a extraer el valor de la variable de entorno.	cuerda / cadena
valor	Valor de variable de entorno no secreto.	cuerda / cadena

Configuración del ciclo de vida

Nombre	Descripción	Importancia
cooldownPeriodInSeconds	El período de enfriamiento de una sesión en segundos cuando el tipo de ciclo de vida es "Timed".	Int
lifecycleType	Tipo de ciclo de vida del grupo de sesiones.	'OnContainerExit' 'Cronometrado'
maxAlivePeriodInSeconds	Período de vida máximo de una sesión en segundos cuando el tipo de ciclo de vida es "OnContainerExit".	Int

ManagedIdentitySetting

Nombre	Descripción	Importancia
identidad	Identificador de recurso de una identidad administrada asignada por el usuario que se asigna al grupo de sesiones o "sistema" para la identidad asignada por el sistema.	string (obligatorio)
ciclo de vida	Use para seleccionar las fases del ciclo de vida de un grupo de sesiones durante el cual la identidad administrada debe estar disponible.	"Todo" 'Inicio' 'Principal' 'Ninguno'

ManagedServiceIdentity

Nombre	Descripción	Importancia
tipo	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).	'Ninguno' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatorio)
identidades asignadas por el usuario	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities

Configuración de McpServer

Nombre	Descripción	Importancia
isMcpServerApiKeyDisabled	Indica si la clave API del servidor MCP está deshabilitada.	bool
isMcpServerEnabled	Indica si el servidor MCP está habilitado.	bool

ScaleConfiguration

Nombre	Descripción	Importancia
maxConcurrentSessions	Recuento máximo de sesiones al mismo tiempo.	Int
readySessionInstances	Recuento mínimo de instancias de sesión listas.	Int

SessionContainer (Contenedor de sesión)

Nombre	Descripción	Importancia
args	Argumentos de comando de inicio de contenedor.	cadena[]
comando	Comando container start.	cadena[]
Entorno	Variables de entorno de contenedor.	EnvironmentVar[]
imagen	Etiqueta de imagen de contenedor.	cuerda / cadena
nombre	Nombre de contenedor personalizado.	cuerda / cadena
probes	Lista de sondeos para el contenedor.	Sonda de sesión[]
recursos	Requisitos de recursos de contenedor.	sessionContainerResources

SessionContainerResources

Nombre	Descripción	Importancia
CPU	CPU necesaria en núcleos, por ejemplo, 0,5	Int
memoria	Memoria necesaria, por ejemplo, "250 Mb"	cuerda / cadena

SessionIngress

Nombre	Descripción	Importancia
targetPort	Puerto de destino en contenedores para el tráfico desde la entrada	Int

SessionNetworkConfiguration

Nombre	Descripción	Importancia
estado	Estado de red de las sesiones.	'EgresoDeshabilitado' 'SalidaHabilitada'

SessionPoolProperties

Nombre	Descripción	Importancia
containerType	Tipo de contenedor de las sesiones.	'Contenedor personalizado' "PythonLTS"
customContainerTemplate	Configuración de contenedor personalizada si containerType es CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	La configuración del grupo si poolManagementType es dinámica.	DynamicPoolConfiguration
environmentId	Identificador de recurso del entorno del grupo de sesiones.	cuerda / cadena
managedIdentitySettings	Configuración opcional de una identidad administrada asignada al grupo de sesiones.	ManagedIdentitySetting[]
Configuración del servidor mcp	La configuración del servidor MCP (Model Context Protocol) del grupo de sesiones.	Configuración de McpServer
poolManagementType	El tipo de administración de grupos del grupo de sesiones.	"Dinámico" 'Manual'
scaleConfiguration	Configuración de escala del grupo de sesiones.	ScaleConfiguration
secretos	Secretos del grupo de sesiones.	SessionPoolSecret[]
sessionNetworkConfiguration	Configuración de red de las sesiones del grupo de sesiones.	SessionNetworkConfiguration

SessionPoolSecret

Nombre	Descripción	Importancia
nombre	Nombre del secreto.	cuerda / cadena
valor	Valor secreto.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.

SessionProbe

Nombre	Descripción	Importancia
failureThreshold	Se han producido errores consecutivos mínimos para que el sondeo se considere erróneo después de haber realizado correctamente. El valor predeterminado es 3. El valor mínimo es 1. El valor máximo es 10.	Int
httpGet (en inglés)	HTTPGet especifica la solicitud HTTP que se va a realizar.	SessionProbeHttpGet
initialDelaySeconds	Número de segundos después de que se haya iniciado el contenedor antes de que se inicien los sondeos de ejecución. El valor mínimo es 1. El valor máximo es 60.	Int
periodSeconds	Frecuencia (en segundos) para realizar el sondeo. El valor predeterminado es de 10 segundos. El valor mínimo es 1. El valor máximo es 240.	Int
successThreshold	Número mínimo de éxitos consecutivos para que el sondeo se considere correcto después de haber producido un error. De manera predeterminada, su valor es 1. Debe ser 1 para la vida y el inicio. El valor mínimo es 1. El valor máximo es 10.	Int
tcpSocket	TCPSocket especifica una acción que implica un puerto TCP. Todavía no se admiten enlaces TCP.	SessionProbeTcpSocket
terminationGracePeriodSeconds	Duración opcional en segundos, el pod debe finalizar correctamente tras un error de sondeo. El período de gracia es la duración en segundos después de que los procesos que se ejecutan en el pod se envíen una señal de terminación y el tiempo en que los procesos se detengan forzadamente con una señal de eliminación. Establezca este valor más largo que el tiempo de limpieza esperado para el proceso. Si este valor es nulo, se usará la terminación del podGracePeriodSeconds. De lo contrario, este valor invalida el valor proporcionado por la especificación de pod. El valor debe ser entero no negativo. El valor cero indica que se detiene inmediatamente a través de la señal de eliminación (sin oportunidad de apagar). Se trata de un campo alfa y requiere habilitar la puerta de características ProbeTerminationGracePeriod. El valor máximo es de 3600 segundos (1 hora)	Int
timeoutSeconds	Número de segundos después del cual el sondeo agota el tiempo de espera. El valor predeterminado es 1 segundo. El valor mínimo es 1. El valor máximo es 240.	Int
tipo	Denota el tipo de sonda. Puede ser de ejecución o de inicio, la sonda de preparación no se admite en las sesiones. El tipo debe ser único para cada sondeo en el contexto de una lista de sondeos (SessionProbes).	"Liveness" 'Inicio'

SessionProbeHttpGet

Nombre	Descripción	Importancia
host	Nombre de host al que conectarse, el valor predeterminado es la dirección IP del pod. Probablemente quiera establecer "Host" en httpHeaders en su lugar.	cuerda / cadena
httpHeaders	Encabezados personalizados que se van a establecer en la solicitud. HTTP permite encabezados repetidos.	SessionProbeHttpGetHttpHeadersItem[]
camino	Ruta de acceso al acceso en el servidor HTTP.	cuerda / cadena
port	Nombre o número del puerto al que se va a acceder en el contenedor. El número debe estar en el intervalo de 1 a 65535. El nombre debe ser un IANA_SVC_NAME.	int (obligatorio)
scheme	Esquema que se va a usar para conectarse al host. El valor predeterminado es HTTP.	'HTTP' 'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nombre	Descripción	Importancia
nombre	Nombre del campo de encabezado	string (obligatorio)
valor	Valor del campo de encabezado	string (obligatorio)

SessionProbeTcpSocket

Nombre	Descripción	Importancia
host	Opcional: nombre de host al que conectarse, el valor predeterminado es la dirección IP del pod.	cuerda / cadena
port	Número o nombre del puerto al que se va a acceder en el contenedor. El número debe estar en el intervalo de 1 a 65535. El nombre debe ser un IANA_SVC_NAME.	int (obligatorio)

SessionRegistryCredentials

Nombre	Descripción	Importancia
identidad	Una identidad administrada que se va a usar para autenticarse con Azure Container Registry. En el caso de las identidades asignadas por el usuario, use el identificador de recurso de identidad asignado por el usuario completo. En el caso de las identidades asignadas por el sistema, use "system"	cuerda / cadena
passwordSecretRef	Nombre del secreto que contiene la contraseña de inicio de sesión del Registro	cuerda / cadena
servidor	Servidor de registro de contenedor.	cuerda / cadena
nombre de usuario	Nombre de usuario del registro de contenedor.	cuerda / cadena

TrackedResourceTags

Nombre	Descripción	Importancia

UserAssignedIdentities

Nombre	Descripción	Importancia

IdentidadAsignadaPorElUsuario

Nombre	Descripción	Importancia

Ejemplos de uso

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso sessionPools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso de Microsoft.App/sessionPools, agregue el siguiente Terraform a la plantilla.

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"
      }
    }
  }
}

Valores de propiedad

Microsoft.App/sessionPools

Nombre	Descripción	Importancia
identidad	Identidades administradas necesarias por un grupo de sesiones para interactuar con otros servicios de Azure para no mantener secretos ni credenciales en el código.	managedServiceIdentity
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 3 Longitud máxima = 63 Patrón = ^[a-z][a-z0-9]*$ (obligatorio)
parent_id	Identificador del recurso al que se va a aplicar este recurso de extensión.	string (obligatorio)
Propiedades	Propiedades específicas del recurso del grupo de sesiones de aplicación de contenedor	SessionPoolProperties
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.App/sessionPools@2025-10-02-preview"

CustomContainerTemplate

Nombre	Descripción	Importancia
recipientes	Lista de definiciones de contenedor para las sesiones del grupo de sesiones.	sessionContainer[]
ingreso	Configuración de entrada del grupo de sesiones.	sessionIngress de
registryCredentials	Credenciales del registro de contenedor privado para contenedores usados por las sesiones del grupo de sesiones.	sessionRegistryCredentials

DynamicPoolConfiguration

Nombre	Descripción	Importancia
lifecycleConfiguration	Configuración del ciclo de vida de una sesión en el grupo de sesiones dinámicas	lifecycleConfiguration

EnvironmentVar (Var de entorno)

Nombre	Descripción	Importancia
nombre	Nombre de la variable de entorno.	cuerda / cadena
secretRef	Nombre del secreto de aplicación contenedora del que se va a extraer el valor de la variable de entorno.	cuerda / cadena
valor	Valor de variable de entorno no secreto.	cuerda / cadena

Configuración del ciclo de vida

Nombre	Descripción	Importancia
cooldownPeriodInSeconds	El período de enfriamiento de una sesión en segundos cuando el tipo de ciclo de vida es "Timed".	Int
lifecycleType	Tipo de ciclo de vida del grupo de sesiones.	'OnContainerExit' 'Cronometrado'
maxAlivePeriodInSeconds	Período de vida máximo de una sesión en segundos cuando el tipo de ciclo de vida es "OnContainerExit".	Int

ManagedIdentitySetting

Nombre	Descripción	Importancia
identidad	Identificador de recurso de una identidad administrada asignada por el usuario que se asigna al grupo de sesiones o "sistema" para la identidad asignada por el sistema.	string (obligatorio)
ciclo de vida	Use para seleccionar las fases del ciclo de vida de un grupo de sesiones durante el cual la identidad administrada debe estar disponible.	"Todo" 'Inicio' 'Principal' 'Ninguno'

ManagedServiceIdentity

Nombre	Descripción	Importancia
tipo	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).	'Ninguno' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatorio)
identidades asignadas por el usuario	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities

Configuración de McpServer

Nombre	Descripción	Importancia
isMcpServerApiKeyDisabled	Indica si la clave API del servidor MCP está deshabilitada.	bool
isMcpServerEnabled	Indica si el servidor MCP está habilitado.	bool

ScaleConfiguration

Nombre	Descripción	Importancia
maxConcurrentSessions	Recuento máximo de sesiones al mismo tiempo.	Int
readySessionInstances	Recuento mínimo de instancias de sesión listas.	Int

SessionContainer (Contenedor de sesión)

Nombre	Descripción	Importancia
args	Argumentos de comando de inicio de contenedor.	cadena[]
comando	Comando container start.	cadena[]
Entorno	Variables de entorno de contenedor.	EnvironmentVar[]
imagen	Etiqueta de imagen de contenedor.	cuerda / cadena
nombre	Nombre de contenedor personalizado.	cuerda / cadena
probes	Lista de sondeos para el contenedor.	Sonda de sesión[]
recursos	Requisitos de recursos de contenedor.	sessionContainerResources

SessionContainerResources

Nombre	Descripción	Importancia
CPU	CPU necesaria en núcleos, por ejemplo, 0,5	Int
memoria	Memoria necesaria, por ejemplo, "250 Mb"	cuerda / cadena

SessionIngress

Nombre	Descripción	Importancia
targetPort	Puerto de destino en contenedores para el tráfico desde la entrada	Int

SessionNetworkConfiguration

Nombre	Descripción	Importancia
estado	Estado de red de las sesiones.	'EgresoDeshabilitado' 'SalidaHabilitada'

SessionPoolProperties

Nombre	Descripción	Importancia
containerType	Tipo de contenedor de las sesiones.	'Contenedor personalizado' "PythonLTS"
customContainerTemplate	Configuración de contenedor personalizada si containerType es CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	La configuración del grupo si poolManagementType es dinámica.	DynamicPoolConfiguration
environmentId	Identificador de recurso del entorno del grupo de sesiones.	cuerda / cadena
managedIdentitySettings	Configuración opcional de una identidad administrada asignada al grupo de sesiones.	ManagedIdentitySetting[]
Configuración del servidor mcp	La configuración del servidor MCP (Model Context Protocol) del grupo de sesiones.	Configuración de McpServer
poolManagementType	El tipo de administración de grupos del grupo de sesiones.	"Dinámico" 'Manual'
scaleConfiguration	Configuración de escala del grupo de sesiones.	ScaleConfiguration
secretos	Secretos del grupo de sesiones.	SessionPoolSecret[]
sessionNetworkConfiguration	Configuración de red de las sesiones del grupo de sesiones.	SessionNetworkConfiguration

SessionPoolSecret

Nombre	Descripción	Importancia
nombre	Nombre del secreto.	cuerda / cadena
valor	Valor secreto.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.

SessionProbe

Nombre	Descripción	Importancia
failureThreshold	Se han producido errores consecutivos mínimos para que el sondeo se considere erróneo después de haber realizado correctamente. El valor predeterminado es 3. El valor mínimo es 1. El valor máximo es 10.	Int
httpGet (en inglés)	HTTPGet especifica la solicitud HTTP que se va a realizar.	SessionProbeHttpGet
initialDelaySeconds	Número de segundos después de que se haya iniciado el contenedor antes de que se inicien los sondeos de ejecución. El valor mínimo es 1. El valor máximo es 60.	Int
periodSeconds	Frecuencia (en segundos) para realizar el sondeo. El valor predeterminado es de 10 segundos. El valor mínimo es 1. El valor máximo es 240.	Int
successThreshold	Número mínimo de éxitos consecutivos para que el sondeo se considere correcto después de haber producido un error. De manera predeterminada, su valor es 1. Debe ser 1 para la vida y el inicio. El valor mínimo es 1. El valor máximo es 10.	Int
tcpSocket	TCPSocket especifica una acción que implica un puerto TCP. Todavía no se admiten enlaces TCP.	SessionProbeTcpSocket
terminationGracePeriodSeconds	Duración opcional en segundos, el pod debe finalizar correctamente tras un error de sondeo. El período de gracia es la duración en segundos después de que los procesos que se ejecutan en el pod se envíen una señal de terminación y el tiempo en que los procesos se detengan forzadamente con una señal de eliminación. Establezca este valor más largo que el tiempo de limpieza esperado para el proceso. Si este valor es nulo, se usará la terminación del podGracePeriodSeconds. De lo contrario, este valor invalida el valor proporcionado por la especificación de pod. El valor debe ser entero no negativo. El valor cero indica que se detiene inmediatamente a través de la señal de eliminación (sin oportunidad de apagar). Se trata de un campo alfa y requiere habilitar la puerta de características ProbeTerminationGracePeriod. El valor máximo es de 3600 segundos (1 hora)	Int
timeoutSeconds	Número de segundos después del cual el sondeo agota el tiempo de espera. El valor predeterminado es 1 segundo. El valor mínimo es 1. El valor máximo es 240.	Int
tipo	Denota el tipo de sonda. Puede ser de ejecución o de inicio, la sonda de preparación no se admite en las sesiones. El tipo debe ser único para cada sondeo en el contexto de una lista de sondeos (SessionProbes).	"Liveness" 'Inicio'

SessionProbeHttpGet

Nombre	Descripción	Importancia
host	Nombre de host al que conectarse, el valor predeterminado es la dirección IP del pod. Probablemente quiera establecer "Host" en httpHeaders en su lugar.	cuerda / cadena
httpHeaders	Encabezados personalizados que se van a establecer en la solicitud. HTTP permite encabezados repetidos.	SessionProbeHttpGetHttpHeadersItem[]
camino	Ruta de acceso al acceso en el servidor HTTP.	cuerda / cadena
port	Nombre o número del puerto al que se va a acceder en el contenedor. El número debe estar en el intervalo de 1 a 65535. El nombre debe ser un IANA_SVC_NAME.	int (obligatorio)
scheme	Esquema que se va a usar para conectarse al host. El valor predeterminado es HTTP.	'HTTP' 'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nombre	Descripción	Importancia
nombre	Nombre del campo de encabezado	string (obligatorio)
valor	Valor del campo de encabezado	string (obligatorio)

SessionProbeTcpSocket

Nombre	Descripción	Importancia
host	Opcional: nombre de host al que conectarse, el valor predeterminado es la dirección IP del pod.	cuerda / cadena
port	Número o nombre del puerto al que se va a acceder en el contenedor. El número debe estar en el intervalo de 1 a 65535. El nombre debe ser un IANA_SVC_NAME.	int (obligatorio)

SessionRegistryCredentials

Nombre	Descripción	Importancia
identidad	Una identidad administrada que se va a usar para autenticarse con Azure Container Registry. En el caso de las identidades asignadas por el usuario, use el identificador de recurso de identidad asignado por el usuario completo. En el caso de las identidades asignadas por el sistema, use "system"	cuerda / cadena
passwordSecretRef	Nombre del secreto que contiene la contraseña de inicio de sesión del Registro	cuerda / cadena
servidor	Servidor de registro de contenedor.	cuerda / cadena
nombre de usuario	Nombre de usuario del registro de contenedor.	cuerda / cadena

TrackedResourceTags

Nombre	Descripción	Importancia

UserAssignedIdentities

Nombre	Descripción	Importancia

IdentidadAsignadaPorElUsuario

Nombre	Descripción	Importancia