Aracılığıyla paylaş


Microsoft.App oturumuHavuzlar

Bicep kaynak tanımı

sessionPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.App/sessionPools kaynağı oluşturmak için aşağıdaki Bicep'i şablonunuza ekleyin.

resource symbolicname 'Microsoft.App/sessionPools@2025-10-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'
      }
    ]
    mcpServerSettings: {
      isMcpServerApiKeyDisabled: bool
      isMcpServerEnabled: bool
    }
    poolManagementType: 'string'
    scaleConfiguration: {
      maxConcurrentSessions: int
      readySessionInstances: int
    }
    secrets: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    sessionNetworkConfiguration: {
      status: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Özellik Değerleri

Microsoft.App/sessionPools

İsim Açıklama Değer
kimlik Kodda gizli dizileri veya kimlik bilgilerini korumamak için diğer Azure hizmetleriyle etkileşime geçmek için bir oturum havuzunun ihtiyaç duyduğu yönetilen kimlikler. ManagedServiceIdentity
konum Kaynağın bulunduğu coğrafi konum dize (gerekli)
isim Kaynak adı karakter dizisi

Kısıtlama -ları:
En az uzunluk = 3
Maksimum uzunluk = 63
Desen = ^[a-z][a-z0-9]*$ (gerekli)
özellikler Kapsayıcı Uygulaması oturum havuzu kaynağa özgü özellikler SessionPoolProperties
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

CustomContainerTemplate

İsim Açıklama Değer
Konteyner Oturum havuzunun oturumları için kapsayıcı tanımlarının listesi. SessionContainer[]
giriş Oturum havuzu giriş yapılandırması. SessionIngress
registryCredentials Oturum havuzunun oturumları tarafından kullanılan kapsayıcılar için özel kapsayıcı kayıt defteri kimlik bilgileri. SessionRegistryCredentials

Dinamik Havuz Yapılandırması

İsim Açıklama Değer
yaşam döngüsüYapılandırması Dinamik oturum havuzundaki bir oturumun yaşam döngüsü yapılandırması Yaşam Döngüsü Yapılandırması

Çevresel Değişken

İsim Açıklama Değer
isim Ortam değişkeni adı. String
secretRef Ortam değişkeni değerinin çekildiği Container App gizli dizisinin adı. String
değer Gizli dizi olmayan ortam değişkeni değeri. String

Yaşam Döngüsü Yapılandırması

İsim Açıklama Değer
cooldownPeriodInSeconds Yaşam döngüsü türü 'Zamanlanmış' olduğunda oturumun saniye cinsinden bekleme süresi. Int
lifecycleType Oturum havuzunun yaşam döngüsü türü. 'OnContainerExit' (OnContainerExit)
'Zamanlanmış'
maxAlivePeriodInSeconds Yaşam döngüsü türü 'OnContainerExit' olduğunda oturumun saniye cinsinden en uzun yaşam süresi. Int

ManagedIdentitySetting

İsim Açıklama Değer
kimlik Oturum Havuzu'na atanan kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliği veya sistem tarafından atanan kimlik için 'sistem'. dize (gerekli)
yaşam döngüsü Yönetilen Kimliğin kullanılabilir olması gereken Oturum Havuzunun yaşam döngüsü aşamalarını seçmek için kullanın. 'Tümü'
'Başlangıç'
'Ana'
'Hiçbiri'

ManagedServiceIdentity (Yönetilen Servis Kimliği)

İsim Açıklama Değer
tür Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir). 'Hiçbiri'
'Sistem Atandı'
'SystemAssigned,UserAssigned'
'UserAssigned' (gerekli)
kullanıcı tarafından atanan kimlikler Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir. UserAssignedIdentities

McpServerSettings

İsim Açıklama Değer
isMcpServerApiKeyDisabled MCP sunucusu API anahtarının devre dışı bırakılıp bırakılmadığını gösterir. bool
isMcpServerEtkin MCP sunucusunun etkin olup olmadığını gösterir. bool

Ölçek Yapılandırması

İsim Açıklama Değer
maxConcurrentSessions Aynı anda en fazla oturum sayısı. Int
readySessionInstances Hazır oturum örneklerinin minimum sayısı. Int

Oturum Kapsayıcısı

