Agent Pools - Get

Layanan:: AKS

Versi API:: 2025-10-01

Mendapatkan kumpulan agen kluster terkelola yang ditentukan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Nama kumpulan agen.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
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]$	Nama sumber daya kluster terkelola.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	AgentPool	OK
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Get Agent Pool

Permintaan sampel

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

Respon sampel

Kode status:: 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%"
    }
  }
}

Definisi

Nama	Deskripsi
AgentPool	Kumpulan Agen.
AgentPoolGatewayProfile	Profil kumpulan agen gateway kluster terkelola.
AgentPoolMode	Mode kumpulan agen. Kluster harus memiliki setidaknya satu Kumpulan Agen 'Sistem' setiap saat. Untuk informasi tambahan tentang pembatasan dan praktik terbaik kumpulan agen, lihat: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolNetworkProfile	Pengaturan jaringan kumpulan agen.
AgentPoolSecurityProfile	Pengaturan keamanan kumpulan agen.
AgentPoolSSHAccess	Metode akses SSH dari kumpulan agen.
AgentPoolStatus	Berisi informasi baca-saja tentang Kumpulan Agen.
AgentPoolType	Jenis Kumpulan Agen.
AgentPoolUpgradeSettings	Pengaturan untuk memutakhirkan agentpool
AgentPoolWindowsProfile	Profil spesifik kumpulan agen Windows.
code	Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan
CreationData	Data yang digunakan saat membuat sumber daya target dari sumber daya sumber.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
GPUDriver	Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.
GPUInstanceProfile	GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.
GPUProfile	Pengaturan GPU untuk Kumpulan Agen.
IPTag	Berisi IPTag yang terkait dengan objek .
KubeletConfig	Konfigurasi kubelet simpul agen. Lihat konfigurasi node kustom AKS untuk detail selengkapnya.
KubeletDiskType	Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.
LinuxOSConfig	Konfigurasi OS simpul agen Linux. Lihat konfigurasi node kustom AKS untuk detail selengkapnya.
LocalDNSForwardDestination	Server tujuan untuk kueri DNS yang akan diteruskan dari localDNS.
LocalDNSForwardPolicy	Meneruskan kebijakan untuk memilih server DNS hulu. Lihat plugin forward untuk informasi lebih lanjut.
LocalDNSMode	Mode pemberdayaan untuk localDNS.
LocalDNSOverride	Penggantian untuk profil localDNS.
LocalDNSProfile	Mengonfigurasi DNS lokal per simpul, dengan penggantian VnetDNS dan KubeDNS. LocalDNS membantu meningkatkan performa dan keandalan resolusi DNS dalam kluster AKS. Untuk detail selengkapnya, lihat aka.ms/aks/localdns.
LocalDNSProtocol	Terapkan TCP atau pilih protokol UDP untuk koneksi dari localDNS ke server DNS hulu.
LocalDNSQueryLogging	Tingkat log untuk kueri DNS di localDNS.
LocalDNSServeStale	Kebijakan untuk menyajikan data kedaluwarsa. Lihat plugin cache untuk informasi selengkapnya.
LocalDNSState	Status localDNS yang dihasilkan sistem.
ManualScaleProfile	Spesifikasi pada jumlah komputer.
OSDiskType	Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen. Defaultnya adalah 'Ephemeral' jika VM mendukungnya dan memiliki disk cache yang lebih besar dari OSDiskSizeGB yang diminta. Jika tidak, default ke 'Terkelola'. Mungkin tidak diubah setelah pembuatan. Untuk informasi selengkapnya, lihatOS Ephemeral .
OSSKU	Menentukan SKU OS yang digunakan oleh kumpulan agen. Defaultnya adalah Ubuntu jika OSType adalah Linux. Defaultnya adalah Windows2019 ketika Kubernetes <= 1.24 atau Windows2022 ketika Kubernetes >= 1,25 jika OSType adalah Windows.
OSType	Jenis sistem operasi. Defaultnya adalah Linux.
PodIPAllocationMode	Mode Alokasi IP Pod. Mode alokasi IP untuk pod di kumpulan agen. Harus digunakan dengan podSubnetId. Defaultnya adalah 'DynamicIndividual'.
PortRange	Rentang port.
PowerState	Menjelaskan Status Daya kluster
Protocol	Protokol jaringan port.
ScaleDownMode	Menjelaskan bagaimana VM ditambahkan ke atau dihapus dari Kumpulan Agen. Lihat status penagihan.
ScaleProfile	Spesifikasi tentang cara menskalakan kumpulan agen VirtualMachines.
ScaleSetEvictionPolicy	Kebijakan penggusuran Set Skala Komputer Virtual. Kebijakan penggusuran menentukan apa yang harus dilakukan dengan VM saat diusir. Defaultnya adalah Hapus. Untuk informasi selengkapnya tentang penggusuran, lihat VM spot
ScaleSetPriority	Prioritas Set Skala Komputer Virtual.
SysctlConfig	Pengaturan Sysctl untuk simpul agen Linux.
UndrainableNodeBehavior	Menentukan perilaku untuk simpul yang tidak dapat dibatalkan selama peningkatan. Penyebab paling umum dari simpul yang tidak dapat dibatalkan adalah Anggaran Gangguan Pod (PDB), tetapi masalah lain, seperti masa tenggang penghentian pod melebihi batas waktu pengurasan per node yang tersisa atau pod masih dalam keadaan berjalan, juga dapat menyebabkan simpul yang tidak dapat dibatalkan.
VirtualMachineNodes	Status saat ini pada sekelompok simpul dengan ukuran vm yang sama.
VirtualMachinesProfile	Spesifikasi tentang kumpulan agen VirtualMachines.
WorkloadRuntime	Menentukan jenis beban kerja yang dapat dijalankan simpul.

AgentPool

Objek

Kumpulan Agen.

