Microsoft.App sessionPools

Article
12/21/2024

Définition de ressource Bicep

Le type de ressource sessionPools peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.App/sessionPools, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.App/sessionPools@2024-10-02-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containerType: 'string'
    customContainerTemplate: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          resources: {
            cpu: int
            memory: 'string'
          }
        }
      ]
      ingress: {
        targetPort: int
      }
      registryCredentials: {
        identity: 'string'
        passwordSecretRef: 'string'
        server: 'string'
        username: 'string'
      }
    }
    dynamicPoolConfiguration: {
      cooldownPeriodInSeconds: int
      executionType: 'string'
    }
    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'
  }
}

Valeurs de propriété

CustomContainerTemplate

Nom	Description	Valeur
Conteneurs	Liste des définitions de conteneur pour les sessions du pool de sessions.	SessionContainer[]
entrée	Configuration de l’entrée du pool de sessions.	SessionIngress
registryCredentials	Informations d’identification du registre de conteneurs privés pour les conteneurs utilisés par les sessions du pool de sessions.	SessionRegistryCredentials

DynamicPoolConfiguration

Nom	Description	Valeur
cooldownPeriodInSeconds	Période de refroidissement d’une session en secondes.	Int
executionType	Type d’exécution du pool de sessions.	'Timed'

EnvironmentVar

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.	corde
valeur	Valeur de variable d’environnement non secrète.	corde

ManagedIdentitySetting

Nom	Description	Valeur
identité	ID de ressource d’une identité managée affectée par l’utilisateur qui est affectée au pool de sessions, ou « système » pour l’identité affectée par le système.	chaîne (obligatoire)
cycle de vie	Permet de sélectionner les étapes de cycle de vie d’un pool de sessions pendant lesquelles l’identité managée doit être disponible.	'All' 'Init' 'Main' 'None'

ManagedServiceIdentity

Nom	Description	Valeur
type	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire)
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

Microsoft.App/sessionPools

Nom	Description	Valeur
identité	Identités managées nécessaires par un pool de sessions pour interagir avec d’autres services Azure pour ne pas conserver de secrets ou d’informations d’identification dans le code.	ManagedServiceIdentity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 3 Longueur maximale = 3 Modèle = `^[a-z][a-z0-9]*$` (obligatoire)
Propriétés	Propriétés spécifiques à la ressource du pool de sessions d’application conteneur	sessionPoolProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

ScaleConfiguration

Nom	Description	Valeur
maxConcurrentSessions	Nombre maximal de sessions en même temps.	Int
readySessionInstances	Nombre minimal d’instances de session prêtes.	Int

SessionContainer

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
ressources	Exigences en matière de ressources de conteneur.	SessionContainerResources

SessionContainerResources

Nom	Description	Valeur
CPU	Processeur requis dans les cœurs, par exemple 0,5	Int
mémoire	Mémoire requise, par exemple « 250 Mo »	corde

SessionIngress

Nom	Description	Valeur
targetPort	Port cible dans les conteneurs pour le trafic à partir d’entrée	Int

SessionNetworkConfiguration

Nom	Description	Valeur
statut	État réseau des sessions.	'EgressDisabled' 'EgressEnabled'

SessionPoolProperties

Nom	Description	Valeur
containerType	Type de conteneur des sessions.	'CustomContainer' 'PythonLTS'
customContainerTemplate	Configuration de conteneur personnalisée si le containerType est CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	Configuration du pool si poolManagementType est dynamique.	DynamicPoolConfiguration
environmentId	ID de ressource de l’environnement du pool de sessions.	corde
managedIdentitySettings	Paramètres facultatifs pour une identité managée affectée au pool de sessions.	ManagedIdentitySetting[]
poolManagementType	Type de gestion du pool de sessions.	'Dynamique' 'Manuel'
scaleConfiguration	Configuration de mise à l’échelle du pool de sessions.	ScaleConfiguration
Secrets	Secrets du pool de sessions.	SessionPoolSecret[]
sessionNetworkConfiguration	Configuration réseau des sessions dans le pool de sessions.	sessionNetworkConfiguration

SessionPoolSecret

Nom	Description	Valeur
nom	Nom du secret.	corde
valeur	Valeur secrète.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

