Container Apps Session Pools - Create Or Update

Service:

Azure Container Apps

Versione API:

2026-07-01

Creare o aggiornare un pool di sessioni con le proprietà specificate.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
sessionPoolName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Nome del pool di sessioni.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
identity		ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
properties.containerType		ContainerType	Tipo di contenitore delle sessioni. Puoi usare il tuo container per costruire il pool di sessioni, oppure puoi usare un container predefinito per eseguire il carico di lavoro con un linguaggio specifico.
properties.customContainerTemplate		CustomContainerTemplate	Configurazione del contenitore personalizzata se containerType è CustomContainer.
properties.dynamicPoolConfiguration		DynamicPoolConfiguration	Configurazione del pool se poolManagementType è dinamico.
properties.environmentId		string (arm-id)	ID risorsa dell'ambiente del pool di sessioni.
properties.managedIdentitySettings		ManagedIdentitySetting[]	Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.
properties.poolManagementType		PoolManagementType	Tipo di gestione del pool di sessioni.
properties.scaleConfiguration		ScaleConfiguration	Configurazione della scalabilità del pool di sessioni.
properties.secrets		SessionPoolSecret[]	Segreti del pool di sessioni.
properties.sessionNetworkConfiguration		SessionNetworkConfiguration	Configurazione di rete delle sessioni nel pool di sessioni.
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	SessionPool	Operazione di aggiornamento 'SessionPool' della risorsa riuscita
201 Created	SessionPool	Risorsa 'SessionPool' crea operazione con successo Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

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

Esempio di richiesta

HTTP

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

Java

import com.azure.resourcemanager.appcontainers.models.ContainerType;
import com.azure.resourcemanager.appcontainers.models.CustomContainerTemplate;
import com.azure.resourcemanager.appcontainers.models.DynamicPoolConfiguration;
import com.azure.resourcemanager.appcontainers.models.LifecycleConfiguration;
import com.azure.resourcemanager.appcontainers.models.LifecycleType;
import com.azure.resourcemanager.appcontainers.models.ManagedIdentitySetting;
import com.azure.resourcemanager.appcontainers.models.ManagedServiceIdentity;
import com.azure.resourcemanager.appcontainers.models.ManagedServiceIdentityType;
import com.azure.resourcemanager.appcontainers.models.PoolManagementType;
import com.azure.resourcemanager.appcontainers.models.ScaleConfiguration;
import com.azure.resourcemanager.appcontainers.models.SessionContainer;
import com.azure.resourcemanager.appcontainers.models.SessionContainerResources;
import com.azure.resourcemanager.appcontainers.models.SessionIngress;
import com.azure.resourcemanager.appcontainers.models.SessionNetworkConfiguration;
import com.azure.resourcemanager.appcontainers.models.SessionNetworkStatus;
import com.azure.resourcemanager.appcontainers.models.SessionPoolIdentityLifeCycle;
import com.azure.resourcemanager.appcontainers.models.SessionRegistryCredentials;
import java.util.Arrays;

