Container Apps Session Pools - Create Or Update

Créez ou mettez à jour un pool de sessions avec les propriétés données.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/sessionPools/{sessionPoolName}?api-version=2026-07-01

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

sessionPoolName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-z][a-z0-9]*$

Nom du pool de sessions.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource

identity

ManagedServiceIdentity

Identités de service managées affectées à cette ressource.

properties.containerType

ContainerType

Type de conteneur des sessions. Vous pouvez utiliser votre propre conteneur pour construire le pool de sessions, ou un conteneur prédéfini pour exécuter des charges de travail avec un langage spécifique.

properties.customContainerTemplate

CustomContainerTemplate

Configuration de conteneur personnalisée si le containerType est CustomContainer.

properties.dynamicPoolConfiguration

DynamicPoolConfiguration

Configuration du pool si poolManagementType est dynamique.

properties.environmentId

string (arm-id)

ID de ressource de l’environnement du pool de sessions.

properties.managedIdentitySettings

ManagedIdentitySetting[]

Paramètres facultatifs pour une identité managée affectée au pool de sessions.

properties.poolManagementType

PoolManagementType

Type de gestion du pool de sessions.

properties.scaleConfiguration

ScaleConfiguration

Configuration de mise à l’échelle du pool de sessions.

properties.secrets

SessionPoolSecret[]

Secrets du pool de sessions.

properties.sessionNetworkConfiguration

SessionNetworkConfiguration

Configuration réseau des sessions dans le pool de sessions.

tags

object

Balises de ressources.

Réponses

Nom Type Description
200 OK

SessionPool

Opération de mise à jour « SessionPool » de la ressource réussie

201 Created

SessionPool

Ressource 'SessionPool' créer l’opération réussie

En-têtes

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Usurper l’identité de votre compte utilisateur

Exemples

Create or Update Session Pool with lifecycle OnContainerExit Timed
Create or Update Session Pool with lifecycle type Timed
Create or Update Session Pool with MCP server

Create or Update Session Pool with lifecycle OnContainerExit Timed