İsim Açıklama Değer
Args (Türkçe) Kapsayıcı başlatma komutu bağımsız değişkenleri. dize[]
komut Kapsayıcı başlatma komutu. dize[]
Env Kapsayıcı ortamı değişkenleri. EnvironmentVar[]
resim Kapsayıcı görüntüsü etiketi. String
isim Özel kapsayıcı adı. String
probes Kapsayıcı için yoklamaların listesi. Oturum Sondası[]
Kaynaklar Kapsayıcı kaynağı gereksinimleri. SessionContainerResources

SessionContainerResources

İsim Açıklama Değer
CPU Çekirdeklerde gerekli CPU, örneğin 0,5 Int
hafıza Gerekli bellek, örneğin "250 Mb" String

SessionIngress

İsim Açıklama Değer
hedef Bağlantı Noktası Girişten gelen trafik için kapsayıcılarda hedef bağlantı noktası Int

SessionNetworkConfiguration (OturumAğ Yapılandırması)

İsim Açıklama Değer
statü Oturumlar için ağ durumu. 'Çıkış Devre Dışı'
'Çıkış Etkin'

SessionPoolProperties

İsim Açıklama Değer
konteyner Türü Oturumların kapsayıcı türü. 'CustomContainer' (Özel Konteyner)
'PythonLTS'
customContainerTemplate ContainerType CustomContainer ise özel kapsayıcı yapılandırması. CustomContainerTemplate
dynamicPoolConfiguration poolManagementType dinamikse havuz yapılandırması. DynamicPoolConfiguration
environmentId Oturum havuzunun ortamının kaynak kimliği. String
managedIdentitySettings Oturum havuzuna atanan Yönetilen Kimlik için isteğe bağlı ayarlar. ManagedIdentitySetting[]
mcpSunucu Ayarları Oturum havuzunun MCP (Model Bağlam Protokolü) sunucu ayarları. McpServerSettings
poolManagementType Oturum havuzunun havuz yönetim türü. 'Dinamik'
'El ile'
ölçek Yapılandırması Oturum havuzunun ölçek yapılandırması. Ölçek Yapılandırması
Sırlar Oturum havuzunun gizli dizileri. SessionPoolSecret[]
sessionNetworkConfiguration Oturum havuzundaki oturumların ağ yapılandırması. SessionNetworkConfiguration (OturumAğ Yapılandırması)

SessionPoolSecret (Oturum HavuzuGizli Bilgisi)

İsim Açıklama Değer
isim Gizli Dizi Adı. String
değer Gizli Dizi Değeri. karakter dizisi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.

Oturum Probedi

İsim Açıklama Değer
failureThreshold Yoklamanın dikkate alınması için en düşük ardışık hatalar başarılı olduktan sonra başarısız oldu. Varsayılan değer 3'tir. En düşük değer 1'dir. En yüksek değer 10'dur. Int
httpGet (İngilizce) HTTPGet gerçekleştirilecek http isteğini belirtir. SessionProbeHttpGet
initialDelaySeconds Canlılık yoklamaları başlatılmadan önce kapsayıcı başlatıldıktan sonraki saniye sayısı. En düşük değer 1'dir. En yüksek değer 60'tır. Int
periodSeconds Yoklamanın ne sıklıkta (saniye olarak) gerçekleştirilecek? Varsayılan olarak 10 saniyedir. En düşük değer 1'dir. En yüksek değer 240'tır. Int
successThreshold Başarısız olduktan sonra yoklamanın başarılı olarak kabul edilmesi için en düşük ardışık başarı. Varsayılan değer 1'tir. Canlılık ve başlangıç için 1 olmalıdır. En düşük değer 1'dir. En yüksek değer 10'dur. Int
tcpSoket TCPSocket, TCP bağlantı noktası içeren bir eylem belirtir. TCP kancaları henüz desteklenmiyor. SessionProbeTcpSocket
terminationGracePeriodSeconds Yoklama hatasından sonra podun düzgün bir şekilde sonlandırılması gereken saniye cinsinden isteğe bağlı süre. Yetkisiz kullanım süresi, podda çalışan işlemlerin sonlandırma sinyali gönderilmesinden sonra saniye cinsinden süre ve işlemlerin sonlandırma sinyaliyle zorla durdurulduğu zamandır. Bu değeri, işleminiz için beklenen temizleme süresinden daha uzun ayarlayın. Bu değer sıfır olursa pod'un terminationGracePeriodSeconds kullanılır. Aksi takdirde, bu değer pod belirtimi tarafından sağlanan değeri geçersiz kılar. Değer negatif olmayan tamsayı olmalıdır. Sıfır değeri sonlandırma sinyali aracılığıyla hemen durmayı gösterir (kapatma fırsatı yoktur). Bu bir alfa alanıdır ve ProbeTerminationGracePeriod özellik geçidinin etkinleştirilmesini gerektirir. Maksimum değer 3600 saniyedir (1 saat) Int
timeoutSeconds Yoklamanın zaman aşımına uğradıktan sonraki saniye sayısı. Varsayılan değer 1 saniyedir. En düşük değer 1'dir. En yüksek değer 240'tır. Int
tür Prob tipini belirtir. Canlılık veya Başlangıç olabilir, Hazırlık araştırması oturumlarda desteklenmez. Tür, bir araştırma listesi (SessionProbes) bağlamında her araştırma için benzersiz olmalıdır. 'Canlılık'
'Başlangıç'

