Partilhar via

Microsoft.App sessionPools

Definição de recursos do bíceps

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 log de alterações.

Formato do recurso

Para criar um recurso Microsoft.App/sessionPools, adicione o seguinte Bíceps ao seu 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 para um pool de sessões interagir com outros serviços do Azure para não manter segredos ou credenciais no código. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (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
âmbito 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 Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

CustomContainerTemplate

Nome Descrição Valor
contentores Lista de definições de contêiner para as sessões do pool de sessões. SessionContainer []
entrada Configuração de entrada do pool de sessões. SessionIngress
registryCredenciais Credenciais de registro de contêiner privado para contêineres usados pelas sessões do pool de sessões. SessionRegistryCredentials

DynamicPoolConfiguration

Nome Descrição Valor
ciclo de vidaConfiguração A configuração do ciclo de vida de uma sessão no pool de sessões dinâmico Ciclo de vidaConfiguração

Variável de Ambiente

Nome Descrição Valor
nome Nome da variável de ambiente. cadeia (de caracteres)
secretRef Nome do segredo do aplicativo de contêiner do qual extrair o valor da variável de ambiente. cadeia (de caracteres)
valor Valor da variável de ambiente não secreto. cadeia (de caracteres)

Ciclo de vidaConfiguração

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ões. 'OnContainerExit'
'Cronometrado'
maxAlivePeriodInSeconds O período máximo de ativação de uma sessão em segundos quando o tipo de ciclo de vida é 'OnContainerExit'. Int

ManagedIdentitySetting

Nome Descrição Valor
identidade O ID de recurso de uma identidade gerenciada atribuída pelo usuário que é atribuída ao Pool de Sessões, ou 'sistema' para identidade atribuída ao sistema. string (obrigatório)
ciclo de vida Use para selecionar os estágios do ciclo de vida de um Pool de Sessões durante os quais a Identidade Gerenciada deve estar disponível. 'Todos'
'Init'
'Principal'
'Nenhuma'

ManagedServiceIdentity

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

McpServerSettings

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

ScaleConfiguration

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

SessionContainer

Nome Descrição Valor
Args Argumentos do comando Container start. string[]
comando Comando Container start. string[]
env Variáveis de ambiente de contêiner. AmbienteVar[]
imagem Tag de imagem de contêiner. cadeia (de caracteres)
nome Nome do contêiner personalizado. cadeia (de caracteres)
probes Lista de sondas para o recipiente. 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, "250Mb" cadeia (de caracteres)

SessionIngress

Nome Descrição Valor
Porto-alvo Porta de destino em contentores para o tráfego de entrada Int

SessionNetworkConfiguration

Nome Descrição Valor
estado Estado da rede para as sessões. 'EgressoDesativado'
'EgressEnabled'

SessionPoolProperties

Nome Descrição Valor
Tipo de contentor O tipo de contêiner das sessões. 'CustomContainer'
'PythonLTS'
customContainerTemplate A configuração de contêiner personalizada se containerType for CustomContainer. CustomContainerTemplate
dynamicPoolConfiguration A configuração do pool se o poolManagementType for dinâmico. DynamicPoolConfiguration
environmentId ID do recurso do ambiente do pool de sessões. cadeia (de caracteres)
managedIdentitySettings Configurações opcionais para uma Identidade Gerenciada atribuída ao Pool de Sessões. ManagedIdentitySetting []
mcpServerSettings As configurações do servidor MCP (Model Context Protocol) do pool de sessões. McpServerSettings
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

SessionPoolSecret

Nome Descrição Valor
nome Nome secreto. cadeia (de caracteres)
valor Valor Secreto. cadeia de caracteres

Restrições:
Valor sensível. Passe como um parâmetro seguro.

Sonda de Sessão

Nome Descrição Valor
failureThreshold Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O padrão é 3. O valor mínimo é 1. O valor máximo é 10. Int
httpObter HTTPGet especifica a solicitação http a ser executada. SessionProbeHttpGet
initialDelaySeconds Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. Int
segundosPeríodo Com que frequência (em segundos) realizar a sonda. O padrão é de 10 segundos. O valor mínimo é 1. O valor máximo é 240. Int
successThreshold Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. O padrão é 1. Deve ser 1 para liveness e startup. O valor mínimo é 1. O valor máximo é 10. Int
tcpSocket TCPSocket especifica uma ação envolvendo uma porta TCP. Ganchos TCP ainda não suportados. SessionProbeTcpSocket
terminationGracePeriodSeconds Duração opcional: em segundos, o pod precisa terminar normalmente em caso de falha da sonda. O período de carência é a duração em segundos após os processos em execução no pod receberem um sinal de terminação e o tempo 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 seu processo. Se esse valor for nulo, a terminationGracePeriodSeconds do pod será usada. 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 através do sinal de morte (sem oportunidade de encerrar). Este é um campo alfa e requer a ativação da porta de recurso ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) Int
timeoutSeconds Número de segundos após os quais a sonda atinge o tempo limite. O padrão é de 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 Readiness não é suportada em sessões. O tipo deve ser exclusivo para cada teste dentro do contexto de uma lista de testes (SessionProbes). 'Vivacidade'
'Startup'

