Microsoft.App sessionPool

Definizione di risorsa Bicep

Il tipo di risorsa sessionPools può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/sessionPools, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.App/sessionPools@2025-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'
          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'
  }
}

Valori delle proprietà

Microsoft.App/sessionPools

Nome	Descrizione	Valore
identità	Identità gestite necessarie da un pool di sessioni per interagire con altri servizi di Azure per non mantenere segreti o credenziali nel codice.	ManagedServiceIdentity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	corda Vincoli: Lunghezza minima = 3 Lunghezza massima = 63 Pattern = `^[a-z][a-z0-9]*$` (obbligatorio)
proprietà	Proprietà specifiche delle risorse del pool di sessioni dell'app contenitore	Proprietà SessionPool
etichette	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

Modello di contenitore personalizzato

Nome	Descrizione	Valore
contenitori	Elenco delle definizioni di contenitore per le sessioni del pool di sessioni.	sessionContainer[]
ingresso	Configurazione in ingresso del pool di sessioni.	Ingresso sessione
registryCredentials	Credenziali del Registro Contenitori private per i contenitori usati dalle sessioni del pool di sessioni.	Credenziali SessionRegistryCredentials

Configurazione DynamicPoolConfiguration

Nome	Descrizione	Valore
ciclo di vitaConfigurazione	Configurazione del ciclo di vita di una sessione nel pool di sessioni dinamiche	Configurazione del ciclo di vita

AmbienteVar

Nome	Descrizione	Valore
nome	Nome della variabile di ambiente.	corda
secretRef	Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente.	corda
valore	Valore della variabile di ambiente non segreto.	corda

Configurazione del ciclo di vita

Nome	Descrizione	Valore
cooldownPeriodInSeconds	Periodo di raffreddamento di una sessione in secondi quando il tipo di ciclo di vita è "Timed".	Int
ciclo di vitaTipo	Tipo di ciclo di vita del pool di sessioni.	'OnContainerExit' 'Cronometrato'
maxAlivePeriodInSeconds	Periodo massimo attivo di una sessione in secondi quando il tipo di ciclo di vita è "OnContainerExit".	Int

ManagedIdentitySetting

Nome	Descrizione	Valore
identità	ID risorsa di un'identità gestita assegnata dall'utente assegnata dall'utente assegnata al pool di sessioni o "sistema" per l'identità assegnata dal sistema.	stringa (obbligatorio)
ciclo di vita	Usare per selezionare le fasi del ciclo di vita di un pool di sessioni durante la quale l'identità gestita deve essere disponibile.	'Tutti' 'Init' 'Principale' 'Nessuno'

Identità dei Servizi Gestiti

Nome	Descrizione	Valore
tipo	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'Nessuno' 'Assegnato dal sistema' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
userAssignedIdentities	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	UserAssignedIdentities

Impostazioni McpServer

Nome	Descrizione	Valore
isMcpServerApiKeyDisabled	Indica se la chiave API del server MCP è disabilitata.	bool
isMcpServerEnabled	Indica se il server MCP è abilitato.	bool

ScaleConfiguration

Nome	Descrizione	Valore
maxConcurrentSessions	Numero massimo di sessioni contemporaneamente.	Int
readySessionInstances	Numero minimo di istanze di sessione pronte.	Int

Contenitore di sessione

Nome	Descrizione	Valore
argomenti	Argomenti del comando di avvio del contenitore.	stringa[]
comando	Comando start del contenitore.	stringa[]
Env	Variabili di ambiente del contenitore.	EnvironmentVar[]
immagine	Tag immagine contenitore.	corda
nome	Nome del contenitore personalizzato.	corda
probes	Elenco di probe per il contenitore.	SessionProbe[]
risorse	Requisiti delle risorse del contenitore.	SessionContainerResources

SessionContainerResources

Nome	Descrizione	Valore
CPU	CPU necessaria nei core, ad esempio 0,5	Int
memoria	Memoria necessaria, ad esempio "250 Mb"	corda

Ingresso sessione

Nome	Descrizione	Valore
targetPort	Porta di destinazione nei contenitori per il traffico proveniente da ingresso	Int

Configurazione Rete Sessione