SessionRegistryCredentials

Nom	Description	Valeur
identité	Identité managée à utiliser pour s’authentifier auprès d’Azure Container Registry. Pour les identités affectées par l’utilisateur, utilisez l’ID complet de ressource d’identité affectée par l’utilisateur. Pour les identités affectées par le système, utilisez « système »	corde
passwordSecretRef	Nom du secret qui contient le mot de passe de connexion au Registre	corde
serveur	Serveur de registre de conteneurs.	corde
nom d’utilisateur	Nom d’utilisateur du registre de conteneurs.	corde

TrackedResourceTags

Nom	Description	Valeur

UserAssignedIdentities

Nom	Description	Valeur

UserAssignedIdentity

Nom	Description	Valeur

Définition de ressource de modèle ARM

Le type de ressource sessionPools peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.App/sessionPools, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.App/sessionPools",
  "apiVersion": "2024-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",
          "resources": {
            "cpu": "int",
            "memory": "string"
          }
        }
      ],
      "ingress": {
        "targetPort": "int"
      },
      "registryCredentials": {
        "identity": "string",
        "passwordSecretRef": "string",
        "server": "string",
        "username": "string"
      }
    },
    "dynamicPoolConfiguration": {
      "cooldownPeriodInSeconds": "int",
      "executionType": "string"
    },
    "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"
  }
}

Valeurs de propriété

CustomContainerTemplate

Nom	Description	Valeur
Conteneurs	Liste des définitions de conteneur pour les sessions du pool de sessions.	SessionContainer[]
entrée	Configuration de l’entrée du pool de sessions.	SessionIngress
registryCredentials	Informations d’identification du registre de conteneurs privés pour les conteneurs utilisés par les sessions du pool de sessions.	SessionRegistryCredentials

DynamicPoolConfiguration

Nom	Description	Valeur
cooldownPeriodInSeconds	Période de refroidissement d’une session en secondes.	Int
executionType	Type d’exécution du pool de sessions.	'Timed'

EnvironmentVar

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.	corde
valeur	Valeur de variable d’environnement non secrète.	corde

ManagedIdentitySetting

Nom	Description	Valeur
identité	ID de ressource d’une identité managée affectée par l’utilisateur qui est affectée au pool de sessions, ou « système » pour l’identité affectée par le système.	chaîne (obligatoire)
cycle de vie	Permet de sélectionner les étapes de cycle de vie d’un pool de sessions pendant lesquelles l’identité managée doit être disponible.	'All' 'Init' 'Main' 'None'

ManagedServiceIdentity

Nom	Description	Valeur
type	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire)
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

Microsoft.App/sessionPools

Nom	Description	Valeur
apiVersion	Version de l’API	'2024-10-02-preview'
identité	Identités managées nécessaires par un pool de sessions pour interagir avec d’autres services Azure pour ne pas conserver de secrets ou d’informations d’identification dans le code.	ManagedServiceIdentity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 3 Longueur maximale = 3 Modèle = `^[a-z][a-z0-9]*$` (obligatoire)
Propriétés	Propriétés spécifiques à la ressource du pool de sessions d’application conteneur	sessionPoolProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type	Type de ressource	'Microsoft.App/sessionPools'

ScaleConfiguration

Nom	Description	Valeur
maxConcurrentSessions	Nombre maximal de sessions en même temps.	Int
readySessionInstances	Nombre minimal d’instances de session prêtes.	Int

SessionContainer

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
ressources	Exigences en matière de ressources de conteneur.	SessionContainerResources

SessionContainerResources

Nom	Description	Valeur
CPU	Processeur requis dans les cœurs, par exemple 0,5	Int
mémoire	Mémoire requise, par exemple « 250 Mo »	corde

SessionIngress

Nom	Description	Valeur
targetPort	Port cible dans les conteneurs pour le trafic à partir d’entrée	Int

SessionNetworkConfiguration

Nom	Description	Valeur
statut	État réseau des sessions.	'EgressDisabled' 'EgressEnabled'

SessionPoolProperties