/**
 * Samples for ContainerAppsSessionPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-07-01/SessionPools_LifecycleOnContainerExit_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or Update Session Pool with lifecycle OnContainerExit Timed.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void createOrUpdateSessionPoolWithLifecycleOnContainerExitTimed(
        com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.containerAppsSessionPools().define("testsessionpool").withRegion("East US")
            .withExistingResourceGroup("rg")
            .withIdentity(new ManagedServiceIdentity().withType(ManagedServiceIdentityType.SYSTEM_ASSIGNED))
            .withEnvironmentId(
                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube")
            .withContainerType(ContainerType.CUSTOM_CONTAINER).withPoolManagementType(PoolManagementType.DYNAMIC)
            .withScaleConfiguration(
                new ScaleConfiguration().withMaxConcurrentSessions(500).withReadySessionInstances(100))
            .withDynamicPoolConfiguration(
                new DynamicPoolConfiguration().withLifecycleConfiguration(new LifecycleConfiguration()
                    .withLifecycleType(LifecycleType.ON_CONTAINER_EXIT).withMaxAlivePeriodInSeconds(86400)))
            .withCustomContainerTemplate(new CustomContainerTemplate()
                .withRegistryCredentials(new SessionRegistryCredentials().withServer("test.azurecr.io").withIdentity(
                    "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP"))
                .withContainers(Arrays.asList(new SessionContainer().withImage("repo/testcontainer:v4")
                    .withName("testinitcontainer").withCommand(Arrays.asList("/bin/sh"))
                    .withArgs(Arrays.asList("-c", "while true; do echo hello; sleep 10;done"))
                    .withResources(new SessionContainerResources().withCpu(0.25D).withMemory("0.5Gi"))))
                .withIngress(new SessionIngress().withTargetPort(80)))
            .withSessionNetworkConfiguration(
                new SessionNetworkConfiguration().withStatus(SessionNetworkStatus.EGRESS_ENABLED))
            .withManagedIdentitySettings(Arrays.asList(
                new ManagedIdentitySetting().withIdentity("system").withLifecycle(SessionPoolIdentityLifeCycle.MAIN)))
            .create();
    }
}

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

Python

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-07-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

Go

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v5"
)

// Generated from example definition: 2026-07-01/SessionPools_LifecycleOnContainerExit_CreateOrUpdate.json
func ExampleContainerAppsSessionPoolsClient_BeginCreateOrUpdate_createOrUpdateSessionPoolWithLifecycleOnContainerExitTimed() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContainerAppsSessionPoolsClient().BeginCreateOrUpdate(ctx, "rg", "testsessionpool", armappcontainers.SessionPool{
		Identity: &armappcontainers.ManagedServiceIdentity{
			Type: to.Ptr(armappcontainers.ManagedServiceIdentityTypeSystemAssigned),
		},
		Location: to.Ptr("East US"),
		Properties: &armappcontainers.SessionPoolProperties{
			ContainerType: to.Ptr(armappcontainers.ContainerTypeCustomContainer),
			CustomContainerTemplate: &armappcontainers.CustomContainerTemplate{
				Containers: []*armappcontainers.SessionContainer{
					{
						Name: to.Ptr("testinitcontainer"),
						Args: []*string{
							to.Ptr("-c"),
							to.Ptr("while true; do echo hello; sleep 10;done"),
						},
						Command: []*string{
							to.Ptr("/bin/sh"),
						},
						Image: to.Ptr("repo/testcontainer:v4"),
						Resources: &armappcontainers.SessionContainerResources{
							CPU:    to.Ptr[float64](0.25),
							Memory: to.Ptr("0.5Gi"),
						},
					},
				},
				Ingress: &armappcontainers.SessionIngress{
					TargetPort: to.Ptr[int32](80),
				},
				RegistryCredentials: &armappcontainers.SessionRegistryCredentials{
					Identity: to.Ptr("/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP"),
					Server:   to.Ptr("test.azurecr.io"),
				},
			},
			DynamicPoolConfiguration: &armappcontainers.DynamicPoolConfiguration{
				LifecycleConfiguration: &armappcontainers.LifecycleConfiguration{
					LifecycleType:           to.Ptr(armappcontainers.LifecycleTypeOnContainerExit),
					MaxAlivePeriodInSeconds: to.Ptr[int32](86400),
				},
			},
			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
			ManagedIdentitySettings: []*armappcontainers.ManagedIdentitySetting{
				{
					Identity:  to.Ptr("system"),
					Lifecycle: to.Ptr(armappcontainers.SessionPoolIdentityLifeCycleMain),
				},
			},
			PoolManagementType: to.Ptr(armappcontainers.PoolManagementTypeDynamic),
			ScaleConfiguration: &armappcontainers.ScaleConfiguration{
				MaxConcurrentSessions: to.Ptr[int32](500),
				ReadySessionInstances: to.Ptr[int32](100),
			},
			SessionNetworkConfiguration: &armappcontainers.SessionNetworkConfiguration{
				Status: to.Ptr(armappcontainers.SessionNetworkStatusEgressEnabled),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappcontainers.ContainerAppsSessionPoolsClientCreateOrUpdateResponse{
	// 	SessionPool: armappcontainers.SessionPool{
	// 		Name: to.Ptr("testsessionpool"),
	// 		Type: to.Ptr("Microsoft.App/sessionPools"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool"),
	// 		Identity: &armappcontainers.ManagedServiceIdentity{
	// 			Type: to.Ptr(armappcontainers.ManagedServiceIdentityTypeSystemAssigned),
	// 			PrincipalID: to.Ptr("bce8c037-3d10-44a4-a970-25f799611fc6"),
	// 			TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 		},
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappcontainers.SessionPoolProperties{
	// 			ContainerType: to.Ptr(armappcontainers.ContainerTypeCustomContainer),
	// 			CustomContainerTemplate: &armappcontainers.CustomContainerTemplate{
	// 				Containers: []*armappcontainers.SessionContainer{
	// 					{
	// 						Name: to.Ptr("testinitcontainer"),
	// 						Args: []*string{
	// 							to.Ptr("-c"),
	// 							to.Ptr("while true; do echo hello; sleep 10;done"),
	// 						},
	// 						Command: []*string{
	// 							to.Ptr("/bin/sh"),
	// 						},
	// 						Image: to.Ptr("repo/testcontainer:v4"),
	// 						Resources: &armappcontainers.SessionContainerResources{
	// 							CPU: to.Ptr[float64](0.25),
	// 							Memory: to.Ptr("0.5Gi"),
	// 						},
	// 					},
	// 				},
	// 				Ingress: &armappcontainers.SessionIngress{
	// 					TargetPort: to.Ptr[int32](80),
	// 				},
	// 				RegistryCredentials: &armappcontainers.SessionRegistryCredentials{
	// 					Identity: to.Ptr("/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP"),
	// 					Server: to.Ptr("test.azurecr.io"),
	// 				},
	// 			},
	// 			DynamicPoolConfiguration: &armappcontainers.DynamicPoolConfiguration{
	// 				LifecycleConfiguration: &armappcontainers.LifecycleConfiguration{
	// 					LifecycleType: to.Ptr(armappcontainers.LifecycleTypeOnContainerExit),
	// 					MaxAlivePeriodInSeconds: to.Ptr[int32](86400),
	// 				},
	// 			},
	// 			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
	// 			NodeCount: to.Ptr[int32](1),
	// 			PoolManagementEndpoint: to.Ptr("https://testsessionpool.agreeableriver-3d30edf1.eastus.azurecontainerapps.io"),
	// 			PoolManagementType: to.Ptr(armappcontainers.PoolManagementTypeDynamic),
	// 			ProvisioningState: to.Ptr(armappcontainers.SessionPoolProvisioningStateSucceeded),
	// 			ScaleConfiguration: &armappcontainers.ScaleConfiguration{
	// 				MaxConcurrentSessions: to.Ptr[int32](500),
	// 				ReadySessionInstances: to.Ptr[int32](100),
	// 			},
	// 			SessionNetworkConfiguration: &armappcontainers.SessionNetworkConfiguration{
	// 				Status: to.Ptr(armappcontainers.SessionNetworkStatusEgressEnabled),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create or update a session pool with the given properties.
 *
 * @summary create or update a session pool with the given properties.
 * x-ms-original-file: 2026-07-01/SessionPools_LifecycleOnContainerExit_CreateOrUpdate.json
 */
