Udostępnij przez

Microsoft.App puli sesji

Definicja zasobu Bicep

Typ zasobu sessionPools można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/sessionPools, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.App/sessionPools

Nazwa Opis Wartość
tożsamość Tożsamości zarządzane wymagane przez pulę sesji do interakcji z innymi usługami platformy Azure, aby nie przechowywać żadnych wpisów tajnych ani poświadczeń w kodzie. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-z][a-z0-9]*$ (wymagane)
właściwości Właściwości specyficzne dla zasobu puli sesji aplikacji kontenera Właściwości puli sesji
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Etykiety Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

CustomContainerTemplate (Szablon kontenera)

Nazwa Opis Wartość
Pojemniki Lista definicji kontenerów dla sesji puli sesji. Kontener sesji[]
reguły ruchu przychodzącego Konfiguracja ruchu przychodzącego puli sesji. SessionIngress (Ruch przychodzący sesji)
registryCredentials (rejestryReferencje) Prywatne poświadczenia rejestru kontenerów dla kontenerów używanych przez sesje puli sesji. SessionRegistryCredentials

Konfiguracja puli dynamicznej

Nazwa Opis Wartość
konfiguracja cyklu życia Konfiguracja cyklu życia sesji w puli sesji dynamicznej Konfiguracja cyklu życia

Zmienna środowiskowa

Nazwa Opis Wartość
nazwa Nazwa zmiennej środowiskowej. ciąg
secretRef (tajny odnośnik) Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej. ciąg
wartość Wartość zmiennej środowiskowej bez wpisu tajnego. ciąg

Konfiguracja cyklu życia

Nazwa Opis Wartość
cooldownPeriodInSeconds (Czas ochłonięciaOkresW sekundach) Okres ochładzania sesji w sekundach, gdy typ cyklu życia to "Timed". int (integer)
typ cyklu życia Typ cyklu życia puli sesji. "OnContainerExit"
"Czas"
maxAlivePeriodInSeconds (maksymalna liczba sekund) Maksymalny okres aktywności sesji w sekundach, gdy typ cyklu życia to "OnContainerExit". int (integer)

ManagedIdentitySetting

Nazwa Opis Wartość
tożsamość Identyfikator zasobu przypisanej przez użytkownika tożsamości zarządzanej przypisanej do puli sesji lub "system" dla tożsamości przypisanej przez system. ciąg (wymagany)
cykl życia Służy do wybierania etapów cyklu życia puli sesji, podczas których powinna być dostępna tożsamość zarządzana. "Wszystko"
"Init"
"Main"
"Brak"

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

Ustawienia serwera McpServerSettings

Nazwa Opis Wartość
isMcpServerApiKeyDisabled Wskazuje, czy klucz interfejsu API serwera MCP jest wyłączony. bool
isMcpServerEnabled (Włączony serwer) Wskazuje, czy serwer MCP jest włączony. bool

ScaleConfiguration (konfiguracja skalowania)

Nazwa Opis Wartość
maxConcurrentSessions (Sesje maxConcurrentSessions) Maksymalna liczba sesji w tym samym czasie. int (integer)
readySessionInstances (Instancje readySession) Minimalna liczba gotowych wystąpień sesji. int (integer)

Kontener sesji

Nazwa Opis Wartość
argumenty Argumenty poleceń uruchamiania kontenera. ciąg znakowy[]
polecenie Polecenie uruchamiania kontenera. ciąg znakowy[]
środowisko Zmienne środowiskowe kontenera. Zmienna środowiskowa[]
obraz Tag obrazu kontenera. ciąg
nazwa Niestandardowa nazwa kontenera. ciąg
probes Lista sond dla kontenera. Sonda sesji[]
zasoby Wymagania dotyczące zasobów kontenera. SessionContainerResources

SessionContainerResources

Nazwa Opis Wartość
procesor Wymagany procesor CPU w rdzeniach, np. 0,5 int (integer)
pamięć Wymagana pamięć, np. "250 Mb" ciąg

SessionIngress (Ruch przychodzący sesji)

Nazwa Opis Wartość
port docelowy Port docelowy w kontenerach dla ruchu przychodzącego int (integer)

SessionNetworkConfiguration (Konfiguracja sieci)

Nazwa Opis Wartość
stan Stan sieci dla sesji. "EgressDisabled"
"EgressEnabled"