Nama	Jenis	Nilai default	Deskripsi
id	string		ID Sumber Daya.
name	string		Nama sumber daya yang unik dalam grup sumber daya. Nama ini dapat digunakan untuk mengakses sumber daya.
properties.availabilityZones	string[]		Daftar Zona ketersediaan yang akan digunakan untuk simpul. Ini hanya dapat ditentukan jika properti AgentPoolType adalah 'VirtualMachineScaleSets'.
properties.capacityReservationGroupID	string (arm-id)		AKS akan mengaitkan kumpulan agen yang ditentukan dengan Grup Reservasi Kapasitas.
properties.count	integer (int32)		Jumlah agen (VM) untuk menghosting kontainer docker. Nilai yang diizinkan harus dalam rentang 0 hingga 1000 (inklusif) untuk kumpulan pengguna dan dalam rentang 1 hingga 1000 (inklusif) untuk kumpulan sistem. Nilai defaultnya adalah 1.
properties.creationData	CreationData		CreationData yang akan digunakan untuk menentukan ID Rekam Jepret sumber jika kumpulan simpul akan dibuat/ditingkatkan menggunakan rekam jepret.
properties.currentOrchestratorVersion	string		Versi Kubernetes yang dijalankan Kumpulan Agen. Jika orchestratorVersion adalah versi yang sepenuhnya ditentukan <major.minor.patch>, bidang ini akan sama persis dengannya. Jika orchestratorVersion <>major.minor , bidang ini akan berisi versi <> major.minor.patch lengkap yang digunakan.
properties.eTag	string		String baca-saja unik yang digunakan untuk mengimplementasikan konkurensi optimis. Nilai eTag akan berubah saat sumber daya diperbarui. Tentukan header if-match atau if-none-match dengan nilai eTag untuk permintaan berikutnya guna mengaktifkan konkurensi optimis sesuai konvensi eTag normal.
properties.enableAutoScaling	boolean		Apakah akan mengaktifkan penskala otomatis
properties.enableEncryptionAtHost	boolean		Apakah akan mengaktifkan OS berbasis host dan enkripsi drive data. Ini hanya didukung pada ukuran VM tertentu dan di wilayah Azure tertentu. Untuk informasi selengkapnya, lihat: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS	boolean		Apakah akan menggunakan OS berkemampuan FIPS. Lihat Menambahkan kumpulan simpul berkemampuan FIPS untuk detail selengkapnya.
properties.enableNodePublicIP	boolean		Apakah setiap simpul dialokasikan IP publiknya sendiri. Beberapa skenario mungkin memerlukan simpul di kumpulan simpul untuk menerima alamat IP publik khusus mereka sendiri. Skenario umum adalah untuk beban kerja permainan, di mana konsol perlu membuat koneksi langsung ke komputer virtual cloud untuk meminimalkan lompatan. Untuk informasi selengkapnya, lihat menetapkan IP publik per simpul. Defaultnya adalah false.
properties.enableUltraSSD	boolean		Apakah akan mengaktifkan UltraSSD
properties.gatewayProfile	AgentPoolGatewayProfile		Profil khusus untuk kumpulan agen terkelola dalam mode Gateway. Bidang ini tidak dapat diatur jika mode kumpulan agen bukan Gateway.
properties.gpuInstanceProfile	GPUInstanceProfile		GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.
properties.gpuProfile	GPUProfile		Pengaturan GPU untuk Kumpulan Agen.
properties.hostGroupID	string (arm-id)		ID sumber daya yang sepenuhnya memenuhi syarat dari Grup Host Khusus untuk memprovisikan komputer virtual, hanya digunakan dalam skenario pembuatan dan tidak diizinkan untuk berubah sekali diatur. Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Untuk informasi selengkapnya, lihat host khusus Azure.
properties.kubeletConfig	KubeletConfig		Konfigurasi Kubelet pada simpul kumpulan agen.
properties.kubeletDiskType	KubeletDiskType		Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.
properties.linuxOSConfig	LinuxOSConfig		Konfigurasi OS simpul agen Linux.
properties.localDNSProfile	LocalDNSProfile		Mengonfigurasi DNS lokal per simpul, dengan penggantian VnetDNS dan KubeDNS. LocalDNS membantu meningkatkan performa dan keandalan resolusi DNS dalam kluster AKS. Untuk detail selengkapnya, lihat aka.ms/aks/localdns.
properties.maxCount	integer (int32)		Jumlah maksimum simpul untuk penskalaan otomatis
properties.maxPods	integer (int32)		Jumlah maksimum pod yang dapat berjalan pada simpul.
properties.messageOfTheDay	string		Pesan hari ini untuk simpul Linux, dikodekan base64. String yang dikodekan base64 yang akan ditulis ke /etc/motd setelah decoding. Ini memungkinkan penyesuaian pesan hari itu untuk simpul Linux. Ini tidak boleh ditentukan untuk simpul Windows. Ini harus berupa string statis (yaitu, akan dicetak mentah dan tidak dijalankan sebagai skrip).
properties.minCount	integer (int32)		Jumlah minimum simpul untuk penskalaan otomatis
properties.mode	AgentPoolMode		Mode kumpulan agen. Kluster harus memiliki setidaknya satu Kumpulan Agen 'Sistem' setiap saat. Untuk informasi tambahan tentang pembatasan dan praktik terbaik kumpulan agen, lihat: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile	AgentPoolNetworkProfile		Pengaturan terkait jaringan kumpulan agen.
properties.nodeImageVersion	string		Versi gambar simpul
properties.nodeLabels	object		Label node yang akan dipertahankan di semua simpul di kumpulan agen.
properties.nodePublicIPPrefixID	string (arm-id)		ID awalan IP publik tempat simpul VM harus menggunakan IP. Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints	string[]		Taint ditambahkan ke simpul baru selama pembuatan dan skala kumpulan simpul. Misalnya, key=value:NoSchedule.
properties.orchestratorVersion	string		Versi Kubernetes yang ditentukan oleh pengguna. Kedua versi patch <> major.minor.patch (misalnya 1.20.13) dan <> major.minor (misalnya 1,20) didukung. Ketika <> major.minor ditentukan, versi patch GA terbaru yang didukung dipilih secara otomatis. Memperbarui kluster dengan <> major.minor yang sama setelah dibuat (misalnya 1.14.x -> 1.14) tidak akan memicu peningkatan, bahkan jika versi patch yang lebih baru tersedia. Sebagai praktik terbaik, Anda harus meningkatkan semua kumpulan simpul dalam kluster AKS ke versi Kubernetes yang sama. Versi kumpulan simpul harus memiliki versi utama yang sama dengan sarana kontrol. Versi minor kumpulan simpul harus dalam dua versi minor dari versi sarana kontrol. Versi kumpulan simpul tidak boleh lebih besar dari versi sarana kontrol. Untuk informasi selengkapnya, lihat meningkatkan kumpulan simpul.
properties.osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Ukuran Disk OS dalam GB yang akan digunakan untuk menentukan ukuran disk untuk setiap komputer di kumpulan master/agen. Jika Anda menentukan 0, itu akan menerapkan ukuran osDisk default sesuai dengan vmSize yang ditentukan.
properties.osDiskType	OSDiskType		Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen. Defaultnya adalah 'Ephemeral' jika VM mendukungnya dan memiliki disk cache yang lebih besar dari OSDiskSizeGB yang diminta. Jika tidak, default ke 'Terkelola'. Mungkin tidak diubah setelah pembuatan. Untuk informasi selengkapnya, lihatOS Ephemeral .
properties.osSKU	OSSKU		Menentukan SKU OS yang digunakan oleh kumpulan agen. Defaultnya adalah Ubuntu jika OSType adalah Linux. Defaultnya adalah Windows2019 ketika Kubernetes <= 1.24 atau Windows2022 ketika Kubernetes >= 1,25 jika OSType adalah Windows.
properties.osType	OSType	Linux	Jenis sistem operasi. Defaultnya adalah Linux.
properties.podIPAllocationMode	PodIPAllocationMode		Mode Alokasi IP Pod. Mode alokasi IP untuk pod di kumpulan agen. Harus digunakan dengan podSubnetId. Defaultnya adalah 'DynamicIndividual'.
properties.podSubnetID	string (arm-id)		ID subnet yang akan bergabung dengan pod saat diluncurkan. Jika dihilangkan, IP pod secara statis ditetapkan pada subnet simpul (lihat vnetSubnetID untuk detail selengkapnya). Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState	PowerState		Apakah Kumpulan Agen sedang berjalan atau dihentikan. Ketika Kumpulan Agen pertama kali dibuat, kumpulan tersebut awalnya Berjalan. Kumpulan Agen dapat dihentikan dengan mengatur bidang ini ke Dihentikan. Kumpulan Agen yang dihentikan menghentikan semua VM-nya dan tidak dikenakan biaya penagihan. Kumpulan Agen hanya dapat dihentikan jika sedang Berjalan dan status provisi Berhasil
properties.provisioningState	string		Status penyebaran atau provisi saat ini.
properties.proximityPlacementGroupID	string (arm-id)		ID untuk Grup Penempatan Kedekatan.
properties.scaleDownMode	ScaleDownMode		Mode penurunan skala yang akan digunakan saat menskalakan Kumpulan Agen. Ini juga berdampak pada perilaku autoscaler kluster. Jika tidak ditentukan, defaultnya adalah Hapus.
properties.scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	Kebijakan pengeluaran Set Skala Komputer Virtual yang akan digunakan. Ini tidak dapat ditentukan kecuali scaleSetPriority adalah 'Spot'. Jika tidak ditentukan, defaultnya adalah 'Hapus'.
properties.scaleSetPriority	ScaleSetPriority	Regular	Prioritas Set Skala Komputer Virtual. Jika tidak ditentukan, defaultnya adalah 'Reguler'.
properties.securityProfile	AgentPoolSecurityProfile		Pengaturan keamanan kumpulan agen.
properties.spotMaxPrice	number	-1	Harga maksimum (dalam Dolar AS) yang bersedia Anda bayar untuk instans spot. Nilai yang mungkin adalah nilai desimal apa pun yang lebih besar dari nol atau -1 yang menunjukkan harga default up-to sesuai permintaan. Nilai yang mungkin adalah nilai desimal apa pun yang lebih besar dari nol atau -1 yang menunjukkan kesediaan untuk membayar harga sesuai permintaan. Untuk detail selengkapnya tentang harga spot, lihat harga VM spot
properties.status	AgentPoolStatus		Berisi informasi baca-saja tentang Kumpulan Agen.
properties.tags	object		Tag yang akan dipertahankan pada kumpulan agen set skala komputer virtual.
properties.type	AgentPoolType		Jenis Kumpulan Agen.
properties.upgradeSettings	AgentPoolUpgradeSettings		Pengaturan untuk memutakhirkan agentpool
properties.virtualMachineNodesStatus	VirtualMachineNodes[]		Status simpul dalam kumpulan agen VirtualMachines.
properties.virtualMachinesProfile	VirtualMachinesProfile		Spesifikasi tentang kumpulan agen VirtualMachines.
properties.vmSize	string		Ukuran VM kumpulan agen. Ketersediaan ukuran VM bervariasi menurut wilayah. Jika sebuah simpul berisi sumber daya komputasi (memori, cpu, dll) pod yang tidak memadai mungkin gagal berjalan dengan benar. Untuk detail selengkapnya tentang ukuran VM terbatas, lihat: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID	string (arm-id)		ID subnet simpul kumpulan agen dan pod opsional akan bergabung pada startup. Jika ini tidak ditentukan, VNET dan subnet akan dihasilkan dan digunakan. Jika tidak ada podSubnetID yang ditentukan, ini berlaku untuk simpul dan pod, jika tidak, pod tersebut hanya berlaku untuk simpul. Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile	AgentPoolWindowsProfile		Profil spesifik kumpulan agen Windows.
properties.workloadRuntime	WorkloadRuntime		Menentukan jenis beban kerja yang dapat dijalankan simpul.
type	string		Jenis sumber daya

