Container Apps Session Pools - Get

Служба:

Azure Container Apps

Версия API:

2026-01-01

Получите свойства пула сеансов.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
sessionPoolName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Имя пула сеансов.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	SessionPool	OK.
Other Status Codes	ErrorResponse	Распространенная реакция на ошибки.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	Выдача себя за свою учетную запись пользователя

Примеры

Get Session Pool

Образец запроса

HTTP

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

Пример ответа

Код состояния:

200

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

Определения

Имя	Описание
ContainerType	Тип контейнера сеансов.
createdByType	Тип удостоверения, создавшего ресурс.
CustomContainerTemplate	Настраиваемая конфигурация контейнера.
DynamicPoolConfiguration	Конфигурация динамического пула.
EnvironmentVar	Переменная среды контейнера приложения-контейнера.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
IdentitySettingsLifeCycle	Используется для выбора этапов жизненного цикла пула сеансов, в течение которого должно быть доступно управляемое удостоверение.
LifecycleConfiguration	Свойства конфигурации жизненного цикла сеанса в динамическом пуле сеансов
LifecycleType	Тип жизненного цикла пула сеансов.
ManagedIdentitySetting	Необязательные параметры управляемого удостоверения, назначенного пулу сеансов.
ManagedServiceIdentity	Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения
ManagedServiceIdentityType	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
PoolManagementType	Тип управления пулом пула сеансов.
ScaleConfiguration	Конфигурация масштабирования.
SessionContainer	Определения контейнеров для сеансов пула сеансов.
SessionContainerResources	Требования к ресурсам контейнера для сеансов пула сеансов.
SessionIngress	Конфигурация входящего трафика пула сеансов.
SessionNetworkConfiguration	Конфигурация сети сеанса.
SessionNetworkStatus	Состояние сети для сеансов.
SessionPool	Пул сеансов приложения-контейнера.
SessionPoolProvisioningState	Состояние подготовки пула сеансов.
SessionPoolSecret	Определение секрета.
SessionRegistryCredentials	Учетные данные частного реестра пула сеансов.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
UserAssignedIdentity	Свойства назначаемого пользователем удостоверения

ContainerType

Перечисление

Тип контейнера сеансов.

Значение	Описание
CustomContainer
PythonLTS

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

CustomContainerTemplate

Объект

Настраиваемая конфигурация контейнера.

Имя	Тип	Описание
containers	SessionContainer[]	Список определений контейнеров для сеансов пула сеансов.
ingress	SessionIngress	Конфигурация входящего трафика пула сеансов.
registryCredentials	SessionRegistryCredentials	Учетные данные реестра частных контейнеров для контейнеров, используемых сеансами пула сеансов.

DynamicPoolConfiguration

Объект

Конфигурация динамического пула.

Имя	Тип	Описание
lifecycleConfiguration	LifecycleConfiguration	Конфигурация жизненного цикла сеанса в динамическом пуле сеансов

EnvironmentVar

Объект

Переменная среды контейнера приложения-контейнера.

Имя	Тип	Описание
name	string	Имя переменной среды.
secretRef	string	Имя секрета приложения контейнера, из которого требуется извлечь значение переменной среды.
value	string	Значение переменной среды, отличной от секрета.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

IdentitySettingsLifeCycle

Перечисление

Используется для выбора этапов жизненного цикла пула сеансов, в течение которого должно быть доступно управляемое удостоверение.

Значение	Описание
None
Main

LifecycleConfiguration

Объект

Свойства конфигурации жизненного цикла сеанса в динамическом пуле сеансов

Имя	Тип	Описание
cooldownPeriodInSeconds	integer (int32)	Период охлаждения сеанса в секундах, когда тип жизненного цикла имеет значение Timed.
lifecycleType	LifecycleType	Тип жизненного цикла пула сеансов.
maxAlivePeriodInSeconds	integer (int32)	Максимальный жизненный период сеанса в секундах, когда тип жизненного цикла — OnContainerExit.

LifecycleType

Перечисление

Тип жизненного цикла пула сеансов.

Значение	Описание
Timed
OnContainerExit

ManagedIdentitySetting

Объект

Необязательные параметры управляемого удостоверения, назначенного пулу сеансов.

Имя	Тип	Default value	Описание
identity	string		Идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который назначается пулу сеансов или системе для назначаемого системой удостоверения.
lifecycle	IdentitySettingsLifeCycle	None	Используется для выбора этапов жизненного цикла пула сеансов, в течение которого должно быть доступно управляемое удостоверение.

ManagedServiceIdentity

Объект

Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения

Имя	Тип	Описание
principalId	string (uuid)	Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.
tenantId	string (uuid)	Идентификатор клиента назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.
type	ManagedServiceIdentityType	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
userAssignedIdentities	<string,  UserAssignedIdentity>	удостоверения User-Assigned Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.

ManagedServiceIdentityType

Перечисление

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

Значение	Описание
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PoolManagementType

Перечисление

Тип управления пулом пула сеансов.

Значение	Описание
Manual
Dynamic

ScaleConfiguration

Объект

Конфигурация масштабирования.

Имя	Тип	Описание
maxConcurrentSessions	integer (int32)	Максимальное количество сеансов одновременно.
readySessionInstances	integer (int32)	Минимальное количество готовых экземпляров сеанса.

SessionContainer

Объект

Определения контейнеров для сеансов пула сеансов.

Имя	Тип	Описание
args	string[]	Аргументы команд запуска контейнера.
command	string[]	Команда запуска контейнера.
env	EnvironmentVar[]	Переменные среды контейнера.
image	string	Тег образа контейнера.
name	string	Имя настраиваемого контейнера.
resources	SessionContainerResources	Требования к ресурсам контейнера.

SessionContainerResources

Объект

Требования к ресурсам контейнера для сеансов пула сеансов.

Имя	Тип	Описание
cpu	number (double)	Обязательный ЦП в ядрах, например 0,5
memory	string	Требуемая память, например "250 Мб"

SessionIngress

Объект

Конфигурация входящего трафика пула сеансов.

Имя	Тип	Описание
targetPort	integer (int32)	Целевой порт в контейнерах для трафика из входящего трафика

SessionNetworkConfiguration

Объект

Конфигурация сети сеанса.

Имя	Тип	Описание
status	SessionNetworkStatus	Состояние сети для сеансов.

SessionNetworkStatus

Перечисление

Состояние сети для сеансов.

Значение	Описание
EgressEnabled
EgressDisabled

SessionPool

Объект

Пул сеансов приложения-контейнера.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Управляемые идентификаторы, необходимые пулу сессий для взаимодействия с другими сервисами Azure, чтобы не сохранять секреты или учетные данные в коде.
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.containerType	ContainerType	Тип контейнера сеансов.
properties.customContainerTemplate	CustomContainerTemplate	Настраиваемая конфигурация контейнера, если контейнерType — CustomContainer.
properties.dynamicPoolConfiguration	DynamicPoolConfiguration	Конфигурация пула, если poolManagementType является динамическим.
properties.environmentId	string (arm-id)	Идентификатор ресурса среды пула сеансов.
properties.managedIdentitySettings	ManagedIdentitySetting[]	Необязательные параметры управляемого удостоверения, назначенного пулу сеансов.
properties.nodeCount	integer (int32)	Количество узлов, которые использует пул сеансов.
properties.poolManagementEndpoint	string (uri)	Конечная точка для управления пулом.
properties.poolManagementType	PoolManagementType	Тип управления пулом пула сеансов.
properties.provisioningState	SessionPoolProvisioningState	Состояние подготовки пула сеансов.
properties.scaleConfiguration	ScaleConfiguration	Конфигурация масштабируемого пула сеансов.
properties.secrets	SessionPoolSecret[]	Секреты пула сеансов.
properties.sessionNetworkConfiguration	SessionNetworkConfiguration	Сетевая конфигурация сеансов в пуле сеансов.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

SessionPoolProvisioningState

Перечисление

Состояние подготовки пула сеансов.

Значение	Описание
InProgress
Succeeded
Failed
Canceled
Deleting

SessionPoolSecret

Объект

Определение секрета.

Имя	Тип	Описание
name	string	Имя секрета.
value	string	Значение секрета.

SessionRegistryCredentials

Объект

Учетные данные частного реестра пула сеансов.

Имя	Тип	Описание
identity	string	Управляемая идентичность для аутентификации с помощью Azure Container Registry. Для удостоверений, назначенных пользователем, используйте полный идентификатор ресурса удостоверения, назначаемого пользователем. Для удостоверений, назначенных системой, используйте system
passwordSecretRef	string	Имя секрета, содержащего пароль для входа в реестр
server	string	Сервер реестра контейнеров.
username	string	Имя пользователя реестра контейнеров.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

UserAssignedIdentity

Объект

Свойства назначаемого пользователем удостоверения

Имя	Тип	Описание
clientId	string (uuid)	Идентификатор клиента назначенного удостоверения.
principalId	string (uuid)	Основной идентификатор назначенного удостоверения.