Microsoft.App sessões Pools

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

Exemplos de uso

Módulos verificados do Azure

Os seguintes Azure Módulos Verificados podem ser usados para implementar este tipo de recurso.

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

Formato do recurso

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

resource symbolicname 'Microsoft.App/sessionPools@2026-01-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containerType: 'string'
    customContainerTemplate: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          resources: {
            cpu: int
            memory: 'string'
          }
        }
      ]
      ingress: {
        targetPort: int
      }
      registryCredentials: {
        identity: 'string'
        passwordSecretRef: 'string'
        server: 'string'
        username: 'string'
      }
    }
    dynamicPoolConfiguration: {
      lifecycleConfiguration: {
        cooldownPeriodInSeconds: int
        lifecycleType: 'string'
        maxAlivePeriodInSeconds: int
      }
    }
    environmentId: 'string'
    managedIdentitySettings: [
      {
        identity: 'string'
        lifecycle: 'string'
      }
    ]
    poolManagementType: 'string'
    scaleConfiguration: {
      maxConcurrentSessions: int
      readySessionInstances: int
    }
    secrets: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    sessionNetworkConfiguration: {
      status: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.App/sessionPools

Nome Descrição Valor
identidade As identidades de serviço gerenciado atribuídas a este recurso. 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

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

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)
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. Podes usar o teu próprio contentor para construir o pool de sessões, ou podes usar um contentor pré-definido para executar cargas de trabalho com linguagem específica. '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 []
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.

SessionRegistryCredentials

Nome Descrição Valor
identidade Uma Identidade Gerida para usar para autenticar com o Azure Container Registry. 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

Definição de recurso de modelo ARM

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

Exemplos de uso

Formato do recurso

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

{
  "type": "Microsoft.App/sessionPools",
  "apiVersion": "2026-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "containerType": "string",
    "customContainerTemplate": {
      "containers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "resources": {
            "cpu": "int",
            "memory": "string"
          }
        }
      ],
      "ingress": {
        "targetPort": "int"
      },
      "registryCredentials": {
        "identity": "string",
        "passwordSecretRef": "string",
        "server": "string",
        "username": "string"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": "int",
        "lifecycleType": "string",
        "maxAlivePeriodInSeconds": "int"
      }
    },
    "environmentId": "string",
    "managedIdentitySettings": [
      {
        "identity": "string",
        "lifecycle": "string"
      }
    ],
    "poolManagementType": "string",
    "scaleConfiguration": {
      "maxConcurrentSessions": "int",
      "readySessionInstances": "int"
    },
    "secrets": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "sessionNetworkConfiguration": {
      "status": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.App/sessionPools

Nome Descrição Valor
Versão da API A versão api '2026-01-01'
identidade As identidades de serviço gerenciado atribuídas a este recurso. 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. '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

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)
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. Podes usar o teu próprio contentor para construir o pool de sessões, ou podes usar um contentor pré-definido para executar cargas de trabalho com linguagem específica. '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 []
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.

SessionRegistryCredentials

Nome Descrição Valor
identidade Uma Identidade Gerida para usar para autenticar com o Azure Container Registry. 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

Definição de recursos Terraform (provedor AzAPI)

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

  • Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja registo 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@2026-01-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      containerType = "string"
      customContainerTemplate = {
        containers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            resources = {
              cpu = int
              memory = "string"
            }
          }
        ]
        ingress = {
          targetPort = int
        }
        registryCredentials = {
          identity = "string"
          passwordSecretRef = "string"
          server = "string"
          username = "string"
        }
      }
      dynamicPoolConfiguration = {
        lifecycleConfiguration = {
          cooldownPeriodInSeconds = int
          lifecycleType = "string"
          maxAlivePeriodInSeconds = int
        }
      }
      environmentId = "string"
      managedIdentitySettings = [
        {
          identity = "string"
          lifecycle = "string"
        }
      ]
      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 As identidades de serviço gerenciado atribuídas a este recurso. 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.
tipo O tipo de recurso "Microsoft.App/sessionPools@2026-01-01"

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

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)
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. Podes usar o teu próprio contentor para construir o pool de sessões, ou podes usar um contentor pré-definido para executar cargas de trabalho com linguagem específica. '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 []
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.

SessionRegistryCredentials

Nome Descrição Valor
identidade Uma Identidade Gerida para usar para autenticar com o Azure Container Registry. 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