Nome	Descrizione	Valore
stato	Stato della rete per le sessioni.	'EgressDisabled' 'EgressEnabled'

Proprietà SessionPool

Nome	Descrizione	Valore
containerType	Tipo di contenitore delle sessioni.	'Contenitore personalizzato' 'PythonLTS'
customContainerTemplate	Configurazione del contenitore personalizzata se containerType è CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	Configurazione del pool se poolManagementType è dinamico.	Configurazione DynamicPoolConfiguration
environmentId	ID risorsa dell'ambiente del pool di sessioni.	corda
managedIdentitySettings	Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.	ManagedIdentitySetting[]
mcpServerImpostazioni	Le impostazioni del server MCP (Model Context Protocol) del pool di sessioni.	Impostazioni McpServer
poolManagementType	Tipo di gestione del pool di sessioni.	'Dinamico' 'Manuale'
scaleConfiguration	Configurazione della scalabilità del pool di sessioni.	ScaleConfiguration
segreti	Segreti del pool di sessioni.	SessionPoolSecret[]
sessioneNetworkConfiguration	Configurazione di rete delle sessioni nel pool di sessioni.	Configurazione Rete Sessione

SessionPoolSecret

Nome	Descrizione	Valore
nome	Nome segreto.	corda
valore	Valore segreto.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.

Sonda di sessione

Nome	Descrizione	Valore
failureThreshold	Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10.	Int
httpGet	HTTPGet specifica la richiesta HTTP da eseguire.	SessionProbeHttpGet
initialDelaySeconds	Il numero di secondi dopo l'avvio del contenitore prima che vengano avviati i probe di attività. Il valore minimo è 1. Il valore massimo è 60.	Int
periodSeconds	Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240.	Int
successThreshold	Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Assume il valore predefinito 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10.	Int
tcpSocket	TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati.	SessionProbeTcpSocket
terminationGracePeriodSeconds	La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora)	Int
timeoutSeconds	Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240.	Int
tipo	Indica il tipo di sonda. Può essere Liveness o Startup, il probe di prontezza non è supportato nelle sessioni. Il tipo deve essere univoco per ogni probe nel contesto di un elenco di probe (SessionProbes).	'Vitalità' 'Avvio'

SessionProbeHttpGet

Nome	Descrizione	Valore
ospitante	Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders.	corda
intestazioni HTTP	Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute.	SessionProbeHttpGetHttpHeadersItem[]
path	Percorso di accesso nel server HTTP.	corda
port	Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.	int (obbligatorio)
scheme	Schema da usare per la connessione all'host. Il valore predefinito è HTTP.	'HTTP' 'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nome	Descrizione	Valore
nome	Nome del campo dell'intestazione	stringa (obbligatorio)
valore	Valore del campo dell'intestazione	stringa (obbligatorio)

SessionProbeTcpSocket

Nome	Descrizione	Valore
ospitante	Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod.	corda
port	Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.	int (obbligatorio)

Credenziali SessionRegistryCredentials

Nome	Descrizione	Valore
identità	Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system'	corda
passwordSecretRef	Nome del segreto che contiene la password di accesso del Registro di sistema	corda
server	Server registro contenitori.	corda
nome utente	Nome utente registro contenitori.	corda

TrackedResourceTags

Nome	Descrizione	Valore

UserAssignedIdentities

Nome	Descrizione	Valore

Identità Assegnata dall'Utente

Nome	Descrizione	Valore

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Descrizione
pool di sessioni dell'app	Modulo di risorse AVM per il pool di sessioni dell'app

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa sessionPools può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/sessionPools, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

Microsoft.App/sessionPools

Nome	Descrizione	Valore
versione dell'API	Versione dell'API	'Anteprima 2025-10-02'
identità	Identità gestite necessarie da un pool di sessioni per interagire con altri servizi di Azure per non mantenere segreti o credenziali nel codice.	ManagedServiceIdentity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	corda Vincoli: Lunghezza minima = 3 Lunghezza massima = 63 Pattern = `^[a-z][a-z0-9]*$` (obbligatorio)
proprietà	Proprietà specifiche delle risorse del pool di sessioni dell'app contenitore	Proprietà SessionPool
etichette	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
tipo	Tipo di risorsa	'Microsoft.App/sessionPools'