SessionProbeHttpGet

Nome Descrição Valor
alojar Nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders em vez disso. cadeia (de caracteres)
Cabeçalhos HTTP Cabeçalhos personalizados para definir na solicitação. HTTP permite cabeçalhos repetidos. SessionProbeHttpGetHttpHeadersItem[]
caminho Caminho de acesso no servidor HTTP. cadeia (de caracteres)
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 string (obrigatório)
valor O valor do campo de cabeçalho string (obrigatório)

SessionProbeTcpSocket

Nome Descrição Valor
alojar Opcional: Nome do host ao qual se conectar, o padrão é o IP do pod. cadeia (de caracteres)
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 o ID de recurso de identidade atribuído pelo usuário completo. Para identidades atribuídas ao sistema, use 'system' cadeia (de caracteres)
senhaSecretRef O nome do segredo que contém a senha de login do Registro cadeia (de caracteres)
servidor Servidor de registro de contêiner. cadeia (de caracteres)
nome de utilizador Nome de usuário do registro de contêiner. cadeia (de caracteres)

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Nome Descrição Valor

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
Pool de sessões do aplicativo Módulo de recursos AVM para pool de sessões de aplicativos

Definição de recurso de modelo 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 log de alterações.

Formato do recurso

Para criar um recurso Microsoft.App/sessionPools, adicione o JSON a seguir ao seu 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
Versão da API A versão api '2025-10-02-pré-visualização'
identidade Identidades gerenciadas necessárias para um pool de sessões interagir com outros serviços do Azure para não manter segredos ou credenciais no código. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (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 Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.App/sessionPools'

CustomContainerTemplate

Nome Descrição Valor
contentores Lista de definições de contêiner para as sessões do pool de sessões. SessionContainer []
entrada Configuração de entrada do pool de sessões. SessionIngress
registryCredenciais Credenciais de registro de contêiner privado para contêineres usados pelas sessões do pool de sessões. SessionRegistryCredentials

DynamicPoolConfiguration

Nome Descrição Valor
ciclo de vidaConfiguração A configuração do ciclo de vida de uma sessão no pool de sessões dinâmico Ciclo de vidaConfiguração

Variável de Ambiente

Nome Descrição Valor
nome Nome da variável de ambiente. cadeia (de caracteres)
secretRef Nome do segredo do aplicativo de contêiner do qual extrair o valor da variável de ambiente. cadeia (de caracteres)
valor Valor da variável de ambiente não secreto. cadeia (de caracteres)

Ciclo de vidaConfiguração

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ões. 'OnContainerExit'
'Cronometrado'
maxAlivePeriodInSeconds O período máximo de ativação de uma sessão em segundos quando o tipo de ciclo de vida é 'OnContainerExit'. Int

ManagedIdentitySetting

Nome Descrição Valor
identidade O ID de recurso de uma identidade gerenciada atribuída pelo usuário que é atribuída ao Pool de Sessões, ou 'sistema' para identidade atribuída ao sistema. string (obrigatório)
ciclo de vida Use para selecionar os estágios do ciclo de vida de um Pool de Sessões durante os quais a Identidade Gerenciada deve estar disponível. 'Todos'
'Init'
'Principal'
'Nenhuma'

ManagedServiceIdentity

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

McpServerSettings

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

ScaleConfiguration

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

SessionContainer

Nome Descrição Valor
Args Argumentos do comando Container start. string[]
comando Comando Container start. string[]
env Variáveis de ambiente de contêiner. AmbienteVar[]
imagem Tag de imagem de contêiner. cadeia (de caracteres)
nome Nome do contêiner personalizado. cadeia (de caracteres)
probes Lista de sondas para o recipiente. 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, "250Mb" cadeia (de caracteres)

SessionIngress

Nome Descrição Valor
Porto-alvo Porta de destino em contentores para o tráfego de entrada Int

SessionNetworkConfiguration

Nome Descrição Valor
estado Estado da rede para as sessões. 'EgressoDesativado'
'EgressEnabled'

SessionPoolProperties

Nome Descrição Valor
Tipo de contentor O tipo de contêiner das sessões. 'CustomContainer'
'PythonLTS'
customContainerTemplate A configuração de contêiner personalizada se containerType for CustomContainer. CustomContainerTemplate
dynamicPoolConfiguration A configuração do pool se o poolManagementType for dinâmico. DynamicPoolConfiguration
environmentId ID do recurso do ambiente do pool de sessões. cadeia (de caracteres)
managedIdentitySettings Configurações opcionais para uma Identidade Gerenciada atribuída ao Pool de Sessões. ManagedIdentitySetting []
mcpServerSettings As configurações do servidor MCP (Model Context Protocol) do pool de sessões. McpServerSettings
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

SessionPoolSecret

Nome Descrição Valor
nome Nome secreto. cadeia (de caracteres)
valor Valor Secreto. cadeia de caracteres

Restrições:
Valor sensível. Passe como um parâmetro seguro.

Sonda de Sessão

Nome Descrição Valor
failureThreshold Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O padrão é 3. O valor mínimo é 1. O valor máximo é 10. Int
httpObter HTTPGet especifica a solicitação http a ser executada. SessionProbeHttpGet
initialDelaySeconds Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. Int
segundosPeríodo Com que frequência (em segundos) realizar a sonda. O padrão é de 10 segundos. O valor mínimo é 1. O valor máximo é 240. Int
successThreshold Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. O padrão é 1. Deve ser 1 para liveness e startup. O valor mínimo é 1. O valor máximo é 10. Int
tcpSocket TCPSocket especifica uma ação envolvendo uma porta TCP. Ganchos TCP ainda não suportados. SessionProbeTcpSocket
terminationGracePeriodSeconds Duração opcional: em segundos, o pod precisa terminar normalmente em caso de falha da sonda. O período de carência é a duração em segundos após os processos em execução no pod receberem um sinal de terminação e o tempo 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 seu processo. Se esse valor for nulo, a terminationGracePeriodSeconds do pod será usada. 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 através do sinal de morte (sem oportunidade de encerrar). Este é um campo alfa e requer a ativação da porta de recurso ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) Int
timeoutSeconds Número de segundos após os quais a sonda atinge o tempo limite. O padrão é de 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 Readiness não é suportada em sessões. O tipo deve ser exclusivo para cada teste dentro do contexto de uma lista de testes (SessionProbes). 'Vivacidade'
'Startup'

