Aracılığıyla paylaş


Agent Pools - List

Belirtilen yönetilen kümedeki aracı havuzlarının listesini alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools?api-version=2025-04-01

URI Parametreleri

Name İçinde Gerekli Tür Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.

resourceName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

Yönetilen küme kaynağının adı.

subscriptionId
path True

string (uuid)

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name Tür Description
200 OK

AgentPoolListResult

Tamam

Other Status Codes

CloudError

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

List Agent Pools by Managed Cluster

Örnek isteği

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools?api-version=2025-04-01

Örnek yanıt

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
      "name": "agentpool1",
      "properties": {
        "provisioningState": "Succeeded",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "eTag": "ewnfuib"
      }
    }
  ]
}

Tanımlar

Name Description
AgentPool

Aracı Havuzu.

AgentPoolGatewayProfile

Yönetilen küme ağ geçidi aracı havuzunun profili.

AgentPoolListResult

Aracı Havuzlarını Listele işleminden gelen yanıt.

AgentPoolMode

Aracı havuzunun modu.

AgentPoolNetworkProfile

Aracı havuzunun ağ ayarları.

AgentPoolSecurityProfile

Aracı havuzunun güvenlik ayarları.

AgentPoolStatus

Aracı Havuzu hakkında salt okunur bilgiler içerir.

AgentPoolType

Aracı Havuzu türü.

AgentPoolUpgradeSettings

Aracı havuzunu yükseltme ayarları

AgentPoolWindowsProfile

Windows aracı havuzunun belirli profili.

CloudError

Kapsayıcı hizmetinden bir hata yanıtı.

CloudErrorBody

Kapsayıcı hizmetinden bir hata yanıtı.

code

Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir

CreationData

Kaynak kaynaktan hedef kaynak oluştururken kullanılan veriler.

GPUDriver

GPU sürücülerinin yüklenip yüklenmeyeceği. Belirtilmediğinde, varsayılan olarak Yükle'dir.

GPUInstanceProfile

Desteklenen GPU VM SKU'su için GPU MIG örnek profilini belirtmek üzere kullanılacak GPUInstanceProfile.

GPUProfile

Aracı Havuzu için GPU ayarları.

IPTag

Nesneyle ilişkilendirilmiş IPTag'i içerir.

KubeletConfig

Aracı düğümlerinin Kubelet yapılandırmaları.

KubeletDiskType

emptyDir birimlerinin, kapsayıcı çalışma zamanı veri kökünün ve Kubelet kısa ömürlü depolamanın yerleşimini belirler.

LinuxOSConfig

Linux aracı düğümlerinin işletim sistemi yapılandırmaları.

ManualScaleProfile

Makine sayısıyla ilgili belirtimler.

OSDiskType

Aracı havuzundaki makineler için kullanılacak işletim sistemi disk türü.

OSSKU

Aracı havuzu tarafından kullanılan işletim sistemi SKU'su belirtir. OSType Linux ise varsayılan değer Ubuntu'dur. OSType Windows ise, Kubernetes <= 1,24 veya Windows2022 olduğunda varsayılan >değer Windows2019'dur.

OSType

İşletim sistemi türü. Varsayılan değer Linux'tır.

PodIPAllocationMode

Pod IP Ayırma Modu

PortRange

Bağlantı noktası aralığı.

PowerState

Kümenin Güç Durumunu açıklar

Protocol

Bağlantı noktasının ağ protokolü.

ScaleDownMode

VM'lerin Aracı Havuzlarına nasıl eklendiğini veya aracı havuzlarından nasıl kaldırıldığını açıklar. Bkz. faturalama durumları.

ScaleProfile

VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler.

ScaleSetEvictionPolicy

Sanal Makine Ölçek Kümesi çıkarma ilkesi.

ScaleSetPriority

Sanal Makine Ölçek Kümesi önceliği.

SysctlConfig

Linux aracı düğümleri için sysctl ayarları.

UndrainableNodeBehavior

Yükseltme sırasında çizilemez düğümlerin davranışını tanımlar. Çizilemeyen düğümlerin en yaygın nedeni Pod Kesinti bütçeleri (PDB) olsa da pod sonlandırma yetkisiz kullanım süresi kalan düğüm başına boşaltma zaman aşımını aşıyor veya pod hala çalışıyor durumdaysa, ayrıca çizilemez düğümlere neden olabilir.

VirtualMachineNodes

Aynı vm boyutundaki düğüm grubundaki geçerli durum.

VirtualMachinesProfile

VirtualMachines aracı havuzundaki belirtimler.

WorkloadRuntime

Bir düğümün çalıştırabileceği iş yükü türünü belirler.

AgentPool

Aracı Havuzu.

Name Tür Default value Description
id

string

Kaynak Kimliği.

name

string

Kaynak grubu içinde benzersiz olan kaynağın adı. Bu ad kaynağa erişmek için kullanılabilir.

properties.availabilityZones

string[]

Düğümler için kullanılacak Kullanılabilirlik alanlarının listesi. Bu yalnızca AgentPoolType özelliği 'VirtualMachineScaleSets' olduğunda belirtilebilir.

properties.capacityReservationGroupID

string (arm-id)

Ayrılmış bir Sanal Makine grubundan sanal makineler sağlamak için Kapasite Rezervasyon Grubu'nun tam kaynak kimliği.
AKS, belirtilen aracı havuzunu Kapasite Rezervasyon Grubu ile ilişkilendirir.