AgentPoolGatewayProfile

Objek

Profil kumpulan agen gateway kluster terkelola.

Nama	Jenis	Nilai default	Deskripsi
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 31	31	Kumpulan agen Gateway mengaitkan satu IPPrefix publik untuk setiap gateway keluar statis untuk menyediakan jalan keluar publik. Ukuran IPPrefix Publik harus dipilih oleh pengguna. Setiap simpul di kumpulan agen ditetapkan dengan satu IP dari IPPrefix. Dengan demikian, ukuran IPPrefix berfungsi sebagai batas pada ukuran kumpulan agen Gateway. Karena batasan ukuran IPPrefix publik Azure, rentang nilai yang valid adalah [28, 31] (/31 = 2 node/IP, /30 = 4 node/IP, /29 = 8 node/IP, /28 = 16 node/IP). Nilai defaultnya adalah 31.

AgentPoolMode

Enumerasi

Mode kumpulan agen. Kluster harus memiliki setidaknya satu Kumpulan Agen 'Sistem' setiap saat. Untuk informasi tambahan tentang pembatasan dan praktik terbaik kumpulan agen, lihat: https://docs.microsoft.com/azure/aks/use-system-pools

Nilai	Deskripsi
System	Kumpulan agen sistem terutama untuk menghosting pod sistem penting seperti CoreDNS dan metrics-server. Kumpulan agen sistem osType harus Linux. SKU VM kumpulan agen sistem harus memiliki setidaknya 2vCPU dan memori 4GB.
User	Kumpulan agen pengguna terutama untuk menghosting pod aplikasi Anda.
Gateway	Kumpulan agen gateway didedikasikan untuk menyediakan IP keluar statis ke pod. Untuk detail lebih lanjut, lihat https://aka.ms/aks/static-egress-gateway.

