Container Apps Session Pools - Create Or Update

Service:: Azure Container Apps

Version d’API:: 2026-01-01

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-01-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 ressource.

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.

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	emprunter l’identité de votre compte d’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

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool?api-version=2026-01-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"
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python session_pools_lifecycle_on_container_exit_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.container_apps_session_pools.begin_create_or_update(
        resource_group_name="rg",
        session_pool_name="testsessionpool",
        session_pool_envelope={
            "identity": {"type": "SystemAssigned"},
            "location": "East US",
            "properties": {
                "containerType": "CustomContainer",
                "customContainerTemplate": {
                    "containers": [
                        {
                            "args": ["-c", "while true; do echo hello; sleep 10;done"],
                            "command": ["/bin/sh"],
                            "image": "repo/testcontainer:v4",
                            "name": "testinitcontainer",
                            "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"},
            },
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-01-01/SessionPools_LifecycleOnContainerExit_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "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"
    }
  }
}

Code d’état:: 201

{
  "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

HTTP
Python

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool?api-version=2026-01-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"
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python session_pools_lifecycle_timed_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.container_apps_session_pools.begin_create_or_update(
        resource_group_name="rg",
        session_pool_name="testsessionpool",
        session_pool_envelope={
            "identity": {"type": "SystemAssigned"},
            "location": "East US",
            "properties": {
                "containerType": "CustomContainer",
                "customContainerTemplate": {
                    "containers": [
                        {
                            "args": ["-c", "while true; do echo hello; sleep 10;done"],
                            "command": ["/bin/sh"],
                            "image": "repo/testcontainer:v4",
                            "name": "testinitcontainer",
                            "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"},
            },
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-01-01/SessionPools_LifecycleTimed_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "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"
    }
  }
}

Code d’état:: 201

{
  "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

HTTP
Python

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

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.appcontainers import ContainerAppsAPIClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-appcontainers
# USAGE
    python session_pools_mcp_server_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerAppsAPIClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.container_apps_session_pools.begin_create_or_update(
        resource_group_name="rg",
        session_pool_name="testsessionpool",
        session_pool_envelope={
            "location": "East US",
            "properties": {
                "containerType": "Shell",
                "dynamicPoolConfiguration": {
                    "lifecycleConfiguration": {"cooldownPeriodInSeconds": 600, "lifecycleType": "Timed"}
                },
                "poolManagementType": "Dynamic",
                "scaleConfiguration": {"maxConcurrentSessions": 50},
                "sessionNetworkConfiguration": {"status": "EgressEnabled"},
            },
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-01-01/SessionPools_McpServer_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exemple de réponse

Code d’état:: 200

{
  "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"
    }
  }
}

Code d’état:: 201

{
  "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.
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.
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

Énumération

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

Énumération

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

Valeur	Description
User
Application
ManagedIdentity
Key

CustomContainerTemplate

Objet

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

Objet

Configuration du pool dynamique.

Nom	Type	Description
lifecycleConfiguration	LifecycleConfiguration	Configuration du cycle de vie d’une session dans le pool de sessions dynamiques

EnvironmentVar

Objet

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

Objet

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

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplé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

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

LifecycleConfiguration

Objet

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

Énumération

Type de cycle de vie du pool de sessions.

Valeur	Description
Timed	Chronométré
OnContainerExit	OnContainerExit

ManagedIdentitySetting

Objet

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

Objet

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

Énumération

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

Valeur	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PoolManagementType

Énumération

Type de gestion du pool de sessions.

Valeur	Description
Manual	Manuel
Dynamic	Dynamic

ScaleConfiguration

Objet

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.

SessionContainer

Objet

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é.
resources	SessionContainerResources	Exigences en matière de ressources de conteneur.

SessionContainerResources

Objet

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

Objet

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

Objet

Configuration du réseau de session.

Nom	Type	Description
status	SessionNetworkStatus	État réseau des sessions.

SessionNetworkStatus

Énumération

État réseau des sessions.

Valeur	Description
EgressEnabled	SortieEnabled
EgressDisabled	EgressDisabled

SessionPool

Objet

Pool de sessions d’application conteneur.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet 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 ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

SessionPoolIdentityLifeCycle

Énumération

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

Énumération

État d’approvisionnement du pool de sessions.

Valeur	Description
InProgress	En cours
Succeeded	Réussi
Failed	Échec
Canceled	Opération annulée
Deleting	Suppression en cours

SessionPoolSecret

Objet

Définition du secret.

Nom	Type	Description
name	string	Nom du secret.
value	string (password)	Valeur secrète.

SessionRegistryCredentials

Objet

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

Nom	Type	Description
identity	string	Identité managée à utiliser pour s’authentifier auprès de 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

Objet

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

Objet

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.