Agent Pools - Get

Hizmet:: AKS

API Sürümü:: 2025-10-01

Belirtilen yönetilen küme aracısı havuzunu alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Aracı havuzunun adı.
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	AgentPool	Tamam
Other Status Codes	ErrorResponse	İş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

Get Agent Pool

Örnek isteği

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


/**
 * Samples for AgentPools Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/
     * AgentPoolsGet.json
     */
    /**
     * Sample code: Get Agent Pool.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAgentPool(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.kubernetesClusters().manager().serviceClient().getAgentPools().getWithResponse("rg1", "clustername1",
            "agentpool1", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python agent_pools_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.agent_pools.get(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
    )
    print(response)


# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v8"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9cc7633f842575274f715cc02e37c5769ac2742d/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
func ExampleAgentPoolsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAgentPoolsClient().Get(ctx, "rg1", "clustername1", "agentpool1", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.AgentPool = armcontainerservice.AgentPool{
	// 	Name: to.Ptr("agentpool1"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1"),
	// 	Properties: &armcontainerservice.ManagedClusterAgentPoolProfileProperties{
	// 		Count: to.Ptr[int32](3),
	// 		CurrentOrchestratorVersion: to.Ptr("1.9.6"),
	// 		ETag: to.Ptr("ebwiyfneowv"),
	// 		MaxPods: to.Ptr[int32](110),
	// 		NodeImageVersion: to.Ptr("AKSUbuntu:1604:2020.03.11"),
	// 		OrchestratorVersion: to.Ptr("1.9.6"),
	// 		OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		UpgradeSettings: &armcontainerservice.AgentPoolUpgradeSettings{
	// 			MaxSurge: to.Ptr("33%"),
	// 		},
	// 		VMSize: to.Ptr("Standard_DS1_v2"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets the specified managed cluster agent pool.
 *
 * @summary Gets the specified managed cluster agent pool.
 * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
 */
async function getAgentPool() {
  const subscriptionId =
    process.env["CONTAINERSERVICE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERSERVICE_RESOURCE_GROUP"] || "rg1";
  const resourceName = "clustername1";
  const agentPoolName = "agentpool1";
  const credential = new DefaultAzureCredential();
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.get(resourceGroupName, resourceName, agentPoolName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ContainerService.Models;
using Azure.ResourceManager.ContainerService;

// Generated from example definition: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
// this example is just showing the usage of "AgentPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ContainerServiceAgentPoolResource created on azure
// for more information of creating ContainerServiceAgentPoolResource, please refer to the document of ContainerServiceAgentPoolResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "rg1";
string resourceName = "clustername1";
string agentPoolName = "agentpool1";
ResourceIdentifier containerServiceAgentPoolResourceId = ContainerServiceAgentPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceName, agentPoolName);
ContainerServiceAgentPoolResource containerServiceAgentPool = client.GetContainerServiceAgentPoolResource(containerServiceAgentPoolResourceId);

// invoke the operation
ContainerServiceAgentPoolResource result = await containerServiceAgentPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ContainerServiceAgentPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:: 200

{
  "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",
    "eTag": "ebwiyfneowv",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
    "upgradeSettings": {
      "maxSurge": "33%"
    }
  }
}

Tanımlar

Name	Description
AgentPool	Aracı Havuzu.
AgentPoolGatewayProfile	Yönetilen küme ağ geçidi aracı havuzunun profili.
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
AgentPoolNetworkProfile	Aracı havuzunun ağ ayarları.
AgentPoolSecurityProfile	Aracı havuzunun güvenlik ayarları.
AgentPoolSSHAccess	Aracı havuzunun SSH erişim yöntemi.
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.
code	Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir
CreationData	Kaynak kaynaktan hedef kaynak oluştururken kullanılan veriler.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
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ı. Daha fazla bilgi için bkz. AKS özel düğüm yapılandırma .
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ı. Daha fazla bilgi için bkz. AKS özel düğüm yapılandırma .
LocalDNSForwardDestination	LocalDNS'den iletilecek DNS sorguları için hedef sunucu.
LocalDNSForwardPolicy	Yukarı akış DNS sunucusunu seçmek için ilkeyi iletin. Daha fazla bilgi için ileri eklentiye bakın.
LocalDNSMode	localDNS için etkinleştirme modu.
LocalDNSOverride	localDNS profili için geçersiz kılmalar.
LocalDNSProfile	VnetDNS ve KubeDNS geçersiz kılmaları ile düğüm başına yerel DNS'yi yapılandırır. LocalDNS, bir AKS kümesinde DNS çözümlemesinin performansını ve güvenilirliğini artırmaya yardımcı olur. Daha fazla ayrıntı için aka.ms/aks/localdns bakın.
LocalDNSProtocol	LocalDNS'den yukarı akış DNS sunucusuna bağlantılar için TCP'yi zorunlu kılın veya UDP protokolünü tercih edin.
LocalDNSQueryLogging	localDNS'deki DNS sorguları için günlük düzeyi.
LocalDNSServeStale	Eski verileri sunma ilkesi. Daha fazla bilgi için önbellek eklentisine bakın.
LocalDNSState	localDNS'nin sistem tarafından oluşturulan durumu.
ManualScaleProfile	Makine sayısıyla ilgili belirtimler.
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.
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 Kubernetes >= 1,25 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. Aracı havuzundaki podlar için IP ayırma modu. podSubnetId ile kullanılmalıdır. Varsayılan değer :'DynamicIndividual'.
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 bu havuzlardan nasıl kaldırıldığını açıklar. Faturalandırma durumlarına bakın.
ScaleProfile	VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler.
ScaleSetEvictionPolicy	Sanal Makine Ölçek Kümesi çıkarma ilkesi. Çıkarma ilkesi, çıkarıldığında VM ile ne yapılacağını belirtir. Varsayılan değer Sil'dir. Çıkarma hakkında daha fazla bilgi için bkz.
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

