Compartilhar via

Microsoft.App sessionPools

Definição de recurso do Bicep

O tipo de recurso sessionPools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso de Microsoft.App/sessionPools, adicione o seguinte Bicep ao modelo.

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 propriedade

Microsoft.App/sessionPools

Nome Descrição Valor
identidade Identidades gerenciadas necessárias por um pool de sessões para interagir com outros serviços do Azure para não manter segredos ou credenciais no código. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
propriedades Propriedades específicas do recurso do pool de sessões do Aplicativo de Contêiner SessionPoolProperties
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Marcas em modelos

CustomContainerTemplate

Nome Descrição Valor
Recipientes Lista de definições de contêiner para as sessões do pool de sessão. Contêiner de Sessão
entrada Configuração de entrada do pool de sessão. SessionIngress
RegistryCredentials Credenciais de registro de contêiner privado para contêineres usados pelas sessões do pool de sessão. SessionRegistryCredentials

Configuração do Dynamic Pool

Nome Descrição Valor
ciclo de vidaConfiguração A configuração do ciclo de vida de uma sessão no pool de sessão dinâmica LifecycleConfiguration

Var Ambiente

Nome Descrição Valor
nome Nome da variável de ambiente. cadeia
secretRef Nome do segredo do Aplicativo de Contêiner do qual extrair o valor da variável de ambiente. cadeia
valor Valor de variável de ambiente não secreto. cadeia

Configuração do ciclo de vida

Nome Descrição Valor
cooldownPeriodInSeconds O período de resfriamento de uma sessão em segundos, quando o tipo de ciclo de vida é "Cronometrado". int
tipo de ciclo de vida O tipo de ciclo de vida do pool de sessão. 'OnContainerExit'
'Cronometrado'
maxAlivePeriodInSeconds O período máximo ativo de uma sessão em segundos quando o tipo de ciclo de vida é 'OnContainerExit'. int

Configuração de Identidade Gerenciada

Nome Descrição Valor
identidade A ID de recurso de uma identidade gerenciada atribuída pelo usuário atribuída ao Pool de Sessão ou "sistema" para a identidade atribuída pelo sistema. cadeia de caracteres (obrigatório)
ciclo de vida Use para selecionar os estágios do ciclo de vida de um Pool de Sessão durante o qual a Identidade Gerenciada deve estar disponível. 'Todos'
'Inicialização'
'Principal'
'Nenhum'

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhum'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Configurações do McpServer

Nome Descrição Valor
isMcpServerApiKeyDisabled Indica se a chave de API do servidor MCP está desativada. bool
isMcpServerEnabled Indica se o servidor MCP está habilitado. bool

Configuração de escala

Nome Descrição Valor
maxConcurrentSessions A contagem máxima de sessões ao mesmo tempo. int
readySessionInstances A contagem mínima de instâncias de sessão prontas. int

Contêiner de sessão

Nome Descrição Valor
argumentos Argumentos de comando de início de contêiner. cadeia de caracteres[]
comando Comando de início do contêiner. cadeia de caracteres[]
Env Variáveis de ambiente de contêiner. EnvironmentVar []
imagem Marca de imagem de contêiner. cadeia
nome Nome do contêiner personalizado. cadeia
probes Lista de investigações para o contêiner. Sonda de Sessão
recursos Requisitos de recursos de contêiner. SessionContainerResources

SessionContainerResources

Nome Descrição Valor
CPU CPU necessária em núcleos, por exemplo, 0,5 int
memória Memória necessária, por exemplo, "250 Mb" cadeia

SessionIngress

Nome Descrição Valor
targetPort Porta de destino em contêineres para tráfego de entrada int

Configuração de rede de sessão

Nome Descrição Valor
status Status da rede para as sessões. 'Saída Desabilitada'
'EgressEnabled'

SessionPoolProperties