Modello di contenitore personalizzato

Nome	Descrizione	Valore
contenitori	Elenco delle definizioni di contenitore per le sessioni del pool di sessioni.	sessionContainer[]
ingresso	Configurazione in ingresso del pool di sessioni.	Ingresso sessione
registryCredentials	Credenziali del Registro Contenitori private per i contenitori usati dalle sessioni del pool di sessioni.	Credenziali SessionRegistryCredentials

Configurazione DynamicPoolConfiguration

Nome	Descrizione	Valore
ciclo di vitaConfigurazione	Configurazione del ciclo di vita di una sessione nel pool di sessioni dinamiche	Configurazione del ciclo di vita

AmbienteVar

Nome	Descrizione	Valore
nome	Nome della variabile di ambiente.	corda
secretRef	Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente.	corda
valore	Valore della variabile di ambiente non segreto.	corda

Configurazione del ciclo di vita

Nome	Descrizione	Valore
cooldownPeriodInSeconds	Periodo di raffreddamento di una sessione in secondi quando il tipo di ciclo di vita è "Timed".	Int
ciclo di vitaTipo	Tipo di ciclo di vita del pool di sessioni.	'OnContainerExit' 'Cronometrato'
maxAlivePeriodInSeconds	Periodo massimo attivo di una sessione in secondi quando il tipo di ciclo di vita è "OnContainerExit".	Int

ManagedIdentitySetting

Nome	Descrizione	Valore
identità	ID risorsa di un'identità gestita assegnata dall'utente assegnata dall'utente assegnata al pool di sessioni o "sistema" per l'identità assegnata dal sistema.	stringa (obbligatorio)
ciclo di vita	Usare per selezionare le fasi del ciclo di vita di un pool di sessioni durante la quale l'identità gestita deve essere disponibile.	'Tutti' 'Init' 'Principale' 'Nessuno'

Identità dei Servizi Gestiti

Nome	Descrizione	Valore
tipo	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'Nessuno' 'Assegnato dal sistema' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
userAssignedIdentities	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	UserAssignedIdentities

Impostazioni McpServer

Nome	Descrizione	Valore
isMcpServerApiKeyDisabled	Indica se la chiave API del server MCP è disabilitata.	bool
isMcpServerEnabled	Indica se il server MCP è abilitato.	bool

ScaleConfiguration

Nome	Descrizione	Valore
maxConcurrentSessions	Numero massimo di sessioni contemporaneamente.	Int
readySessionInstances	Numero minimo di istanze di sessione pronte.	Int

Contenitore di sessione

Nome	Descrizione	Valore
argomenti	Argomenti del comando di avvio del contenitore.	stringa[]
comando	Comando start del contenitore.	stringa[]
Env	Variabili di ambiente del contenitore.	EnvironmentVar[]
immagine	Tag immagine contenitore.	corda
nome	Nome del contenitore personalizzato.	corda
probes	Elenco di probe per il contenitore.	SessionProbe[]
risorse	Requisiti delle risorse del contenitore.	SessionContainerResources

SessionContainerResources

Nome	Descrizione	Valore
CPU	CPU necessaria nei core, ad esempio 0,5	Int
memoria	Memoria necessaria, ad esempio "250 Mb"	corda

Ingresso sessione

Nome	Descrizione	Valore
targetPort	Porta di destinazione nei contenitori per il traffico proveniente da ingresso	Int

Configurazione Rete Sessione

Nome	Descrizione	Valore
stato	Stato della rete per le sessioni.	'EgressDisabled' 'EgressEnabled'

Proprietà SessionPool

Nome	Descrizione	Valore
containerType	Tipo di contenitore delle sessioni.	'Contenitore personalizzato' 'PythonLTS'
customContainerTemplate	Configurazione del contenitore personalizzata se containerType è CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	Configurazione del pool se poolManagementType è dinamico.	Configurazione DynamicPoolConfiguration
environmentId	ID risorsa dell'ambiente del pool di sessioni.	corda
managedIdentitySettings	Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.	ManagedIdentitySetting[]
mcpServerImpostazioni	Le impostazioni del server MCP (Model Context Protocol) del pool di sessioni.	Impostazioni McpServer
poolManagementType	Tipo di gestione del pool di sessioni.	'Dinamico' 'Manuale'
scaleConfiguration	Configurazione della scalabilità del pool di sessioni.	ScaleConfiguration
segreti	Segreti del pool di sessioni.	SessionPoolSecret[]
sessioneNetworkConfiguration	Configurazione di rete delle sessioni nel pool di sessioni.	Configurazione Rete Sessione