AgentPoolNetworkProfile

Objek

Pengaturan jaringan kumpulan agen.

Nama	Jenis	Deskripsi
allowedHostPorts	PortRange[]	Rentang port yang diizinkan untuk diakses. Rentang yang ditentukan diizinkan untuk tumpang tindih.
applicationSecurityGroups	string[] (arm-id)	ID grup keamanan aplikasi yang akan dikaitkan dengan kumpulan agen saat dibuat.
nodePublicIPTags	IPTag[]	IPTag IP publik tingkat instans.

AgentPoolSecurityProfile

Objek

Pengaturan keamanan kumpulan agen.

Nama	Jenis	Deskripsi
enableSecureBoot	boolean	Boot Aman adalah fitur Peluncuran Tepercaya yang memastikan bahwa hanya sistem operasi dan driver yang ditandatangani yang dapat melakukan booting. Untuk detail selengkapnya, lihat aka.ms/aks/trustedlaunch. Jika tidak ditentukan, defaultnya adalah false.
enableVTPM	boolean	vTPM adalah fitur Peluncuran Tepercaya untuk mengonfigurasi brankas aman khusus untuk kunci dan pengukuran yang disimpan secara lokal pada simpul. Untuk detail selengkapnya, lihat aka.ms/aks/trustedlaunch. Jika tidak ditentukan, defaultnya adalah false.
sshAccess	AgentPoolSSHAccess	Metode akses SSH dari kumpulan agen.

AgentPoolSSHAccess

Enumerasi

Metode akses SSH dari kumpulan agen.

Nilai	Deskripsi
LocalUser	Dapatkah SSH ke simpul sebagai pengguna lokal menggunakan kunci privat.
Disabled	Layanan SSH akan dinonaktifkan pada simpul.

AgentPoolStatus

Objek

Berisi informasi baca-saja tentang Kumpulan Agen.

Nama	Jenis	Deskripsi
provisioningError	ErrorDetail	Informasi detail kesalahan kumpulan agen. Mempertahankan info terperinci tentang kegagalan. Jika tidak ada kesalahan, bidang ini dihilangkan.

AgentPoolType

Enumerasi

Jenis Kumpulan Agen.

Nilai	Deskripsi
VirtualMachineScaleSets	Buat Kumpulan Agen yang didukung oleh Set Skala Komputer Virtual.
AvailabilitySet	Penggunaan ini sangat tidak dianjurkan.
VirtualMachines	Buat Kumpulan Agen yang didukung oleh mode orkestrasi VM Instans Tunggal.

AgentPoolUpgradeSettings

Objek

Pengaturan untuk memutakhirkan agentpool

Nama	Jenis	Deskripsi
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	Batas waktu pengurasan untuk node. Jumlah waktu (dalam menit) untuk menunggu pengeluaran pod dan penghentian anggun per simpul. Waktu tunggu pengeluaran ini menghormati menunggu anggaran gangguan pod. Jika waktu ini terlampaui, peningkatan gagal. Jika tidak ditentukan, defaultnya adalah 30 menit.
maxSurge	string	Jumlah maksimum atau persentase simpul yang melonjak selama peningkatan. Ini dapat diatur ke bilangan bulat (misalnya '5') atau persentase (misalnya ' 50%'). Jika persentase ditentukan, persentase dari total ukuran kumpulan agen pada saat peningkatan. Untuk persentase, simpul pecahan dibulatkan ke atas. Jika tidak ditentukan, defaultnya adalah 10%. Untuk informasi selengkapnya, termasuk praktik terbaik, lihat: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable	string	Jumlah maksimum atau persentase simpul yang secara bersamaan tidak tersedia selama peningkatan. Ini dapat diatur ke bilangan bulat (misalnya '1') atau persentase (misalnya '5%'). Jika persentase ditentukan, persentase dari total ukuran kumpulan agen pada saat peningkatan. Untuk persentase, simpul pecahan dibulatkan ke atas. Jika tidak ditentukan, defaultnya adalah 0. Untuk informasi selengkapnya, termasuk praktik terbaik, lihat: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes	integer (int32) minimum: 0 maximum: 30	Durasi perendaman untuk node. Jumlah waktu (dalam menit) untuk menunggu setelah menguras simpul dan sebelum menggantinya dan beralih ke simpul berikutnya. Jika tidak ditentukan, defaultnya adalah 0 menit.
undrainableNodeBehavior	UndrainableNodeBehavior	Menentukan perilaku untuk simpul yang tidak dapat dibatalkan selama peningkatan. Penyebab paling umum dari simpul yang tidak dapat dibatalkan adalah Anggaran Gangguan Pod (PDB), tetapi masalah lain, seperti masa tenggang penghentian pod melebihi batas waktu pengurasan per node yang tersisa atau pod masih dalam keadaan berjalan, juga dapat menyebabkan simpul yang tidak dapat dibatalkan.