Nome Descrição Valor
tipo contêiner O tipo de contêiner das sessões. 'Contêiner personalizado'
'PythonLTS'
customContainerTemplate A configuração de contêiner personalizado se o containerType for CustomContainer. CustomContainerTemplate
Configuração do Pool Dinâmico A configuração do pool se o poolManagementType for dinâmico. DynamicPoolConfiguration
ID do ambiente ID do recurso do ambiente do pool de sessão. cadeia
managedIdentitySettings Configurações opcionais para uma Identidade Gerenciada atribuída ao pool de sessão. ManagedIdentitySetting []
Configurações do mcpServer As configurações do servidor MCP (Model Context Protocol) do pool de sessões. Configurações do McpServer
poolManagementType O tipo de gerenciamento de pool do pool de sessões. 'Dinâmico'
'Manual'
scaleConfiguration A configuração de escala do pool de sessões. ScaleConfiguration
segredos Os segredos do pool de sessões. SessionPoolSecret []
sessionNetworkConfiguration A configuração de rede das sessões no pool de sessões. SessionNetworkConfiguration

Segredo da SessãoPool

Nome Descrição Valor
nome Nome do segredo. cadeia
valor Valor secreto. cadeia de caracteres

Restrições:
Valor confidencial. Passe como um parâmetro seguro.

Sonda de sessão

Nome Descrição Valor
failureThreshold Falhas consecutivas mínimas para que a investigação seja considerada falha após ter sido bem-sucedida. O valor padrão é 3. O valor mínimo é 1. O valor máximo é 10. int
httpGet HTTPGet especifica a solicitação http a ser executada. SessionProbeHttpGet
initialDelaySeconds Número de segundos depois que o contêiner é iniciado antes que as investigações de atividade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. int
periodSeconds Com que frequência (em segundos) executar a investigação. O padrão é 10 segundos. O valor mínimo é 1. O valor máximo é 240. int
successThreshold Sucessos mínimos consecutivos para que a investigação seja considerada bem-sucedida após ter falhado. O valor padrão é 1. Deve ser 1 para animação e inicialização. O valor mínimo é 1. O valor máximo é 10. int
tcpSoquete O TCPSocket especifica uma ação envolvendo uma porta TCP. Ainda não há suporte para ganchos TCP. SessionProbeTcpSocket
terminationGracePeriodSeconds Duração opcional em segundos, o pod precisa terminar normalmente após a falha da investigação. O período de carência é a duração em segundos depois que os processos em execução no pod são enviados um sinal de terminação e a hora em que os processos são interrompidos à força com um sinal de morte. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o processo. Se esse valor for nulo, os terminationGracePeriodSeconds do pod serão usados. Caso contrário, esse valor substituirá o valor fornecido pela especificação do pod. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente por meio do sinal de eliminação (sem oportunidade de desligar). Esse é um campo alfa e requer a habilitação do portão de recursos ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) int
timeoutSeconds Número de segundos após o qual a investigação atinge o tempo limite. O padrão é 1 segundo. O valor mínimo é 1. O valor máximo é 240. int
tipo Indica o tipo de sonda. Pode ser Liveness ou Startup, a sonda de prontidão não é suportada nas sessões. O tipo deve ser exclusivo para cada teste no contexto de uma lista de testes (SessionProbes). 'Vivacidade'
'Inicialização'

SessionProbeHttpGet

Nome Descrição Valor
hospedar O nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders. cadeia
httpCabeçalhos Cabeçalhos personalizados a serem definidos na solicitação. HTTP permite cabeçalhos repetidos. SessionProbeHttpGetHttpHeadersItem[]
caminho Caminho para acesso no servidor HTTP. cadeia
porta Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. int (obrigatório)
scheme Esquema a ser usado para se conectar ao host. O padrão é HTTP. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nome Descrição Valor
nome O nome do campo de cabeçalho cadeia de caracteres (obrigatório)
valor O valor do campo de cabeçalho cadeia de caracteres (obrigatório)

SessionProbeTcpSocket

Nome Descrição Valor
hospedar Opcional: nome do host ao qual se conectar, o padrão é o IP do pod. cadeia
porta Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. int (obrigatório)

SessionRegistryCredentials

Nome Descrição Valor
identidade Uma Identidade Gerenciada a ser usada para autenticar com o Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use a ID completa do recurso de identidade atribuída pelo usuário. Para identidades atribuídas pelo sistema, use 'system' cadeia
passwordSecretRef O nome do segredo que contém a senha de logon do Registro cadeia
servidor Servidor do Registro de Contêiner. cadeia
nome de usuário Nome de usuário do Registro de Contêiner. cadeia

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Descrição
do Pool de Sessões de Aplicativo Módulo de recurso AVM para pool de sessão de aplicativo