SessionPoolSecret

Nome	Descrizione	Valore
nome	Nome segreto.	corda
valore	Valore segreto.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.

Sonda di sessione

Nome	Descrizione	Valore
failureThreshold	Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10.	Int
httpGet	HTTPGet specifica la richiesta HTTP da eseguire.	SessionProbeHttpGet
initialDelaySeconds	Il numero di secondi dopo l'avvio del contenitore prima che vengano avviati i probe di attività. Il valore minimo è 1. Il valore massimo è 60.	Int
periodSeconds	Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240.	Int
successThreshold	Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Assume il valore predefinito 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10.	Int
tcpSocket	TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati.	SessionProbeTcpSocket
terminationGracePeriodSeconds	La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora)	Int
timeoutSeconds	Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240.	Int
tipo	Indica il tipo di sonda. Può essere Liveness o Startup, il probe di prontezza non è supportato nelle sessioni. Il tipo deve essere univoco per ogni probe nel contesto di un elenco di probe (SessionProbes).	'Vitalità' 'Avvio'

SessionProbeHttpGet

Nome	Descrizione	Valore
ospitante	Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders.	corda
intestazioni HTTP	Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute.	SessionProbeHttpGetHttpHeadersItem[]
path	Percorso di accesso nel server HTTP.	corda
port	Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.	int (obbligatorio)
scheme	Schema da usare per la connessione all'host. Il valore predefinito è HTTP.	'HTTP' 'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nome	Descrizione	Valore
nome	Nome del campo dell'intestazione	stringa (obbligatorio)
valore	Valore del campo dell'intestazione	stringa (obbligatorio)

SessionProbeTcpSocket

Nome	Descrizione	Valore
ospitante	Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod.	corda
port	Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.	int (obbligatorio)

Credenziali SessionRegistryCredentials

Nome	Descrizione	Valore
identità	Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system'	corda
passwordSecretRef	Nome del segreto che contiene la password di accesso del Registro di sistema	corda
server	Server registro contenitori.	corda
nome utente	Nome utente registro contenitori.	corda

TrackedResourceTags

Nome	Descrizione	Valore

UserAssignedIdentities

Nome	Descrizione	Valore

Identità Assegnata dall'Utente

Nome	Descrizione	Valore

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa sessionPools può essere distribuito con operazioni destinate a:

Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/sessionPools, aggiungere il modello Terraform seguente.

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

Valori delle proprietà

Microsoft.App/sessionPools

Nome	Descrizione	Valore
identità	Identità gestite necessarie da un pool di sessioni per interagire con altri servizi di Azure per non mantenere segreti o credenziali nel codice.	ManagedServiceIdentity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	corda Vincoli: Lunghezza minima = 3 Lunghezza massima = 63 Pattern = `^[a-z][a-z0-9]*$` (obbligatorio)
proprietà	Proprietà specifiche delle risorse del pool di sessioni dell'app contenitore	Proprietà SessionPool
etichette	Tag delle risorse	Dizionario di nomi e valori di tag.
tipo	Tipo di risorsa	"Microsoft.App/sessionPools@2025-10-02-preview"

Modello di contenitore personalizzato

Nome	Descrizione	Valore
contenitori	Elenco delle definizioni di contenitore per le sessioni del pool di sessioni.	sessionContainer[]
ingresso	Configurazione in ingresso del pool di sessioni.	Ingresso sessione
registryCredentials	Credenziali del Registro Contenitori private per i contenitori usati dalle sessioni del pool di sessioni.	Credenziali SessionRegistryCredentials

Configurazione DynamicPoolConfiguration

Nome	Descrizione	Valore
ciclo di vitaConfigurazione	Configurazione del ciclo di vita di una sessione nel pool di sessioni dinamiche	Configurazione del ciclo di vita

AmbienteVar