properties.count

integer (int32)

Docker kapsayıcılarını barındıracak aracıların (VM) sayısı. İzin verilen değerler, kullanıcı havuzları için 0 ile 1000 (dahil) arasında ve sistem havuzları için 1 ile 1000 (dahil) arasında olmalıdır. Varsayılan değer 1'dir.

properties.creationData

CreationData

Düğüm havuzu bir anlık görüntü kullanılarak oluşturulacak/yükseltilecekse kaynak Anlık Görüntü Kimliğini belirtmek için kullanılacak CreationData.

properties.currentOrchestratorVersion

string

Aracı Havuzunun çalıştığı Kubernetes sürümü.
OrchestratorVersion tam olarak belirtilen bir sürüm <major.minor.patch>ise, bu alan buna tam olarak eşit olacaktır. OrchestratorVersion <major.minor>ise, bu alan kullanılmakta olan tam <major.minor.patch> sürümünü içerir.

properties.eTag

string

İyimser eşzamanlılık uygulamak için kullanılan benzersiz salt okunur dize. Kaynak güncelleştirildiğinde eTag değeri değişir. Normal etag kuralı başına iyimser eşzamanlılığı etkinleştirmek için sonraki bir istek için eTag değeriyle bir if-match veya if-none-match üst bilgisi belirtin.

properties.enableAutoScaling

boolean

Otomatik ölçeklendiricinin etkinleştirilip etkinleştirilmeyileceği

properties.enableEncryptionAtHost

boolean

Konak tabanlı işletim sisteminin ve veri sürücüsü şifrelemenin etkinleştirilip etkinleştirilmeyileceği.
Bu yalnızca belirli VM boyutlarında ve belirli Azure bölgelerinde desteklenir. Daha fazla bilgi için bkz. https://docs.microsoft.com/azure/aks/enable-host-encryption

properties.enableFIPS

boolean

FIPS özellikli işletim sisteminin kullanılıp kullanılmaymayacağı.
Daha fazla ayrıntı için bkz. FIPS özellikli düğüm havuzu ekleme .

properties.enableNodePublicIP

boolean

Her düğümün kendi genel IP'sini ayırıp ayırmadığı.
Bazı senaryolar, düğüm havuzundaki düğümlerin kendi ayrılmış genel IP adreslerini almasını gerektirebilir. Yaygın bir senaryo, konsolun atlamaları en aza indirmek için bulut sanal makinesine doğrudan bağlantı sağlaması gereken oyun iş yüklerine yöneliktir. Daha fazla bilgi için bkz. Düğüm başına genel IP atama. Varsayılan değer false'tur.

properties.enableUltraSSD

boolean

UltraSSD'nin etkinleştirilip etkinleştirilmeyileceği

properties.gatewayProfile

AgentPoolGatewayProfile

Ağ geçidi modunda yönetilen aracı havuzuna özgü profil. Aracı havuzu modu Ağ Geçidi değilse bu alan ayarlanamaz.

properties.gpuInstanceProfile

GPUInstanceProfile

Desteklenen GPU VM SKU'su için GPU MIG örnek profilini belirtmek üzere kullanılacak GPUInstanceProfile.

properties.gpuProfile

GPUProfile

Aracı Havuzu için GPU ayarları.

properties.hostGroupID

string (arm-id)

Sanal makinelerin sağlanacağı Ayrılmış Konak Grubunun tam kaynak kimliği, yalnızca oluşturma senaryosunda kullanılır ve bir kez ayarlandıktan sonra değiştirilmesine izin verilmez.
Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Daha fazla bilgi için bkz. Azure ayrılmış konakları.

properties.kubeletConfig

KubeletConfig

Aracı düğümlerinin Kubelet yapılandırmaları.
Aracı havuzu düğümlerinde Kubelet yapılandırması.

properties.kubeletDiskType

KubeletDiskType

emptyDir birimlerinin, kapsayıcı çalışma zamanı veri kökünün ve Kubelet kısa ömürlü depolamanın yerleşimini belirler.

properties.linuxOSConfig

LinuxOSConfig

Linux aracı düğümlerinin işletim sistemi yapılandırmaları.
Linux aracı düğümlerinin işletim sistemi yapılandırması.

properties.maxCount

integer (int32)

Otomatik ölçeklendirme için en fazla düğüm sayısı

properties.maxPods

integer (int32)

Bir düğümde çalışabilecek en fazla pod sayısı.

properties.messageOfTheDay

string

Base64 kodlu Linux düğümleri için günün iletisi.
Kod çözmeden sonra /etc/motd öğesine yazılacak base64 kodlanmış bir dize. Bu, Linux düğümleri için günün iletisinin özelleştirilmesini sağlar. Windows düğümleri için belirtilmemelidir. Statik bir dize olmalıdır (örneğin, ham olarak yazdırılır ve betik olarak yürütülmeyecektir).

properties.minCount

integer (int32)

Otomatik ölçeklendirme için en az düğüm sayısı

properties.mode

AgentPoolMode

Aracı havuzunun modu.
Bir kümenin her zaman en az bir 'Sistem' Aracı Havuzu olmalıdır. Aracı havuzu kısıtlamaları ve en iyi yöntemler hakkında ek bilgi için bkz. https://docs.microsoft.com/azure/aks/use-system-pools

properties.networkProfile