Definição de recurso de modelo do ARM

O tipo de recurso sessionPools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso de Microsoft.App/sessionPools, adicione o JSON a seguir ao modelo.

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

Microsoft.App/sessionPools

Nome Descrição Valor
apiVersion A versão da API '2025-10-02-preview'
identidade Identidades gerenciadas necessárias por um pool de sessões para interagir com outros serviços do Azure para não manter segredos ou credenciais no código. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
propriedades Propriedades específicas do recurso do pool de sessões do Aplicativo de Contêiner SessionPoolProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.App/sessionPools'

CustomContainerTemplate

Nome Descrição Valor
Recipientes Lista de definições de contêiner para as sessões do pool de sessão. Contêiner de Sessão
entrada Configuração de entrada do pool de sessão. SessionIngress
RegistryCredentials Credenciais de registro de contêiner privado para contêineres usados pelas sessões do pool de sessão. SessionRegistryCredentials

Configuração do Dynamic Pool

Nome Descrição Valor
ciclo de vidaConfiguração A configuração do ciclo de vida de uma sessão no pool de sessão dinâmica LifecycleConfiguration

Var Ambiente

Nome Descrição Valor
nome Nome da variável de ambiente. cadeia
secretRef Nome do segredo do Aplicativo de Contêiner do qual extrair o valor da variável de ambiente. cadeia
valor Valor de variável de ambiente não secreto. cadeia

Configuração do ciclo de vida

Nome Descrição Valor
cooldownPeriodInSeconds O período de resfriamento de uma sessão em segundos, quando o tipo de ciclo de vida é "Cronometrado". int
tipo de ciclo de vida O tipo de ciclo de vida do pool de sessão. 'OnContainerExit'
'Cronometrado'
maxAlivePeriodInSeconds O período máximo ativo de uma sessão em segundos quando o tipo de ciclo de vida é 'OnContainerExit'. int

Configuração de Identidade Gerenciada

Nome Descrição Valor
identidade A ID de recurso de uma identidade gerenciada atribuída pelo usuário atribuída ao Pool de Sessão ou "sistema" para a identidade atribuída pelo sistema. cadeia de caracteres (obrigatório)
ciclo de vida Use para selecionar os estágios do ciclo de vida de um Pool de Sessão durante o qual a Identidade Gerenciada deve estar disponível. 'Todos'
'Inicialização'
'Principal'
'Nenhum'

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhum'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Configurações do McpServer

Nome Descrição Valor
isMcpServerApiKeyDisabled Indica se a chave de API do servidor MCP está desativada. bool
isMcpServerEnabled Indica se o servidor MCP está habilitado. bool

Configuração de escala

Nome Descrição Valor
maxConcurrentSessions A contagem máxima de sessões ao mesmo tempo. int
readySessionInstances A contagem mínima de instâncias de sessão prontas. int

Contêiner de sessão

Nome Descrição Valor
argumentos Argumentos de comando de início de contêiner. cadeia de caracteres[]
comando Comando de início do contêiner. cadeia de caracteres[]
Env Variáveis de ambiente de contêiner. EnvironmentVar []
imagem Marca de imagem de contêiner. cadeia
nome Nome do contêiner personalizado. cadeia
probes Lista de investigações para o contêiner. Sonda de Sessão
recursos Requisitos de recursos de contêiner. SessionContainerResources

SessionContainerResources

Nome Descrição Valor
CPU CPU necessária em núcleos, por exemplo, 0,5 int
memória Memória necessária, por exemplo, "250 Mb" cadeia

SessionIngress

Nome Descrição Valor
targetPort Porta de destino em contêineres para tráfego de entrada int

Configuração de rede de sessão

Nome Descrição Valor
status Status da rede para as sessões. 'Saída Desabilitada'
'EgressEnabled'

SessionPoolProperties