SessionProbeHttpGet

İsim Açıklama Değer
host Bağlanacak ana bilgisayar adı, pod IP'sini varsayılan olarak kullanır. Bunun yerine httpHeaders'da "Host" ayarlamak isteyebilirsiniz. String
httpHeaders (Http Başlıkları) İstekte ayarlanacağı özel üst bilgiler. HTTP yinelenen üst bilgiler sağlar. SessionProbeHttpGetHttpHeadersItem[]
path HTTP sunucusunda erişim yolu. String
port Kapsayıcıda erişecek bağlantı noktasının adı veya numarası. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır. int (gerekli)
scheme Konağa bağlanmak için kullanılacak düzen. Varsayılan olarak HTTP'yi kullanır. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

İsim Açıklama Değer
isim Üst bilgi alanı adı dize (gerekli)
değer Üst bilgi alanı değeri dize (gerekli)

SessionProbeTcpSocket

İsim Açıklama Değer
host İsteğe bağlı: Bağlanacak ana bilgisayar adı, pod IP'sine varsayılan olarak kullanılır. String
port Kapsayıcıda erişecek bağlantı noktasının numarası veya adı. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır. int (gerekli)

SessionRegistryCredentials

İsim Açıklama Değer
kimlik Azure Container Registry ile kimlik doğrulaması yapmak için kullanılacak Yönetilen Kimlik. Kullanıcı tarafından atanan kimlikler için, kullanıcı tarafından atanan tam kimlik Kaynak Kimliğini kullanın. Sistem tarafından atanan kimlikler için 'system' kullanın String
passwordSecretRef Kayıt defteri oturum açma parolasını içeren gizli dizinin adı String
sunucu Kapsayıcı kayıt defteri sunucusu. String
kullanıcı adı Kapsayıcı kayıt defteri kullanıcı adı. String

TrackedResourceTags

İsim Açıklama Değer

UserAssignedIdentities

İsim Açıklama Değer

Kullanıcı Atanmış Kimlik

İsim Açıklama Değer

Kullanım Örnekleri

Azure Doğrulanmış Modülleri

Aşağıdaki Azure Doğrulanmış Modüller bu kaynak türünü dağıtmak için kullanılabilir.

Modül Açıklama
Uygulama Oturumu Havuzu Uygulama Oturum Havuzu için AVM Kaynak Modülü

ARM şablonu kaynak tanımı

sessionPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.App/sessionPools kaynağı oluşturmak için şablonunuza aşağıdaki JSON dosyasını ekleyin.

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

Özellik Değerleri

Microsoft.App/sessionPools

İsim Açıklama Değer
apiVersiyonu API sürümü '2025-10-02-önizleme'
kimlik Kodda gizli dizileri veya kimlik bilgilerini korumamak için diğer Azure hizmetleriyle etkileşime geçmek için bir oturum havuzunun ihtiyaç duyduğu yönetilen kimlikler. ManagedServiceIdentity
konum Kaynağın bulunduğu coğrafi konum dize (gerekli)
isim Kaynak adı karakter dizisi

Kısıtlama -ları:
En az uzunluk = 3
Maksimum uzunluk = 63
Desen = ^[a-z][a-z0-9]*$ (gerekli)
özellikler Kapsayıcı Uygulaması oturum havuzu kaynağa özgü özellikler SessionPoolProperties
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
tür Kaynak türü 'Microsoft.App/sessionPools'

