Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Definição de recurso Bicep
O tipo de recurso sessionPools pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
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 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 | Identidades geridas necessárias por um grupo de sessões para 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 |
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 |
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
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 |
|---|
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 |
|---|---|
| App Session Pool | 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:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
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": "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 | Identidades geridas necessárias por um grupo de sessões para 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 |
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
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 |
|---|
Exemplos de uso
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso sessionPools pode ser implantado com operações direcionadas:
- Grupos de recursos
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@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 | Identidades geridas necessárias por um grupo de sessões para 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. |
| 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. | '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 |
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
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 |
|---|