Nome Descrição Valor
tipo contêiner O tipo de contêiner das sessões. 'Contêiner personalizado'
'PythonLTS'
customContainerTemplate A configuração de contêiner personalizado se o containerType for CustomContainer. CustomContainerTemplate
Configuração do Pool Dinâmico A configuração do pool se o poolManagementType for dinâmico. DynamicPoolConfiguration
ID do ambiente ID do recurso do ambiente do pool de sessão. cadeia
managedIdentitySettings Configurações opcionais para uma Identidade Gerenciada atribuída ao pool de sessão. ManagedIdentitySetting []
Configurações do mcpServer As configurações do servidor MCP (Model Context Protocol) do pool de sessões. Configurações do McpServer
poolManagementType O tipo de gerenciamento de pool do pool de sessões. 'Dinâmico'
'Manual'
scaleConfiguration A configuração de escala do pool de sessões. ScaleConfiguration
segredos Os segredos do pool de sessões. SessionPoolSecret []
sessionNetworkConfiguration A configuração de rede das sessões no pool de sessões. SessionNetworkConfiguration

Segredo da SessãoPool

Nome Descrição Valor
nome Nome do segredo. cadeia
valor Valor secreto. cadeia de caracteres

Restrições:
Valor confidencial. Passe como um parâmetro seguro.

Sonda de sessão

Nome Descrição Valor
failureThreshold Falhas consecutivas mínimas para que a investigação seja considerada falha após ter sido bem-sucedida. O valor padrão é 3. O valor mínimo é 1. O valor máximo é 10. int
httpGet HTTPGet especifica a solicitação http a ser executada. SessionProbeHttpGet
initialDelaySeconds Número de segundos depois que o contêiner é iniciado antes que as investigações de atividade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. int
periodSeconds Com que frequência (em segundos) executar a investigação. O padrão é 10 segundos. O valor mínimo é 1. O valor máximo é 240. int
successThreshold Sucessos mínimos consecutivos para que a investigação seja considerada bem-sucedida após ter falhado. O valor padrão é 1. Deve ser 1 para animação e inicialização. O valor mínimo é 1. O valor máximo é 10. int
tcpSoquete O TCPSocket especifica uma ação envolvendo uma porta TCP. Ainda não há suporte para ganchos TCP. SessionProbeTcpSocket
terminationGracePeriodSeconds Duração opcional em segundos, o pod precisa terminar normalmente após a falha da investigação. O período de carência é a duração em segundos depois que os processos em execução no pod são enviados um sinal de terminação e a hora em que os processos são interrompidos à força com um sinal de morte. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o processo. Se esse valor for nulo, os terminationGracePeriodSeconds do pod serão usados. Caso contrário, esse valor substituirá o valor fornecido pela especificação do pod. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente por meio do sinal de eliminação (sem oportunidade de desligar). Esse é um campo alfa e requer a habilitação do portão de recursos ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) int
timeoutSeconds Número de segundos após o qual a investigação atinge o tempo limite. O padrão é 1 segundo. O valor mínimo é 1. O valor máximo é 240. int
tipo Indica o tipo de sonda. Pode ser Liveness ou Startup, a sonda de prontidão não é suportada nas sessões. O tipo deve ser exclusivo para cada teste no contexto de uma lista de testes (SessionProbes). 'Vivacidade'
'Inicialização'

SessionProbeHttpGet

Nome Descrição Valor
hospedar O nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders. cadeia
httpCabeçalhos Cabeçalhos personalizados a serem definidos na solicitação. HTTP permite cabeçalhos repetidos. SessionProbeHttpGetHttpHeadersItem[]
caminho Caminho para acesso no servidor HTTP. cadeia
porta Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. int (obrigatório)
scheme Esquema a ser usado para se conectar ao host. O padrão é HTTP. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nome Descrição Valor
nome O nome do campo de cabeçalho cadeia de caracteres (obrigatório)
valor O valor do campo de cabeçalho cadeia de caracteres (obrigatório)

SessionProbeTcpSocket

Nome Descrição Valor
hospedar Opcional: nome do host ao qual se conectar, o padrão é o IP do pod. cadeia
porta Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. int (obrigatório)

SessionRegistryCredentials

Nome Descrição Valor
identidade Uma Identidade Gerenciada a ser usada para autenticar com o Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use a ID completa do recurso de identidade atribuída pelo usuário. Para identidades atribuídas pelo sistema, use 'system' cadeia
passwordSecretRef O nome do segredo que contém a senha de logon do Registro cadeia
servidor Servidor do Registro de Contêiner. cadeia
nome de usuário Nome de usuário do Registro de Contêiner. cadeia

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