AgentPoolWindowsProfile

Objek

Profil spesifik kumpulan agen Windows.

Nama	Jenis	Deskripsi
disableOutboundNat	boolean	Apakah akan menonaktifkan OutboundNAT di simpul windows. Nilai defaultnya adalah false. NAT keluar hanya dapat dinonaktifkan jika outboundType kluster adalah NAT Gateway dan kumpulan agen Windows tidak mengaktifkan IP publik node.

code

Enumerasi

Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan

Nilai	Deskripsi
Running	Kluster sedang berjalan.
Stopped	Kluster dihentikan.

CreationData

Objek

Data yang digunakan saat membuat sumber daya target dari sumber daya sumber.

Nama	Jenis	Deskripsi
sourceResourceId	string (arm-id)	Ini adalah ID ARM dari objek sumber yang akan digunakan untuk membuat objek target.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

GPUDriver

Enumerasi

Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.

Nilai	Deskripsi
Install	Instal driver.
None	Lewati penginstalan driver.

GPUInstanceProfile

Enumerasi

GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.

Nilai	Deskripsi
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Objek

Pengaturan GPU untuk Kumpulan Agen.

Nama	Jenis	Deskripsi
driver	GPUDriver	Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.

IPTag

Objek

Berisi IPTag yang terkait dengan objek .

Nama	Jenis	Deskripsi
ipTagType	string	Jenis tag IP. Contoh: RoutingPreference.
tag	string	Nilai tag IP yang terkait dengan IP publik. Contoh: Internet.

KubeletConfig

Objek

Konfigurasi kubelet simpul agen. Lihat konfigurasi node kustom AKS untuk detail selengkapnya.

Nama	Jenis	Deskripsi
allowedUnsafeSysctls	string[]	Daftar sysctl yang tidak aman atau pola sysctl yang tidak aman (berakhiran `*`).
containerLogMaxFiles	integer (int32) minimum: 2	Jumlah maksimum file log kontainer yang dapat ada untuk kontainer. Angka harus ≥ 2.
containerLogMaxSizeMB	integer (int32)	Ukuran maksimum (misalnya 10Mi) file log kontainer sebelum diputar.
cpuCfsQuota	boolean	Jika pemberlakuan kuota CPU CFS diaktifkan untuk kontainer yang menentukan batas CPU. Nilai bawaan adalah benar.
cpuCfsQuotaPeriod	string	Nilai periode kuota CPU CFS. Defaultnya adalah '100ms.' Nilai yang valid adalah urutan angka desimal dengan pecahan opsional dan akhiran unit. Misalnya: '300ms', '2h45m'. Unit yang didukung adalah 'ns', 'us', 'ms', 's', 'm', dan 'h'.
cpuManagerPolicy	string	Kebijakan Manajer CPU yang akan digunakan. Defaultnya adalah 'none'. Lihat Kebijakan manajemen CPU Kubernetes untuk informasi selengkapnya. Nilai yang diizinkan adalah 'none' dan 'statis'.
failSwapOn	boolean	Jika diatur ke true, itu akan membuat Kubelet gagal memulai jika pertukaran diaktifkan pada simpul.
imageGcHighThreshold	integer (int32)	Persentase penggunaan disk setelah pengumpulan sampah gambar selalu dijalankan. Untuk menonaktifkan pengumpulan sampah gambar, atur ke 100. Defaultnya adalah 85%
imageGcLowThreshold	integer (int32)	Persentase penggunaan disk sebelum pengumpulan sampah gambar tidak pernah dijalankan. Ini tidak dapat diatur lebih tinggi dari imageGcHighThreshold. Defaultnya adalah 80%
podMaxPids	integer (int32)	Jumlah maksimum proses per pod.
topologyManagerPolicy	string	Kebijakan Manajer Topologi yang akan digunakan. Untuk informasi selengkapnya, lihat Manajer Topologi Kubernetes. Defaultnya adalah 'none'. Nilai yang diizinkan adalah 'none', 'best-effort', 'restricted', dan 'single-numa-node'.

KubeletDiskType

Enumerasi

Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.

Nilai	Deskripsi
OS	Kubelet akan menggunakan disk OS untuk datanya.
Temporary	Kubelet akan menggunakan disk sementara untuk datanya.

LinuxOSConfig

Objek

Konfigurasi OS simpul agen Linux. Lihat konfigurasi node kustom AKS untuk detail selengkapnya.

Nama	Jenis	Deskripsi
swapFileSizeMB	integer (int32)	Ukuran dalam MB file swap yang akan dibuat pada setiap simpul.
sysctls	SysctlConfig	Pengaturan Sysctl untuk simpul agen Linux.
transparentHugePageDefrag	string	Apakah kernel harus menggunakan pemadatan memori yang agresif untuk membuat lebih banyak halaman yang tersedia. Nilai yang valid adalah 'always', 'defer', 'defer+madvise', 'madvise' dan 'never'. Defaultnya adalah 'madvise'. Untuk informasi selengkapnya, lihat Transparent Hugepages.
transparentHugePageEnabled	string	Apakah halaman besar transparan diaktifkan. Nilai yang valid adalah 'always', 'madvise', dan 'never'. Defaultnya adalah 'always'. Untuk informasi selengkapnya, lihat Transparent Hugepages.

LocalDNSForwardDestination

Enumerasi

Server tujuan untuk kueri DNS yang akan diteruskan dari localDNS.

Nilai	Deskripsi
ClusterCoreDNS	Teruskan kueri DNS dari localDNS ke kluster CoreDNS.
VnetDNS	Teruskan kueri DNS dari localDNS ke server DNS yang dikonfigurasi di VNET. VNET dapat memiliki beberapa server DNS yang dikonfigurasi.

LocalDNSForwardPolicy

Enumerasi