CustomContainerTemplate

İsim Açıklama Değer
Konteyner Oturum havuzunun oturumları için kapsayıcı tanımlarının listesi. SessionContainer[]
giriş Oturum havuzu giriş yapılandırması. SessionIngress
registryCredentials Oturum havuzunun oturumları tarafından kullanılan kapsayıcılar için özel kapsayıcı kayıt defteri kimlik bilgileri. SessionRegistryCredentials

Dinamik Havuz Yapılandırması

İsim Açıklama Değer
yaşam döngüsüYapılandırması Dinamik oturum havuzundaki bir oturumun yaşam döngüsü yapılandırması Yaşam Döngüsü Yapılandırması

Çevresel Değişken

İsim Açıklama Değer
isim Ortam değişkeni adı. String
secretRef Ortam değişkeni değerinin çekildiği Container App gizli dizisinin adı. String
değer Gizli dizi olmayan ortam değişkeni değeri. String

Yaşam Döngüsü Yapılandırması

İsim Açıklama Değer
cooldownPeriodInSeconds Yaşam döngüsü türü 'Zamanlanmış' olduğunda oturumun saniye cinsinden bekleme süresi. Int
lifecycleType Oturum havuzunun yaşam döngüsü türü. 'OnContainerExit' (OnContainerExit)
'Zamanlanmış'
maxAlivePeriodInSeconds Yaşam döngüsü türü 'OnContainerExit' olduğunda oturumun saniye cinsinden en uzun yaşam süresi. Int

ManagedIdentitySetting

İsim Açıklama Değer
kimlik Oturum Havuzu'na atanan kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliği veya sistem tarafından atanan kimlik için 'sistem'. dize (gerekli)
yaşam döngüsü Yönetilen Kimliğin kullanılabilir olması gereken Oturum Havuzunun yaşam döngüsü aşamalarını seçmek için kullanın. 'Tümü'
'Başlangıç'
'Ana'
'Hiçbiri'

ManagedServiceIdentity (Yönetilen Servis Kimliği)

İsim Açıklama Değer
tür Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir). 'Hiçbiri'
'Sistem Atandı'
'SystemAssigned,UserAssigned'
'UserAssigned' (gerekli)
kullanıcı tarafından atanan kimlikler Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir. UserAssignedIdentities

McpServerSettings

İsim Açıklama Değer
isMcpServerApiKeyDisabled MCP sunucusu API anahtarının devre dışı bırakılıp bırakılmadığını gösterir. bool
isMcpServerEtkin MCP sunucusunun etkin olup olmadığını gösterir. bool

Ölçek Yapılandırması

İsim Açıklama Değer
maxConcurrentSessions Aynı anda en fazla oturum sayısı. Int
readySessionInstances Hazır oturum örneklerinin minimum sayısı. Int

Oturum Kapsayıcısı

İsim Açıklama Değer
Args (Türkçe) Kapsayıcı başlatma komutu bağımsız değişkenleri. dize[]
komut Kapsayıcı başlatma komutu. dize[]
Env Kapsayıcı ortamı değişkenleri. EnvironmentVar[]
resim Kapsayıcı görüntüsü etiketi. String
isim Özel kapsayıcı adı. String
probes Kapsayıcı için yoklamaların listesi. Oturum Sondası[]
Kaynaklar Kapsayıcı kaynağı gereksinimleri. SessionContainerResources

SessionContainerResources

İsim Açıklama Değer
CPU Çekirdeklerde gerekli CPU, örneğin 0,5 Int
hafıza Gerekli bellek, örneğin "250 Mb" String

SessionIngress

İsim Açıklama Değer
hedef Bağlantı Noktası Girişten gelen trafik için kapsayıcılarda hedef bağlantı noktası Int

SessionNetworkConfiguration (OturumAğ Yapılandırması)

İsim Açıklama Değer
statü Oturumlar için ağ durumu. 'Çıkış Devre Dışı'
'Çıkış Etkin'

SessionPoolProperties