async function createOrUpdateSessionPoolWithLifecycleOnContainerExitTimed() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerAppsSessionPools.createOrUpdate("rg", "testsessionpool", {
    identity: { type: "SystemAssigned" },
    location: "East US",
    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" },
  });
  console.log(result);
}

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

HTTP

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

Java

import com.azure.resourcemanager.appcontainers.models.ContainerType;
import com.azure.resourcemanager.appcontainers.models.CustomContainerTemplate;
import com.azure.resourcemanager.appcontainers.models.DynamicPoolConfiguration;
import com.azure.resourcemanager.appcontainers.models.LifecycleConfiguration;
import com.azure.resourcemanager.appcontainers.models.LifecycleType;
import com.azure.resourcemanager.appcontainers.models.ManagedIdentitySetting;
import com.azure.resourcemanager.appcontainers.models.ManagedServiceIdentity;
import com.azure.resourcemanager.appcontainers.models.ManagedServiceIdentityType;
import com.azure.resourcemanager.appcontainers.models.PoolManagementType;
import com.azure.resourcemanager.appcontainers.models.ScaleConfiguration;
import com.azure.resourcemanager.appcontainers.models.SessionContainer;
import com.azure.resourcemanager.appcontainers.models.SessionContainerResources;
import com.azure.resourcemanager.appcontainers.models.SessionIngress;
import com.azure.resourcemanager.appcontainers.models.SessionNetworkConfiguration;
import com.azure.resourcemanager.appcontainers.models.SessionNetworkStatus;
import com.azure.resourcemanager.appcontainers.models.SessionPoolIdentityLifeCycle;
import com.azure.resourcemanager.appcontainers.models.SessionRegistryCredentials;
import java.util.Arrays;