AgentPoolNetworkProfile

Aracı havuzunun ağ ile ilgili ayarları.

properties.nodeImageVersion

string

Düğüm görüntüsünün sürümü

properties.nodeLabels

object

Aracı havuzundaki tüm düğümlerde kalıcı hale getirmek için düğüm etiketleri.

properties.nodePublicIPPrefixID

string (arm-id)

VM düğümlerinin IP'lerini kullanması gereken genel IP ön ek kimliği.
Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

properties.nodeTaints

string[]

Düğüm havuzu oluşturma ve ölçeklendirme sırasında yeni düğümlere eklenen renk tonları. Örneğin, key=value:NoSchedule.

properties.orchestratorVersion

string

Kullanıcı tarafından belirtilen Kubernetes sürümü.
Hem yama sürümü <major.minor.patch> (örneğin, 1.20.13) hem de <major.minor> (örneğin 1.20) desteklenir. <major.minor> belirtildiğinde, desteklenen en son GA düzeltme eki sürümü otomatik olarak seçilir. Küme oluşturulduktan sonra aynı <major.minor> ile güncelleştirilmesi (örneğin, 1.14.x -> 1.14) daha yeni bir düzeltme eki sürümü kullanılabilir olsa bile yükseltme tetiklemez. En iyi yöntem olarak, AKS kümesindeki tüm düğüm havuzlarını aynı Kubernetes sürümüne yükseltmeniz gerekir. Düğüm havuzu sürümü, denetim düzlemi ile aynı ana sürüme sahip olmalıdır. Düğüm havuzu ikincil sürümü, denetim düzlemi sürümünün iki ikincil sürümünde olmalıdır. Düğüm havuzu sürümü, denetim düzlemi sürümünden büyük olamaz. Daha fazla bilgi için bkz. Düğüm havuzunu yükseltme.

properties.osDiskSizeGB

integer (int32)

minimum: 0
maximum: 2048

Ana/aracı havuzundaki her makine için disk boyutunu belirtmek için kullanılacak GB cinsinden işletim sistemi Disk Boyutu. 0 belirtirseniz, belirtilen vmSize değerine göre varsayılan osDisk boyutunu uygular.

properties.osDiskType

OSDiskType

Aracı havuzundaki makineler için kullanılacak işletim sistemi disk türü.
VM destekliyorsa ve istenen OSDiskSizeGB değerinden daha büyük bir önbellek diske sahipse varsayılan değer 'Kısa Ömürlü'dür. Aksi takdirde, varsayılan olarak 'Yönetilen' olarak gösterilir. Oluşturulduktan sonra değiştirilemez. Daha fazla bilgi için bkz. Kısa ömürlü işletim sistemi.

properties.osSKU

OSSKU

Aracı havuzu tarafından kullanılan işletim sistemi SKU'su belirtir. OSType Linux ise varsayılan değer Ubuntu'dur. OSType Windows ise, Kubernetes <= 1,24 veya Windows2022 olduğunda varsayılan >değer Windows2019'dur.

properties.osType

OSType

Linux

İşletim sistemi türü. Varsayılan değer Linux'tır.

properties.podIPAllocationMode

PodIPAllocationMode

Pod IP Ayırma Modu
Aracı havuzundaki podlar için IP ayırma modu. podSubnetId ile kullanılmalıdır. Varsayılan değer :'DynamicIndividual'.

properties.podSubnetID

string (arm-id)

Podların başlatıldığında birleştirileceği alt ağın kimliği.
Atlanırsa pod IP'leri düğüm alt ağından statik olarak atanır (daha fazla ayrıntı için bkz. vnetSubnetID). Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

properties.powerState

PowerState

Aracı Havuzunun çalışıp çalışmadığı veya durdurulduğu.
Bir Aracı Havuzu ilk oluşturulduğunda başlangıçta Çalışıyor olur. Aracı Havuzu, bu alan Durduruldu olarak ayarlanarak durdurulabilir. Durdurulan Aracı Havuzu tüm VM'lerini durdurur ve faturalama ücretlerini tahakkuk etmez. Aracı Havuzu yalnızca Çalışıyor ve sağlama durumu Başarılı olduğunda durdurulabilir

properties.provisioningState

string

Geçerli dağıtım veya sağlama durumu.

properties.proximityPlacementGroupID

string (arm-id)

YakınLık Yerleştirme Grubu kimliği.

properties.scaleDownMode

ScaleDownMode

Aracı Havuzunu ölçeklendirirken kullanılacak ölçeği azaltma modu.
Bu, küme otomatik ölçeklendirici davranışını da etkiler. Belirtilmezse, varsayılan olarak Delete olur.

properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

Kullanılacak Sanal Makine Ölçek Kümesi çıkarma ilkesi.
scaleSetPriority değeri 'Spot' değilse bu belirtilemez. Belirtilmezse, varsayılan değer 'Sil'dir.

properties.scaleSetPriority

ScaleSetPriority

Regular

Sanal Makine Ölçek Kümesi önceliği. Belirtilmezse, varsayılan değer 'Normal'dir.

properties.securityProfile

AgentPoolSecurityProfile

Aracı havuzunun güvenlik ayarları.

properties.spotMaxPrice

number

-1

