Microsoft.App puli sesji

2025-05-14

Definicja zasobu Bicep

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

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

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-02-02-preview' = {
  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'
      }
    ]
    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
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[]
wejście	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.	sznurek
secretRef (tajny odnośnik)	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej.	sznurek
wartość	Wartość zmiennej środowiskowej bez wpisu tajnego.	sznurek

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ść
rodzaj	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

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.	sznurek
nazwa	Niestandardowa nazwa kontenera.	sznurek
Sondy	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"	sznurek

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.	sznurek
managedIdentitySettings	Opcjonalne ustawienia tożsamości zarządzanej przypisanej do puli sesji.	ManagedIdentitySetting[]
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.	sznurek
wartość	Wartość wpisu tajnego.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.

Sonda SessionProbe (Sonda Sesji)

Nazwa	Opis	Wartość
failureThreshold (próg awarii)	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 (Sekundy początkoweOpóźnienie)	Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60.	int (integer)
okresSekundy	Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240.	int (integer)
successThreshold (próg sukcesu)	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 (Sekundy zakończenia)	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)
timeoutSekundy	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)
rodzaj	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.	sznurek
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.	sznurek
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)
schemat	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.	sznurek
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"	sznurek
passwordSecretRef (hasłoTajny odnośnik)	Nazwa wpisu tajnego zawierającego hasło logowania do rejestru	sznurek
serwer	Serwer rejestru kontenerów.	sznurek
nazwa użytkownika	Nazwa użytkownika rejestru kontenerów.	sznurek

Ś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:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

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-02-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"
      }
    ],
    "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-02-02-podgląd"
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
rodzaj	Typ zasobu	"Microsoft.App/sessionPools"

CustomContainerTemplate (Szablon kontenera)

Nazwa	Opis	Wartość
Pojemniki	Lista definicji kontenerów dla sesji puli sesji.	Kontener sesji[]
wejście	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.	sznurek
secretRef (tajny odnośnik)	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej.	sznurek
wartość	Wartość zmiennej środowiskowej bez wpisu tajnego.	sznurek

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ść
rodzaj	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

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.	sznurek
nazwa	Niestandardowa nazwa kontenera.	sznurek
Sondy	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"	sznurek

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.	sznurek
managedIdentitySettings	Opcjonalne ustawienia tożsamości zarządzanej przypisanej do puli sesji.	ManagedIdentitySetting[]
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.	sznurek
wartość	Wartość wpisu tajnego.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.

Sonda SessionProbe (Sonda Sesji)

Nazwa	Opis	Wartość
failureThreshold (próg awarii)	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 (Sekundy początkoweOpóźnienie)	Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60.	int (integer)
okresSekundy	Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240.	int (integer)
successThreshold (próg sukcesu)	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 (Sekundy zakończenia)	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)
timeoutSekundy	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)
rodzaj	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.	sznurek
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.	sznurek
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)
schemat	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.	sznurek
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"	sznurek
passwordSecretRef (hasłoTajny odnośnik)	Nazwa wpisu tajnego zawierającego hasło logowania do rejestru	sznurek
serwer	Serwer rejestru kontenerów.	sznurek
nazwa użytkownika	Nazwa użytkownika rejestru kontenerów.	sznurek

Ś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:

Grupy zasobów

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-02-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"
        }
      ]
      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)
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.
rodzaj	Typ zasobu	"Microsoft.App/sessionPools@2025-02-02-preview"

CustomContainerTemplate (Szablon kontenera)

Nazwa	Opis	Wartość
Pojemniki	Lista definicji kontenerów dla sesji puli sesji.	Kontener sesji[]
wejście	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.	sznurek
secretRef (tajny odnośnik)	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej.	sznurek
wartość	Wartość zmiennej środowiskowej bez wpisu tajnego.	sznurek

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ść
rodzaj	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

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.	sznurek
nazwa	Niestandardowa nazwa kontenera.	sznurek
Sondy	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"	sznurek

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.	sznurek
managedIdentitySettings	Opcjonalne ustawienia tożsamości zarządzanej przypisanej do puli sesji.	ManagedIdentitySetting[]
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.	sznurek
wartość	Wartość wpisu tajnego.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.