/**
 * Samples for ContainerAppsSessionPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-07-01/SessionPools_LifecycleTimed_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or Update Session Pool with lifecycle type Timed.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void createOrUpdateSessionPoolWithLifecycleTypeTimed(
        com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.containerAppsSessionPools().define("testsessionpool").withRegion("East US")
            .withExistingResourceGroup("rg")
            .withIdentity(new ManagedServiceIdentity().withType(ManagedServiceIdentityType.SYSTEM_ASSIGNED))
            .withEnvironmentId(
                "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube")
            .withContainerType(ContainerType.CUSTOM_CONTAINER).withPoolManagementType(PoolManagementType.DYNAMIC)
            .withScaleConfiguration(
                new ScaleConfiguration().withMaxConcurrentSessions(500).withReadySessionInstances(100))
            .withDynamicPoolConfiguration(new DynamicPoolConfiguration().withLifecycleConfiguration(
                new LifecycleConfiguration().withLifecycleType(LifecycleType.TIMED).withCooldownPeriodInSeconds(600)))
            .withCustomContainerTemplate(new CustomContainerTemplate()
                .withRegistryCredentials(new SessionRegistryCredentials().withServer("test.azurecr.io").withIdentity(
                    "/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP"))
                .withContainers(Arrays.asList(new SessionContainer().withImage("repo/testcontainer:v4")
                    .withName("testinitcontainer").withCommand(Arrays.asList("/bin/sh"))
                    .withArgs(Arrays.asList("-c", "while true; do echo hello; sleep 10;done"))
                    .withResources(new SessionContainerResources().withCpu(0.25D).withMemory("0.5Gi"))))
                .withIngress(new SessionIngress().withTargetPort(80)))
            .withSessionNetworkConfiguration(
                new SessionNetworkConfiguration().withStatus(SessionNetworkStatus.EGRESS_ENABLED))
            .withManagedIdentitySettings(Arrays.asList(
                new ManagedIdentitySetting().withIdentity("system").withLifecycle(SessionPoolIdentityLifeCycle.MAIN)))
            .create();
    }
}

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

Python

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-07-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

Go

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v5"
)

// Generated from example definition: 2026-07-01/SessionPools_LifecycleTimed_CreateOrUpdate.json
func ExampleContainerAppsSessionPoolsClient_BeginCreateOrUpdate_createOrUpdateSessionPoolWithLifecycleTypeTimed() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContainerAppsSessionPoolsClient().BeginCreateOrUpdate(ctx, "rg", "testsessionpool", armappcontainers.SessionPool{
		Identity: &armappcontainers.ManagedServiceIdentity{
			Type: to.Ptr(armappcontainers.ManagedServiceIdentityTypeSystemAssigned),
		},
		Location: to.Ptr("East US"),
		Properties: &armappcontainers.SessionPoolProperties{
			ContainerType: to.Ptr(armappcontainers.ContainerTypeCustomContainer),
			CustomContainerTemplate: &armappcontainers.CustomContainerTemplate{
				Containers: []*armappcontainers.SessionContainer{
					{
						Name: to.Ptr("testinitcontainer"),
						Args: []*string{
							to.Ptr("-c"),
							to.Ptr("while true; do echo hello; sleep 10;done"),
						},
						Command: []*string{
							to.Ptr("/bin/sh"),
						},
						Image: to.Ptr("repo/testcontainer:v4"),
						Resources: &armappcontainers.SessionContainerResources{
							CPU:    to.Ptr[float64](0.25),
							Memory: to.Ptr("0.5Gi"),
						},
					},
				},
				Ingress: &armappcontainers.SessionIngress{
					TargetPort: to.Ptr[int32](80),
				},
				RegistryCredentials: &armappcontainers.SessionRegistryCredentials{
					Identity: to.Ptr("/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP"),
					Server:   to.Ptr("test.azurecr.io"),
				},
			},
			DynamicPoolConfiguration: &armappcontainers.DynamicPoolConfiguration{
				LifecycleConfiguration: &armappcontainers.LifecycleConfiguration{
					CooldownPeriodInSeconds: to.Ptr[int32](600),
					LifecycleType:           to.Ptr(armappcontainers.LifecycleTypeTimed),
				},
			},
			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
			ManagedIdentitySettings: []*armappcontainers.ManagedIdentitySetting{
				{
					Identity:  to.Ptr("system"),
					Lifecycle: to.Ptr(armappcontainers.SessionPoolIdentityLifeCycleMain),
				},
			},
			PoolManagementType: to.Ptr(armappcontainers.PoolManagementTypeDynamic),
			ScaleConfiguration: &armappcontainers.ScaleConfiguration{
				MaxConcurrentSessions: to.Ptr[int32](500),
				ReadySessionInstances: to.Ptr[int32](100),
			},
			SessionNetworkConfiguration: &armappcontainers.SessionNetworkConfiguration{
				Status: to.Ptr(armappcontainers.SessionNetworkStatusEgressEnabled),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappcontainers.ContainerAppsSessionPoolsClientCreateOrUpdateResponse{
	// 	SessionPool: armappcontainers.SessionPool{
	// 		Name: to.Ptr("testsessionpool"),
	// 		Type: to.Ptr("Microsoft.App/sessionPools"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool"),
	// 		Identity: &armappcontainers.ManagedServiceIdentity{
	// 			Type: to.Ptr(armappcontainers.ManagedServiceIdentityTypeSystemAssigned),
	// 			PrincipalID: to.Ptr("bce8c037-3d10-44a4-a970-25f799611fc6"),
	// 			TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 		},
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappcontainers.SessionPoolProperties{
	// 			ContainerType: to.Ptr(armappcontainers.ContainerTypeCustomContainer),
	// 			CustomContainerTemplate: &armappcontainers.CustomContainerTemplate{
	// 				Containers: []*armappcontainers.SessionContainer{
	// 					{
	// 						Name: to.Ptr("testinitcontainer"),
	// 						Args: []*string{
	// 							to.Ptr("-c"),
	// 							to.Ptr("while true; do echo hello; sleep 10;done"),
	// 						},
	// 						Command: []*string{
	// 							to.Ptr("/bin/sh"),
	// 						},
	// 						Image: to.Ptr("repo/testcontainer:v4"),
	// 						Resources: &armappcontainers.SessionContainerResources{
	// 							CPU: to.Ptr[float64](0.25),
	// 							Memory: to.Ptr("0.5Gi"),
	// 						},
	// 					},
	// 				},
	// 				Ingress: &armappcontainers.SessionIngress{
	// 					TargetPort: to.Ptr[int32](80),
	// 				},
	// 				RegistryCredentials: &armappcontainers.SessionRegistryCredentials{
	// 					Identity: to.Ptr("/subscriptions/7a497526-bb8d-4816-9795-db1418a1f977/resourcegroups/test/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testSP"),
	// 					Server: to.Ptr("test.azurecr.io"),
	// 				},
	// 			},
	// 			DynamicPoolConfiguration: &armappcontainers.DynamicPoolConfiguration{
	// 				LifecycleConfiguration: &armappcontainers.LifecycleConfiguration{
	// 					CooldownPeriodInSeconds: to.Ptr[int32](600),
	// 					LifecycleType: to.Ptr(armappcontainers.LifecycleTypeTimed),
	// 				},
	// 			},
	// 			EnvironmentID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube"),
	// 			NodeCount: to.Ptr[int32](1),
	// 			PoolManagementEndpoint: to.Ptr("https://testsessionpool.agreeableriver-3d30edf1.eastus.azurecontainerapps.io"),
	// 			PoolManagementType: to.Ptr(armappcontainers.PoolManagementTypeDynamic),
	// 			ProvisioningState: to.Ptr(armappcontainers.SessionPoolProvisioningStateSucceeded),
	// 			ScaleConfiguration: &armappcontainers.ScaleConfiguration{
	// 				MaxConcurrentSessions: to.Ptr[int32](500),
	// 				ReadySessionInstances: to.Ptr[int32](100),
	// 			},
	// 			SessionNetworkConfiguration: &armappcontainers.SessionNetworkConfiguration{
	// 				Status: to.Ptr(armappcontainers.SessionNetworkStatusEgressEnabled),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create or update a session pool with the given properties.
 *
 * @summary create or update a session pool with the given properties.
 * x-ms-original-file: 2026-07-01/SessionPools_LifecycleTimed_CreateOrUpdate.json
 */