Spot örnekler için ödeme yapmak istediğiniz maksimum fiyat (ABD Doları cinsinden). Olası değerler, varsayılan fiyatın isteğe bağlı olarak up-to belirten sıfırdan büyük veya -1 herhangi bir ondalık değerdir.
Olası değerler, herhangi bir isteğe bağlı fiyat ödemeye istekli olduğunu gösteren sıfırdan veya -1 büyük herhangi bir ondalık değerdir. Spot fiyatlandırma hakkında daha fazla bilgi için bkz. spot VM fiyatlandırması

properties.status

AgentPoolStatus

Aracı Havuzu hakkında salt okunur bilgiler içerir.

properties.tags

object

Aracı havuzu sanal makine ölçek kümesinde kalıcı hale eklenecek etiketler.

properties.type

AgentPoolType

Aracı Havuzu türü.

properties.upgradeSettings

AgentPoolUpgradeSettings

Aracı havuzunu yükseltme ayarları

properties.virtualMachineNodesStatus

VirtualMachineNodes[]

VirtualMachines aracı havuzundaki düğümlerin durumu.

properties.virtualMachinesProfile

VirtualMachinesProfile

VirtualMachines aracı havuzundaki belirtimler.

properties.vmSize

string

Aracı havuzu VM'lerinin boyutu.
VM boyutu kullanılabilirliği bölgeye göre değişir. Düğüm yetersiz işlem kaynakları (bellek, cpu vb.) içeriyorsa podlar düzgün çalışmayabilir. Kısıtlanmış VM boyutları hakkında daha fazla bilgi için bkz. https://docs.microsoft.com/azure/aks/quotas-skus-regions

properties.vnetSubnetID

string (arm-id)

Aracı havuzu düğümlerinin ve isteğe bağlı olarak podların başlangıçta birleştirileceği alt ağın kimliği.
Bu belirtilmezse, bir sanal ağ ve alt ağ oluşturulur ve kullanılır. PodSubnetID belirtilmezse, bu düğümler ve podlar için geçerlidir, aksi takdirde yalnızca düğümler için geçerlidir. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

properties.windowsProfile

AgentPoolWindowsProfile

Windows aracı havuzunun belirli profili.

properties.workloadRuntime

WorkloadRuntime

Bir düğümün çalıştırabileceği iş yükü türünü belirler.

type

string

Kaynak türü

AgentPoolGatewayProfile

Yönetilen küme ağ geçidi aracı havuzunun profili.

Name Tür Default value Description
publicIPPrefixSize

integer (int32)

minimum: 28
maximum: 31
31

Ağ geçidi aracı havuzu, genel çıkış sağlamak için her statik çıkış ağ geçidi için bir genel IPPrefix ilişkilendirir. Genel IPPrefix'in boyutu kullanıcı tarafından seçilmelidir. Aracı havuzundaki her düğüm, IPPrefix'ten bir IP ile atanır. BU nedenle IPPrefix boyutu, Ağ Geçidi aracı havuzunun boyutu üzerinde bir üst sınır görevi görür. Azure genel IPPrefix boyut sınırlaması nedeniyle geçerli değer aralığı [28, 31] (/31 = 2 düğüm/IP, /30 = 4 düğüm/IP, /29 = 8 düğüm/IP, /28 = 16 düğüm/IP). Varsayılan değer 31'dir.

AgentPoolListResult

Aracı Havuzlarını Listele işleminden gelen yanıt.

Name Tür Description
nextLink

string

Bir sonraki aracı havuzu sonuçlarını almak için URL.

value

AgentPool[]

Aracı havuzlarının listesi.

AgentPoolMode

Aracı havuzunun modu.

Değer Description
Gateway

Ağ geçidi aracı havuzları, podlara statik çıkış IP'leri sağlamaya ayrılmıştır. Diğer ayrıntılar için bkz. https://aka.ms/aks/static-egress-gateway.

System

Sistem aracısı havuzları öncelikle CoreDNS ve metrics-server gibi kritik sistem podlarını barındırmaya yöneliktir. Sistem aracısı havuzları osType Linux olmalıdır. Sistem aracısı havuzları VM SKU'su en az 2vCPU ve 4 GB belleğe sahip olmalıdır.

User

Kullanıcı aracısı havuzları öncelikli olarak uygulama podlarınızı barındırmaya yöneliktir.

AgentPoolNetworkProfile

Aracı havuzunun ağ ayarları.

Name Tür Description
allowedHostPorts

PortRange[]

Erişmesine izin verilen bağlantı noktası aralıkları. Belirtilen aralıkların çakışmasına izin verilir.

applicationSecurityGroups

string[] (arm-id)

Aracı havuzunun oluşturulduğunda ilişkilendirileceği uygulama güvenlik gruplarının kimlikleri.

nodePublicIPTags

IPTag[]

Örnek düzeyinde genel IP'lerin IPTag'leri.

AgentPoolSecurityProfile

Aracı havuzunun güvenlik ayarları.

Name Tür Description
enableSecureBoot

boolean

Güvenli Önyükleme, yalnızca imzalı işletim sistemlerinin ve sürücülerin önyüklenmesini sağlayan Güvenilir Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur.

enableVTPM

boolean

vTPM, düğümde yerel olarak tutulan anahtarlar ve ölçümler için ayrılmış bir güvenli kasa yapılandırmaya yönelik bir Güvenilen Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur.

AgentPoolStatus

Aracı Havuzu hakkında salt okunur bilgiler içerir.

Name Tür Description
provisioningError

CloudErrorBody