Sonda SessionProbe (Sonda Sesji)

Nazwa	Opis	Wartość
failureThreshold (próg awarii)	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 (Sekundy początkoweOpóźnienie)	Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60.	int (integer)
okresSekundy	Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240.	int (integer)
successThreshold (próg sukcesu)	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 (Sekundy zakończenia)	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)
timeoutSekundy	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)
rodzaj	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.	sznurek
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.	sznurek
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)
schemat	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.	sznurek
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"	sznurek
passwordSecretRef (hasłoTajny odnośnik)	Nazwa wpisu tajnego zawierającego hasło logowania do rejestru	sznurek
serwer	Serwer rejestru kontenerów.	sznurek
nazwa użytkownika	Nazwa użytkownika rejestru kontenerów.	sznurek

Śledzone tagi zasobów

Nazwa	Opis	Wartość

UserAssignedIdentities

Nazwa	Opis	Wartość

Tożsamość przypisana przez użytkownika

Nazwa	Opis	Wartość

Udostępnij za pośrednictwem

Microsoft.App puli sesji

Definicja zasobu Bicep

Format zasobu

Wartości właściwości

Microsoft.App/sessionPools

CustomContainerTemplate (Szablon kontenera)

Konfiguracja puli dynamicznej

Zmienna środowiskowa

Konfiguracja cyklu życia

ManagedIdentitySetting

ManagedServiceIdentity (tożsamość usługi)

ScaleConfiguration (konfiguracja skalowania)

Kontener sesji

SessionContainerResources

SessionIngress (Ruch przychodzący sesji)

SessionNetworkConfiguration (Konfiguracja sieci)

Właściwości puli sesji

Bufor sesjiSecret

Sonda SessionProbe (Sonda Sesji)

SessionProbeHttpGet

SessionProbeHttpGetHttpHeadersItem

SessionProbeTcpSocket

SessionRegistryCredentials

Śledzone tagi zasobów

UserAssignedIdentities

Tożsamość przypisana przez użytkownika

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

Microsoft.App/sessionPools

CustomContainerTemplate (Szablon kontenera)

Konfiguracja puli dynamicznej

Zmienna środowiskowa

Konfiguracja cyklu życia

ManagedIdentitySetting

ManagedServiceIdentity (tożsamość usługi)

ScaleConfiguration (konfiguracja skalowania)

Kontener sesji

SessionContainerResources

SessionIngress (Ruch przychodzący sesji)

SessionNetworkConfiguration (Konfiguracja sieci)

Właściwości puli sesji

Bufor sesjiSecret

Sonda SessionProbe (Sonda Sesji)

SessionProbeHttpGet

SessionProbeHttpGetHttpHeadersItem

SessionProbeTcpSocket

SessionRegistryCredentials

Śledzone tagi zasobów

UserAssignedIdentities

Tożsamość przypisana przez użytkownika

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

Microsoft.App/sessionPools

CustomContainerTemplate (Szablon kontenera)

Konfiguracja puli dynamicznej

Zmienna środowiskowa

Konfiguracja cyklu życia

ManagedIdentitySetting

ManagedServiceIdentity (tożsamość usługi)

ScaleConfiguration (konfiguracja skalowania)

Kontener sesji

SessionContainerResources

SessionIngress (Ruch przychodzący sesji)

SessionNetworkConfiguration (Konfiguracja sieci)

Właściwości puli sesji

Bufor sesjiSecret

Sonda SessionProbe (Sonda Sesji)

SessionProbeHttpGet

SessionProbeHttpGetHttpHeadersItem

SessionProbeTcpSocket

SessionRegistryCredentials

Śledzone tagi zasobów

UserAssignedIdentities

Tożsamość przypisana przez użytkownika