İsim Açıklama Değer
konteyner Türü Oturumların kapsayıcı türü. 'CustomContainer' (Özel Konteyner)
'PythonLTS'
customContainerTemplate ContainerType CustomContainer ise özel kapsayıcı yapılandırması. CustomContainerTemplate
dynamicPoolConfiguration poolManagementType dinamikse havuz yapılandırması. DynamicPoolConfiguration
environmentId Oturum havuzunun ortamının kaynak kimliği. String
managedIdentitySettings Oturum havuzuna atanan Yönetilen Kimlik için isteğe bağlı ayarlar. ManagedIdentitySetting[]
mcpSunucu Ayarları Oturum havuzunun MCP (Model Bağlam Protokolü) sunucu ayarları. McpServerSettings
poolManagementType Oturum havuzunun havuz yönetim türü. 'Dinamik'
'El ile'
ölçek Yapılandırması Oturum havuzunun ölçek yapılandırması. Ölçek Yapılandırması
Sırlar Oturum havuzunun gizli dizileri. SessionPoolSecret[]
sessionNetworkConfiguration Oturum havuzundaki oturumların ağ yapılandırması. SessionNetworkConfiguration (OturumAğ Yapılandırması)

SessionPoolSecret (Oturum HavuzuGizli Bilgisi)

İsim Açıklama Değer
isim Gizli Dizi Adı. String
değer Gizli Dizi Değeri. karakter dizisi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.

Oturum Probedi

İsim Açıklama Değer
failureThreshold Yoklamanın dikkate alınması için en düşük ardışık hatalar başarılı olduktan sonra başarısız oldu. Varsayılan değer 3'tir. En düşük değer 1'dir. En yüksek değer 10'dur. Int
httpGet (İngilizce) HTTPGet gerçekleştirilecek http isteğini belirtir. SessionProbeHttpGet
initialDelaySeconds Canlılık yoklamaları başlatılmadan önce kapsayıcı başlatıldıktan sonraki saniye sayısı. En düşük değer 1'dir. En yüksek değer 60'tır. Int
periodSeconds Yoklamanın ne sıklıkta (saniye olarak) gerçekleştirilecek? Varsayılan olarak 10 saniyedir. En düşük değer 1'dir. En yüksek değer 240'tır. Int
successThreshold Başarısız olduktan sonra yoklamanın başarılı olarak kabul edilmesi için en düşük ardışık başarı. Varsayılan değer 1'tir. Canlılık ve başlangıç için 1 olmalıdır. En düşük değer 1'dir. En yüksek değer 10'dur. Int
tcpSoket TCPSocket, TCP bağlantı noktası içeren bir eylem belirtir. TCP kancaları henüz desteklenmiyor. SessionProbeTcpSocket
terminationGracePeriodSeconds Yoklama hatasından sonra podun düzgün bir şekilde sonlandırılması gereken saniye cinsinden isteğe bağlı süre. Yetkisiz kullanım süresi, podda çalışan işlemlerin sonlandırma sinyali gönderilmesinden sonra saniye cinsinden süre ve işlemlerin sonlandırma sinyaliyle zorla durdurulduğu zamandır. Bu değeri, işleminiz için beklenen temizleme süresinden daha uzun ayarlayın. Bu değer sıfır olursa pod'un terminationGracePeriodSeconds kullanılır. Aksi takdirde, bu değer pod belirtimi tarafından sağlanan değeri geçersiz kılar. Değer negatif olmayan tamsayı olmalıdır. Sıfır değeri sonlandırma sinyali aracılığıyla hemen durmayı gösterir (kapatma fırsatı yoktur). Bu bir alfa alanıdır ve ProbeTerminationGracePeriod özellik geçidinin etkinleştirilmesini gerektirir. Maksimum değer 3600 saniyedir (1 saat) Int
timeoutSeconds Yoklamanın zaman aşımına uğradıktan sonraki saniye sayısı. Varsayılan değer 1 saniyedir. En düşük değer 1'dir. En yüksek değer 240'tır. Int
tür Prob tipini belirtir. Canlılık veya Başlangıç olabilir, Hazırlık araştırması oturumlarda desteklenmez. Tür, bir araştırma listesi (SessionProbes) bağlamında her araştırma için benzersiz olmalıdır. 'Canlılık'
'Başlangıç'

SessionProbeHttpGet

İsim Açıklama Değer
host Bağlanacak ana bilgisayar adı, pod IP'sini varsayılan olarak kullanır. Bunun yerine httpHeaders'da "Host" ayarlamak isteyebilirsiniz. String
httpHeaders (Http Başlıkları) İstekte ayarlanacağı özel üst bilgiler. HTTP yinelenen üst bilgiler sağlar. SessionProbeHttpGetHttpHeadersItem[]
path HTTP sunucusunda erişim yolu. String
port Kapsayıcıda erişecek bağlantı noktasının adı veya numarası. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır. int (gerekli)
scheme Konağa bağlanmak için kullanılacak düzen. Varsayılan olarak HTTP'yi kullanır. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