Nom	Description	Valeur
containerType	Type de conteneur des sessions.	'CustomContainer' 'PythonLTS'
customContainerTemplate	Configuration de conteneur personnalisée si le containerType est CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	Configuration du pool si poolManagementType est dynamique.	DynamicPoolConfiguration
environmentId	ID de ressource de l’environnement du pool de sessions.	corde
managedIdentitySettings	Paramètres facultatifs pour une identité managée affectée au pool de sessions.	ManagedIdentitySetting[]
poolManagementType	Type de gestion du pool de sessions.	'Dynamique' 'Manuel'
scaleConfiguration	Configuration de mise à l’échelle du pool de sessions.	ScaleConfiguration
Secrets	Secrets du pool de sessions.	SessionPoolSecret[]
sessionNetworkConfiguration	Configuration réseau des sessions dans le pool de sessions.	sessionNetworkConfiguration

SessionPoolSecret

Nom	Description	Valeur
nom	Nom du secret.	corde
valeur	Valeur secrète.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

SessionRegistryCredentials

Nom	Description	Valeur
identité	Identité managée à utiliser pour s’authentifier auprès d’Azure Container Registry. Pour les identités affectées par l’utilisateur, utilisez l’ID complet de ressource d’identité affectée par l’utilisateur. Pour les identités affectées par le système, utilisez « système »	corde
passwordSecretRef	Nom du secret qui contient le mot de passe de connexion au Registre	corde
serveur	Serveur de registre de conteneurs.	corde
nom d’utilisateur	Nom d’utilisateur du registre de conteneurs.	corde

TrackedResourceTags

Nom	Description	Valeur

UserAssignedIdentities

Nom	Description	Valeur

UserAssignedIdentity

Nom	Description	Valeur

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource sessionPools peut être déployé avec des opérations qui ciblent :

groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.App/sessionPools, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/sessionPools@2024-10-02-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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 = {
        cooldownPeriodInSeconds = int
        executionType = "string"
      }
      environmentId = "string"
      managedIdentitySettings = [
        {
          identity = "string"
          lifecycle = "string"
        }
      ]
      poolManagementType = "string"
      scaleConfiguration = {
        maxConcurrentSessions = int
        readySessionInstances = int
      }
      secrets = [
        {
          name = "string"
          value = "string"
        }
      ]
      sessionNetworkConfiguration = {
        status = "string"
      }
    }
  })
}

Valeurs de propriété

CustomContainerTemplate

Nom	Description	Valeur
Conteneurs	Liste des définitions de conteneur pour les sessions du pool de sessions.	SessionContainer[]
entrée	Configuration de l’entrée du pool de sessions.	SessionIngress
registryCredentials	Informations d’identification du registre de conteneurs privés pour les conteneurs utilisés par les sessions du pool de sessions.	SessionRegistryCredentials

DynamicPoolConfiguration

Nom	Description	Valeur
cooldownPeriodInSeconds	Période de refroidissement d’une session en secondes.	Int
executionType	Type d’exécution du pool de sessions.	'Timed'

EnvironmentVar

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	corde
secretRef	Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.	corde
valeur	Valeur de variable d’environnement non secrète.	corde

ManagedIdentitySetting

Nom	Description	Valeur
identité	ID de ressource d’une identité managée affectée par l’utilisateur qui est affectée au pool de sessions, ou « système » pour l’identité affectée par le système.	chaîne (obligatoire)
cycle de vie	Permet de sélectionner les étapes de cycle de vie d’un pool de sessions pendant lesquelles l’identité managée doit être disponible.	'All' 'Init' 'Main' 'None'

ManagedServiceIdentity

Nom	Description	Valeur
type	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatoire)
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

Microsoft.App/sessionPools

Nom	Description	Valeur
identité	Identités managées nécessaires par un pool de sessions pour interagir avec d’autres services Azure pour ne pas conserver de secrets ou d’informations d’identification dans le code.	ManagedServiceIdentity
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 3 Longueur maximale = 3 Modèle = `^[a-z][a-z0-9]*$` (obligatoire)
Propriétés	Propriétés spécifiques à la ressource du pool de sessions d’application conteneur	sessionPoolProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
type	Type de ressource	« Microsoft.App/sessionPools@2024-10-02-preview »

ScaleConfiguration