Exemple de requête

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool?api-version=2026-07-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "East US",
  "properties": {
    "containerType": "CustomContainer",
    "customContainerTemplate": {
      "containers": [
        {
          "name": "testinitcontainer",
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "command": [
            "/bin/sh"
          ],
          "image": "repo/testcontainer:v4",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          }
        }
      ],
      "ingress": {
        "targetPort": 80
      },
      "registryCredentials": {
        "identity": "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP",
        "server": "test.azurecr.io"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "lifecycleType": "OnContainerExit",
        "maxAlivePeriodInSeconds": 86400
      }
    },
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "managedIdentitySettings": [
      {
        "identity": "system",
        "lifecycle": "Main"
      }
    ],
    "poolManagementType": "Dynamic",
    "scaleConfiguration": {
      "maxConcurrentSessions": 500,
      "readySessionInstances": 100
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

Exemple de réponse

{
  "name": "testsessionpool",
  "type": "Microsoft.App/sessionPools",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "bce8c037-3d10-44a4-a970-25f799611fc6",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "East US",
  "properties": {
    "containerType": "CustomContainer",
    "customContainerTemplate": {
      "containers": [
        {
          "name": "testinitcontainer",
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "command": [
            "/bin/sh"
          ],
          "image": "repo/testcontainer:v4",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          }
        }
      ],
      "ingress": {
        "targetPort": 80
      },
      "registryCredentials": {
        "identity": "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP",
        "server": "test.azurecr.io"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "lifecycleType": "OnContainerExit",
        "maxAlivePeriodInSeconds": 86400
      }
    },
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "nodeCount": 1,
    "poolManagementEndpoint": "https://testsessionpool.agreeableriver-3d30edf1.eastus.azurecontainerapps.io",
    "poolManagementType": "Dynamic",
    "provisioningState": "Succeeded",
    "scaleConfiguration": {
      "maxConcurrentSessions": 500,
      "readySessionInstances": 100
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}
{
  "name": "testsessionpool",
  "type": "Microsoft.App/sessionPools",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "bce8c037-3d10-44a4-a970-25f799611fc6",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "East US",
  "properties": {
    "containerType": "CustomContainer",
    "customContainerTemplate": {
      "containers": [
        {
          "name": "testinitcontainer",
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "command": [
            "/bin/sh"
          ],
          "image": "repo/testcontainer:v4",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          }
        }
      ],
      "ingress": {
        "targetPort": 80
      },
      "registryCredentials": {
        "identity": "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP",
        "server": "test.azurecr.io"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "lifecycleType": "OnContainerExit",
        "maxAlivePeriodInSeconds": 86400
      }
    },
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "managedIdentitySettings": [
      {
        "identity": "system",
        "lifecycle": "Main"
      }
    ],
    "poolManagementEndpoint": "https://testsessionpool.agreeableriver-3d30edf1.eastus.azurecontainerapps.io",
    "poolManagementType": "Dynamic",
    "provisioningState": "InProgress",
    "scaleConfiguration": {
      "maxConcurrentSessions": 500,
      "readySessionInstances": 100
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

Create or Update Session Pool with lifecycle type Timed

Exemple de requête

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool?api-version=2026-07-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "East US",
  "properties": {
    "containerType": "CustomContainer",
    "customContainerTemplate": {
      "containers": [
        {
          "name": "testinitcontainer",
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "command": [
            "/bin/sh"
          ],
          "image": "repo/testcontainer:v4",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          }
        }
      ],
      "ingress": {
        "targetPort": 80
      },
      "registryCredentials": {
        "identity": "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP",
        "server": "test.azurecr.io"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": 600,
        "lifecycleType": "Timed"
      }
    },
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "managedIdentitySettings": [
      {
        "identity": "system",
        "lifecycle": "Main"
      }
    ],
    "poolManagementType": "Dynamic",
    "scaleConfiguration": {
      "maxConcurrentSessions": 500,
      "readySessionInstances": 100
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

Exemple de réponse

{
  "name": "testsessionpool",
  "type": "Microsoft.App/sessionPools",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "bce8c037-3d10-44a4-a970-25f799611fc6",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "East US",
  "properties": {
    "containerType": "CustomContainer",
    "customContainerTemplate": {
      "containers": [
        {
          "name": "testinitcontainer",
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "command": [
            "/bin/sh"
          ],
          "image": "repo/testcontainer:v4",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          }
        }
      ],
      "ingress": {
        "targetPort": 80
      },
      "registryCredentials": {
        "identity": "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP",
        "server": "test.azurecr.io"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": 600,
        "lifecycleType": "Timed"
      }
    },
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "nodeCount": 1,
    "poolManagementEndpoint": "https://testsessionpool.agreeableriver-3d30edf1.eastus.azurecontainerapps.io",
    "poolManagementType": "Dynamic",
    "provisioningState": "Succeeded",
    "scaleConfiguration": {
      "maxConcurrentSessions": 500,
      "readySessionInstances": 100
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}
{
  "name": "testsessionpool",
  "type": "Microsoft.App/sessionPools",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "bce8c037-3d10-44a4-a970-25f799611fc6",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "East US",
  "properties": {
    "containerType": "CustomContainer",
    "customContainerTemplate": {
      "containers": [
        {
          "name": "testinitcontainer",
          "args": [
            "-c",
            "while true; do echo hello; sleep 10;done"
          ],
          "command": [
            "/bin/sh"
          ],
          "image": "repo/testcontainer:v4",
          "resources": {
            "cpu": 0.25,
            "memory": "0.5Gi"
          }
        }
      ],
      "ingress": {
        "targetPort": 80
      },
      "registryCredentials": {
        "identity": "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP",
        "server": "test.azurecr.io"
      }
    },
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": 600,
        "lifecycleType": "Timed"
      }
    },
    "environmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
    "managedIdentitySettings": [
      {
        "identity": "system",
        "lifecycle": "Main"
      }
    ],
    "poolManagementEndpoint": "https://testsessionpool.agreeableriver-3d30edf1.eastus.azurecontainerapps.io",
    "poolManagementType": "Dynamic",
    "provisioningState": "InProgress",
    "scaleConfiguration": {
      "maxConcurrentSessions": 500,
      "readySessionInstances": 100
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

Create or Update Session Pool with MCP server

Exemple de requête

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool?api-version=2026-07-01

{
  "location": "East US",
  "properties": {
    "containerType": "Shell",
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": 600,
        "lifecycleType": "Timed"
      }
    },
    "poolManagementType": "Dynamic",
    "scaleConfiguration": {
      "maxConcurrentSessions": 50
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

Exemple de réponse

{
  "name": "testsessionpool",
  "type": "Microsoft.App/sessionPools",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool",
  "location": "East US",
  "properties": {
    "containerType": "Shell",
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": 600,
        "lifecycleType": "Timed"
      }
    },
    "poolManagementEndpoint": "https://eastus.dynamicsessions.io/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/sessionPools/testsessionpool",
    "poolManagementType": "Dynamic",
    "provisioningState": "Succeeded",
    "scaleConfiguration": {
      "maxConcurrentSessions": 50
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}
{
  "name": "testsessionpool",
  "type": "Microsoft.App/sessionPools",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool",
  "location": "East US",
  "properties": {
    "containerType": "Shell",
    "dynamicPoolConfiguration": {
      "lifecycleConfiguration": {
        "cooldownPeriodInSeconds": 600,
        "lifecycleType": "Timed"
      }
    },
    "poolManagementEndpoint": "https://eastus.dynamicsessions.io/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/sessionPools/testsessionpool",
    "poolManagementType": "Dynamic",
    "provisioningState": "InProgress",
    "scaleConfiguration": {
      "maxConcurrentSessions": 50
    },
    "sessionNetworkConfiguration": {
      "status": "EgressEnabled"
    }
  }
}

Définitions

Nom Description
ContainerType

Type de conteneur des sessions. Vous pouvez utiliser votre propre conteneur pour construire le pool de sessions, ou un conteneur prédéfini pour exécuter des charges de travail avec un langage spécifique.

createdByType

Type d’identité qui a créé la ressource.

CustomContainerTemplate

Configuration de conteneur personnalisée.

DynamicPoolConfiguration

Configuration du pool dynamique.

EnvironmentVar

Variable d’environnement de conteneur d’application conteneur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

LifecycleConfiguration

Propriétés de configuration du cycle de vie d’une session dans le pool de sessions dynamiques

LifecycleType

Type de cycle de vie du pool de sessions.

ManagedIdentitySetting

Paramètres facultatifs pour une identité managée affectée au pool de sessions.

ManagedServiceIdentity

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

PoolManagementType

Type de gestion du pool de sessions.

ScaleConfiguration

Mettre à l’échelle la configuration.

Scheme

Schéma à utiliser pour la connexion à l’hôte. La valeur par défaut est HTTP.

SessionContainer

Définitions de conteneur pour les sessions du pool de sessions.

SessionContainerResources

Configuration requise pour les ressources de conteneur pour les sessions du pool de sessions.

SessionIngress

Configuration de l’entrée du pool de sessions.

SessionNetworkConfiguration

Configuration du réseau de session.

SessionNetworkStatus

État réseau des sessions.

SessionPool

Pool de sessions d’application conteneur.

SessionPoolIdentityLifeCycle

Permet de sélectionner les étapes de cycle de vie d’un pool de sessions pendant lesquelles l’identité managée doit être disponible.

SessionPoolProvisioningState

État d’approvisionnement du pool de sessions.

SessionPoolSecret

Définition du secret.

SessionProbe

Configuration de la sonde de session.

SessionProbeHttpGet

HTTPGet spécifie la requête http à effectuer.

SessionProbeHttpGetHttpHeadersItem

HTTPHeader décrit un en-tête personnalisé à utiliser dans les sondes HTTP

SessionProbeTcpSocket

TCPSocket spécifie une action impliquant un port TCP. Les hooks TCP ne sont pas encore pris en charge.

SessionProbeType

Indique le type de sonde. Peut être Liveness ou Startup, la sonde de préparation n’est pas prise en charge dans les sessions. Le type doit être unique pour chaque sonde dans le contexte d’une liste de sondes (SessionProbes).

SessionRegistryCredentials

Informations d’identification du registre privé du pool de sessions.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

ContainerType

Type de conteneur des sessions. Vous pouvez utiliser votre propre conteneur pour construire le pool de sessions, ou un conteneur prédéfini pour exécuter des charges de travail avec un langage spécifique.

Valeur Description
CustomContainer

CustomContainer

PythonLTS

PythonLTS

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

CustomContainerTemplate

Configuration de conteneur personnalisée.

Nom Type Description
containers

SessionContainer[]

Liste des définitions de conteneur pour les sessions du pool de sessions.

ingress

SessionIngress

Configuration de l’entrée du pool de sessions.

registryCredentials

SessionRegistryCredentials

Informations d’identification du registre de conteneurs privés pour les conteneurs utilisés par les sessions du pool de sessions.

DynamicPoolConfiguration

Configuration du pool dynamique.

Nom Type Description
lifecycleConfiguration

LifecycleConfiguration

Configuration du cycle de vie d’une session dans le pool de sessions dynamiques

EnvironmentVar

Variable d’environnement de conteneur d’application conteneur.

Nom Type Description
name

string

Nom de la variable d’environnement.

secretRef

string

Nom du secret de l’application conteneur à partir duquel extraire la valeur de la variable d’environnement.

value

string

Valeur de variable d’environnement non secrète.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Le type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations complémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

LifecycleConfiguration

Propriétés de configuration du cycle de vie d’une session dans le pool de sessions dynamiques

Nom Type Description
cooldownPeriodInSeconds

integer (int32)

Période de refroidissement d’une session en secondes lorsque le type de cycle de vie est « Timed ».

lifecycleType

LifecycleType

Type de cycle de vie du pool de sessions.

maxAlivePeriodInSeconds

integer (int32)

Période active maximale d’une session en secondes lorsque le type de cycle de vie est « OnContainerExit ».

LifecycleType

Type de cycle de vie du pool de sessions.

Valeur Description
Timed

Programmé

OnContainerExit

OnContainerExit

ManagedIdentitySetting

Paramètres facultatifs pour une identité managée affectée au pool de sessions.

Nom Type Valeur par défaut Description
identity

string

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.

lifecycle

SessionPoolIdentityLifeCycle

None

Permet de sélectionner les étapes de cycle de vie d’un pool de sessions pendant lesquelles l’identité managée doit être disponible.

ManagedServiceIdentity

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom Type Description
principalId

string (uuid)

ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.

tenantId

string (uuid)

ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.

type

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

userAssignedIdentities

<string,  UserAssignedIdentity>

identités User-Assigned
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.

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Valeur Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PoolManagementType

Type de gestion du pool de sessions.

Valeur Description
Manual

Manuel

Dynamic

Dynamique

ScaleConfiguration

Mettre à l’échelle la configuration.

Nom Type Description
maxConcurrentSessions

integer (int32)

Nombre maximal de sessions en même temps.

readySessionInstances

integer (int32)

Nombre minimal d’instances de session prêtes.

Scheme

Schéma à utiliser pour la connexion à l’hôte. La valeur par défaut est HTTP.

Valeur Description
HTTP

HTTP

HTTPS

HTTPS

SessionContainer

Définitions de conteneur pour les sessions du pool de sessions.

Nom Type Description
args

string[]

Arguments de commande de démarrage du conteneur.

command

string[]

Commande de démarrage du conteneur.

env

EnvironmentVar[]

Variables d’environnement de conteneur.

image

string

Balise d’image conteneur.

name

string

Nom du conteneur personnalisé.

probes

SessionProbe[]

Liste des sondes pour le conteneur.

resources

SessionContainerResources

Exigences en matière de ressources de conteneur.

SessionContainerResources

Configuration requise pour les ressources de conteneur pour les sessions du pool de sessions.

Nom Type Description
cpu

number (double)

Processeur requis dans les cœurs, par exemple 0,5

memory

string

Mémoire requise, par exemple « 250 Mo »

SessionIngress

Configuration de l’entrée du pool de sessions.

Nom Type Description
targetPort

integer (int32)

Port cible dans les conteneurs pour le trafic à partir d’entrée

SessionNetworkConfiguration

Configuration du réseau de session.

Nom Type Description
status

SessionNetworkStatus

État réseau des sessions.

SessionNetworkStatus

État réseau des sessions.

Valeur Description
EgressEnabled

SortieEnabled

EgressDisabled

EgressDisabled

SessionPool

Pool de sessions d’application conteneur.

Nom Type Description
id

string (arm-id)

Identifiant de ressource entièrement qualifié pour la ressource. Par exemple « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

identity

ManagedServiceIdentity

Identités de service managées affectées à cette ressource.

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.containerType

ContainerType

Type de conteneur des sessions. Vous pouvez utiliser votre propre conteneur pour construire le pool de sessions, ou un conteneur prédéfini pour exécuter des charges de travail avec un langage spécifique.

properties.customContainerTemplate

CustomContainerTemplate

Configuration de conteneur personnalisée si le containerType est CustomContainer.

properties.dynamicPoolConfiguration

DynamicPoolConfiguration

Configuration du pool si poolManagementType est dynamique.

properties.environmentId

string (arm-id)

ID de ressource de l’environnement du pool de sessions.

properties.managedIdentitySettings

ManagedIdentitySetting[]

Paramètres facultatifs pour une identité managée affectée au pool de sessions.

properties.nodeCount

integer (int32)

Nombre de nœuds que le pool de sessions utilise.

properties.poolManagementEndpoint

string (uri)

Point de terminaison pour gérer le pool.

properties.poolManagementType

PoolManagementType

Type de gestion du pool de sessions.

properties.provisioningState

SessionPoolProvisioningState

État d’approvisionnement du pool de sessions.

properties.scaleConfiguration

ScaleConfiguration

Configuration de mise à l’échelle du pool de sessions.

properties.secrets

SessionPoolSecret[]

Secrets du pool de sessions.

properties.sessionNetworkConfiguration

SessionNetworkConfiguration

Configuration réseau des sessions dans le pool de sessions.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressources.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

SessionPoolIdentityLifeCycle

Permet de sélectionner les étapes de cycle de vie d’un pool de sessions pendant lesquelles l’identité managée doit être disponible.

Valeur Description
None

N’utilisez pas d’identité gérée à aucun stade du cycle de vie.

Main

Utilisez l’identité gérée durant la phase principale du cycle de vie de l’application Conteneur.

SessionPoolProvisioningState

État d’approvisionnement du pool de sessions.

Valeur Description
InProgress

InProgress

Succeeded

Réussi

Failed

Échec

Canceled

Opération annulée

Deleting

Suppression

SessionPoolSecret

Définition du secret.

Nom Type Description
name

string

Nom du secret.

value

string (password)

Valeur secrète.

SessionProbe

Configuration de la sonde de session.

Nom Type Description
failureThreshold

integer (int32)

Échecs consécutifs minimum pour que la sonde soit considérée comme ayant échoué après avoir réussi. La valeur par défaut est 3. La valeur minimale est 1. La valeur maximale est 10.

httpGet

SessionProbeHttpGet

HTTPGet spécifie la requête http à effectuer.

initialDelaySeconds

integer (int32)

Nombre de secondes après le démarrage du conteneur avant l’initialisation des sondes liveness. La valeur minimale est 1. La valeur maximale est 60.

periodSeconds

integer (int32)

Fréquence (en secondes) d’exécution de la sonde. La valeur par défaut est de 10 secondes. La valeur minimale est 1. La valeur maximale est 240.

successThreshold

integer (int32)

Nombre minimal de réussites consécutives pour que la sonde soit considérée comme réussie après avoir échoué. La valeur par défaut est 1. Doit être 1 pour la vie et le démarrage. La valeur minimale est 1. La valeur maximale est 10.

tcpSocket

SessionProbeTcpSocket

TCPSocket spécifie une action impliquant un port TCP. Les hooks TCP ne sont pas encore pris en charge.

terminationGracePeriodSeconds

integer (int64)

Durée facultative en secondes, le pod doit se terminer correctement lors de l’échec de la sonde. La période de grâce est la durée en secondes après que les processus en cours d’exécution dans le pod soient envoyés un signal d’arrêt et le moment où les processus sont arrêtés de force avec un signal de destruction. Définissez cette valeur plus longtemps que l’heure de nettoyage attendue pour votre processus. Si cette valeur est nulle, l’arrêt du podGracePeriodSeconds est utilisé. Dans le cas contraire, cette valeur remplace la valeur fournie par la spécification de pod. La valeur doit être un entier non négatif. La valeur zéro indique l’arrêt immédiatement via le signal de destruction (aucune occasion d’arrêter). Il s’agit d’un champ alpha et nécessite l’activation de la porte de fonctionnalité ProbeTerminationGracePeriod. La valeur maximale est de 3600 secondes (1 heure)

timeoutSeconds

integer (int32)

Nombre de secondes après lesquelles la sonde expire. La valeur par défaut est 1 seconde. La valeur minimale est 1. La valeur maximale est 240.

type

SessionProbeType

Indique le type de sonde. Peut être Liveness ou Startup, la sonde de préparation n’est pas prise en charge dans les sessions. Le type doit être unique pour chaque sonde dans le contexte d’une liste de sondes (SessionProbes).

SessionProbeHttpGet

HTTPGet spécifie la requête http à effectuer.

Nom Type Description
host

string

Nom d’hôte à connecter, par défaut à l’adresse IP du pod. Vous souhaitez probablement définir « Host » dans httpHeaders à la place.

httpHeaders

SessionProbeHttpGetHttpHeadersItem[]

En-têtes personnalisés à définir dans la requête. HTTP autorise les en-têtes répétés.

path

string

Chemin d’accès au serveur HTTP.

port

integer (int32)

Nom ou numéro du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.

scheme

Scheme

Schéma à utiliser pour la connexion à l’hôte. La valeur par défaut est HTTP.

SessionProbeHttpGetHttpHeadersItem

HTTPHeader décrit un en-tête personnalisé à utiliser dans les sondes HTTP

Nom Type Description
name

string

Nom du champ d’en-tête

value

string

Valeur du champ d’en-tête

SessionProbeTcpSocket

TCPSocket spécifie une action impliquant un port TCP. Les hooks TCP ne sont pas encore pris en charge.

Nom Type Description
host

string

Facultatif : nom d’hôte auquel se connecter, par défaut à l’adresse IP du pod.

port

integer (int32)

Numéro ou nom du port à accéder au conteneur. Le nombre doit être compris entre 1 et 65535. Le nom doit être un IANA_SVC_NAME.

SessionProbeType

Indique le type de sonde. Peut être Liveness ou Startup, la sonde de préparation n’est pas prise en charge dans les sessions. Le type doit être unique pour chaque sonde dans le contexte d’une liste de sondes (SessionProbes).

Valeur Description
Liveness

Vérifie si la séance est toujours en cours et saine.

Startup

Vérifie si la session a bien commencé.

SessionRegistryCredentials

Informations d’identification du registre privé du pool de sessions.

Nom Type Description
identity

string

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 »

passwordSecretRef

string

Nom du secret qui contient le mot de passe de connexion au Registre

server

string

Serveur de registre de conteneurs.

username

string

Nom d’utilisateur du registre de conteneurs.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

Nom Type Description
clientId

string (uuid)

ID client de l’identité affectée.

principalId

string (uuid)

ID principal de l’identité affectée.