SessionProbeHttpGet

Nome Descrição Valor
alojar Nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders em vez disso. cadeia (de caracteres)
Cabeçalhos HTTP Cabeçalhos personalizados para definir na solicitação. HTTP permite cabeçalhos repetidos. SessionProbeHttpGetHttpHeadersItem[]
caminho Caminho de acesso no servidor HTTP. cadeia (de caracteres)
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 string (obrigatório)
valor O valor do campo de cabeçalho string (obrigatório)

SessionProbeTcpSocket

Nome Descrição Valor
alojar Opcional: Nome do host ao qual se conectar, o padrão é o IP do pod. cadeia (de caracteres)
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 o ID de recurso de identidade atribuído pelo usuário completo. Para identidades atribuídas ao sistema, use 'system' cadeia (de caracteres)
senhaSecretRef O nome do segredo que contém a senha de login do Registro cadeia (de caracteres)
servidor Servidor de registro de contêiner. cadeia (de caracteres)
nome de utilizador Nome de usuário do registro de contêiner. cadeia (de caracteres)

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Nome Descrição Valor

Exemplos de uso

Definição de recursos Terraform (provedor 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 log de alterações.

Formato do recurso

Para criar um recurso Microsoft.App/sessionPools, adicione o seguinte Terraform 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 para um pool de sessões interagir com outros serviços do Azure para não manter segredos ou credenciais no código. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (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. string (obrigatório)
propriedades Propriedades específicas do recurso do pool de sessões do aplicativo de contêiner SessionPoolProperties
etiquetas Tags 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
contentores Lista de definições de contêiner para as sessões do pool de sessões. SessionContainer []
entrada Configuração de entrada do pool de sessões. SessionIngress
registryCredenciais Credenciais de registro de contêiner privado para contêineres usados pelas sessões do pool de sessões. SessionRegistryCredentials

DynamicPoolConfiguration

Nome Descrição Valor
ciclo de vidaConfiguração A configuração do ciclo de vida de uma sessão no pool de sessões dinâmico Ciclo de vidaConfiguração

Variável de Ambiente

Nome Descrição Valor
nome Nome da variável de ambiente. cadeia (de caracteres)
secretRef Nome do segredo do aplicativo de contêiner do qual extrair o valor da variável de ambiente. cadeia (de caracteres)
valor Valor da variável de ambiente não secreto. cadeia (de caracteres)

Ciclo de vidaConfiguração

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ões. 'OnContainerExit'
'Cronometrado'
maxAlivePeriodInSeconds O período máximo de ativação de uma sessão em segundos quando o tipo de ciclo de vida é 'OnContainerExit'. Int

ManagedIdentitySetting

Nome Descrição Valor
identidade O ID de recurso de uma identidade gerenciada atribuída pelo usuário que é atribuída ao Pool de Sessões, ou 'sistema' para identidade atribuída ao sistema. string (obrigatório)
ciclo de vida Use para selecionar os estágios do ciclo de vida de um Pool de Sessões durante os quais a Identidade Gerenciada deve estar disponível. 'Todos'
'Init'
'Principal'
'Nenhuma'

ManagedServiceIdentity

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

McpServerSettings

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

ScaleConfiguration

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

SessionContainer

Nome Descrição Valor
Args Argumentos do comando Container start. string[]
comando Comando Container start. string[]
env Variáveis de ambiente de contêiner. AmbienteVar[]
imagem Tag de imagem de contêiner. cadeia (de caracteres)
nome Nome do contêiner personalizado. cadeia (de caracteres)
probes Lista de sondas para o recipiente. 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, "250Mb" cadeia (de caracteres)

SessionIngress

Nome Descrição Valor
Porto-alvo Porta de destino em contentores para o tráfego de entrada Int

SessionNetworkConfiguration

Nome Descrição Valor
estado Estado da rede para as sessões. 'EgressoDesativado'
'EgressEnabled'

SessionPoolProperties

Nome Descrição Valor
Tipo de contentor O tipo de contêiner das sessões. 'CustomContainer'
'PythonLTS'
customContainerTemplate A configuração de contêiner personalizada se containerType for CustomContainer. CustomContainerTemplate
dynamicPoolConfiguration A configuração do pool se o poolManagementType for dinâmico. DynamicPoolConfiguration
environmentId ID do recurso do ambiente do pool de sessões. cadeia (de caracteres)
managedIdentitySettings Configurações opcionais para uma Identidade Gerenciada atribuída ao Pool de Sessões. ManagedIdentitySetting []
mcpServerSettings As configurações do servidor MCP (Model Context Protocol) do pool de sessões. McpServerSettings
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

SessionPoolSecret

Nome Descrição Valor
nome Nome secreto. cadeia (de caracteres)
valor Valor Secreto. cadeia de caracteres

Restrições:
Valor sensível. Passe como um parâmetro seguro.

Sonda de Sessão

Nome Descrição Valor
failureThreshold Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O padrão é 3. O valor mínimo é 1. O valor máximo é 10. Int
httpObter HTTPGet especifica a solicitação http a ser executada. SessionProbeHttpGet
initialDelaySeconds Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. Int
segundosPeríodo Com que frequência (em segundos) realizar a sonda. O padrão é de 10 segundos. O valor mínimo é 1. O valor máximo é 240. Int
successThreshold Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. O padrão é 1. Deve ser 1 para liveness e startup. O valor mínimo é 1. O valor máximo é 10. Int
tcpSocket TCPSocket especifica uma ação envolvendo uma porta TCP. Ganchos TCP ainda não suportados. SessionProbeTcpSocket
terminationGracePeriodSeconds Duração opcional: em segundos, o pod precisa terminar normalmente em caso de falha da sonda. O período de carência é a duração em segundos após os processos em execução no pod receberem um sinal de terminação e o tempo 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 seu processo. Se esse valor for nulo, a terminationGracePeriodSeconds do pod será usada. 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 através do sinal de morte (sem oportunidade de encerrar). Este é um campo alfa e requer a ativação da porta de recurso ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) Int
timeoutSeconds Número de segundos após os quais a sonda atinge o tempo limite. O padrão é de 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 Readiness não é suportada em sessões. O tipo deve ser exclusivo para cada teste dentro do contexto de uma lista de testes (SessionProbes). 'Vivacidade'
'Startup'

SessionProbeHttpGet

Nome Descrição Valor
alojar Nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders em vez disso. cadeia (de caracteres)
Cabeçalhos HTTP Cabeçalhos personalizados para definir na solicitação. HTTP permite cabeçalhos repetidos. SessionProbeHttpGetHttpHeadersItem[]
caminho Caminho de acesso no servidor HTTP. cadeia (de caracteres)
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 string (obrigatório)
valor O valor do campo de cabeçalho string (obrigatório)

SessionProbeTcpSocket

Nome Descrição Valor
alojar Opcional: Nome do host ao qual se conectar, o padrão é o IP do pod. cadeia (de caracteres)
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 o ID de recurso de identidade atribuído pelo usuário completo. Para identidades atribuídas ao sistema, use 'system' cadeia (de caracteres)
senhaSecretRef O nome do segredo que contém a senha de login do Registro cadeia (de caracteres)
servidor Servidor de registro de contêiner. cadeia (de caracteres)
nome de utilizador Nome de usuário do registro de contêiner. cadeia (de caracteres)

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

IdentidadeAtribuídaPeloUtilizador

Nome Descrição Valor
  • Last updated on