Exemplos de uso

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso sessionPools pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso de Microsoft.App/sessionPools, adicione o Terraform a seguir ao seu modelo.

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 propriedade

Microsoft.App/sessionPools

Nome Descrição Valor
identidade Identidades gerenciadas necessárias por um pool de sessões para interagir com outros serviços do Azure para não manter segredos ou credenciais no código. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
propriedades Propriedades específicas do recurso do pool de sessões do Aplicativo de Contêiner SessionPoolProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.App/sessionPools@2025-10-02-preview"

CustomContainerTemplate

Nome Descrição Valor
Recipientes Lista de definições de contêiner para as sessões do pool de sessão. Contêiner de Sessão
entrada Configuração de entrada do pool de sessão. SessionIngress
RegistryCredentials Credenciais de registro de contêiner privado para contêineres usados pelas sessões do pool de sessão. SessionRegistryCredentials

Configuração do Dynamic Pool

Nome Descrição Valor
ciclo de vidaConfiguração A configuração do ciclo de vida de uma sessão no pool de sessão dinâmica LifecycleConfiguration

Var Ambiente

Nome Descrição Valor
nome Nome da variável de ambiente. cadeia
secretRef Nome do segredo do Aplicativo de Contêiner do qual extrair o valor da variável de ambiente. cadeia
valor Valor de variável de ambiente não secreto. cadeia

Configuração do ciclo de vida

Nome Descrição Valor
cooldownPeriodInSeconds O período de resfriamento de uma sessão em segundos, quando o tipo de ciclo de vida é "Cronometrado". int
tipo de ciclo de vida O tipo de ciclo de vida do pool de sessão. 'OnContainerExit'
'Cronometrado'
maxAlivePeriodInSeconds O período máximo ativo de uma sessão em segundos quando o tipo de ciclo de vida é 'OnContainerExit'. int

Configuração de Identidade Gerenciada

Nome Descrição Valor
identidade A ID de recurso de uma identidade gerenciada atribuída pelo usuário atribuída ao Pool de Sessão ou "sistema" para a identidade atribuída pelo sistema. cadeia de caracteres (obrigatório)
ciclo de vida Use para selecionar os estágios do ciclo de vida de um Pool de Sessão durante o qual a Identidade Gerenciada deve estar disponível. 'Todos'
'Inicialização'
'Principal'
'Nenhum'

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhum'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Configurações do McpServer

Nome Descrição Valor
isMcpServerApiKeyDisabled Indica se a chave de API do servidor MCP está desativada. bool
isMcpServerEnabled Indica se o servidor MCP está habilitado. bool

Configuração de escala

Nome Descrição Valor
maxConcurrentSessions A contagem máxima de sessões ao mesmo tempo. int
readySessionInstances A contagem mínima de instâncias de sessão prontas. int

Contêiner de sessão

Nome Descrição Valor
argumentos Argumentos de comando de início de contêiner. cadeia de caracteres[]
comando Comando de início do contêiner. cadeia de caracteres[]
Env Variáveis de ambiente de contêiner. EnvironmentVar []
imagem Marca de imagem de contêiner. cadeia
nome Nome do contêiner personalizado. cadeia
probes Lista de investigações para o contêiner. Sonda de Sessão
recursos Requisitos de recursos de contêiner. SessionContainerResources

SessionContainerResources

Nome Descrição Valor
CPU CPU necessária em núcleos, por exemplo, 0,5 int
memória Memória necessária, por exemplo, "250 Mb" cadeia

SessionIngress

Nome Descrição Valor
targetPort Porta de destino em contêineres para tráfego de entrada int

Configuração de rede de sessão

Nome Descrição Valor
status Status da rede para as sessões. 'Saída Desabilitada'
'EgressEnabled'

SessionPoolProperties

