Bicep-Ressourcendefinition
Der SessionPools-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Um eine Microsoft.App/sessionPools-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.
resource symbolicname 'Microsoft.App/sessionPools@2025-10-02-preview' = {
scope: resourceSymbolicName or scope
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
containerType: 'string'
customContainerTemplate: {
containers: [
{
args: [
'string'
]
command: [
'string'
]
env: [
{
name: 'string'
secretRef: 'string'
value: 'string'
}
]
image: 'string'
name: 'string'
probes: [
{
failureThreshold: int
httpGet: {
host: 'string'
httpHeaders: [
{
name: 'string'
value: 'string'
}
]
path: 'string'
port: int
scheme: 'string'
}
initialDelaySeconds: int
periodSeconds: int
successThreshold: int
tcpSocket: {
host: 'string'
port: int
}
terminationGracePeriodSeconds: int
timeoutSeconds: int
type: 'string'
}
]
resources: {
cpu: int
memory: 'string'
}
}
]
ingress: {
targetPort: int
}
registryCredentials: {
identity: 'string'
passwordSecretRef: 'string'
server: 'string'
username: 'string'
}
}
dynamicPoolConfiguration: {
lifecycleConfiguration: {
cooldownPeriodInSeconds: int
lifecycleType: 'string'
maxAlivePeriodInSeconds: int
}
}
environmentId: 'string'
managedIdentitySettings: [
{
identity: 'string'
lifecycle: 'string'
}
]
mcpServerSettings: {
isMcpServerApiKeyDisabled: bool
isMcpServerEnabled: bool
}
poolManagementType: 'string'
scaleConfiguration: {
maxConcurrentSessions: int
readySessionInstances: int
}
secrets: [
{
name: 'string'
value: 'string'
}
]
sessionNetworkConfiguration: {
status: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Eigenschaftswerte
Microsoft.App/sessionPools
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Verwaltete Identitäten, die von einem Sitzungspool benötigt werden, um mit anderen Azure-Diensten zu interagieren, um keine geheimen Schlüssel oder Anmeldeinformationen im Code zu verwalten. |
ManagedServiceIdentity- |
| Standort |
Der geografische Standort, an dem sich die Ressource befindet |
Zeichenfolge (erforderlich) |
| Name |
Der Ressourcenname |
Zeichenfolge
Zwänge: Min. Länge = 3 Max. Länge = 63 Pattern = ^[a-z][a-z0-9]*$ (erforderlich) |
| Eigenschaften |
Ressourcenspezifische Eigenschaften des Container-App-Sitzungspools |
SessionPoolProperties- |
| scope |
Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. |
Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden. |
| Schlagwörter |
Ressourcenetiketten |
Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
CustomContainerTemplate
| Name |
BESCHREIBUNG |
Wert |
| Container |
Liste der Containerdefinitionen für die Sitzungen des Sitzungspools. |
SessionContainer-[] |
| Eintritt |
Konfiguration des Sitzungspools. |
SessionIngress- |
| registryAnmeldeinformationen |
Anmeldeinformationen für private Container für Container, die von den Sitzungen des Sitzungspools verwendet werden. |
SessionRegistryCredentials- |
DynamicPoolConfiguration
| Name |
BESCHREIBUNG |
Wert |
| lifecycleConfiguration |
Die Lebenszykluskonfiguration einer Sitzung im dynamischen Sitzungspool |
LifecycleConfiguration- |
UmgebungVar
| Name |
BESCHREIBUNG |
Wert |
| Name |
Name der Umgebungsvariable. |
Schnur |
| secretRef |
Name des geheimen Container-App-Schlüssels, aus dem der Umgebungsvariablenwert abgerufen werden soll. |
Schnur |
| Wert |
Nicht geheimer Umgebungsvariablenwert. |
Schnur |
Lebenszyklus-Konfiguration
| Name |
BESCHREIBUNG |
Wert |
| cooldownPeriodInSeconds |
Der Cooldownzeitraum einer Sitzung in Sekunden, wenn der Lebenszyklustyp "Timed" ist. |
INT |
| Lebenszyklus-Typ |
Der Lebenszyklustyp des Sitzungspools. |
'OnContainerExit' "Timed" |
| maxAlivePeriodInSeconds |
Der maximale Lebendigkeitszeitraum einer Sitzung in Sekunden, wenn der Lebenszyklustyp "OnContainerExit" ist. |
INT |
ManagedIdentitySetting
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Die Ressourcen-ID einer vom Benutzer zugewiesenen verwalteten Identität, die dem Sitzungspool oder dem System für die vom System zugewiesene Identität zugewiesen ist. |
Zeichenfolge (erforderlich) |
| Lebenszyklus |
Wird verwendet, um die Lebenszyklusphasen eines Sitzungspools auszuwählen, in dem die verwaltete Identität verfügbar sein sollte. |
"Alle" 'Init' "Haupt" "Keine" |
Verwaltete Dienstidentität
| Name |
BESCHREIBUNG |
Wert |
| Typ |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
"Keine" 'SystemZugewiesen' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
| vom Benutzer zugewiesene Identitäten |
Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. |
UserAssignedIdentities- |
McpServerEinstellungen
| Name |
BESCHREIBUNG |
Wert |
| isMcpServerApiKeyDeaktiviert |
Gibt an, ob der API-Schlüssel des MCP-Servers deaktiviert ist. |
Boolesch |
| isMcpServerEnabled |
Gibt an, ob der MCP-Server aktiviert ist. |
Boolesch |
ScaleConfiguration (Skalieren)
| Name |
BESCHREIBUNG |
Wert |
| maxConcurrentSessions |
Die maximale Anzahl von Sitzungen gleichzeitig. |
INT |
| readySession-Instanzen |
Die Mindestanzahl der bereiten Sitzungsinstanzen. |
INT |
SessionContainer (Englisch)
| Name |
BESCHREIBUNG |
Wert |
| Args |
Argumente für containerstartbefehle. |
Zeichenfolge[] |
| Befehl |
Containerstartbefehl. |
Zeichenfolge[] |
| Umgebung |
Containerumgebungsvariablen. |
UmgebungVar[] |
| Bild |
Containerimage-Tag. |
Schnur |
| Name |
Benutzerdefinierter Containername. |
Schnur |
| probes |
Liste der Prüfpunkte für den Container. |
SessionProbe[] |
| ressourcen |
Containerressourcenanforderungen. |
SessionContainerResources- |
SessionContainerRessourcen
| Name |
BESCHREIBUNG |
Wert |
| CPU |
Erforderliche CPU in Kernen, z. B. 0,5 |
INT |
| Gedächtnis |
Erforderlicher Arbeitsspeicher, z. B. "250Mb" |
Schnur |
SessionIngress
| Name |
BESCHREIBUNG |
Wert |
| targetPort |
Zielport in Containern für Datenverkehr vom Ingress |
INT |
SessionNetworkConfiguration
| Name |
BESCHREIBUNG |
Wert |
| Status |
Netzwerkstatus für die Sitzungen. |
'EgressDisabled' 'EgressEnabled' |
SessionPoolEigenschaften
| Name |
BESCHREIBUNG |
Wert |
| containerTyp |
Der Containertyp der Sitzungen. |
'CustomContainer' "PythonLTS" |
| customContainerTemplate |
Die benutzerdefinierte Containerkonfiguration, wenn der containerType customContainer ist. |
CustomContainerTemplate- |
| dynamicPoolConfiguration |
Die Poolkonfiguration, wenn der poolManagementType dynamisch ist. |
DynamicPoolConfiguration- |
| Umgebungs-ID |
Ressourcen-ID der Umgebung des Sitzungspools. |
Schnur |
| managedIdentitySettings |
Optionale Einstellungen für eine verwaltete Identität, die dem Sitzungspool zugewiesen ist. |
ManagedIdentitySetting[] |
| mcpServerEinstellungen |
Die MCP-Servereinstellungen (Model Context Protocol) des Sitzungspools. |
McpServerEinstellungen |
| poolManagementType |
Der Poolverwaltungstyp des Sitzungspools. |
"Dynamisch" "Manuell" |
| scaleConfiguration |
Die Skalierungskonfiguration des Sitzungspools. |
ScaleConfiguration- |
| Geheimnisse |
Die geheimen Schlüssel des Sitzungspools. |
SessionPoolSecret[] |
| sessionNetworkConfiguration |
Die Netzwerkkonfiguration der Sitzungen im Sitzungspool. |
SessionNetworkConfiguration- |
SessionPoolSecret
| Name |
BESCHREIBUNG |
Wert |
| Name |
Geheimer Name. |
Schnur |
| Wert |
Geheimer Wert. |
Zeichenfolge
Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
SessionProbe
| Name |
BESCHREIBUNG |
Wert |
| failureThreshold |
Mindestens aufeinander folgende Fehler für den Prüfpunkt, der nach erfolgreichem Erfolg als fehlgeschlagen betrachtet werden soll. Der Standardwert ist 3. Der Mindestwert ist 1. Der Maximalwert ist 10. |
INT |
| httpHolen |
HTTPGet gibt die auszuführende HTTP-Anforderung an. |
SessionProbeHttpGet |
| initialDelaySeconds |
Die Anzahl der Sekunden, die nach dem Start des Containers vergehen, bevor Livetests initiiert werden. Der Mindestwert ist 1. Der Maximalwert ist 60. |
INT |
| periodSeconds |
Wie oft (in Sekunden) die Probe ausgeführt werden soll. Der Standardwert ist 10 Sekunden. Der Mindestwert ist 1. Der Maximalwert ist 240. |
INT |
| successThreshold |
Mindestens aufeinander folgende Erfolge für die Sonde, die nach einem Fehler als erfolgreich angesehen werden sollen. Der Standardwert lautet 1. Muss 1 für Lebendigkeit und Start sein. Der Mindestwert ist 1. Der Maximalwert ist 10. |
INT |
| tcpSocket |
TCPSocket gibt eine Aktion an, die einen TCP-Port umfasst. TCP-Hooks werden noch nicht unterstützt. |
SessionProbeTcpSocket |
| terminationGracePeriodSeconds |
Optionale Dauer in Sekunden, die der Pod bei Einem Probefehler ordnungsgemäß beenden muss. Die Karenzzeit ist die Dauer in Sekunden, nachdem die im Pod ausgeführten Prozesse ein Beendigungssignal gesendet wurden, und die Zeit, zu der die Prozesse mit einem Kill-Signal unterbrochen werden. Legen Sie diesen Wert länger als die erwartete Bereinigungszeit für Ihren Prozess fest. Wenn dieser Wert "nil" ist, wird die "terminationGracePeriodSeconds" des Pods verwendet. Andernfalls überschreibt dieser Wert den von der Pod-Spezifikation bereitgestellten Wert. Der Wert muss eine nicht negative ganze Zahl sein. Der Wert Null gibt den Stopp sofort über das Kill-Signal an (keine Möglichkeit, herunterzufahren). Dies ist ein Alphafeld und erfordert das Aktivieren des ProbeTerminationGracePeriod-Featuregates. Der Maximalwert beträgt 3600 Sekunden (1 Stunde) |
INT |
| timeoutSeconds |
Die Anzahl der Sekunden, nach denen der Sonde eine Zeitüberschreitung aufweist. Der Standardwert ist 1 Sekunde. Der Mindestwert ist 1. Der Maximalwert ist 240. |
INT |
| Typ |
Gibt den Typ der Sonde an. Kann Liveness oder Startup sein, Readiness Probe wird in Sitzungen nicht unterstützt. Der Typ muss für jeden Test im Kontext einer Liste von Tests (SessionProbes) eindeutig sein. |
"Lebendigkeit" "Start" |
SessionProbeHttpGet
| Name |
BESCHREIBUNG |
Wert |
| host |
Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP. Wahrscheinlich möchten Sie stattdessen "Host" in httpHeaders festlegen. |
Schnur |
| httpHeader |
Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP ermöglicht wiederholte Header. |
SessionProbeHttpGetHttpHeadersItem[] |
| Pfad |
Pfad für den Zugriff auf den HTTP-Server. |
Schnur |
| port |
Name oder Nummer des Ports für den Zugriff auf den Container. Die Zahl muss im Bereich 1 bis 65535 liegen. Der Name muss ein IANA_SVC_NAME sein. |
int (erforderlich) |
| scheme |
Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Standardwert ist HTTP. |
'HTTP' 'HTTPS' |
| Name |
BESCHREIBUNG |
Wert |
| Name |
Der Name des Kopfzeilenfelds |
Zeichenfolge (erforderlich) |
| Wert |
Der Wert des Kopfzeilenfelds |
Zeichenfolge (erforderlich) |
SessionProbeTcpSocket
| Name |
BESCHREIBUNG |
Wert |
| host |
Optional: Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP. |
Schnur |
| port |
Die Nummer oder der Name des Ports für den Zugriff auf den Container. Die Zahl muss im Bereich 1 bis 65535 liegen. Der Name muss ein IANA_SVC_NAME sein. |
int (erforderlich) |
SessionRegistryAnmeldeinformationen
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Eine verwaltete Identität zur Authentifizierung bei Azure Container Registry. Verwenden Sie für vom Benutzer zugewiesene Identitäten die vollständige vom Benutzer zugewiesene Identitätsressourcen-ID. Verwenden Sie für vom System zugewiesene Identitäten "system" |
Schnur |
| passwordSecretRef |
Der Name des geheimen Schlüssels, der das Registrierungsanmeldungskennwort enthält |
Schnur |
| Server |
Containerregistrierungsserver. |
Schnur |
| Benutzername |
Benutzername der Containerregistrierung. |
Schnur |
UserAssignedIdentities
UserAssignedIdentity
Verwendungsbeispiele
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
ARM-Vorlagenressourcendefinition
Der SessionPools-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Um eine Microsoft.App/sessionPools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.App/sessionPools",
"apiVersion": "2025-10-02-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"containerType": "string",
"customContainerTemplate": {
"containers": [
{
"args": [ "string" ],
"command": [ "string" ],
"env": [
{
"name": "string",
"secretRef": "string",
"value": "string"
}
],
"image": "string",
"name": "string",
"probes": [
{
"failureThreshold": "int",
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"path": "string",
"port": "int",
"scheme": "string"
},
"initialDelaySeconds": "int",
"periodSeconds": "int",
"successThreshold": "int",
"tcpSocket": {
"host": "string",
"port": "int"
},
"terminationGracePeriodSeconds": "int",
"timeoutSeconds": "int",
"type": "string"
}
],
"resources": {
"cpu": "int",
"memory": "string"
}
}
],
"ingress": {
"targetPort": "int"
},
"registryCredentials": {
"identity": "string",
"passwordSecretRef": "string",
"server": "string",
"username": "string"
}
},
"dynamicPoolConfiguration": {
"lifecycleConfiguration": {
"cooldownPeriodInSeconds": "int",
"lifecycleType": "string",
"maxAlivePeriodInSeconds": "int"
}
},
"environmentId": "string",
"managedIdentitySettings": [
{
"identity": "string",
"lifecycle": "string"
}
],
"mcpServerSettings": {
"isMcpServerApiKeyDisabled": "bool",
"isMcpServerEnabled": "bool"
},
"poolManagementType": "string",
"scaleConfiguration": {
"maxConcurrentSessions": "int",
"readySessionInstances": "int"
},
"secrets": [
{
"name": "string",
"value": "string"
}
],
"sessionNetworkConfiguration": {
"status": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Eigenschaftswerte
Microsoft.App/sessionPools
| Name |
BESCHREIBUNG |
Wert |
| apiVersion (Englisch) |
Die API-Version |
'02.10.2025 Vorschau |
| Identität |
Verwaltete Identitäten, die von einem Sitzungspool benötigt werden, um mit anderen Azure-Diensten zu interagieren, um keine geheimen Schlüssel oder Anmeldeinformationen im Code zu verwalten. |
ManagedServiceIdentity- |
| Standort |
Der geografische Standort, an dem sich die Ressource befindet |
Zeichenfolge (erforderlich) |
| Name |
Der Ressourcenname |
Zeichenfolge
Zwänge: Min. Länge = 3 Max. Länge = 63 Pattern = ^[a-z][a-z0-9]*$ (erforderlich) |
| Eigenschaften |
Ressourcenspezifische Eigenschaften des Container-App-Sitzungspools |
SessionPoolProperties- |
| Schlagwörter |
Ressourcenetiketten |
Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Typ |
Der Ressourcentyp |
"Microsoft.App/sessionPools" |
CustomContainerTemplate
| Name |
BESCHREIBUNG |
Wert |
| Container |
Liste der Containerdefinitionen für die Sitzungen des Sitzungspools. |
SessionContainer-[] |
| Eintritt |
Konfiguration des Sitzungspools. |
SessionIngress- |
| registryAnmeldeinformationen |
Anmeldeinformationen für private Container für Container, die von den Sitzungen des Sitzungspools verwendet werden. |
SessionRegistryCredentials- |
DynamicPoolConfiguration
| Name |
BESCHREIBUNG |
Wert |
| lifecycleConfiguration |
Die Lebenszykluskonfiguration einer Sitzung im dynamischen Sitzungspool |
LifecycleConfiguration- |
UmgebungVar
| Name |
BESCHREIBUNG |
Wert |
| Name |
Name der Umgebungsvariable. |
Schnur |
| secretRef |
Name des geheimen Container-App-Schlüssels, aus dem der Umgebungsvariablenwert abgerufen werden soll. |
Schnur |
| Wert |
Nicht geheimer Umgebungsvariablenwert. |
Schnur |
Lebenszyklus-Konfiguration
| Name |
BESCHREIBUNG |
Wert |
| cooldownPeriodInSeconds |
Der Cooldownzeitraum einer Sitzung in Sekunden, wenn der Lebenszyklustyp "Timed" ist. |
INT |
| Lebenszyklus-Typ |
Der Lebenszyklustyp des Sitzungspools. |
'OnContainerExit' "Timed" |
| maxAlivePeriodInSeconds |
Der maximale Lebendigkeitszeitraum einer Sitzung in Sekunden, wenn der Lebenszyklustyp "OnContainerExit" ist. |
INT |
ManagedIdentitySetting
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Die Ressourcen-ID einer vom Benutzer zugewiesenen verwalteten Identität, die dem Sitzungspool oder dem System für die vom System zugewiesene Identität zugewiesen ist. |
Zeichenfolge (erforderlich) |
| Lebenszyklus |
Wird verwendet, um die Lebenszyklusphasen eines Sitzungspools auszuwählen, in dem die verwaltete Identität verfügbar sein sollte. |
"Alle" 'Init' "Haupt" "Keine" |
Verwaltete Dienstidentität
| Name |
BESCHREIBUNG |
Wert |
| Typ |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
"Keine" 'SystemZugewiesen' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
| vom Benutzer zugewiesene Identitäten |
Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. |
UserAssignedIdentities- |
McpServerEinstellungen
| Name |
BESCHREIBUNG |
Wert |
| isMcpServerApiKeyDeaktiviert |
Gibt an, ob der API-Schlüssel des MCP-Servers deaktiviert ist. |
Boolesch |
| isMcpServerEnabled |
Gibt an, ob der MCP-Server aktiviert ist. |
Boolesch |
ScaleConfiguration (Skalieren)
| Name |
BESCHREIBUNG |
Wert |
| maxConcurrentSessions |
Die maximale Anzahl von Sitzungen gleichzeitig. |
INT |
| readySession-Instanzen |
Die Mindestanzahl der bereiten Sitzungsinstanzen. |
INT |
SessionContainer (Englisch)
| Name |
BESCHREIBUNG |
Wert |
| Args |
Argumente für containerstartbefehle. |
Zeichenfolge[] |
| Befehl |
Containerstartbefehl. |
Zeichenfolge[] |
| Umgebung |
Containerumgebungsvariablen. |
UmgebungVar[] |
| Bild |
Containerimage-Tag. |
Schnur |
| Name |
Benutzerdefinierter Containername. |
Schnur |
| probes |
Liste der Prüfpunkte für den Container. |
SessionProbe[] |
| ressourcen |
Containerressourcenanforderungen. |
SessionContainerResources- |
SessionContainerRessourcen
| Name |
BESCHREIBUNG |
Wert |
| CPU |
Erforderliche CPU in Kernen, z. B. 0,5 |
INT |
| Gedächtnis |
Erforderlicher Arbeitsspeicher, z. B. "250Mb" |
Schnur |
SessionIngress
| Name |
BESCHREIBUNG |
Wert |
| targetPort |
Zielport in Containern für Datenverkehr vom Ingress |
INT |
SessionNetworkConfiguration
| Name |
BESCHREIBUNG |
Wert |
| Status |
Netzwerkstatus für die Sitzungen. |
'EgressDisabled' 'EgressEnabled' |
SessionPoolEigenschaften
| Name |
BESCHREIBUNG |
Wert |
| containerTyp |
Der Containertyp der Sitzungen. |
'CustomContainer' "PythonLTS" |
| customContainerTemplate |
Die benutzerdefinierte Containerkonfiguration, wenn der containerType customContainer ist. |
CustomContainerTemplate- |
| dynamicPoolConfiguration |
Die Poolkonfiguration, wenn der poolManagementType dynamisch ist. |
DynamicPoolConfiguration- |
| Umgebungs-ID |
Ressourcen-ID der Umgebung des Sitzungspools. |
Schnur |
| managedIdentitySettings |
Optionale Einstellungen für eine verwaltete Identität, die dem Sitzungspool zugewiesen ist. |
ManagedIdentitySetting[] |
| mcpServerEinstellungen |
Die MCP-Servereinstellungen (Model Context Protocol) des Sitzungspools. |
McpServerEinstellungen |
| poolManagementType |
Der Poolverwaltungstyp des Sitzungspools. |
"Dynamisch" "Manuell" |
| scaleConfiguration |
Die Skalierungskonfiguration des Sitzungspools. |
ScaleConfiguration- |
| Geheimnisse |
Die geheimen Schlüssel des Sitzungspools. |
SessionPoolSecret[] |
| sessionNetworkConfiguration |
Die Netzwerkkonfiguration der Sitzungen im Sitzungspool. |
SessionNetworkConfiguration- |
SessionPoolSecret
| Name |
BESCHREIBUNG |
Wert |
| Name |
Geheimer Name. |
Schnur |
| Wert |
Geheimer Wert. |
Zeichenfolge
Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
SessionProbe
| Name |
BESCHREIBUNG |
Wert |
| failureThreshold |
Mindestens aufeinander folgende Fehler für den Prüfpunkt, der nach erfolgreichem Erfolg als fehlgeschlagen betrachtet werden soll. Der Standardwert ist 3. Der Mindestwert ist 1. Der Maximalwert ist 10. |
INT |
| httpHolen |
HTTPGet gibt die auszuführende HTTP-Anforderung an. |
SessionProbeHttpGet |
| initialDelaySeconds |
Die Anzahl der Sekunden, die nach dem Start des Containers vergehen, bevor Livetests initiiert werden. Der Mindestwert ist 1. Der Maximalwert ist 60. |
INT |
| periodSeconds |
Wie oft (in Sekunden) die Probe ausgeführt werden soll. Der Standardwert ist 10 Sekunden. Der Mindestwert ist 1. Der Maximalwert ist 240. |
INT |
| successThreshold |
Mindestens aufeinander folgende Erfolge für die Sonde, die nach einem Fehler als erfolgreich angesehen werden sollen. Der Standardwert lautet 1. Muss 1 für Lebendigkeit und Start sein. Der Mindestwert ist 1. Der Maximalwert ist 10. |
INT |
| tcpSocket |
TCPSocket gibt eine Aktion an, die einen TCP-Port umfasst. TCP-Hooks werden noch nicht unterstützt. |
SessionProbeTcpSocket |
| terminationGracePeriodSeconds |
Optionale Dauer in Sekunden, die der Pod bei Einem Probefehler ordnungsgemäß beenden muss. Die Karenzzeit ist die Dauer in Sekunden, nachdem die im Pod ausgeführten Prozesse ein Beendigungssignal gesendet wurden, und die Zeit, zu der die Prozesse mit einem Kill-Signal unterbrochen werden. Legen Sie diesen Wert länger als die erwartete Bereinigungszeit für Ihren Prozess fest. Wenn dieser Wert "nil" ist, wird die "terminationGracePeriodSeconds" des Pods verwendet. Andernfalls überschreibt dieser Wert den von der Pod-Spezifikation bereitgestellten Wert. Der Wert muss eine nicht negative ganze Zahl sein. Der Wert Null gibt den Stopp sofort über das Kill-Signal an (keine Möglichkeit, herunterzufahren). Dies ist ein Alphafeld und erfordert das Aktivieren des ProbeTerminationGracePeriod-Featuregates. Der Maximalwert beträgt 3600 Sekunden (1 Stunde) |
INT |
| timeoutSeconds |
Die Anzahl der Sekunden, nach denen der Sonde eine Zeitüberschreitung aufweist. Der Standardwert ist 1 Sekunde. Der Mindestwert ist 1. Der Maximalwert ist 240. |
INT |
| Typ |
Gibt den Typ der Sonde an. Kann Liveness oder Startup sein, Readiness Probe wird in Sitzungen nicht unterstützt. Der Typ muss für jeden Test im Kontext einer Liste von Tests (SessionProbes) eindeutig sein. |
"Lebendigkeit" "Start" |
SessionProbeHttpGet
| Name |
BESCHREIBUNG |
Wert |
| host |
Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP. Wahrscheinlich möchten Sie stattdessen "Host" in httpHeaders festlegen. |
Schnur |
| httpHeader |
Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP ermöglicht wiederholte Header. |
SessionProbeHttpGetHttpHeadersItem[] |
| Pfad |
Pfad für den Zugriff auf den HTTP-Server. |
Schnur |
| port |
Name oder Nummer des Ports für den Zugriff auf den Container. Die Zahl muss im Bereich 1 bis 65535 liegen. Der Name muss ein IANA_SVC_NAME sein. |
int (erforderlich) |
| scheme |
Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Standardwert ist HTTP. |
'HTTP' 'HTTPS' |
| Name |
BESCHREIBUNG |
Wert |
| Name |
Der Name des Kopfzeilenfelds |
Zeichenfolge (erforderlich) |
| Wert |
Der Wert des Kopfzeilenfelds |
Zeichenfolge (erforderlich) |
SessionProbeTcpSocket
| Name |
BESCHREIBUNG |
Wert |
| host |
Optional: Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP. |
Schnur |
| port |
Die Nummer oder der Name des Ports für den Zugriff auf den Container. Die Zahl muss im Bereich 1 bis 65535 liegen. Der Name muss ein IANA_SVC_NAME sein. |
int (erforderlich) |
SessionRegistryAnmeldeinformationen
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Eine verwaltete Identität zur Authentifizierung bei Azure Container Registry. Verwenden Sie für vom Benutzer zugewiesene Identitäten die vollständige vom Benutzer zugewiesene Identitätsressourcen-ID. Verwenden Sie für vom System zugewiesene Identitäten "system" |
Schnur |
| passwordSecretRef |
Der Name des geheimen Schlüssels, der das Registrierungsanmeldungskennwort enthält |
Schnur |
| Server |
Containerregistrierungsserver. |
Schnur |
| Benutzername |
Benutzername der Containerregistrierung. |
Schnur |
UserAssignedIdentities
UserAssignedIdentity
Verwendungsbeispiele
Der SessionPools-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Um eine Microsoft.App/sessionPools Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.App/sessionPools@2025-10-02-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
containerType = "string"
customContainerTemplate = {
containers = [
{
args = [
"string"
]
command = [
"string"
]
env = [
{
name = "string"
secretRef = "string"
value = "string"
}
]
image = "string"
name = "string"
probes = [
{
failureThreshold = int
httpGet = {
host = "string"
httpHeaders = [
{
name = "string"
value = "string"
}
]
path = "string"
port = int
scheme = "string"
}
initialDelaySeconds = int
periodSeconds = int
successThreshold = int
tcpSocket = {
host = "string"
port = int
}
terminationGracePeriodSeconds = int
timeoutSeconds = int
type = "string"
}
]
resources = {
cpu = int
memory = "string"
}
}
]
ingress = {
targetPort = int
}
registryCredentials = {
identity = "string"
passwordSecretRef = "string"
server = "string"
username = "string"
}
}
dynamicPoolConfiguration = {
lifecycleConfiguration = {
cooldownPeriodInSeconds = int
lifecycleType = "string"
maxAlivePeriodInSeconds = int
}
}
environmentId = "string"
managedIdentitySettings = [
{
identity = "string"
lifecycle = "string"
}
]
mcpServerSettings = {
isMcpServerApiKeyDisabled = bool
isMcpServerEnabled = bool
}
poolManagementType = "string"
scaleConfiguration = {
maxConcurrentSessions = int
readySessionInstances = int
}
secrets = [
{
name = "string"
value = "string"
}
]
sessionNetworkConfiguration = {
status = "string"
}
}
}
}
Eigenschaftswerte
Microsoft.App/sessionPools
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Verwaltete Identitäten, die von einem Sitzungspool benötigt werden, um mit anderen Azure-Diensten zu interagieren, um keine geheimen Schlüssel oder Anmeldeinformationen im Code zu verwalten. |
ManagedServiceIdentity- |
| Standort |
Der geografische Standort, an dem sich die Ressource befindet |
Zeichenfolge (erforderlich) |
| Name |
Der Ressourcenname |
Zeichenfolge
Zwänge: Min. Länge = 3 Max. Länge = 63 Pattern = ^[a-z][a-z0-9]*$ (erforderlich) |
| parent_id |
Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. |
Zeichenfolge (erforderlich) |
| Eigenschaften |
Ressourcenspezifische Eigenschaften des Container-App-Sitzungspools |
SessionPoolProperties- |
| Schlagwörter |
Ressourcenetiketten |
Wörterbuch der Tagnamen und -werte. |
| Typ |
Der Ressourcentyp |
"Microsoft.App/sessionPools@2025-10-02-preview" |
CustomContainerTemplate
| Name |
BESCHREIBUNG |
Wert |
| Container |
Liste der Containerdefinitionen für die Sitzungen des Sitzungspools. |
SessionContainer-[] |
| Eintritt |
Konfiguration des Sitzungspools. |
SessionIngress- |
| registryAnmeldeinformationen |
Anmeldeinformationen für private Container für Container, die von den Sitzungen des Sitzungspools verwendet werden. |
SessionRegistryCredentials- |
DynamicPoolConfiguration
| Name |
BESCHREIBUNG |
Wert |
| lifecycleConfiguration |
Die Lebenszykluskonfiguration einer Sitzung im dynamischen Sitzungspool |
LifecycleConfiguration- |
UmgebungVar
| Name |
BESCHREIBUNG |
Wert |
| Name |
Name der Umgebungsvariable. |
Schnur |
| secretRef |
Name des geheimen Container-App-Schlüssels, aus dem der Umgebungsvariablenwert abgerufen werden soll. |
Schnur |
| Wert |
Nicht geheimer Umgebungsvariablenwert. |
Schnur |
Lebenszyklus-Konfiguration
| Name |
BESCHREIBUNG |
Wert |
| cooldownPeriodInSeconds |
Der Cooldownzeitraum einer Sitzung in Sekunden, wenn der Lebenszyklustyp "Timed" ist. |
INT |
| Lebenszyklus-Typ |
Der Lebenszyklustyp des Sitzungspools. |
'OnContainerExit' "Timed" |
| maxAlivePeriodInSeconds |
Der maximale Lebendigkeitszeitraum einer Sitzung in Sekunden, wenn der Lebenszyklustyp "OnContainerExit" ist. |
INT |
ManagedIdentitySetting
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Die Ressourcen-ID einer vom Benutzer zugewiesenen verwalteten Identität, die dem Sitzungspool oder dem System für die vom System zugewiesene Identität zugewiesen ist. |
Zeichenfolge (erforderlich) |
| Lebenszyklus |
Wird verwendet, um die Lebenszyklusphasen eines Sitzungspools auszuwählen, in dem die verwaltete Identität verfügbar sein sollte. |
"Alle" 'Init' "Haupt" "Keine" |
Verwaltete Dienstidentität
| Name |
BESCHREIBUNG |
Wert |
| Typ |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
"Keine" 'SystemZugewiesen' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
| vom Benutzer zugewiesene Identitäten |
Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. |
UserAssignedIdentities- |
McpServerEinstellungen
| Name |
BESCHREIBUNG |
Wert |
| isMcpServerApiKeyDeaktiviert |
Gibt an, ob der API-Schlüssel des MCP-Servers deaktiviert ist. |
Boolesch |
| isMcpServerEnabled |
Gibt an, ob der MCP-Server aktiviert ist. |
Boolesch |
ScaleConfiguration (Skalieren)
| Name |
BESCHREIBUNG |
Wert |
| maxConcurrentSessions |
Die maximale Anzahl von Sitzungen gleichzeitig. |
INT |
| readySession-Instanzen |
Die Mindestanzahl der bereiten Sitzungsinstanzen. |
INT |
SessionContainer (Englisch)
| Name |
BESCHREIBUNG |
Wert |
| Args |
Argumente für containerstartbefehle. |
Zeichenfolge[] |
| Befehl |
Containerstartbefehl. |
Zeichenfolge[] |
| Umgebung |
Containerumgebungsvariablen. |
UmgebungVar[] |
| Bild |
Containerimage-Tag. |
Schnur |
| Name |
Benutzerdefinierter Containername. |
Schnur |
| probes |
Liste der Prüfpunkte für den Container. |
SessionProbe[] |
| ressourcen |
Containerressourcenanforderungen. |
SessionContainerResources- |
SessionContainerRessourcen
| Name |
BESCHREIBUNG |
Wert |
| CPU |
Erforderliche CPU in Kernen, z. B. 0,5 |
INT |
| Gedächtnis |
Erforderlicher Arbeitsspeicher, z. B. "250Mb" |
Schnur |
SessionIngress
| Name |
BESCHREIBUNG |
Wert |
| targetPort |
Zielport in Containern für Datenverkehr vom Ingress |
INT |
SessionNetworkConfiguration
| Name |
BESCHREIBUNG |
Wert |
| Status |
Netzwerkstatus für die Sitzungen. |
'EgressDisabled' 'EgressEnabled' |
SessionPoolEigenschaften
| Name |
BESCHREIBUNG |
Wert |
| containerTyp |
Der Containertyp der Sitzungen. |
'CustomContainer' "PythonLTS" |
| customContainerTemplate |
Die benutzerdefinierte Containerkonfiguration, wenn der containerType customContainer ist. |
CustomContainerTemplate- |
| dynamicPoolConfiguration |
Die Poolkonfiguration, wenn der poolManagementType dynamisch ist. |
DynamicPoolConfiguration- |
| Umgebungs-ID |
Ressourcen-ID der Umgebung des Sitzungspools. |
Schnur |
| managedIdentitySettings |
Optionale Einstellungen für eine verwaltete Identität, die dem Sitzungspool zugewiesen ist. |
ManagedIdentitySetting[] |
| mcpServerEinstellungen |
Die MCP-Servereinstellungen (Model Context Protocol) des Sitzungspools. |
McpServerEinstellungen |
| poolManagementType |
Der Poolverwaltungstyp des Sitzungspools. |
"Dynamisch" "Manuell" |
| scaleConfiguration |
Die Skalierungskonfiguration des Sitzungspools. |
ScaleConfiguration- |
| Geheimnisse |
Die geheimen Schlüssel des Sitzungspools. |
SessionPoolSecret[] |
| sessionNetworkConfiguration |
Die Netzwerkkonfiguration der Sitzungen im Sitzungspool. |
SessionNetworkConfiguration- |
SessionPoolSecret
| Name |
BESCHREIBUNG |
Wert |
| Name |
Geheimer Name. |
Schnur |
| Wert |
Geheimer Wert. |
Zeichenfolge
Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
SessionProbe
| Name |
BESCHREIBUNG |
Wert |
| failureThreshold |
Mindestens aufeinander folgende Fehler für den Prüfpunkt, der nach erfolgreichem Erfolg als fehlgeschlagen betrachtet werden soll. Der Standardwert ist 3. Der Mindestwert ist 1. Der Maximalwert ist 10. |
INT |
| httpHolen |
HTTPGet gibt die auszuführende HTTP-Anforderung an. |
SessionProbeHttpGet |
| initialDelaySeconds |
Die Anzahl der Sekunden, die nach dem Start des Containers vergehen, bevor Livetests initiiert werden. Der Mindestwert ist 1. Der Maximalwert ist 60. |
INT |
| periodSeconds |
Wie oft (in Sekunden) die Probe ausgeführt werden soll. Der Standardwert ist 10 Sekunden. Der Mindestwert ist 1. Der Maximalwert ist 240. |
INT |
| successThreshold |
Mindestens aufeinander folgende Erfolge für die Sonde, die nach einem Fehler als erfolgreich angesehen werden sollen. Der Standardwert lautet 1. Muss 1 für Lebendigkeit und Start sein. Der Mindestwert ist 1. Der Maximalwert ist 10. |
INT |
| tcpSocket |
TCPSocket gibt eine Aktion an, die einen TCP-Port umfasst. TCP-Hooks werden noch nicht unterstützt. |
SessionProbeTcpSocket |
| terminationGracePeriodSeconds |
Optionale Dauer in Sekunden, die der Pod bei Einem Probefehler ordnungsgemäß beenden muss. Die Karenzzeit ist die Dauer in Sekunden, nachdem die im Pod ausgeführten Prozesse ein Beendigungssignal gesendet wurden, und die Zeit, zu der die Prozesse mit einem Kill-Signal unterbrochen werden. Legen Sie diesen Wert länger als die erwartete Bereinigungszeit für Ihren Prozess fest. Wenn dieser Wert "nil" ist, wird die "terminationGracePeriodSeconds" des Pods verwendet. Andernfalls überschreibt dieser Wert den von der Pod-Spezifikation bereitgestellten Wert. Der Wert muss eine nicht negative ganze Zahl sein. Der Wert Null gibt den Stopp sofort über das Kill-Signal an (keine Möglichkeit, herunterzufahren). Dies ist ein Alphafeld und erfordert das Aktivieren des ProbeTerminationGracePeriod-Featuregates. Der Maximalwert beträgt 3600 Sekunden (1 Stunde) |
INT |
| timeoutSeconds |
Die Anzahl der Sekunden, nach denen der Sonde eine Zeitüberschreitung aufweist. Der Standardwert ist 1 Sekunde. Der Mindestwert ist 1. Der Maximalwert ist 240. |
INT |
| Typ |
Gibt den Typ der Sonde an. Kann Liveness oder Startup sein, Readiness Probe wird in Sitzungen nicht unterstützt. Der Typ muss für jeden Test im Kontext einer Liste von Tests (SessionProbes) eindeutig sein. |
"Lebendigkeit" "Start" |
SessionProbeHttpGet
| Name |
BESCHREIBUNG |
Wert |
| host |
Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP. Wahrscheinlich möchten Sie stattdessen "Host" in httpHeaders festlegen. |
Schnur |
| httpHeader |
Benutzerdefinierte Header, die in der Anforderung festgelegt werden sollen. HTTP ermöglicht wiederholte Header. |
SessionProbeHttpGetHttpHeadersItem[] |
| Pfad |
Pfad für den Zugriff auf den HTTP-Server. |
Schnur |
| port |
Name oder Nummer des Ports für den Zugriff auf den Container. Die Zahl muss im Bereich 1 bis 65535 liegen. Der Name muss ein IANA_SVC_NAME sein. |
int (erforderlich) |
| scheme |
Schema, das zum Herstellen einer Verbindung mit dem Host verwendet werden soll. Standardwert ist HTTP. |
'HTTP' 'HTTPS' |
| Name |
BESCHREIBUNG |
Wert |
| Name |
Der Name des Kopfzeilenfelds |
Zeichenfolge (erforderlich) |
| Wert |
Der Wert des Kopfzeilenfelds |
Zeichenfolge (erforderlich) |
SessionProbeTcpSocket
| Name |
BESCHREIBUNG |
Wert |
| host |
Optional: Hostname, mit dem eine Verbindung hergestellt werden soll, ist standardmäßig die Pod-IP. |
Schnur |
| port |
Die Nummer oder der Name des Ports für den Zugriff auf den Container. Die Zahl muss im Bereich 1 bis 65535 liegen. Der Name muss ein IANA_SVC_NAME sein. |
int (erforderlich) |
SessionRegistryAnmeldeinformationen
| Name |
BESCHREIBUNG |
Wert |
| Identität |
Eine verwaltete Identität zur Authentifizierung bei Azure Container Registry. Verwenden Sie für vom Benutzer zugewiesene Identitäten die vollständige vom Benutzer zugewiesene Identitätsressourcen-ID. Verwenden Sie für vom System zugewiesene Identitäten "system" |
Schnur |
| passwordSecretRef |
Der Name des geheimen Schlüssels, der das Registrierungsanmeldungskennwort enthält |
Schnur |
| Server |
Containerregistrierungsserver. |
Schnur |
| Benutzername |
Benutzername der Containerregistrierung. |
Schnur |
UserAssignedIdentities
UserAssignedIdentity