Meneruskan kebijakan untuk memilih server DNS hulu. Lihat plugin forward untuk informasi lebih lanjut.

Nilai	Deskripsi
Sequential	Mengimplementasikan pemilihan server DNS hulu berurutan. Lihat plugin forward untuk informasi lebih lanjut.
RoundRobin	Mengimplementasikan pemilihan server DNS hulu round robin. Lihat plugin forward untuk informasi lebih lanjut.
Random	Mengimplementasikan pemilihan server DNS hulu acak. Lihat plugin forward untuk informasi lebih lanjut.

LocalDNSMode

Enumerasi

Mode pemberdayaan untuk localDNS.

Nilai	Deskripsi
Preferred	Jika versi orkestrator saat ini mendukung fitur ini, lebih suka mengaktifkan localDNS.
Required	Aktifkan localDNS.
Disabled	Nonaktifkan localDNS.

LocalDNSOverride

Objek

Penggantian untuk profil localDNS.

Nama	Jenis	Nilai default	Deskripsi
cacheDurationInSeconds	integer (int32)	3600	Cache TTL maks dalam hitungan detik. Lihat plugin cache untuk informasi selengkapnya.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Server tujuan untuk kueri DNS yang akan diteruskan dari localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Meneruskan kebijakan untuk memilih server DNS hulu. Lihat plugin forward untuk informasi lebih lanjut.
maxConcurrent	integer (int32)	1000	Jumlah maksimum kueri bersamaan. Lihat plugin forward untuk informasi lebih lanjut.
protocol	LocalDNSProtocol	PreferUDP	Terapkan TCP atau pilih protokol UDP untuk koneksi dari localDNS ke server DNS hulu.
queryLogging	LocalDNSQueryLogging	Error	Tingkat log untuk kueri DNS di localDNS.
serveStale	LocalDNSServeStale	Immediate	Kebijakan untuk menyajikan data kedaluwarsa. Lihat plugin cache untuk informasi selengkapnya.
serveStaleDurationInSeconds	integer (int32)	3600	Sajikan durasi basi dalam hitungan detik. Lihat plugin cache untuk informasi selengkapnya.

LocalDNSProfile

Objek

Mengonfigurasi DNS lokal per simpul, dengan penggantian VnetDNS dan KubeDNS. LocalDNS membantu meningkatkan performa dan keandalan resolusi DNS dalam kluster AKS. Untuk detail selengkapnya, lihat aka.ms/aks/localdns.

Nama	Jenis	Nilai default	Deskripsi
kubeDNSOverrides	<string, LocalDNSOverride>		Penggantian KubeDNS berlaku untuk lalu lintas DNS dari pod dengan dnsPolicy:ClusterFirst (disebut sebagai lalu lintas KubeDNS).
mode	LocalDNSMode	Preferred	Mode pemberdayaan untuk localDNS.
state	LocalDNSState		Status localDNS yang dihasilkan sistem.
vnetDNSOverrides	<string, LocalDNSOverride>		Penggantian VnetDNS berlaku untuk lalu lintas DNS dari pod dengan dnsPolicy:default atau kubelet (disebut sebagai lalu lintas VnetDNS).

LocalDNSProtocol

Enumerasi

Terapkan TCP atau pilih protokol UDP untuk koneksi dari localDNS ke server DNS hulu.

Nilai	Deskripsi
PreferUDP	Lebih suka protokol UDP untuk koneksi dari localDNS ke server DNS hulu.
ForceTCP	Terapkan protokol TCP untuk koneksi dari localDNS ke server DNS hulu.

LocalDNSQueryLogging

Enumerasi

Tingkat log untuk kueri DNS di localDNS.

Nilai	Deskripsi
Error	Mengaktifkan pengelogan kesalahan di localDNS. Lihat plugin error untuk informasi selengkapnya.
Log	Mengaktifkan pengelogan kueri di localDNS. Lihat plugin log untuk informasi selengkapnya.

LocalDNSServeStale

Enumerasi

Kebijakan untuk menyajikan data kedaluwarsa. Lihat plugin cache untuk informasi selengkapnya.

Nilai	Deskripsi
Verify	Menyajikan data kedaluwarsa dengan verifikasi. Pertama-tama verifikasi bahwa entri masih tidak tersedia dari sumber sebelum mengirim entri kedaluwarsa ke klien. Lihat plugin cache untuk informasi selengkapnya.
Immediate	Segera sajikan data kedaluwarsa. Kirim entri kedaluwarsa ke klien sebelum memeriksa untuk melihat apakah entri tersedia dari sumber. Lihat plugin cache untuk informasi selengkapnya.
Disable	Nonaktifkan penayangan data kedaluwarsa.

LocalDNSState

Enumerasi

Status localDNS yang dihasilkan sistem.

Nilai	Deskripsi
Enabled	localDNS diaktifkan.
Disabled	localDNS dinonaktifkan.

ManualScaleProfile

Objek

Spesifikasi pada jumlah komputer.

Nama	Jenis	Deskripsi
count	integer (int32)	Jumlah simpul.
size	string	Ukuran VM yang akan digunakan AKS saat membuat dan menskalakan misalnya 'Standard_E4s_v3', 'Standard_E16s_v3' atau 'Standard_D16s_v5'.

OSDiskType

Enumerasi

Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen. Defaultnya adalah 'Ephemeral' jika VM mendukungnya dan memiliki disk cache yang lebih besar dari OSDiskSizeGB yang diminta. Jika tidak, default ke 'Terkelola'. Mungkin tidak diubah setelah pembuatan. Untuk informasi selengkapnya, lihatOS Ephemeral .

Nilai	Deskripsi
Managed	Azure mereplikasi disk sistem operasi untuk komputer virtual ke penyimpanan Azure untuk menghindari kehilangan data jika VM perlu dipindahkan ke host lain. Karena kontainer tidak dirancang agar status lokal tetap ada, perilaku ini menawarkan nilai terbatas sambil memberikan beberapa kelemahan, termasuk provisi simpul yang lebih lambat dan latensi baca/tulis yang lebih tinggi.
Ephemeral	Disk OS sementara hanya disimpan di mesin host, seperti disk sementara. Ini memberikan latensi baca/tulis yang lebih rendah, bersama dengan penskalaan node dan peningkatan kluster yang lebih cepat.