Nom	Description	Valeur
maxConcurrentSessions	Nombre maximal de sessions en même temps.	Int
readySessionInstances	Nombre minimal d’instances de session prêtes.	Int

SessionContainer

Nom	Description	Valeur
args	Arguments de commande de démarrage du conteneur.	string[]
commander	Commande de démarrage du conteneur.	string[]
Env	Variables d’environnement de conteneur.	EnvironmentVar[]
image	Balise d’image conteneur.	corde
nom	Nom du conteneur personnalisé.	corde
ressources	Exigences en matière de ressources de conteneur.	SessionContainerResources

SessionContainerResources

Nom	Description	Valeur
CPU	Processeur requis dans les cœurs, par exemple 0,5	Int
mémoire	Mémoire requise, par exemple « 250 Mo »	corde

SessionIngress

Nom	Description	Valeur
targetPort	Port cible dans les conteneurs pour le trafic à partir d’entrée	Int

SessionNetworkConfiguration

Nom	Description	Valeur
statut	État réseau des sessions.	'EgressDisabled' 'EgressEnabled'

SessionPoolProperties

Nom	Description	Valeur
containerType	Type de conteneur des sessions.	'CustomContainer' 'PythonLTS'
customContainerTemplate	Configuration de conteneur personnalisée si le containerType est CustomContainer.	CustomContainerTemplate
dynamicPoolConfiguration	Configuration du pool si poolManagementType est dynamique.	DynamicPoolConfiguration
environmentId	ID de ressource de l’environnement du pool de sessions.	corde
managedIdentitySettings	Paramètres facultatifs pour une identité managée affectée au pool de sessions.	ManagedIdentitySetting[]
poolManagementType	Type de gestion du pool de sessions.	'Dynamique' 'Manuel'
scaleConfiguration	Configuration de mise à l’échelle du pool de sessions.	ScaleConfiguration
Secrets	Secrets du pool de sessions.	SessionPoolSecret[]
sessionNetworkConfiguration	Configuration réseau des sessions dans le pool de sessions.	sessionNetworkConfiguration

SessionPoolSecret

Nom	Description	Valeur
nom	Nom du secret.	corde
valeur	Valeur secrète.	corde Contraintes: Valeur sensible. Passez en tant que paramètre sécurisé.

SessionRegistryCredentials

Nom	Description	Valeur
identité	Identité managée à utiliser pour s’authentifier auprès d’Azure Container Registry. Pour les identités affectées par l’utilisateur, utilisez l’ID complet de ressource d’identité affectée par l’utilisateur. Pour les identités affectées par le système, utilisez « système »	corde
passwordSecretRef	Nom du secret qui contient le mot de passe de connexion au Registre	corde
serveur	Serveur de registre de conteneurs.	corde
nom d’utilisateur	Nom d’utilisateur du registre de conteneurs.	corde

TrackedResourceTags

Nom	Description	Valeur

UserAssignedIdentities

Nom	Description	Valeur

UserAssignedIdentity

Nom	Description	Valeur

Partager via

Microsoft.App sessionPools

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

CustomContainerTemplate

DynamicPoolConfiguration

EnvironmentVar

ManagedIdentitySetting

ManagedServiceIdentity

Microsoft.App/sessionPools

ScaleConfiguration

SessionContainer

SessionContainerResources

SessionIngress

SessionNetworkConfiguration

SessionPoolProperties

SessionPoolSecret

SessionRegistryCredentials

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

CustomContainerTemplate

DynamicPoolConfiguration

EnvironmentVar

ManagedIdentitySetting

ManagedServiceIdentity

Microsoft.App/sessionPools

ScaleConfiguration

SessionContainer

SessionContainerResources

SessionIngress

SessionNetworkConfiguration

SessionPoolProperties

SessionPoolSecret

SessionRegistryCredentials

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

CustomContainerTemplate

DynamicPoolConfiguration

EnvironmentVar

ManagedIdentitySetting

ManagedServiceIdentity

Microsoft.App/sessionPools

ScaleConfiguration

SessionContainer

SessionContainerResources

SessionIngress

SessionNetworkConfiguration

SessionPoolProperties

SessionPoolSecret

SessionRegistryCredentials

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Commentaires

Ressources supplémentaires