İsim Açıklama Değer
isim Üst bilgi alanı adı dize (gerekli)
değer Üst bilgi alanı değeri dize (gerekli)

SessionProbeTcpSocket

İsim Açıklama Değer
host İsteğe bağlı: Bağlanacak ana bilgisayar adı, pod IP'sine varsayılan olarak kullanılır. String
port Kapsayıcıda erişecek bağlantı noktasının numarası veya adı. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır. int (gerekli)

SessionRegistryCredentials

İsim Açıklama Değer
kimlik Azure Container Registry ile kimlik doğrulaması yapmak için kullanılacak Yönetilen Kimlik. Kullanıcı tarafından atanan kimlikler için, kullanıcı tarafından atanan tam kimlik Kaynak Kimliğini kullanın. Sistem tarafından atanan kimlikler için 'system' kullanın String
passwordSecretRef Kayıt defteri oturum açma parolasını içeren gizli dizinin adı String
sunucu Kapsayıcı kayıt defteri sunucusu. String
kullanıcı adı Kapsayıcı kayıt defteri kullanıcı adı. String

TrackedResourceTags

İsim Açıklama Değer

UserAssignedIdentities

İsim Açıklama Değer

Kullanıcı Atanmış Kimlik

İsim Açıklama Değer

Kullanım Örnekleri

Terraform (AzAPI sağlayıcısı) kaynak tanımı

sessionPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.App/sessionPools kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

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

Özellik Değerleri

Microsoft.App/sessionPools

İsim Açıklama Değer
kimlik Kodda gizli dizileri veya kimlik bilgilerini korumamak için diğer Azure hizmetleriyle etkileşime geçmek için bir oturum havuzunun ihtiyaç duyduğu yönetilen kimlikler. ManagedServiceIdentity
konum Kaynağın bulunduğu coğrafi konum dize (gerekli)
isim Kaynak adı karakter dizisi

Kısıtlama -ları:
En az uzunluk = 3
Maksimum uzunluk = 63
Desen = ^[a-z][a-z0-9]*$ (gerekli)
özellikler Kapsayıcı Uygulaması oturum havuzu kaynağa özgü özellikler SessionPoolProperties
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
tür Kaynak türü "Microsoft.App/sessionPools@2025-10-02-preview"

CustomContainerTemplate

İsim Açıklama Değer
Konteyner Oturum havuzunun oturumları için kapsayıcı tanımlarının listesi. SessionContainer[]
giriş Oturum havuzu giriş yapılandırması. SessionIngress
registryCredentials Oturum havuzunun oturumları tarafından kullanılan kapsayıcılar için özel kapsayıcı kayıt defteri kimlik bilgileri. SessionRegistryCredentials

Dinamik Havuz Yapılandırması

İsim Açıklama Değer
yaşam döngüsüYapılandırması Dinamik oturum havuzundaki bir oturumun yaşam döngüsü yapılandırması Yaşam Döngüsü Yapılandırması

Çevresel Değişken

İsim Açıklama Değer
isim Ortam değişkeni adı. String
secretRef Ortam değişkeni değerinin çekildiği Container App gizli dizisinin adı. String
değer Gizli dizi olmayan ortam değişkeni değeri. String

Yaşam Döngüsü Yapılandırması

İsim Açıklama Değer
cooldownPeriodInSeconds Yaşam döngüsü türü 'Zamanlanmış' olduğunda oturumun saniye cinsinden bekleme süresi. Int
lifecycleType Oturum havuzunun yaşam döngüsü türü. 'OnContainerExit' (OnContainerExit)
'Zamanlanmış'
maxAlivePeriodInSeconds Yaşam döngüsü türü 'OnContainerExit' olduğunda oturumun saniye cinsinden en uzun yaşam süresi. Int

ManagedIdentitySetting

İsim Açıklama Değer
kimlik Oturum Havuzu'na atanan kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliği veya sistem tarafından atanan kimlik için 'sistem'. dize (gerekli)
yaşam döngüsü Yönetilen Kimliğin kullanılabilir olması gereken Oturum Havuzunun yaşam döngüsü aşamalarını seçmek için kullanın. 'Tümü'
'Başlangıç'
'Ana'
'Hiçbiri'