OSSKU

Enumerasi

Menentukan SKU OS yang digunakan oleh kumpulan agen. Defaultnya adalah Ubuntu jika OSType adalah Linux. Defaultnya adalah Windows2019 ketika Kubernetes <= 1.24 atau Windows2022 ketika Kubernetes >= 1,25 jika OSType adalah Windows.

Nilai	Deskripsi
AzureLinux	Gunakan AzureLinux sebagai OS untuk gambar simpul. Azure Linux adalah distro Linux yang dioptimalkan kontainer yang dibangun oleh Microsoft, kunjungi https://aka.ms/azurelinux untuk informasi selengkapnya.
AzureLinux3	Gunakan AzureLinux3 sebagai OS untuk gambar simpul. Azure Linux adalah distro Linux yang dioptimalkan kontainer yang dibangun oleh Microsoft, kunjungi https://aka.ms/azurelinux untuk informasi selengkapnya. Untuk batasan, kunjungi https://aka.ms/aks/node-images. Untuk panduan migrasi OS, lihat https://aka.ms/aks/upgrade-os-version.
CBLMariner	OSSKU yang tidak digunakan lagi. Microsoft menyarankan agar penyebaran baru memilih 'AzureLinux' sebagai gantinya.
Ubuntu	Gunakan Ubuntu sebagai OS untuk gambar simpul.
Ubuntu2204	Gunakan Ubuntu2204 sebagai OS untuk gambar node, namun, Ubuntu 22.04 mungkin tidak didukung untuk semua nodepool. Untuk batasan dan versi kubernetes yang didukung, lihat https://aka.ms/aks/supported-ubuntu-versions
Ubuntu2404	Gunakan Ubuntu2404 sebagai OS untuk gambar node, namun, Ubuntu 24.04 mungkin tidak didukung untuk semua nodepool. Untuk batasan dan versi kubernetes yang didukung, lihat https://aka.ms/aks/supported-ubuntu-versions
Windows2019	Gunakan Windows2019 sebagai OS untuk gambar simpul. Tidak didukung untuk kumpulan simpul sistem. Windows2019 hanya mendukung kontainer Windows2019; ini tidak dapat menjalankan kontainer Windows2022 dan sebaliknya.
Windows2022	Gunakan Windows2022 sebagai OS untuk gambar simpul. Tidak didukung untuk kumpulan simpul sistem. Windows2022 hanya mendukung kontainer Windows2022; ini tidak dapat menjalankan kontainer Windows2019 dan sebaliknya.

OSType

Enumerasi

Jenis sistem operasi. Defaultnya adalah Linux.

Nilai	Deskripsi
Linux	Gunakan Linux.
Windows	Gunakan Windows.

PodIPAllocationMode

Enumerasi

Mode Alokasi IP Pod. Mode alokasi IP untuk pod di kumpulan agen. Harus digunakan dengan podSubnetId. Defaultnya adalah 'DynamicIndividual'.

Nilai

Deskripsi

DynamicIndividual

Setiap node dialokasikan dengan daftar alamat IP yang tidak berdekatan yang dapat ditetapkan ke pod. Ini lebih baik untuk memaksimalkan subnet kecil hingga menengah berukuran /16 atau lebih kecil. Kluster Azure CNI dengan alokasi IP dinamis default ke mode ini jika pelanggan tidak secara eksplisit menentukan podIPAllocationMode

StaticBlock

Setiap node dialokasikan secara statis blok CIDR dengan ukuran /28 = 16 IP per blok untuk memenuhi maxPods per node. Jumlah blok CIDR >= (maxPods / 16). Blok, bukan satu IP, dihitung terhadap batas IP Privat Azure Vnet sebesar 65K. Oleh karena itu, mode blok cocok untuk menjalankan beban kerja yang lebih besar dengan lebih dari batas 65K pod saat ini dalam kluster. Mode ini lebih cocok untuk diskalakan dengan subnet /15 yang lebih besar atau lebih besar

PortRange

Objek

Rentang port.

Nama	Jenis	Deskripsi
portEnd	integer (int32) minimum: 1 maximum: 65535	Port maksimum yang disertakan dalam rentang. Ini harus berkisar dari 1 hingga 65535, dan lebih besar dari atau sama dengan portStart.
portStart	integer (int32) minimum: 1 maximum: 65535	Port minimum yang disertakan dalam rentang. Ini harus berkisar dari 1 hingga 65535, dan kurang dari atau sama dengan portEnd.
protocol	Protocol	Protokol jaringan port.

PowerState

Objek

Menjelaskan Status Daya kluster

Nama	Jenis	Deskripsi
code	code	Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan

Protocol

Enumerasi

Protokol jaringan port.

Nilai	Deskripsi
TCP	Protokol TCP.
UDP	Protokol UDP.

ScaleDownMode

Enumerasi

Menjelaskan bagaimana VM ditambahkan ke atau dihapus dari Kumpulan Agen. Lihat status penagihan.

Nilai	Deskripsi
Delete	Buat instans baru selama peningkatan skala dan hapus instans selama penurunan skala.
Deallocate	Cobalah untuk memulai instans yang dibatalkan alokasi (jika ada) selama peningkatan skala dan membatalkan alokasi instans selama penurunan skala.

ScaleProfile

Objek

Spesifikasi tentang cara menskalakan kumpulan agen VirtualMachines.

Nama	Jenis	Deskripsi
manual	ManualScaleProfile[]	Spesifikasi tentang cara menskalakan kumpulan agen VirtualMachines ke ukuran tetap.

ScaleSetEvictionPolicy

Enumerasi

Kebijakan penggusuran Set Skala Komputer Virtual. Kebijakan penggusuran menentukan apa yang harus dilakukan dengan VM saat diusir. Defaultnya adalah Hapus. Untuk informasi selengkapnya tentang penggusuran, lihat VM spot