Nome	Descrizione	Valore
nome	Nome della variabile di ambiente.	corda
secretRef	Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente.	corda
valore	Valore della variabile di ambiente non segreto.	corda

Configurazione del ciclo di vita

Nome	Descrizione	Valore
cooldownPeriodInSeconds	Periodo di raffreddamento di una sessione in secondi quando il tipo di ciclo di vita è "Timed".	Int
ciclo di vitaTipo	Tipo di ciclo di vita del pool di sessioni.	'OnContainerExit' 'Cronometrato'
maxAlivePeriodInSeconds	Periodo massimo attivo di una sessione in secondi quando il tipo di ciclo di vita è "OnContainerExit".	Int

ManagedIdentitySetting

Nome	Descrizione	Valore
identità	ID risorsa di un'identità gestita assegnata dall'utente assegnata dall'utente assegnata al pool di sessioni o "sistema" per l'identità assegnata dal sistema.	stringa (obbligatorio)
ciclo di vita	Usare per selezionare le fasi del ciclo di vita di un pool di sessioni durante la quale l'identità gestita deve essere disponibile.	'Tutti' 'Init' 'Principale' 'Nessuno'

Identità dei Servizi Gestiti

Nome	Descrizione	Valore
tipo	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'Nessuno' 'Assegnato dal sistema' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
userAssignedIdentities	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	UserAssignedIdentities

Impostazioni McpServer

Nome	Descrizione	Valore
isMcpServerApiKeyDisabled	Indica se la chiave API del server MCP è disabilitata.	bool
isMcpServerEnabled	Indica se il server MCP è abilitato.	bool

ScaleConfiguration

Nome	Descrizione	Valore
maxConcurrentSessions	Numero massimo di sessioni contemporaneamente.	Int
readySessionInstances	Numero minimo di istanze di sessione pronte.	Int

Contenitore di sessione

Nome	Descrizione	Valore
argomenti	Argomenti del comando di avvio del contenitore.	stringa[]
comando	Comando start del contenitore.	stringa[]
Env	Variabili di ambiente del contenitore.	EnvironmentVar[]
immagine	Tag immagine contenitore.	corda
nome	Nome del contenitore personalizzato.	corda
probes	Elenco di probe per il contenitore.	SessionProbe[]
risorse	Requisiti delle risorse del contenitore.	SessionContainerResources

SessionContainerResources

Nome	Descrizione	Valore
CPU	CPU necessaria nei core, ad esempio 0,5	Int
memoria	Memoria necessaria, ad esempio "250 Mb"	corda

Ingresso sessione

Nome	Descrizione	Valore
targetPort	Porta di destinazione nei contenitori per il traffico proveniente da ingresso	Int

Configurazione Rete Sessione

Nome	Descrizione	Valore
stato	Stato della rete per le sessioni.	'EgressDisabled' 'EgressEnabled'

Proprietà SessionPool

Nome	Descrizione	Valore
containerType	Tipo di contenitore delle sessioni.	'Contenitore personalizzato' 'PythonLTS'
customContainerTemplate	Configurazione del contenitore personalizzata se containerType è CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	Configurazione del pool se poolManagementType è dinamico.	Configurazione DynamicPoolConfiguration
environmentId	ID risorsa dell'ambiente del pool di sessioni.	corda
managedIdentitySettings	Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.	ManagedIdentitySetting[]
mcpServerImpostazioni	Le impostazioni del server MCP (Model Context Protocol) del pool di sessioni.	Impostazioni McpServer
poolManagementType	Tipo di gestione del pool di sessioni.	'Dinamico' 'Manuale'
scaleConfiguration	Configurazione della scalabilità del pool di sessioni.	ScaleConfiguration
segreti	Segreti del pool di sessioni.	SessionPoolSecret[]
sessioneNetworkConfiguration	Configurazione di rete delle sessioni nel pool di sessioni.	Configurazione Rete Sessione

SessionPoolSecret

Nome	Descrizione	Valore
nome	Nome segreto.	corda
valore	Valore segreto.	corda Vincoli: Valore sensibile. Passare come parametro sicuro.

Sonda di sessione