ManagedServiceIdentity (Yönetilen Servis Kimliği)

İsim Açıklama Değer
tür Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir). 'Hiçbiri'
'Sistem Atandı'
'SystemAssigned,UserAssigned'
'UserAssigned' (gerekli)
kullanıcı tarafından atanan kimlikler Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir. UserAssignedIdentities

McpServerSettings

İsim Açıklama Değer
isMcpServerApiKeyDisabled MCP sunucusu API anahtarının devre dışı bırakılıp bırakılmadığını gösterir. bool
isMcpServerEtkin MCP sunucusunun etkin olup olmadığını gösterir. bool

Ölçek Yapılandırması

İsim Açıklama Değer
maxConcurrentSessions Aynı anda en fazla oturum sayısı. Int
readySessionInstances Hazır oturum örneklerinin minimum sayısı. Int

Oturum Kapsayıcısı

İsim Açıklama Değer
Args (Türkçe) Kapsayıcı başlatma komutu bağımsız değişkenleri. dize[]
komut Kapsayıcı başlatma komutu. dize[]
Env Kapsayıcı ortamı değişkenleri. EnvironmentVar[]
resim Kapsayıcı görüntüsü etiketi. String
isim Özel kapsayıcı adı. String
probes Kapsayıcı için yoklamaların listesi. Oturum Sondası[]
Kaynaklar Kapsayıcı kaynağı gereksinimleri. SessionContainerResources

SessionContainerResources

İsim Açıklama Değer
CPU Çekirdeklerde gerekli CPU, örneğin 0,5 Int
hafıza Gerekli bellek, örneğin "250 Mb" String

SessionIngress

İsim Açıklama Değer
hedef Bağlantı Noktası Girişten gelen trafik için kapsayıcılarda hedef bağlantı noktası Int

SessionNetworkConfiguration (OturumAğ Yapılandırması)

İsim Açıklama Değer
statü Oturumlar için ağ durumu. 'Çıkış Devre Dışı'
'Çıkış Etkin'

SessionPoolProperties

İsim Açıklama Değer
konteyner Türü Oturumların kapsayıcı türü. 'CustomContainer' (Özel Konteyner)
'PythonLTS'
customContainerTemplate ContainerType CustomContainer ise özel kapsayıcı yapılandırması. CustomContainerTemplate
dynamicPoolConfiguration poolManagementType dinamikse havuz yapılandırması. DynamicPoolConfiguration
environmentId Oturum havuzunun ortamının kaynak kimliği. String
managedIdentitySettings Oturum havuzuna atanan Yönetilen Kimlik için isteğe bağlı ayarlar. ManagedIdentitySetting[]
mcpSunucu Ayarları Oturum havuzunun MCP (Model Bağlam Protokolü) sunucu ayarları. McpServerSettings
poolManagementType Oturum havuzunun havuz yönetim türü. 'Dinamik'
'El ile'
ölçek Yapılandırması Oturum havuzunun ölçek yapılandırması. Ölçek Yapılandırması
Sırlar Oturum havuzunun gizli dizileri. SessionPoolSecret[]
sessionNetworkConfiguration Oturum havuzundaki oturumların ağ yapılandırması. SessionNetworkConfiguration (OturumAğ Yapılandırması)

SessionPoolSecret (Oturum HavuzuGizli Bilgisi)

İsim Açıklama Değer
isim Gizli Dizi Adı. String
değer Gizli Dizi Değeri. karakter dizisi

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.

Oturum Probedi