Nilai	Deskripsi
Delete	Node dalam Kumpulan Skala yang mendasari kumpulan node akan dihapus saat diusir.
Deallocate	Node dalam Kumpulan Skala yang mendasari kumpulan simpul diatur ke status dihentikan-dibatalkan alokasi setelah penggusuran. Simpul dalam jumlah status yang dihentikan alokasinya terhadap kuota komputasi Anda dan dapat menyebabkan masalah dengan penskalaan atau peningkatan kluster.

ScaleSetPriority

Enumerasi

Prioritas Set Skala Komputer Virtual.

Nilai	Deskripsi
Spot	VM prioritas spot akan digunakan. Tidak ada SLA untuk simpul spot. Lihat spot di AKS untuk informasi selengkapnya.
Regular	VM biasa akan digunakan.

SysctlConfig

Objek

Pengaturan Sysctl untuk simpul agen Linux.

Nama	Jenis	Deskripsi
fsAioMaxNr	integer (int32)	Pengaturan Sysctl fs.aio-max-nr.
fsFileMax	integer (int32)	Pengaturan Sysctl fs.file-max.
fsInotifyMaxUserWatches	integer (int32)	Pengaturan Sysctl fs.inotify.max_user_watches.
fsNrOpen	integer (int32)	Pengaturan Sysctl fs.nr_open.
kernelThreadsMax	integer (int32)	Pengaturan Sysctl kernel.threads-max.
netCoreNetdevMaxBacklog	integer (int32)	Pengaturan Sysctl net.core.netdev_max_backlog.
netCoreOptmemMax	integer (int32)	Pengaturan Sysctl net.core.optmem_max.
netCoreRmemDefault	integer (int32)	Pengaturan Sysctl net.core.rmem_default.
netCoreRmemMax	integer (int32)	Pengaturan Sysctl net.core.rmem_max.
netCoreSomaxconn	integer (int32)	Pengaturan Sysctl net.core.somaxconn.
netCoreWmemDefault	integer (int32)	Pengaturan Sysctl net.core.wmem_default.
netCoreWmemMax	integer (int32)	Pengaturan Sysctl net.core.wmem_max.
netIpv4IpLocalPortRange	string	Pengaturan Sysctl net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1	integer (int32)	Pengaturan Sysctl net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2	integer (int32)	Pengaturan Sysctl net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3	integer (int32)	Pengaturan Sysctl net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout	integer (int32)	Pengaturan Sysctl net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes	integer (int32)	Pengaturan Sysctl net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime	integer (int32)	Pengaturan Sysctl net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog	integer (int32)	Pengaturan Sysctl net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets	integer (int32)	Pengaturan Sysctl net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse	boolean	Pengaturan Sysctl net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl	integer (int32) minimum: 10 maximum: 90	Pengaturan Sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Pengaturan Sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 2097152	Pengaturan Sysctl net.netfilter.nf_conntrack_max.
vmMaxMapCount	integer (int32)	Pengaturan Sysctl vm.max_map_count.
vmSwappiness	integer (int32)	Pengaturan Sysctl vm.swappiness.
vmVfsCachePressure	integer (int32)	Pengaturan Sysctl vm.vfs_cache_pressure.

UndrainableNodeBehavior

Enumerasi

Menentukan perilaku untuk simpul yang tidak dapat dibatalkan selama peningkatan. Penyebab paling umum dari simpul yang tidak dapat dibatalkan adalah Anggaran Gangguan Pod (PDB), tetapi masalah lain, seperti masa tenggang penghentian pod melebihi batas waktu pengurasan per node yang tersisa atau pod masih dalam keadaan berjalan, juga dapat menyebabkan simpul yang tidak dapat dibatalkan.

Nilai

Deskripsi

Schedule

AKS akan menandai simpul yang diblokir dapat dijadwalkan, tetapi simpul yang diblokir tidak ditingkatkan. Upaya terbaik akan dilakukan untuk menghapus semua simpul lonjakan. Operasi peningkatan dan kluster terkelola akan dalam status gagal jika ada simpul yang diblokir.

Cordon

AKS akan mengikat node yang diblokir dan menggantinya dengan node lonjakan selama peningkatan. Simpul yang diblokir akan disambungkan dan digantikan oleh node lonjakan. Simpul yang diblokir akan memiliki label 'kubernetes.azure.com/upgrade-status:Quarantined'. Simpul lonjakan akan dipertahankan untuk setiap simpul yang diblokir. Upaya terbaik akan dilakukan untuk menghapus semua simpul lonjakan lainnya. Jika ada cukup node lonjakan untuk menggantikan simpul yang diblokir, maka operasi peningkatan dan kluster terkelola akan dalam status gagal. Jika tidak, operasi peningkatan dan kluster terkelola akan dalam status dibatalkan.

VirtualMachineNodes

Objek

Status saat ini pada sekelompok simpul dengan ukuran vm yang sama.

Nama	Jenis	Deskripsi
count	integer (int32)	Jumlah simpul.
size	string	Ukuran VM agen yang digunakan untuk menghosting grup simpul ini.

VirtualMachinesProfile

Objek

Spesifikasi tentang kumpulan agen VirtualMachines.

Nama	Jenis	Deskripsi
scale	ScaleProfile	Spesifikasi tentang cara menskalakan kumpulan agen VirtualMachines.

WorkloadRuntime

Enumerasi

Menentukan jenis beban kerja yang dapat dijalankan simpul.

Nilai	Deskripsi
OCIContainer	Simpul akan menggunakan Kubelet untuk menjalankan beban kerja kontainer OCI standar.
WasmWasi	Simpul akan menggunakan Krustlet untuk menjalankan beban kerja WASM menggunakan penyedia WASI (Pratinjau).
KataVmIsolation	Node dapat menggunakan (Kata + Cloud Hypervisor + Hyper-V) untuk mengaktifkan pod berbasis VM Bersarang. Karena penggunaan Hyper-V, OS simpul AKS itu sendiri adalah VM berlapis (OS akar) Hyper-V. Dengan demikian hanya dapat digunakan dengan seri VM yang mendukung Virtualisasi Berlapis seperti seri Dv3.