Freigeben über

Microsoft.App SessionPools

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.

Ressourcenformat

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'

SessionProbeHttpGetHttpHeadersItem

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

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

UserAssignedIdentities

Name BESCHREIBUNG Wert

UserAssignedIdentity

Name BESCHREIBUNG Wert

Verwendungsbeispiele

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Modul BESCHREIBUNG
App-Sitzungspool AVM-Ressourcenmodul für App-Sitzungspool

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.

Ressourcenformat

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'

SessionProbeHttpGetHttpHeadersItem

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

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

UserAssignedIdentities

Name BESCHREIBUNG Wert

UserAssignedIdentity

Name BESCHREIBUNG Wert

Verwendungsbeispiele

Terraform -Ressourcendefinition (AzAPI-Anbieter)

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.

Ressourcenformat

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'

SessionProbeHttpGetHttpHeadersItem

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

Verfolgte ResourceTags

Name BESCHREIBUNG Wert

UserAssignedIdentities

Name BESCHREIBUNG Wert

UserAssignedIdentity

Name BESCHREIBUNG Wert
  • Last updated on