async function createOrUpdateSessionPoolWithLifecycleTypeTimed() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerAppsSessionPools.createOrUpdate("rg", "testsessionpool", {
    identity: { type: "SystemAssigned" },
    location: "East US",
    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" },
  });
  console.log(result);
}

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Esempio di richiesta

HTTP

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

Java

import com.azure.resourcemanager.appcontainers.models.ContainerType;
import com.azure.resourcemanager.appcontainers.models.DynamicPoolConfiguration;
import com.azure.resourcemanager.appcontainers.models.LifecycleConfiguration;
import com.azure.resourcemanager.appcontainers.models.LifecycleType;
import com.azure.resourcemanager.appcontainers.models.PoolManagementType;
import com.azure.resourcemanager.appcontainers.models.ScaleConfiguration;
import com.azure.resourcemanager.appcontainers.models.SessionNetworkConfiguration;
import com.azure.resourcemanager.appcontainers.models.SessionNetworkStatus;

/**
 * Samples for ContainerAppsSessionPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-07-01/SessionPools_McpServer_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or Update Session Pool with MCP server.
     * 
     * @param manager Entry point to ContainerAppsApiManager.
     */
    public static void createOrUpdateSessionPoolWithMCPServer(
        com.azure.resourcemanager.appcontainers.ContainerAppsApiManager manager) {
        manager.containerAppsSessionPools().define("testsessionpool").withRegion("East US")
            .withExistingResourceGroup("rg").withContainerType(ContainerType.fromString("Shell"))
            .withPoolManagementType(PoolManagementType.DYNAMIC)
            .withScaleConfiguration(new ScaleConfiguration().withMaxConcurrentSessions(50))
            .withDynamicPoolConfiguration(new DynamicPoolConfiguration().withLifecycleConfiguration(
                new LifecycleConfiguration().withLifecycleType(LifecycleType.TIMED).withCooldownPeriodInSeconds(600)))
            .withSessionNetworkConfiguration(
                new SessionNetworkConfiguration().withStatus(SessionNetworkStatus.EGRESS_ENABLED))
            .create();
    }
}

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

Python

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-07-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

Go

package armappcontainers_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appcontainers/armappcontainers/v5"
)