Aracı havuzunun hata ayrıntı bilgileri.
Hatanın ayrıntılı bilgilerini korur. Hata yoksa, bu alan atlanır.

AgentPoolType

Aracı Havuzu türü.

Değer Description
AvailabilitySet

Bunun kullanımı kesinlikle önerilmez.

VirtualMachineScaleSets

Sanal Makine Ölçek Kümesi tarafından yedeklenen bir Aracı Havuzu oluşturun.

VirtualMachines

Tek Örnekli VM düzenleme modu tarafından yedeklenen bir Aracı Havuzu oluşturun.

AgentPoolUpgradeSettings

Aracı havuzunu yükseltme ayarları

Name Tür Description
drainTimeoutInMinutes

integer (int32)

minimum: 1
maximum: 1440

Düğüm için boşaltma zaman aşımı
Podların çıkarılması ve düğüm başına düzgün sonlandırma için bekleme süresi (dakika cinsinden). Bu çıkarma bekleme süresi, pod kesintisi bütçelerini beklemeyi kabul eder. Bu süre aşılırsa yükseltme başarısız olur. Belirtilmezse, varsayılan değer 30 dakikadır.

maxSurge

string

Yükseltme sırasında kullanılabilecek en fazla düğüm sayısı veya yüzdesi.
Bu bir tamsayıya (ör. '5') veya yüzdeye (örneğin, '50%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 10%'dir. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

maxUnavailable

string

Yükseltme sırasında aynı anda kullanılamayabilecek en fazla düğüm sayısı veya yüzdesi.
Bu bir tamsayıya (ör. '1') veya bir yüzdeye (ör. '5%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 0'dır. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

nodeSoakDurationInMinutes

integer (int32)

minimum: 0
maximum: 30

Düğüm için bekletme süresi
Bir düğümü boşaltıp yeniden boyutlandırmadan ve sonraki düğüme geçmeden önce beklenmesi gereken süre (dakika cinsinden). Belirtilmezse, varsayılan değer 0 dakikadır.

undrainableNodeBehavior

UndrainableNodeBehavior

Yükseltme sırasında çizilemez düğümlerin davranışını tanımlar. Çizilemeyen düğümlerin en yaygın nedeni Pod Kesinti bütçeleri (PDB) olsa da pod sonlandırma yetkisiz kullanım süresi kalan düğüm başına boşaltma zaman aşımını aşıyor veya pod hala çalışıyor durumdaysa, ayrıca çizilemez düğümlere neden olabilir.

AgentPoolWindowsProfile

Windows aracı havuzunun belirli profili.

Name Tür Description
disableOutboundNat

boolean

Windows düğümlerinde OutboundNAT'nin devre dışı bırakılıp devre dışı bırakılmayacağı
Varsayılan değer yanlıştır. Giden NAT yalnızca küme outboundType NAT Ağ Geçidi ise ve Windows aracı havuzunda düğüm genel IP'sinin etkinleştirilmemesi durumunda devre dışı bırakılabilir.

CloudError

Kapsayıcı hizmetinden bir hata yanıtı.

Name Tür Description
error

CloudErrorBody

Hatayla ilgili ayrıntılar.

CloudErrorBody

Kapsayıcı hizmetinden bir hata yanıtı.

Name Tür Description
code

string

Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.

details

CloudErrorBody[]

Hatayla ilgili ek ayrıntıların listesi.

message

string

Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

target

string

Belirli bir hatanın hedefi. Örneğin, özelliğin adı hatalı.

code

Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir

Değer Description
Running

Küme çalışıyor.

Stopped

Küme durduruldu.

CreationData

Kaynak kaynaktan hedef kaynak oluştururken kullanılan veriler.

Name Tür Description
sourceResourceId

string (arm-id)

Bu, hedef nesneyi oluşturmak için kullanılacak kaynak nesnenin ARM kimliğidir.

GPUDriver

GPU sürücülerinin yüklenip yüklenmeyeceği. Belirtilmediğinde, varsayılan olarak Yükle'dir.

Değer Description
Install

Sürücüyü yükleyin.

None

Sürücü yüklemesini atlayın.

GPUInstanceProfile

Desteklenen GPU VM SKU'su için GPU MIG örnek profilini belirtmek üzere kullanılacak GPUInstanceProfile.

Değer Description
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Aracı Havuzu için GPU ayarları.

Name Tür Description
driver

GPUDriver

GPU sürücülerinin yüklenip yüklenmeyeceği. Belirtilmediğinde, varsayılan olarak Yükle'dir.

IPTag

Nesneyle ilişkilendirilmiş IPTag'i içerir.

Name Tür Description
ipTagType

string

IP etiketi türü. Örnek: RoutingPreference.

tag

string

Genel IP ile ilişkili IP etiketinin değeri. Örnek: İnternet.

KubeletConfig

Aracı düğümlerinin Kubelet yapılandırmaları.

Name Tür Description
allowedUnsafeSysctls

string[]

Güvenli olmayan sysctl veya güvenli olmayan sysctl desenlerinin izin verilen listesi (ile *biten).

containerLogMaxFiles

integer (int32)

minimum: 2

Kapsayıcı için mevcut olabilecek en fazla kapsayıcı günlüğü dosyası sayısı. Sayı 2 ≥ olmalıdır.

containerLogMaxSizeMB

integer (int32)

Döndürülmeden önce kapsayıcı günlük dosyasının en büyük boyutu (örneğin 10Mi).

cpuCfsQuota

boolean

CPU sınırlarını belirten kapsayıcılar için CPU CFS kota zorlaması etkinleştirildiyse.
Varsayılan değer true'dur.

cpuCfsQuotaPeriod

string

CPU CFS kota dönemi değeri.
Varsayılan değer :'100ms.' Geçerli değerler, isteğe bağlı kesir ve birim soneki içeren ondalık sayı dizisidir. Örneğin: '300ms', '2h45m'. Desteklenen birimler 'ns', 'us', 'ms', 's', 'm' ve 'h' birimleridir.

cpuManagerPolicy

string

Kullanılacak CPU Yöneticisi ilkesi.
Varsayılan değer :'none'. Daha fazla bilgi için bkz. Kubernetes CPU yönetim ilkeleri . İzin verilen değerler 'none' ve 'static' değerleridir.

failSwapOn

boolean

True olarak ayarlanırsa, düğümde değiştirme etkinse Kubelet'in başlatılamamasına neden olur.

imageGcHighThreshold

integer (int32)

Görüntü çöp toplama işleminin her zaman çalıştırıldığı disk kullanımı yüzdesi.
Görüntü çöp toplamayı devre dışı bırakmak için 100 olarak ayarlayın. Varsayılan değer 85%

imageGcLowThreshold

integer (int32)

Görüntü atık toplama işleminin hiçbir zaman çalıştırılamadan önce disk kullanımı yüzdesi.
Bu ayar imageGcHighThreshold değerinden yüksek olamaz. Varsayılan değer 80%

podMaxPids

integer (int32)

Pod başına işlem sayısı üst sınırı.

topologyManagerPolicy

string

Kullanılacak Topoloji Yöneticisi ilkesi.
Daha fazla bilgi için bkz. Kubernetes Topoloji Yöneticisi. Varsayılan değer :'none'. İzin verilen değerler 'none', 'best-effort', 'restricted' ve 'single-numa-node' değerleridir.

KubeletDiskType

emptyDir birimlerinin, kapsayıcı çalışma zamanı veri kökünün ve Kubelet kısa ömürlü depolamanın yerleşimini belirler.

Değer Description
OS

Kubelet, verileri için işletim sistemi diskini kullanır.

Temporary

Kubelet verileri için geçici diski kullanır.

LinuxOSConfig

Linux aracı düğümlerinin işletim sistemi yapılandırmaları.

Name Tür Description
swapFileSizeMB

integer (int32)

Her düğümde oluşturulacak takas dosyasının MB cinsinden boyutu.

sysctls

SysctlConfig

Linux aracı düğümleri için sysctl ayarları.

transparentHugePageDefrag

string

Çekirdeğin daha büyük sayfaları kullanılabilir hale getirmek için bellek sıkıştırmasını agresif bir şekilde kullanıp kullanmaması.
Geçerli değerler :'always', 'defer', 'defer+madvise', 'madvise' ve 'never'. Varsayılan değer "madvise" şeklindedir. Daha fazla bilgi için bkz . Transparent Hugepages.

transparentHugePageEnabled

string

Saydam büyük sayfaların etkinleştirilip etkinleştirilmediği.
Geçerli değerler 'always', 'madvise' ve 'never' değerleridir. Varsayılan değer "her zaman"dır. Daha fazla bilgi için bkz . Transparent Hugepages.

ManualScaleProfile

Makine sayısıyla ilgili belirtimler.

Name Tür Description
count

integer (int32)

Düğüm sayısı.

size

string

AKS 'Standard_E4s_v3', 'Standard_E16s_v3' veya 'Standard_D16s_v5' gibi oluşturma ve ölçeklendirme sırasında kullanacağı VM boyutu.

OSDiskType

Aracı havuzundaki makineler için kullanılacak işletim sistemi disk türü.

Değer Description
Ephemeral

Kısa ömürlü işletim sistemi diskleri, tıpkı geçici bir disk gibi yalnızca konak makinede depolanır. Bu, daha hızlı düğüm ölçeklendirme ve küme yükseltmelerinin yanı sıra daha düşük okuma/yazma gecikme süresi sağlar.

Managed

Vm'nin başka bir konağa yeniden yerleştirilmesi gerektiğinde veri kaybını önlemek için Azure, bir sanal makinenin işletim sistemi diskini Azure depolama alanına çoğaltır. Kapsayıcılar yerel durumun kalıcı olması için tasarlanmadığından, bu davranış düşük düğüm sağlama ve daha yüksek okuma/yazma gecikme süresi gibi bazı dezavantajlar sağlarken sınırlı değer sunar.

OSSKU

Aracı havuzu tarafından kullanılan işletim sistemi SKU'su belirtir. OSType Linux ise varsayılan değer Ubuntu'dur. OSType Windows ise, Kubernetes <= 1,24 veya Windows2022 olduğunda varsayılan >değer Windows2019'dur.

Değer Description
AzureLinux

Düğüm görüntüleri için işletim sistemi olarak AzureLinux kullanın. Azure Linux, Microsoft tarafından oluşturulan kapsayıcı için iyileştirilmiş bir Linux dağıtımıdır. Daha fazla bilgi için https://aka.ms/azurelinux adresini ziyaret edin.

CBLMariner

Kullanım dışı bırakılmış OSSKU. Microsoft, yeni dağıtımların bunun yerine 'AzureLinux' seçmesini önerir.

Ubuntu

Düğüm görüntüleri için işletim sistemi olarak Ubuntu kullanın.

Ubuntu2204

Düğüm görüntüleri için işletim sistemi olarak Ubuntu2204 kullanın, ancak Ubuntu 22.04 tüm düğüm havuzları için desteklenmeyebilir. Sınırlamalar ve desteklenen Kubernetes sürümleri için bkz. https://aka.ms/aks/supported-ubuntu-versions

Windows2019

Düğüm görüntüleri için işletim sistemi olarak Windows2019 kullanın. Sistem düğümü havuzları için desteklenmiyor. Windows2019 yalnızca Windows2019 kapsayıcılarını destekler; Windows2022 kapsayıcılarını çalıştıramaz ve tam tersi de geçerlidir.

Windows2022

Düğüm görüntüleri için işletim sistemi olarak Windows2022 kullanın. Sistem düğümü havuzları için desteklenmiyor. Windows2022 yalnızca Windows2022 kapsayıcılarını destekler; Windows2019 kapsayıcılarını çalıştıramaz ve tam tersi de geçerlidir.

OSType

İşletim sistemi türü. Varsayılan değer Linux'tır.

Değer Description
Linux

Linux kullanın.

Windows

Windows kullanın.

PodIPAllocationMode

Pod IP Ayırma Modu

Değer Description
DynamicIndividual

Her düğüme, podlara atanabilen bitişik olmayan bir IP adresleri listesi atanır. Bu, /16 veya daha küçük boyutlu küçük ve orta bir alt ağı en üst düzeye çıkarmak için daha iyidir. Müşteri açıkça podIPAllocationMode belirtmezse dinamik IP ayırmalı Azure CNI kümesi varsayılan olarak bu moda geçer

StaticBlock

Her düğüm, düğüm başına maxPods değerini karşılamak için blok başına /28 = 16 IP boyutunda statik olarak CIDR blokları ayrılır. CIDR bloklarının sayısı >= (maxPods / 16). Blok, tek bir IP yerine 65K Azure Sanal Ağ Özel IP sınırına göre sayılır. Bu nedenle blok modu, bir kümede geçerli 65.000 pod sınırından daha fazla olan daha büyük iş yüklerini çalıştırmak için uygundur. Bu mod daha büyük /15 veya daha büyük alt ağlarla ölçeklendirmek için daha uygundur

PortRange

Bağlantı noktası aralığı.

Name Tür Description
portEnd

integer (int32)

minimum: 1
maximum: 65535

Aralığa dahil edilen maksimum bağlantı noktası. 1 ile 65535 arasında olmalı ve portStart değerinden büyük veya buna eşit olmalıdır.

portStart

integer (int32)

minimum: 1
maximum: 65535

Aralığa dahil edilen en düşük bağlantı noktası. 1 ile 65535 arasında olmalı ve portEnd değerinden küçük veya buna eşit olmalıdır.

protocol

Protocol

Bağlantı noktasının ağ protokolü.

PowerState

Kümenin Güç Durumunu açıklar

Name Tür Description
code

code

Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir

Protocol

Bağlantı noktasının ağ protokolü.

Değer Description
TCP

TCP protokolü.

UDP

UDP protokolü.

ScaleDownMode

VM'lerin Aracı Havuzlarına nasıl eklendiğini veya aracı havuzlarından nasıl kaldırıldığını açıklar. Bkz. faturalama durumları.

Değer Description
Deallocate

Ölçeği artırma sırasında serbest bırakılmış örnekleri (varsa) başlatmayı ve ölçeği azaltma sırasında örnekleri serbest bırakmayı deneme.

Delete

Ölçeği artırma sırasında yeni örnekler oluşturun ve ölçeği azaltma sırasında örnekleri kaldırın.

ScaleProfile

VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler.

Name Tür Description
manual

ManualScaleProfile[]

VirtualMachines aracı havuzunun sabit bir boyuta ölçeklendirilmesiyle ilgili belirtimler.

ScaleSetEvictionPolicy

Sanal Makine Ölçek Kümesi çıkarma ilkesi.

Değer Description
Deallocate

Düğüm havuzunun temel alınan Ölçek Kümesindeki düğümler çıkarmadan sonra durduruldu-serbest bırakıldı durumuna ayarlanır. Durdurulmuş serbest bırakılmış durumdaki düğümler işlem kotanıza göre sayılır ve küme ölçeklendirme veya yükseltme ile ilgili sorunlara neden olabilir.

Delete

Düğüm havuzunun temel alınan Ölçek Kümesindeki düğümler çıkarıldığında silinir.

ScaleSetPriority

Sanal Makine Ölçek Kümesi önceliği.

Değer Description
Regular

Normal VM'ler kullanılır.

Spot

Spot öncelikli VM'ler kullanılır. Spot düğümler için SLA yoktur. Daha fazla bilgi için bkz. AKS nokta.

SysctlConfig

Linux aracı düğümleri için sysctl ayarları.

Name Tür Description
fsAioMaxNr

integer (int32)

Sysctl ayarı fs.aio-max-nr.

fsFileMax

integer (int32)

Sysctl ayarı fs.file-max.

fsInotifyMaxUserWatches

integer (int32)

Sysctl ayarı fs.inotify.max_user_watches.

fsNrOpen

integer (int32)

Sysctl ayarı fs.nr_open.

kernelThreadsMax

integer (int32)

Kernel.threads-max sysctl ayarı.

netCoreNetdevMaxBacklog

integer (int32)

Sysctl ayarı net.core.netdev_max_backlog.

netCoreOptmemMax

integer (int32)

Sysctl ayarı net.core.optmem_max.

netCoreRmemDefault

integer (int32)

Sysctl ayarı net.core.rmem_default.

netCoreRmemMax

integer (int32)

Sysctl ayarı net.core.rmem_max.

netCoreSomaxconn

integer (int32)

Net.core.somaxconn sysctl ayarı.

netCoreWmemDefault

integer (int32)

Sysctl ayarı net.core.wmem_default.

netCoreWmemMax

integer (int32)

Sysctl ayarı net.core.wmem_max.

netIpv4IpLocalPortRange

string

Sysctl ayarı net.ipv4.ip_local_port_range.

netIpv4NeighDefaultGcThresh1

integer (int32)

Sysctl ayarı net.ipv4.neigh.default.gc_thresh1.

netIpv4NeighDefaultGcThresh2

integer (int32)

Sysctl ayarı net.ipv4.neigh.default.gc_thresh2.

netIpv4NeighDefaultGcThresh3

integer (int32)

Sysctl ayarı net.ipv4.neigh.default.gc_thresh3.

netIpv4TcpFinTimeout

integer (int32)

Sysctl ayarı net.ipv4.tcp_fin_timeout.

netIpv4TcpKeepaliveProbes

integer (int32)

Sysctl ayarı net.ipv4.tcp_keepalive_probes.

netIpv4TcpKeepaliveTime

integer (int32)

Sysctl ayarı net.ipv4.tcp_keepalive_time.

netIpv4TcpMaxSynBacklog

integer (int32)

Sysctl ayarı net.ipv4.tcp_max_syn_backlog.

netIpv4TcpMaxTwBuckets

integer (int32)

Sysctl ayarı net.ipv4.tcp_max_tw_buckets.

netIpv4TcpTwReuse

boolean

Sysctl ayarı net.ipv4.tcp_tw_reuse.

netIpv4TcpkeepaliveIntvl

integer (int32)

minimum: 10
maximum: 90

Sysctl ayarı net.ipv4.tcp_keepalive_intvl.

netNetfilterNfConntrackBuckets

integer (int32)

minimum: 65536
maximum: 524288

Sysctl ayarı net.netfilter.nf_conntrack_buckets.

netNetfilterNfConntrackMax

integer (int32)

minimum: 131072
maximum: 2097152

Sysctl ayarı net.netfilter.nf_conntrack_max.

vmMaxMapCount

integer (int32)

Sysctl ayarı vm.max_map_count.

vmSwappiness

integer (int32)

Sysctl ayarı vm.swappiness.

vmVfsCachePressure

integer (int32)

Sysctl ayarı vm.vfs_cache_pressure.

UndrainableNodeBehavior

Yükseltme sırasında çizilemez düğümlerin davranışını tanımlar. Çizilemeyen düğümlerin en yaygın nedeni Pod Kesinti bütçeleri (PDB) olsa da pod sonlandırma yetkisiz kullanım süresi kalan düğüm başına boşaltma zaman aşımını aşıyor veya pod hala çalışıyor durumdaysa, ayrıca çizilemez düğümlere neden olabilir.

Değer Description
Cordon

AKS, engellenen düğümleri kordonlar ve yükseltme sırasında bunları aşırı gerilim düğümleriyle değiştirir. Engellenen düğümler kordonlanır ve aşırı gerilim düğümleri ile değiştirilir. Engellenen düğümler 'kubernetes.azure.com/upgrade-status:Quarantined' etiketine sahip olur. Engellenen her düğüm için bir dalgalanma düğümü korunur. Diğer tüm aşırı gerilim düğümlerini silmek için en iyi çabayı gösterme girişiminde bulunulacaktır. Engellenen düğümleri değiştirmek için yeterli aşırı gerilim düğümü varsa yükseltme işlemi ve yönetilen küme başarısız durumda olur. Aksi takdirde, yükseltme işlemi ve yönetilen küme iptal edilmiş durumda olur.

Schedule

AKS engellenen düğümleri zamanlanabilir olarak işaretler, ancak engellenen düğümler yükseltilmez. Tüm aşırı gerilim düğümlerini silmek için en iyi çabayı gösterme girişiminde bulunulacaktır. Herhangi bir engellenen düğüm varsa yükseltme işlemi ve yönetilen küme başarısız durumda olur.

VirtualMachineNodes

Aynı vm boyutundaki düğüm grubundaki geçerli durum.

Name Tür Description
count

integer (int32)

Düğüm sayısı.

size

string

Bu düğüm grubunu barındırmak için kullanılan aracıların VM boyutu.

VirtualMachinesProfile

VirtualMachines aracı havuzundaki belirtimler.

Name Tür Description
scale

ScaleProfile

VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler.

WorkloadRuntime

Bir düğümün çalıştırabileceği iş yükü türünü belirler.

Değer Description
OCIContainer

Düğümler, standart OCI kapsayıcı iş yüklerini çalıştırmak için Kubelet kullanır.

WasmWasi

Düğümler WASI sağlayıcısını (Önizleme) kullanarak WASM iş yüklerini çalıştırmak için Krustlet kullanır.