Właściwości puli sesji

Nazwa Opis Wartość
containerType (typ kontenera) Typ kontenera sesji. "CustomContainer"
"PythonLTS"
customContainerTemplate (szablon niestandardowy) Konfiguracja kontenera niestandardowego, jeśli parametr containerType to CustomContainer. customContainerTemplate
dynamicPoolConfiguration (konfiguracja puli dynamicznej) Konfiguracja puli, jeśli parametr poolManagementType jest dynamiczny. DynamicPoolConfiguration
environmentId (identyfikator środowiska) Identyfikator zasobu środowiska puli sesji. ciąg
managedIdentitySettings Opcjonalne ustawienia tożsamości zarządzanej przypisanej do puli sesji. ManagedIdentitySetting[]
mcpServerSettings (Ustawienia serwera mcp) Ustawienia serwera MCP (Model Context Protocol) puli sesji. Ustawienia serwera McpServerSettings
poolManagementType (typ puli)ManagementType (typ Typ zarządzania pulą sesji. "Dynamiczny"
"Ręczne"
scaleConfiguration (konfiguracja skala) Konfiguracja skalowania puli sesji. ScaleConfiguration (konfiguracja skalowania)
tajemnice Wpisy tajne puli sesji. Pula sesjiSecret[]
sessionNetworkConfiguration (konfiguracja sieci) Konfiguracja sieci sesji w puli sesji. SessionNetworkConfiguration (Konfiguracja sieci)

Bufor sesjiSecret

Nazwa Opis Wartość
nazwa Nazwa wpisu tajnego. ciąg
wartość Wartość wpisu tajnego. struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.

Sonda SessionProbe (Sonda Sesji)

Nazwa Opis Wartość
failureThreshold Minimalna liczba kolejnych niepowodzeń sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Wartość maksymalna to 10. int (integer)
Pobieranie httpGet Wartość HTTPGet określa żądanie HTTP do wykonania. SessionProbeHttpGet
initialDelaySeconds Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60. int (integer)
periodSeconds Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240. int (integer)
successThreshold Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po niepodaniu. Wartość domyślna to 1. Musi być 1 dla życia i uruchamiania. Wartość minimalna to 1. Wartość maksymalna to 10. int (integer)
tcpSocket (Gniazdo tcp) TcpSocket określa akcję obejmującą port TCP. Haki TCP nie są jeszcze obsługiwane. SessionProbeTcpSocket
terminationGracePeriodSeconds Opcjonalny czas trwania w sekundach zasobnik musi zostać bezpiecznie zakończony po niepowodzeniu sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabicia. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nieujemna liczba całkowita. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału kill (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Wartość maksymalna to 3600 sekund (1 godzina) int (integer)
timeoutSeconds Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Wartość maksymalna to 240. int (integer)
typ Oznacza typ sondy. Może to być Liveness lub Startup, sonda gotowości nie jest obsługiwana w sesjach. Typ musi być unikatowy dla każdej sondy w kontekście listy sond (SessionProbes). "Liveness"
"Uruchamianie"

SessionProbeHttpGet

Nazwa Opis Wartość
gospodarz Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w zamiast tego httpHeaders. ciąg
Nagłówki HTTP Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki. SessionProbeHttpGetHttpHeadersItem[]
ścieżka Ścieżka dostępu na serwerze HTTP. ciąg
port Nazwa lub numer portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. int (wymagane)
scheme Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nazwa Opis Wartość
nazwa Nazwa pola nagłówka ciąg (wymagany)
wartość Wartość pola nagłówka ciąg (wymagany)

SessionProbeTcpSocket

Nazwa Opis Wartość
gospodarz Opcjonalnie: Nazwa hosta do nawiązania połączenia z, domyślnie jest to adres IP zasobnika. ciąg
port Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. int (wymagane)

SessionRegistryCredentials

Nazwa Opis Wartość
tożsamość Tożsamość zarządzana używana do uwierzytelniania w usłudze Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu przypisanego przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system" ciąg
passwordSecretRef (hasłoTajny odnośnik) Nazwa wpisu tajnego zawierającego hasło logowania do rejestru ciąg
serwer Serwer rejestru kontenerów. ciąg
nazwa użytkownika Nazwa użytkownika rejestru kontenerów. ciąg

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
puli sesji aplikacji Moduł zasobów AVM dla puli sesji aplikacji

Definicja zasobu szablonu usługi ARM

Typ zasobu sessionPools można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/sessionPools, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.App/sessionPools

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2025-10-02-preview"
tożsamość Tożsamości zarządzane wymagane przez pulę sesji do interakcji z innymi usługami platformy Azure, aby nie przechowywać żadnych wpisów tajnych ani poświadczeń w kodzie. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-z][a-z0-9]*$ (wymagane)
właściwości Właściwości specyficzne dla zasobu puli sesji aplikacji kontenera Właściwości puli sesji
Etykiety Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.App/sessionPools"

CustomContainerTemplate (Szablon kontenera)

Nazwa Opis Wartość
Pojemniki Lista definicji kontenerów dla sesji puli sesji. Kontener sesji[]
reguły ruchu przychodzącego Konfiguracja ruchu przychodzącego puli sesji. SessionIngress (Ruch przychodzący sesji)
registryCredentials (rejestryReferencje) Prywatne poświadczenia rejestru kontenerów dla kontenerów używanych przez sesje puli sesji. SessionRegistryCredentials

Konfiguracja puli dynamicznej

Nazwa Opis Wartość
konfiguracja cyklu życia Konfiguracja cyklu życia sesji w puli sesji dynamicznej Konfiguracja cyklu życia

Zmienna środowiskowa

Nazwa Opis Wartość
nazwa Nazwa zmiennej środowiskowej. ciąg
secretRef (tajny odnośnik) Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej. ciąg
wartość Wartość zmiennej środowiskowej bez wpisu tajnego. ciąg

Konfiguracja cyklu życia

Nazwa Opis Wartość
cooldownPeriodInSeconds (Czas ochłonięciaOkresW sekundach) Okres ochładzania sesji w sekundach, gdy typ cyklu życia to "Timed". int (integer)
typ cyklu życia Typ cyklu życia puli sesji. "OnContainerExit"
"Czas"
maxAlivePeriodInSeconds (maksymalna liczba sekund) Maksymalny okres aktywności sesji w sekundach, gdy typ cyklu życia to "OnContainerExit". int (integer)

ManagedIdentitySetting

Nazwa Opis Wartość
tożsamość Identyfikator zasobu przypisanej przez użytkownika tożsamości zarządzanej przypisanej do puli sesji lub "system" dla tożsamości przypisanej przez system. ciąg (wymagany)
cykl życia Służy do wybierania etapów cyklu życia puli sesji, podczas których powinna być dostępna tożsamość zarządzana. "Wszystko"
"Init"
"Main"
"Brak"

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

Ustawienia serwera McpServerSettings

Nazwa Opis Wartość
isMcpServerApiKeyDisabled Wskazuje, czy klucz interfejsu API serwera MCP jest wyłączony. bool
isMcpServerEnabled (Włączony serwer) Wskazuje, czy serwer MCP jest włączony. bool

ScaleConfiguration (konfiguracja skalowania)

Nazwa Opis Wartość
maxConcurrentSessions (Sesje maxConcurrentSessions) Maksymalna liczba sesji w tym samym czasie. int (integer)
readySessionInstances (Instancje readySession) Minimalna liczba gotowych wystąpień sesji. int (integer)

Kontener sesji

Nazwa Opis Wartość
argumenty Argumenty poleceń uruchamiania kontenera. ciąg znakowy[]
polecenie Polecenie uruchamiania kontenera. ciąg znakowy[]
środowisko Zmienne środowiskowe kontenera. Zmienna środowiskowa[]
obraz Tag obrazu kontenera. ciąg
nazwa Niestandardowa nazwa kontenera. ciąg
probes Lista sond dla kontenera. Sonda sesji[]
zasoby Wymagania dotyczące zasobów kontenera. SessionContainerResources

SessionContainerResources

Nazwa Opis Wartość
procesor Wymagany procesor CPU w rdzeniach, np. 0,5 int (integer)
pamięć Wymagana pamięć, np. "250 Mb" ciąg

SessionIngress (Ruch przychodzący sesji)

Nazwa Opis Wartość
port docelowy Port docelowy w kontenerach dla ruchu przychodzącego int (integer)

SessionNetworkConfiguration (Konfiguracja sieci)

Nazwa Opis Wartość
stan Stan sieci dla sesji. "EgressDisabled"
"EgressEnabled"

Właściwości puli sesji

Nazwa Opis Wartość
containerType (typ kontenera) Typ kontenera sesji. "CustomContainer"
"PythonLTS"
customContainerTemplate (szablon niestandardowy) Konfiguracja kontenera niestandardowego, jeśli parametr containerType to CustomContainer. customContainerTemplate
dynamicPoolConfiguration (konfiguracja puli dynamicznej) Konfiguracja puli, jeśli parametr poolManagementType jest dynamiczny. DynamicPoolConfiguration
environmentId (identyfikator środowiska) Identyfikator zasobu środowiska puli sesji. ciąg
managedIdentitySettings Opcjonalne ustawienia tożsamości zarządzanej przypisanej do puli sesji. ManagedIdentitySetting[]
mcpServerSettings (Ustawienia serwera mcp) Ustawienia serwera MCP (Model Context Protocol) puli sesji. Ustawienia serwera McpServerSettings
poolManagementType (typ puli)ManagementType (typ Typ zarządzania pulą sesji. "Dynamiczny"
"Ręczne"
scaleConfiguration (konfiguracja skala) Konfiguracja skalowania puli sesji. ScaleConfiguration (konfiguracja skalowania)
tajemnice Wpisy tajne puli sesji. Pula sesjiSecret[]
sessionNetworkConfiguration (konfiguracja sieci) Konfiguracja sieci sesji w puli sesji. SessionNetworkConfiguration (Konfiguracja sieci)

Bufor sesjiSecret

Nazwa Opis Wartość
nazwa Nazwa wpisu tajnego. ciąg
wartość Wartość wpisu tajnego. struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.

Sonda SessionProbe (Sonda Sesji)

Nazwa Opis Wartość
failureThreshold Minimalna liczba kolejnych niepowodzeń sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Wartość maksymalna to 10. int (integer)
Pobieranie httpGet Wartość HTTPGet określa żądanie HTTP do wykonania. SessionProbeHttpGet
initialDelaySeconds Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60. int (integer)
periodSeconds Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240. int (integer)
successThreshold Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po niepodaniu. Wartość domyślna to 1. Musi być 1 dla życia i uruchamiania. Wartość minimalna to 1. Wartość maksymalna to 10. int (integer)
tcpSocket (Gniazdo tcp) TcpSocket określa akcję obejmującą port TCP. Haki TCP nie są jeszcze obsługiwane. SessionProbeTcpSocket
terminationGracePeriodSeconds Opcjonalny czas trwania w sekundach zasobnik musi zostać bezpiecznie zakończony po niepowodzeniu sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabicia. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nieujemna liczba całkowita. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału kill (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Wartość maksymalna to 3600 sekund (1 godzina) int (integer)
timeoutSeconds Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Wartość maksymalna to 240. int (integer)
typ Oznacza typ sondy. Może to być Liveness lub Startup, sonda gotowości nie jest obsługiwana w sesjach. Typ musi być unikatowy dla każdej sondy w kontekście listy sond (SessionProbes). "Liveness"
"Uruchamianie"

SessionProbeHttpGet

Nazwa Opis Wartość
gospodarz Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w zamiast tego httpHeaders. ciąg
Nagłówki HTTP Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki. SessionProbeHttpGetHttpHeadersItem[]
ścieżka Ścieżka dostępu na serwerze HTTP. ciąg
port Nazwa lub numer portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. int (wymagane)
scheme Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nazwa Opis Wartość
nazwa Nazwa pola nagłówka ciąg (wymagany)
wartość Wartość pola nagłówka ciąg (wymagany)

SessionProbeTcpSocket

Nazwa Opis Wartość
gospodarz Opcjonalnie: Nazwa hosta do nawiązania połączenia z, domyślnie jest to adres IP zasobnika. ciąg
port Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. int (wymagane)

SessionRegistryCredentials

Nazwa Opis Wartość
tożsamość Tożsamość zarządzana używana do uwierzytelniania w usłudze Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu przypisanego przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system" ciąg
passwordSecretRef (hasłoTajny odnośnik) Nazwa wpisu tajnego zawierającego hasło logowania do rejestru ciąg
serwer Serwer rejestru kontenerów. ciąg
nazwa użytkownika Nazwa użytkownika rejestru kontenerów. ciąg

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu sessionPools można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/sessionPools, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.App/sessionPools

Nazwa Opis Wartość
tożsamość Tożsamości zarządzane wymagane przez pulę sesji do interakcji z innymi usługami platformy Azure, aby nie przechowywać żadnych wpisów tajnych ani poświadczeń w kodzie. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-z][a-z0-9]*$ (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
właściwości Właściwości specyficzne dla zasobu puli sesji aplikacji kontenera Właściwości puli sesji
Etykiety Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.App/sessionPools@2025-10-02-preview"

CustomContainerTemplate (Szablon kontenera)

Nazwa Opis Wartość
Pojemniki Lista definicji kontenerów dla sesji puli sesji. Kontener sesji[]
reguły ruchu przychodzącego Konfiguracja ruchu przychodzącego puli sesji. SessionIngress (Ruch przychodzący sesji)
registryCredentials (rejestryReferencje) Prywatne poświadczenia rejestru kontenerów dla kontenerów używanych przez sesje puli sesji. SessionRegistryCredentials

Konfiguracja puli dynamicznej

Nazwa Opis Wartość
konfiguracja cyklu życia Konfiguracja cyklu życia sesji w puli sesji dynamicznej Konfiguracja cyklu życia

Zmienna środowiskowa

Nazwa Opis Wartość
nazwa Nazwa zmiennej środowiskowej. ciąg
secretRef (tajny odnośnik) Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej. ciąg
wartość Wartość zmiennej środowiskowej bez wpisu tajnego. ciąg

Konfiguracja cyklu życia

Nazwa Opis Wartość
cooldownPeriodInSeconds (Czas ochłonięciaOkresW sekundach) Okres ochładzania sesji w sekundach, gdy typ cyklu życia to "Timed". int (integer)
typ cyklu życia Typ cyklu życia puli sesji. "OnContainerExit"
"Czas"
maxAlivePeriodInSeconds (maksymalna liczba sekund) Maksymalny okres aktywności sesji w sekundach, gdy typ cyklu życia to "OnContainerExit". int (integer)

ManagedIdentitySetting

Nazwa Opis Wartość
tożsamość Identyfikator zasobu przypisanej przez użytkownika tożsamości zarządzanej przypisanej do puli sesji lub "system" dla tożsamości przypisanej przez system. ciąg (wymagany)
cykl życia Służy do wybierania etapów cyklu życia puli sesji, podczas których powinna być dostępna tożsamość zarządzana. "Wszystko"
"Init"
"Main"
"Brak"

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

Ustawienia serwera McpServerSettings

Nazwa Opis Wartość
isMcpServerApiKeyDisabled Wskazuje, czy klucz interfejsu API serwera MCP jest wyłączony. bool
isMcpServerEnabled (Włączony serwer) Wskazuje, czy serwer MCP jest włączony. bool

ScaleConfiguration (konfiguracja skalowania)

Nazwa Opis Wartość
maxConcurrentSessions (Sesje maxConcurrentSessions) Maksymalna liczba sesji w tym samym czasie. int (integer)
readySessionInstances (Instancje readySession) Minimalna liczba gotowych wystąpień sesji. int (integer)

Kontener sesji

Nazwa Opis Wartość
argumenty Argumenty poleceń uruchamiania kontenera. ciąg znakowy[]
polecenie Polecenie uruchamiania kontenera. ciąg znakowy[]
środowisko Zmienne środowiskowe kontenera. Zmienna środowiskowa[]
obraz Tag obrazu kontenera. ciąg
nazwa Niestandardowa nazwa kontenera. ciąg
probes Lista sond dla kontenera. Sonda sesji[]
zasoby Wymagania dotyczące zasobów kontenera. SessionContainerResources

SessionContainerResources

Nazwa Opis Wartość
procesor Wymagany procesor CPU w rdzeniach, np. 0,5 int (integer)
pamięć Wymagana pamięć, np. "250 Mb" ciąg

SessionIngress (Ruch przychodzący sesji)

Nazwa Opis Wartość
port docelowy Port docelowy w kontenerach dla ruchu przychodzącego int (integer)

SessionNetworkConfiguration (Konfiguracja sieci)

Nazwa Opis Wartość
stan Stan sieci dla sesji. "EgressDisabled"
"EgressEnabled"

Właściwości puli sesji

Nazwa Opis Wartość
containerType (typ kontenera) Typ kontenera sesji. "CustomContainer"
"PythonLTS"
customContainerTemplate (szablon niestandardowy) Konfiguracja kontenera niestandardowego, jeśli parametr containerType to CustomContainer. customContainerTemplate
dynamicPoolConfiguration (konfiguracja puli dynamicznej) Konfiguracja puli, jeśli parametr poolManagementType jest dynamiczny. DynamicPoolConfiguration
environmentId (identyfikator środowiska) Identyfikator zasobu środowiska puli sesji. ciąg
managedIdentitySettings Opcjonalne ustawienia tożsamości zarządzanej przypisanej do puli sesji. ManagedIdentitySetting[]
mcpServerSettings (Ustawienia serwera mcp) Ustawienia serwera MCP (Model Context Protocol) puli sesji. Ustawienia serwera McpServerSettings
poolManagementType (typ puli)ManagementType (typ Typ zarządzania pulą sesji. "Dynamiczny"
"Ręczne"
scaleConfiguration (konfiguracja skala) Konfiguracja skalowania puli sesji. ScaleConfiguration (konfiguracja skalowania)
tajemnice Wpisy tajne puli sesji. Pula sesjiSecret[]
sessionNetworkConfiguration (konfiguracja sieci) Konfiguracja sieci sesji w puli sesji. SessionNetworkConfiguration (Konfiguracja sieci)

Bufor sesjiSecret

Nazwa Opis Wartość
nazwa Nazwa wpisu tajnego. ciąg
wartość Wartość wpisu tajnego. struna

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.

Sonda SessionProbe (Sonda Sesji)

Nazwa Opis Wartość
failureThreshold Minimalna liczba kolejnych niepowodzeń sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Wartość maksymalna to 10. int (integer)
Pobieranie httpGet Wartość HTTPGet określa żądanie HTTP do wykonania. SessionProbeHttpGet
initialDelaySeconds Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60. int (integer)
periodSeconds Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240. int (integer)
successThreshold Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po niepodaniu. Wartość domyślna to 1. Musi być 1 dla życia i uruchamiania. Wartość minimalna to 1. Wartość maksymalna to 10. int (integer)
tcpSocket (Gniazdo tcp) TcpSocket określa akcję obejmującą port TCP. Haki TCP nie są jeszcze obsługiwane. SessionProbeTcpSocket
terminationGracePeriodSeconds Opcjonalny czas trwania w sekundach zasobnik musi zostać bezpiecznie zakończony po niepowodzeniu sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabicia. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nieujemna liczba całkowita. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału kill (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Wartość maksymalna to 3600 sekund (1 godzina) int (integer)
timeoutSeconds Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Wartość maksymalna to 240. int (integer)
typ Oznacza typ sondy. Może to być Liveness lub Startup, sonda gotowości nie jest obsługiwana w sesjach. Typ musi być unikatowy dla każdej sondy w kontekście listy sond (SessionProbes). "Liveness"
"Uruchamianie"

SessionProbeHttpGet

Nazwa Opis Wartość
gospodarz Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w zamiast tego httpHeaders. ciąg
Nagłówki HTTP Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki. SessionProbeHttpGetHttpHeadersItem[]
ścieżka Ścieżka dostępu na serwerze HTTP. ciąg
port Nazwa lub numer portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. int (wymagane)
scheme Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

Nazwa Opis Wartość
nazwa Nazwa pola nagłówka ciąg (wymagany)
wartość Wartość pola nagłówka ciąg (wymagany)

SessionProbeTcpSocket

Nazwa Opis Wartość
gospodarz Opcjonalnie: Nazwa hosta do nawiązania połączenia z, domyślnie jest to adres IP zasobnika. ciąg
port Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. int (wymagane)

SessionRegistryCredentials

Nazwa Opis Wartość
tożsamość Tożsamość zarządzana używana do uwierzytelniania w usłudze Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu przypisanego przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system" ciąg
passwordSecretRef (hasłoTajny odnośnik) Nazwa wpisu tajnego zawierającego hasło logowania do rejestru ciąg
serwer Serwer rejestru kontenerów. ciąg
nazwa użytkownika Nazwa użytkownika rejestru kontenerów. ciąg

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość
  • Last updated on