// Generated from example definition: 2026-07-01/SessionPools_McpServer_CreateOrUpdate.json
func ExampleContainerAppsSessionPoolsClient_BeginCreateOrUpdate_createOrUpdateSessionPoolWithMcpServer() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappcontainers.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewContainerAppsSessionPoolsClient().BeginCreateOrUpdate(ctx, "rg", "testsessionpool", armappcontainers.SessionPool{
		Location: to.Ptr("East US"),
		Properties: &armappcontainers.SessionPoolProperties{
			ContainerType: to.Ptr(armappcontainers.ContainerType("Shell")),
			DynamicPoolConfiguration: &armappcontainers.DynamicPoolConfiguration{
				LifecycleConfiguration: &armappcontainers.LifecycleConfiguration{
					CooldownPeriodInSeconds: to.Ptr[int32](600),
					LifecycleType:           to.Ptr(armappcontainers.LifecycleTypeTimed),
				},
			},
			PoolManagementType: to.Ptr(armappcontainers.PoolManagementTypeDynamic),
			ScaleConfiguration: &armappcontainers.ScaleConfiguration{
				MaxConcurrentSessions: to.Ptr[int32](50),
			},
			SessionNetworkConfiguration: &armappcontainers.SessionNetworkConfiguration{
				Status: to.Ptr(armappcontainers.SessionNetworkStatusEgressEnabled),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappcontainers.ContainerAppsSessionPoolsClientCreateOrUpdateResponse{
	// 	SessionPool: armappcontainers.SessionPool{
	// 		Name: to.Ptr("testsessionpool"),
	// 		Type: to.Ptr("Microsoft.App/sessionPools"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/sessionPools/testsessionpool"),
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappcontainers.SessionPoolProperties{
	// 			ContainerType: to.Ptr(armappcontainers.ContainerType("Shell")),
	// 			DynamicPoolConfiguration: &armappcontainers.DynamicPoolConfiguration{
	// 				LifecycleConfiguration: &armappcontainers.LifecycleConfiguration{
	// 					CooldownPeriodInSeconds: to.Ptr[int32](600),
	// 					LifecycleType: to.Ptr(armappcontainers.LifecycleTypeTimed),
	// 				},
	// 			},
	// 			PoolManagementEndpoint: to.Ptr("https://eastus.dynamicsessions.io/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/sessionPools/testsessionpool"),
	// 			PoolManagementType: to.Ptr(armappcontainers.PoolManagementTypeDynamic),
	// 			ProvisioningState: to.Ptr(armappcontainers.SessionPoolProvisioningStateSucceeded),
	// 			ScaleConfiguration: &armappcontainers.ScaleConfiguration{
	// 				MaxConcurrentSessions: to.Ptr[int32](50),
	// 			},
	// 			SessionNetworkConfiguration: &armappcontainers.SessionNetworkConfiguration{
	// 				Status: to.Ptr(armappcontainers.SessionNetworkStatusEgressEnabled),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

const { ContainerAppsAPIClient } = require("@azure/arm-appcontainers");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create or update a session pool with the given properties.
 *
 * @summary create or update a session pool with the given properties.
 * x-ms-original-file: 2026-07-01/SessionPools_McpServer_CreateOrUpdate.json
 */
async function createOrUpdateSessionPoolWithMCPServer() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
  const client = new ContainerAppsAPIClient(credential, subscriptionId);
  const result = await client.containerAppsSessionPools.createOrUpdate("rg", "testsessionpool", {
    location: "East US",
    containerType: "Shell",
    dynamicPoolConfiguration: {
      lifecycleConfiguration: { cooldownPeriodInSeconds: 600, lifecycleType: "Timed" },
    },
    poolManagementType: "Dynamic",
    scaleConfiguration: { maxConcurrentSessions: 50 },
    sessionNetworkConfiguration: { status: "EgressEnabled" },
  });
  console.log(result);
}

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Definizioni

Nome	Descrizione
ContainerType	Tipo di contenitore delle sessioni. Puoi usare il tuo container per costruire il pool di sessioni, oppure puoi usare un container predefinito per eseguire il carico di lavoro con un linguaggio specifico.
createdByType	Tipo di identità che ha creato la risorsa.
CustomContainerTemplate	Configurazione del contenitore personalizzata.
DynamicPoolConfiguration	Configurazione del pool dinamico.
EnvironmentVar	Variabile di ambiente contenitore dell'app contenitore.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LifecycleConfiguration	Proprietà di configurazione del ciclo di vita di una sessione nel pool di sessioni dinamiche
LifecycleType	Tipo di ciclo di vita del pool di sessioni.
ManagedIdentitySetting	Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
PoolManagementType	Tipo di gestione del pool di sessioni.
ScaleConfiguration	Configurazione della scalabilità.
Scheme	Schema da usare per la connessione all'host. Il valore predefinito è HTTP.
SessionContainer	Definizioni di contenitore per le sessioni del pool di sessioni.
SessionContainerResources	Requisiti delle risorse del contenitore per le sessioni del pool di sessioni.
SessionIngress	Configurazione in ingresso del pool di sessioni.
SessionNetworkConfiguration	Configurazione della rete di sessione.
SessionNetworkStatus	Stato della rete per le sessioni.
SessionPool	Pool di sessioni dell'app contenitore.
SessionPoolIdentityLifeCycle	Usare per selezionare le fasi del ciclo di vita di un pool di sessioni durante la quale l'identità gestita deve essere disponibile.
SessionPoolProvisioningState	Stato di provisioning del pool di sessioni.
SessionPoolSecret	Definizione del segreto.
SessionProbe	Configurazione del probe di sessione.
SessionProbeHttpGet	HTTPGet specifica la richiesta HTTP da eseguire.
SessionProbeHttpGetHttpHeadersItem	HTTPHeader descrive un'intestazione personalizzata da usare nei probe HTTP
SessionProbeTcpSocket	TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati.
SessionProbeType	Indica il tipo di sonda. Può essere Liveness o Startup, il probe di prontezza non è supportato nelle sessioni. Il tipo deve essere univoco per ogni probe nel contesto di un elenco di probe (SessionProbes).
SessionRegistryCredentials	Credenziali del Registro di sistema privato del pool di sessioni.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

ContainerType

Enumerazione

Tipo di contenitore delle sessioni. Puoi usare il tuo container per costruire il pool di sessioni, oppure puoi usare un container predefinito per eseguire il carico di lavoro con un linguaggio specifico.

Valore	Descrizione
CustomContainer	CustomContainer
PythonLTS	PythonLTS

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

CustomContainerTemplate

Oggetto

Configurazione del contenitore personalizzata.

Nome	Tipo	Descrizione
containers	SessionContainer[]	Elenco delle definizioni di contenitore per le sessioni del pool di sessioni.
ingress	SessionIngress	Configurazione in ingresso del pool di sessioni.
registryCredentials	SessionRegistryCredentials	Credenziali del Registro Contenitori private per i contenitori usati dalle sessioni del pool di sessioni.

DynamicPoolConfiguration

Oggetto

Configurazione del pool dinamico.

Nome	Tipo	Descrizione
lifecycleConfiguration	LifecycleConfiguration	Configurazione del ciclo di vita di una sessione nel pool di sessioni dinamiche

EnvironmentVar

Oggetto

Variabile di ambiente contenitore dell'app contenitore.

Nome	Tipo	Descrizione
name	string	Nome della variabile di ambiente.
secretRef	string	Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente.
value	string	Valore della variabile di ambiente non segreto.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	La destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

LifecycleConfiguration

Oggetto

Proprietà di configurazione del ciclo di vita di una sessione nel pool di sessioni dinamiche

Nome	Tipo	Descrizione
cooldownPeriodInSeconds	integer (int32)	Periodo di raffreddamento di una sessione in secondi quando il tipo di ciclo di vita è "Timed".
lifecycleType	LifecycleType	Tipo di ciclo di vita del pool di sessioni.
maxAlivePeriodInSeconds	integer (int32)	Periodo massimo attivo di una sessione in secondi quando il tipo di ciclo di vita è "OnContainerExit".

LifecycleType

Enumerazione

Tipo di ciclo di vita del pool di sessioni.

Valore	Descrizione
Timed	Tempo
OnContainerExit	OnContainerExit

ManagedIdentitySetting

Oggetto

Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.

Nome	Tipo	Valore predefinito	Descrizione
identity	string		ID risorsa di un'identità gestita assegnata dall'utente assegnata dall'utente assegnata al pool di sessioni o "sistema" per l'identità assegnata dal sistema.
lifecycle	SessionPoolIdentityLifeCycle	None	Usare per selezionare le fasi del ciclo di vita di un pool di sessioni durante la quale l'identità gestita deve essere disponibile.

ManagedServiceIdentity

Oggetto

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string,  UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PoolManagementType

Enumerazione

Tipo di gestione del pool di sessioni.

Valore	Descrizione
Manual	Manual
Dynamic	Dinamico

ScaleConfiguration

Oggetto

Configurazione della scalabilità.

Nome	Tipo	Descrizione
maxConcurrentSessions	integer (int32)	Numero massimo di sessioni contemporaneamente.
readySessionInstances	integer (int32)	Numero minimo di istanze di sessione pronte.

Scheme

Enumerazione

Schema da usare per la connessione all'host. Il valore predefinito è HTTP.

Valore	Descrizione
HTTP	HTTP
HTTPS	HTTPS

SessionContainer

Oggetto

Definizioni di contenitore per le sessioni del pool di sessioni.

Nome	Tipo	Descrizione
args	string[]	Argomenti del comando di avvio del contenitore.
command	string[]	Comando start del contenitore.
env	EnvironmentVar[]	Variabili di ambiente del contenitore.
image	string	Tag immagine contenitore.
name	string	Nome del contenitore personalizzato.
probes	SessionProbe[]	Elenco di probe per il contenitore.
resources	SessionContainerResources	Requisiti delle risorse del contenitore.

SessionContainerResources

Oggetto

Requisiti delle risorse del contenitore per le sessioni del pool di sessioni.

Nome	Tipo	Descrizione
cpu	number (double)	CPU necessaria nei core, ad esempio 0,5
memory	string	Memoria necessaria, ad esempio "250 Mb"

SessionIngress

Oggetto

Configurazione in ingresso del pool di sessioni.

Nome	Tipo	Descrizione
targetPort	integer (int32)	Porta di destinazione nei contenitori per il traffico proveniente da ingresso

SessionNetworkConfiguration

Oggetto

Configurazione della rete di sessione.

Nome	Tipo	Descrizione
status	SessionNetworkStatus	Stato della rete per le sessioni.

SessionNetworkStatus

Enumerazione

Stato della rete per le sessioni.

Valore	Descrizione
EgressEnabled	EgressEnabled
EgressDisabled	EgressDisabled

SessionPool

Oggetto

Pool di sessioni dell'app contenitore.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.containerType	ContainerType	Tipo di contenitore delle sessioni. Puoi usare il tuo container per costruire il pool di sessioni, oppure puoi usare un container predefinito per eseguire il carico di lavoro con un linguaggio specifico.
properties.customContainerTemplate	CustomContainerTemplate	Configurazione del contenitore personalizzata se containerType è CustomContainer.
properties.dynamicPoolConfiguration	DynamicPoolConfiguration	Configurazione del pool se poolManagementType è dinamico.
properties.environmentId	string (arm-id)	ID risorsa dell'ambiente del pool di sessioni.
properties.managedIdentitySettings	ManagedIdentitySetting[]	Impostazioni facoltative per un'identità gestita assegnata al pool di sessioni.
properties.nodeCount	integer (int32)	Numero di nodi usati dal pool di sessioni.
properties.poolManagementEndpoint	string (uri)	Endpoint per gestire il pool.
properties.poolManagementType	PoolManagementType	Tipo di gestione del pool di sessioni.
properties.provisioningState	SessionPoolProvisioningState	Stato di provisioning del pool di sessioni.
properties.scaleConfiguration	ScaleConfiguration	Configurazione della scalabilità del pool di sessioni.
properties.secrets	SessionPoolSecret[]	Segreti del pool di sessioni.
properties.sessionNetworkConfiguration	SessionNetworkConfiguration	Configurazione di rete delle sessioni nel pool di sessioni.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SessionPoolIdentityLifeCycle

Enumerazione

Usare per selezionare le fasi del ciclo di vita di un pool di sessioni durante la quale l'identità gestita deve essere disponibile.

Valore	Descrizione
None	Non utilizzare l'identità gestita durante nessuna fase del ciclo di vita.
Main	Usa l'identità gestita durante la fase principale del ciclo di vita dell'app Container.

SessionPoolProvisioningState

Enumerazione

Stato di provisioning del pool di sessioni.

Valore	Descrizione
InProgress	In corso
Succeeded	Succeeded
Failed	Non riuscito
Canceled	Annullato
Deleting	Eliminazione

SessionPoolSecret

Oggetto

Definizione del segreto.

Nome	Tipo	Descrizione
name	string	Nome segreto.
value	string (password)	Valore segreto.

SessionProbe

Oggetto

Configurazione del probe di sessione.

Nome	Tipo	Descrizione
failureThreshold	integer (int32)	Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10.
httpGet	SessionProbeHttpGet	HTTPGet specifica la richiesta HTTP da eseguire.
initialDelaySeconds	integer (int32)	Il numero di secondi dopo l'avvio del contenitore prima che vengano avviati i probe di attività. Il valore minimo è 1. Il valore massimo è 60.
periodSeconds	integer (int32)	Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240.
successThreshold	integer (int32)	Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Il valore predefinito è 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10.
tcpSocket	SessionProbeTcpSocket	TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati.
terminationGracePeriodSeconds	integer (int64)	La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora)
timeoutSeconds	integer (int32)	Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240.
type	SessionProbeType	Indica il tipo di sonda. Può essere Liveness o Startup, il probe di prontezza non è supportato nelle sessioni. Il tipo deve essere univoco per ogni probe nel contesto di un elenco di probe (SessionProbes).

SessionProbeHttpGet

Oggetto

HTTPGet specifica la richiesta HTTP da eseguire.

Nome	Tipo	Descrizione
host	string	Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders.
httpHeaders	SessionProbeHttpGetHttpHeadersItem[]	Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute.
path	string	Percorso di accesso nel server HTTP.
port	integer (int32)	Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.
scheme	Scheme	Schema da usare per la connessione all'host. Il valore predefinito è HTTP.

SessionProbeHttpGetHttpHeadersItem

Oggetto

HTTPHeader descrive un'intestazione personalizzata da usare nei probe HTTP

Nome	Tipo	Descrizione
name	string	Nome del campo dell'intestazione
value	string	Valore del campo dell'intestazione

SessionProbeTcpSocket

Oggetto

TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati.

Nome	Tipo	Descrizione
host	string	Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod.
port	integer (int32)	Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME.

SessionProbeType

Enumerazione

Indica il tipo di sonda. Può essere Liveness o Startup, il probe di prontezza non è supportato nelle sessioni. Il tipo deve essere univoco per ogni probe nel contesto di un elenco di probe (SessionProbes).

Valore	Descrizione
Liveness	Controlla se la sessione è ancora in corso e sana.
Startup	Controlla se la sessione è iniziata con successo.

SessionRegistryCredentials

Oggetto

Credenziali del Registro di sistema privato del pool di sessioni.

Nome	Tipo	Descrizione
identity	string	Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system'
passwordSecretRef	string	Nome del segreto che contiene la password di accesso del Registro di sistema
server	string	Server registro contenitori.
username	string	Nome utente registro contenitori.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato per ultima la risorsa.

UserAssignedIdentity

Oggetto

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.