Nome Descrição Valor
tipo contêiner O tipo de contêiner das sessões. 'Contêiner personalizado'
'PythonLTS'
customContainerTemplate A configuração de contêiner personalizado se o containerType for CustomContainer. CustomContainerTemplate
Configuração do Pool Dinâmico A configuração do pool se o poolManagementType for dinâmico. DynamicPoolConfiguration
ID do ambiente ID do recurso do ambiente do pool de sessão. cadeia
managedIdentitySettings Configurações opcionais para uma Identidade Gerenciada atribuída ao pool de sessão. ManagedIdentitySetting []
Configurações do mcpServer As configurações do servidor MCP (Model Context Protocol) do pool de sessões. Configurações do McpServer
poolManagementType O tipo de gerenciamento de pool do pool de sessões. 'Dinâmico'
'Manual'
scaleConfiguration A configuração de escala do pool de sessões. ScaleConfiguration
segredos Os segredos do pool de sessões. SessionPoolSecret []
sessionNetworkConfiguration A configuração de rede das sessões no pool de sessões. SessionNetworkConfiguration

Segredo da SessãoPool

Nome Descrição Valor
nome Nome do segredo. cadeia
valor Valor secreto. cadeia de caracteres

Restrições:
Valor confidencial. Passe como um parâmetro seguro.

Sonda de sessão

Nome Descrição Valor
failureThreshold Falhas consecutivas mínimas para que a investigação seja considerada falha após ter sido bem-sucedida. O valor padrão é 3. O valor mínimo é 1. O valor máximo é 10. int
httpGet HTTPGet especifica a solicitação http a ser executada. SessionProbeHttpGet
initialDelaySeconds Número de segundos depois que o contêiner é iniciado antes que as investigações de atividade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. int
periodSeconds Com que frequência (em segundos) executar a investigação. O padrão é 10 segundos. O valor mínimo é 1. O valor máximo é 240. int
successThreshold Sucessos mínimos consecutivos para que a investigação seja considerada bem-sucedida após ter falhado. O valor padrão é 1. Deve ser 1 para animação e inicialização. O valor mínimo é 1. O valor máximo é 10. int
tcpSoquete O TCPSocket especifica uma ação envolvendo uma porta TCP. Ainda não há suporte para ganchos TCP. SessionProbeTcpSocket
terminationGracePeriodSeconds Duração opcional em segundos, o pod precisa terminar normalmente após a falha da investigação. O período de carência é a duração em segundos depois que os processos em execução no pod são enviados um sinal de terminação e a hora em que os processos são interrompidos à força com um sinal de morte. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o processo. Se esse valor for nulo, os terminationGracePeriodSeconds do pod serão usados. Caso contrário, esse valor substituirá o valor fornecido pela especificação do pod. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente por meio do sinal de eliminação (sem oportunidade de desligar). Esse é um campo alfa e requer a habilitação do portão de recursos ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) int
timeoutSeconds Número de segundos após o qual a investigação atinge o tempo limite. O padrão é 1 segundo. O valor mínimo é 1. O valor máximo é 240. int
tipo Indica o tipo de sonda. Pode ser Liveness ou Startup, a sonda de prontidão não é suportada nas sessões. O tipo deve ser exclusivo para cada teste no contexto de uma lista de testes (SessionProbes). 'Vivacidade'
'Inicialização'

SessionProbeHttpGet

Nome Descrição Valor
hospedar O nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders. cadeia
httpCabeçalhos Cabeçalhos personalizados a serem definidos na solicitação. HTTP permite cabeçalhos repetidos. SessionProbeHttpGetHttpHeadersItem[]
caminho Caminho para acesso no servidor HTTP. cadeia
porta Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. int (obrigatório)
scheme Esquema a ser usado para se conectar ao host. O padrão é HTTP. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nome Descrição Valor
nome O nome do campo de cabeçalho cadeia de caracteres (obrigatório)
valor O valor do campo de cabeçalho cadeia de caracteres (obrigatório)

SessionProbeTcpSocket

Nome Descrição Valor
hospedar Opcional: nome do host ao qual se conectar, o padrão é o IP do pod. cadeia
porta Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. int (obrigatório)

SessionRegistryCredentials

Nome Descrição Valor
identidade Uma Identidade Gerenciada a ser usada para autenticar com o Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use a ID completa do recurso de identidade atribuída pelo usuário. Para identidades atribuídas pelo sistema, use 'system' cadeia
passwordSecretRef O nome do segredo que contém a senha de logon do Registro cadeia
servidor Servidor do Registro de Contêiner. cadeia
nome de usuário Nome de usuário do Registro de Contêiner. cadeia

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor
  • Last updated on