Nome	Descrizione	Valore
failureThreshold	Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10.	Int
httpGet	HTTPGet specifica la richiesta HTTP da eseguire.	SessionProbeHttpGet
initialDelaySeconds	Il numero di secondi dopo l'avvio del contenitore prima che vengano avviati i probe di attività. Il valore minimo è 1. Il valore massimo è 60.	Int
periodSeconds	Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240.	Int
successThreshold	Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Assume il valore predefinito 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10.	Int
tcpSocket	TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati.	SessionProbeTcpSocket
terminationGracePeriodSeconds	La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora)	Int
timeoutSeconds	Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240.	Int
tipo	Indica il tipo di sonda. Può essere Liveness o Startup, il probe di prontezza non è supportato nelle sessioni. Il tipo deve essere univoco per ogni probe nel contesto di un elenco di probe (SessionProbes).	'Vitalità' 'Avvio'

SessionProbeHttpGet

Nome	Descrizione	Valore
ospitante	Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders.	corda
intestazioni HTTP	Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute.	SessionProbeHttpGetHttpHeadersItem[]
path	Percorso di accesso nel server HTTP.	corda
port	Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.	int (obbligatorio)
scheme	Schema da usare per la connessione all'host. Il valore predefinito è HTTP.	'HTTP' 'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nome	Descrizione	Valore
nome	Nome del campo dell'intestazione	stringa (obbligatorio)
valore	Valore del campo dell'intestazione	stringa (obbligatorio)

SessionProbeTcpSocket

Nome	Descrizione	Valore
ospitante	Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod.	corda
port	Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.	int (obbligatorio)

Credenziali SessionRegistryCredentials

Nome	Descrizione	Valore
identità	Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system'	corda
passwordSecretRef	Nome del segreto che contiene la password di accesso del Registro di sistema	corda
server	Server registro contenitori.	corda
nome utente	Nome utente registro contenitori.	corda

TrackedResourceTags

Nome	Descrizione	Valore

UserAssignedIdentities

Nome	Descrizione	Valore

Identità Assegnata dall'Utente

Nome	Descrizione	Valore

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2025-11-11

Condividi tramite

Microsoft.App sessionPool

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Microsoft.App/sessionPools

Modello di contenitore personalizzato

Configurazione DynamicPoolConfiguration

AmbienteVar

Configurazione del ciclo di vita

ManagedIdentitySetting

Identità dei Servizi Gestiti

Impostazioni McpServer

ScaleConfiguration

Contenitore di sessione

SessionContainerResources

Ingresso sessione

Configurazione Rete Sessione

Proprietà SessionPool

SessionPoolSecret

Sonda di sessione

SessionProbeHttpGet

SessionProbeHttpGetHttpHeadersItem

SessionProbeTcpSocket

Credenziali SessionRegistryCredentials

TrackedResourceTags

UserAssignedIdentities

Identità Assegnata dall'Utente

Esempi di utilizzo

Moduli verificati di Azure

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Microsoft.App/sessionPools

Modello di contenitore personalizzato

Configurazione DynamicPoolConfiguration

AmbienteVar

Configurazione del ciclo di vita

ManagedIdentitySetting

Identità dei Servizi Gestiti

Impostazioni McpServer

ScaleConfiguration

Contenitore di sessione

SessionContainerResources

Ingresso sessione

Configurazione Rete Sessione

Proprietà SessionPool

SessionPoolSecret

Sonda di sessione

SessionProbeHttpGet

SessionProbeHttpGetHttpHeadersItem

SessionProbeTcpSocket

Credenziali SessionRegistryCredentials

TrackedResourceTags

UserAssignedIdentities

Identità Assegnata dall'Utente

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Microsoft.App/sessionPools

Modello di contenitore personalizzato

Configurazione DynamicPoolConfiguration

AmbienteVar

Configurazione del ciclo di vita

ManagedIdentitySetting

Identità dei Servizi Gestiti

Impostazioni McpServer

ScaleConfiguration

Contenitore di sessione

SessionContainerResources

Ingresso sessione

Configurazione Rete Sessione

Proprietà SessionPool

SessionPoolSecret

Sonda di sessione

SessionProbeHttpGet

SessionProbeHttpGetHttpHeadersItem

SessionProbeTcpSocket

Credenziali SessionRegistryCredentials