İsim Açıklama Değer
failureThreshold Yoklamanın dikkate alınması için en düşük ardışık hatalar başarılı olduktan sonra başarısız oldu. Varsayılan değer 3'tir. En düşük değer 1'dir. En yüksek değer 10'dur. Int
httpGet (İngilizce) HTTPGet gerçekleştirilecek http isteğini belirtir. SessionProbeHttpGet
initialDelaySeconds Canlılık yoklamaları başlatılmadan önce kapsayıcı başlatıldıktan sonraki saniye sayısı. En düşük değer 1'dir. En yüksek değer 60'tır. Int
periodSeconds Yoklamanın ne sıklıkta (saniye olarak) gerçekleştirilecek? Varsayılan olarak 10 saniyedir. En düşük değer 1'dir. En yüksek değer 240'tır. Int
successThreshold Başarısız olduktan sonra yoklamanın başarılı olarak kabul edilmesi için en düşük ardışık başarı. Varsayılan değer 1'tir. Canlılık ve başlangıç için 1 olmalıdır. En düşük değer 1'dir. En yüksek değer 10'dur. Int
tcpSoket TCPSocket, TCP bağlantı noktası içeren bir eylem belirtir. TCP kancaları henüz desteklenmiyor. SessionProbeTcpSocket
terminationGracePeriodSeconds Yoklama hatasından sonra podun düzgün bir şekilde sonlandırılması gereken saniye cinsinden isteğe bağlı süre. Yetkisiz kullanım süresi, podda çalışan işlemlerin sonlandırma sinyali gönderilmesinden sonra saniye cinsinden süre ve işlemlerin sonlandırma sinyaliyle zorla durdurulduğu zamandır. Bu değeri, işleminiz için beklenen temizleme süresinden daha uzun ayarlayın. Bu değer sıfır olursa pod'un terminationGracePeriodSeconds kullanılır. Aksi takdirde, bu değer pod belirtimi tarafından sağlanan değeri geçersiz kılar. Değer negatif olmayan tamsayı olmalıdır. Sıfır değeri sonlandırma sinyali aracılığıyla hemen durmayı gösterir (kapatma fırsatı yoktur). Bu bir alfa alanıdır ve ProbeTerminationGracePeriod özellik geçidinin etkinleştirilmesini gerektirir. Maksimum değer 3600 saniyedir (1 saat) Int
timeoutSeconds Yoklamanın zaman aşımına uğradıktan sonraki saniye sayısı. Varsayılan değer 1 saniyedir. En düşük değer 1'dir. En yüksek değer 240'tır. Int
tür Prob tipini belirtir. Canlılık veya Başlangıç olabilir, Hazırlık araştırması oturumlarda desteklenmez. Tür, bir araştırma listesi (SessionProbes) bağlamında her araştırma için benzersiz olmalıdır. 'Canlılık'
'Başlangıç'

SessionProbeHttpGet

İsim Açıklama Değer
host Bağlanacak ana bilgisayar adı, pod IP'sini varsayılan olarak kullanır. Bunun yerine httpHeaders'da "Host" ayarlamak isteyebilirsiniz. String
httpHeaders (Http Başlıkları) İstekte ayarlanacağı özel üst bilgiler. HTTP yinelenen üst bilgiler sağlar. SessionProbeHttpGetHttpHeadersItem[]
path HTTP sunucusunda erişim yolu. String
port Kapsayıcıda erişecek bağlantı noktasının adı veya numarası. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır. int (gerekli)
scheme Konağa bağlanmak için kullanılacak düzen. Varsayılan olarak HTTP'yi kullanır. 'HTTP'
'HTTPS'

SessionProbeHttpGetHttpHeadersItem

İsim Açıklama Değer
isim Üst bilgi alanı adı dize (gerekli)
değer Üst bilgi alanı değeri dize (gerekli)

SessionProbeTcpSocket

İsim Açıklama Değer
host İsteğe bağlı: Bağlanacak ana bilgisayar adı, pod IP'sine varsayılan olarak kullanılır. String
port Kapsayıcıda erişecek bağlantı noktasının numarası veya adı. Sayı 1 ile 65535 arasında olmalıdır. Ad bir IANA_SVC_NAME olmalıdır. int (gerekli)

SessionRegistryCredentials

İsim Açıklama Değer
kimlik Azure Container Registry ile kimlik doğrulaması yapmak için kullanılacak Yönetilen Kimlik. Kullanıcı tarafından atanan kimlikler için, kullanıcı tarafından atanan tam kimlik Kaynak Kimliğini kullanın. Sistem tarafından atanan kimlikler için 'system' kullanın String
passwordSecretRef Kayıt defteri oturum açma parolasını içeren gizli dizinin adı String
sunucu Kapsayıcı kayıt defteri sunucusu. String
kullanıcı adı Kapsayıcı kayıt defteri kullanıcı adı. String

TrackedResourceTags

İsim Açıklama Değer

UserAssignedIdentities

İsim Açıklama Değer

Kullanıcı Atanmış Kimlik

İsim Açıklama Değer