Nesne

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)		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ına göre 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ı 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ırması.
properties.localDNSProfile	LocalDNSProfile		VnetDNS ve KubeDNS geçersiz kılmaları ile düğüm başına yerel DNS'yi yapılandırır. LocalDNS, bir AKS kümesinde DNS çözümlemesinin performansını ve güvenilirliğini artırmaya yardımcı olur. Daha fazla ayrıntı için aka.ms/aks/localdns bakın.
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 major.minor.patch<>düzeltme eki sürümü (ö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. Oluşturulduktan sonra kümenin aynı <major.minor> güncelleştirilmesi (örneğin, 1.14.x -> 1.14), daha yeni bir düzeltme eki sürümü kullanılabilir olsa bile yükseltmeyi 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 Kubernetes >= 1,25 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ırma
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

Nesne

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.

AgentPoolMode

Numaralandırma

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

Değer	Description
System	Sistem aracısı havuzları öncelikle CoreDNS ve metrics-server gibi kritik sistem podlarını barındırmak içindir. 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ı öncelikle uygulama podlarınızı barındırmak içindir.
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.

AgentPoolNetworkProfile

Nesne

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

Nesne

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.
sshAccess	AgentPoolSSHAccess	Aracı havuzunun SSH erişim yöntemi.

AgentPoolSSHAccess

Numaralandırma

Aracı havuzunun SSH erişim yöntemi.

Değer	Description
LocalUser	Özel anahtar kullanarak yerel kullanıcı olarak düğüme SSH ekleyebilir.
Disabled	Düğümde SSH hizmeti kapatılır.

AgentPoolStatus

Nesne

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

Name	Tür	Description
provisioningError	ErrorDetail	Aracı havuzunun hata ayrıntı bilgileri. Arızanın ayrıntılı bilgilerini korur. Herhangi bir hata yoksa, bu alan atlanır.

AgentPoolType

Numaralandırma

Aracı Havuzu türü.

Değer	Description
VirtualMachineScaleSets	Sanal Makine Ölçek Kümesi tarafından desteklenen bir Aracı Havuzu oluşturun.
AvailabilitySet	Bunun kullanılması kesinlikle önerilmez.
VirtualMachines	Tek Örnekli VM düzenleme modu tarafından desteklenen bir Aracı Havuzu oluşturun.

AgentPoolUpgradeSettings

Nesne

Aracı havuzunu yükseltme ayarları

Name	Tür	Description
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	Bir 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	Bir düğümün ıslatma 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

Nesne

Windows aracı havuzunun belirli profili.

Name	Tür	Description
disableOutboundNat	boolean	Windows düğümlerinde OutboundNAT'ın devre dışı bırakılıp 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.

code

Numaralandırma

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

Değer	Description
Running	Küme çalışıyor.
Stopped	Küme durdurulur.

CreationData

Nesne

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.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

GPUDriver

Numaralandırma

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

Numaralandırma

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

Nesne

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

Nesne

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

Nesne

Aracı düğümlerinin Kubelet yapılandırmaları. Daha fazla bilgi için bkz. AKS özel düğüm yapılandırma .

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

Numaralandırma

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

Nesne

Linux aracı düğümlerinin işletim sistemi yapılandırmaları. Daha fazla bilgi için bkz. AKS özel düğüm yapılandırma .

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.

LocalDNSForwardDestination

Numaralandırma

LocalDNS'den iletilecek DNS sorguları için hedef sunucu.

Değer	Description
ClusterCoreDNS	DNS sorgularını localDNS'den küme CoreDNS'ye iletin.
VnetDNS	DNS sorgularını localDNS'den sanal ağda yapılandırılan DNS sunucusuna iletin. Bir sanal ağ için birden çok DNS sunucusu yapılandırılmış olabilir.

LocalDNSForwardPolicy

Numaralandırma

Yukarı akış DNS sunucusunu seçmek için ilkeyi iletin. Daha fazla bilgi için ileri eklentiye bakın.

Değer	Description
Sequential	Sıralı yukarı akış DNS sunucusu seçimini uygular. Daha fazla bilgi için ileri eklentiye bakın.
RoundRobin	Hepsini bir kez deneme yukarı akış DNS sunucusu seçimini uygular. Daha fazla bilgi için ileri eklentiye bakın.
Random	Rasgele yukarı akış DNS sunucusu seçimi uygular. Daha fazla bilgi için ileri eklentiye bakın.

LocalDNSMode

Numaralandırma

localDNS için etkinleştirme modu.

Değer	Description
Preferred	Geçerli düzenleyici sürümü bu özelliği destekliyorsa localDNS'yi etkinleştirmeyi tercih edin.
Required	localDNS'yi etkinleştirin.
Disabled	localDNS'yi devre dışı bırakın.

LocalDNSOverride

Nesne

localDNS profili için geçersiz kılmalar.

Name	Tür	Default value	Description
cacheDurationInSeconds	integer (int32)	3600	Maksimum TTL'yi saniyeler içinde önbelleğe alın. Daha fazla bilgi için önbellek eklentisine bakın.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	LocalDNS'den iletilecek DNS sorguları için hedef sunucu.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Yukarı akış DNS sunucusunu seçmek için ilkeyi iletin. Daha fazla bilgi için ileri eklentiye bakın.
maxConcurrent	integer (int32)	1000	Eşzamanlı sorgu sayısı üst sınırı. Daha fazla bilgi için ileri eklentiye bakın.
protocol	LocalDNSProtocol	PreferUDP	LocalDNS'den yukarı akış DNS sunucusuna bağlantılar için TCP'yi zorunlu kılın veya UDP protokolünü tercih edin.
queryLogging	LocalDNSQueryLogging	Error	localDNS'deki DNS sorguları için günlük düzeyi.
serveStale	LocalDNSServeStale	Immediate	Eski verileri sunma ilkesi. Daha fazla bilgi için önbellek eklentisine bakın.
serveStaleDurationInSeconds	integer (int32)	3600	Saniyeler içinde bayat süre servis yapın. Daha fazla bilgi için önbellek eklentisine bakın.

LocalDNSProfile

Nesne

VnetDNS ve KubeDNS geçersiz kılmaları ile düğüm başına yerel DNS'yi yapılandırır. LocalDNS, bir AKS kümesinde DNS çözümlemesinin performansını ve güvenilirliğini artırmaya yardımcı olur. Daha fazla ayrıntı için aka.ms/aks/localdns bakın.

Name	Tür	Default value	Description
kubeDNSOverrides	<string, LocalDNSOverride>		KubeDNS geçersiz kılmaları, dnsPolicy:ClusterFirst (KubeDNS trafiği olarak adlandırılır) ile podlardan gelen DNS trafiğine uygulanır.
mode	LocalDNSMode	Preferred	localDNS için etkinleştirme modu.
state	LocalDNSState		localDNS'nin sistem tarafından oluşturulan durumu.
vnetDNSOverrides	<string, LocalDNSOverride>		VnetDNS geçersiz kılmaları, dnsPolicy:default veya kubelet (VnetDNS trafiği olarak adlandırılır) ile podlardan gelen DNS trafiğine uygulanır.

LocalDNSProtocol

Numaralandırma

LocalDNS'den yukarı akış DNS sunucusuna bağlantılar için TCP'yi zorunlu kılın veya UDP protokolünü tercih edin.

Değer	Description
PreferUDP	localDNS'den yukarı akış DNS sunucusuna bağlantılar için UDP protokolünü tercih edin.
ForceTCP	localDNS'den yukarı akış DNS sunucusuna bağlantılar için TCP protokolünü zorunlu kılın.

LocalDNSQueryLogging

Numaralandırma

localDNS'deki DNS sorguları için günlük düzeyi.

Değer	Description
Error	localDNS'de hata günlüğünü etkinleştirir. Daha fazla bilgi için errors eklentisine bakın.
Log	localDNS'de sorgu günlüğünü etkinleştirir. Daha fazla bilgi için günlük eklentisine bakın.

LocalDNSServeStale

Numaralandırma

Eski verileri sunma ilkesi. Daha fazla bilgi için önbellek eklentisine bakın.

Değer	Description
Verify	Eski verileri doğrulama ile sunun. Öncelikle, süresi dolan girdiyi istemciye göndermeden önce bir girdinin kaynaktan hala kullanılamadığını doğrulayın. Daha fazla bilgi için önbellek eklentisine bakın.
Immediate	Eski verileri hemen sunun. Girişin kaynaktan kullanılabilir olup olmadığını kontrol etmeden önce süresi dolmuş girişi istemciye gönderin. Daha fazla bilgi için önbellek eklentisine bakın.
Disable	Eski verilerin sunulmasını devre dışı bırakın.

LocalDNSState

Numaralandırma

localDNS'nin sistem tarafından oluşturulan durumu.

Değer	Description
Enabled	localDNS etkinleştirildi.
Disabled	localDNS devre dışı bırakıldı.

ManualScaleProfile

Nesne

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

Numaralandırma

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.

Değer	Description
Managed	Azure, VM'nin başka bir konağa taşınması gerektiğinde veri kaybını önlemek için bir sanal makinenin işletim sistemi diskini Azure depolamaya ç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.
Ephemeral	Kısa ömürlü işletim sistemi diskleri, tıpkı geçici bir disk gibi yalnızca ana 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.

OSSKU

Numaralandırma

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 Kubernetes >= 1,25 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.
AzureLinux3	Düğüm görüntüleri için işletim sistemi olarak AzureLinux3 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. Sınırlamalar için şu adresi ziyaret edin https://aka.ms/aks/node-images: . İşletim sistemi geçiş kılavuzu için bkz.https://aka.ms/aks/upgrade-os-version
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
Ubuntu2404	Düğüm görüntüleri için işletim sistemi olarak Ubuntu2404 kullanın, ancak Ubuntu 24.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

Numaralandırma

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

Değer	Description
Linux	Linux kullanın.
Windows	Windows'u kullanın.

PodIPAllocationMode

Numaralandırma

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

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. Dinamik IP ayırmaya sahip Azure CNI kümesi, müşteri açıkça bir podIPAllocationMode belirtmezse varsayılan olarak bu moda geçer

StaticBlock

Her düğüme, düğüm başına maxPods'u karşılamak için /28 = blok başına 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

Nesne

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

Nesne

Kümenin Güç Durumunu açıklar

Name	Tür	Description
code	code	Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir

Protocol

Numaralandırma

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

Değer	Description
TCP	TCP protokolü.
UDP	UDP protokolü.

ScaleDownMode

Numaralandırma

VM'lerin Aracı Havuzlarına nasıl eklendiğini veya bu havuzlardan nasıl kaldırıldığını açıklar. Faturalandırma durumlarına bakın.

Değer	Description
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.
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ı deneyin.

ScaleProfile

Nesne

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

Numaralandırma

Sanal Makine Ölçek Kümesi çıkarma ilkesi. Çıkarma ilkesi, çıkarıldığında VM ile ne yapılacağını belirtir. Varsayılan değer Sil'dir. Çıkarma hakkında daha fazla bilgi için bkz.

Değer	Description
Delete	Düğüm havuzunun temel alınan Ölçek Kümesi'ndeki düğümler çıkarıldıklarında silinir.
Deallocate	Düğüm havuzunun temel alınan Ölçek Kümesi'ndeki düğümler, çıkarma sonrasında 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.

ScaleSetPriority

Numaralandırma

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

Değer	Description
Spot	Spot öncelikli VM'ler kullanılacaktır. Spot düğümler için SLA yoktur. Daha fazla bilgi için bkz. AKS nokta.
Regular	Normal VM'ler kullanılacaktır.

SysctlConfig

Nesne

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

Numaralandırma

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

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.

Cordon

AKS, yükseltme sırasında engellenen düğümleri kordon altına alır ve bunları dalgalanma 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.

VirtualMachineNodes

Nesne

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

Nesne

VirtualMachines aracı havuzundaki belirtimler.

Name	Tür	Description
scale	ScaleProfile	VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler.

WorkloadRuntime

Numaralandırma

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.
KataVmIsolation	Düğümler, İç İçe VM tabanlı podları etkinleştirmek için (Kata + Cloud Hypervisor + Hyper-V) kullanabilir. Hyper-V kullanımı nedeniyle AKS düğüm işletim sistemi, Hyper-V'nin iç içe geçmiş bir VM'dir (kök işletim sistemi). Bu nedenle yalnızca Dv3 serisi gibi İç İçe Sanallaştırmayı destekleyen VM serisiyle kullanılabilir.