Agent Pools - Create Or Update

Layanan:

AKS

Versi API:

2024-09-01

Membuat atau memperbarui kumpulan agen di kluster terkelola yang ditentukan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
agentPoolName	path	True	string	Nama kumpulan agen. Pola regex: ^[a-z][a-z0-9]{0,11}$
resourceGroupName	path	True	string	Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.
resourceName	path	True	string	Nama sumber daya kluster terkelola. Pola regex: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId	path	True	string uuid	ID langganan target. Nilainya harus UUID.
api-version	query	True	string	Versi API yang akan digunakan untuk operasi ini.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
If-Match		string	Permintaan hanya boleh dilanjutkan jika entitas cocok dengan string ini.
If-None-Match		string	Permintaan hanya boleh dilanjutkan jika tidak ada entitas yang cocok dengan string ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.availabilityZones	string[]	Daftar Zona ketersediaan yang akan digunakan untuk simpul. Ini hanya dapat ditentukan jika properti AgentPoolType adalah 'VirtualMachineScaleSets'.
properties.capacityReservationGroupID	string	ID sumber daya yang sepenuhnya memenuhi syarat dari Grup Reservasi Kapasitas untuk menyediakan komputer virtual dari grup Komputer Virtual yang dipesan. AKS akan mengaitkan kumpulan agen yang ditentukan dengan Grup Reservasi Kapasitas.
properties.count	integer	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.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 game, di mana konsol perlu membuat koneksi langsung ke komputer virtual cloud untuk meminimalkan hop. Untuk informasi selengkapnya, lihat menetapkan IP publik per simpul. Defaultnya adalah false.
properties.enableUltraSSD	boolean	Apakah akan mengaktifkan UltraSSD
properties.gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.
properties.hostGroupID	string	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 simpul agen. 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. Konfigurasi OS simpul agen Linux.
properties.maxCount	integer	Jumlah maksimum simpul untuk penskalaan otomatis
properties.maxPods	integer	Jumlah maksimum pod yang dapat berjalan pada simpul.
properties.minCount	integer	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.nodeLabels	object	Label node yang akan dipertahankan di semua simpul di kumpulan agen.
properties.nodePublicIPPrefixID	string	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	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	Jenis sistem operasi. Defaultnya adalah Linux.
properties.podSubnetID	string	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.proximityPlacementGroupID	string	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	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	Prioritas Set Skala Komputer Virtual. Jika tidak ditentukan, defaultnya adalah 'Reguler'.
properties.securityProfile	AgentPoolSecurityProfile	Pengaturan keamanan kumpulan agen.
properties.spotMaxPrice	number	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.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.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	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.

Respons

Nama	Jenis	Deskripsi
200 OK	AgentPool	Kumpulan agen yang ada berhasil diperbarui.
201 Created	AgentPool	Kumpulan agen baru berhasil dibuat.
Other Status Codes	CloudError	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

Create Agent Pool using an agent pool snapshot

Create Agent Pool with Capacity Reservation Group

Create Agent Pool with Dedicated Host Group

Create Agent Pool with EncryptionAtHost enabled

Create Agent Pool with Ephemeral OS Disk

Create Agent Pool with FIPS enabled OS

Create Agent Pool with GPUMIG

Create Agent Pool with Krustlet and the WASI runtime

Create Agent Pool with KubeletConfig and LinuxOSConfig

Create Agent Pool with OSSKU

Create Agent Pool with PPG

Create Agent Pool with UltraSSD enabled

Create Agent Pool with Windows OSSKU

Create Spot Agent Pool

Create Windows Agent Pool with disabling OutboundNAT

Create/Update Agent Pool

Start Agent Pool

Stop Agent Pool

Update Agent Pool

Create Agent Pool using an agent pool snapshot

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Create Agent Pool with Capacity Reservation Group

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Create Agent Pool with Dedicated Host Group

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Create Agent Pool with EncryptionAtHost enabled

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Create Agent Pool with Ephemeral OS Disk

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "osDiskSizeGB": 64
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "osDiskSizeGB": 64
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "kubeletDiskType": "OS",
    "osDiskSizeGB": 64
  }
}

Create Agent Pool with FIPS enabled OS

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableFIPS": true
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true
  }
}

Create Agent Pool with GPUMIG

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "maxPods": 110,
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "maxPods": 110,
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with Krustlet and the WASI runtime

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Create Agent Pool with KubeletConfig and LinuxOSConfig

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with OSSKU

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with PPG

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Create Agent Pool with UltraSSD enabled

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Create Agent Pool with Windows OSSKU

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2?api-version=2024-09-01

{
  "properties": {
    "orchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.23.3",
    "currentOrchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.23.3",
    "currentOrchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Create Spot Agent Pool

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "spotMaxPrice": -1
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "spotMaxPrice": -1
  }
}

Create Windows Agent Pool with disabling OutboundNAT

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2?api-version=2024-09-01

{
  "properties": {
    "orchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.23.8",
    "currentOrchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.23.8",
    "currentOrchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Create/Update Agent Pool

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User"
  }
}

Start Agent Pool

Permintaan sampel

HTTP

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

{
  "properties": {
    "powerState": {
      "code": "Running"
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Starting",
    "count": 50,
    "enableAutoScaling": true,
    "minCount": 3,
    "maxCount": 55,
    "powerState": {
      "code": "Running"
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Starting",
    "count": 50,
    "enableAutoScaling": true,
    "minCount": 3,
    "maxCount": 55,
    "powerState": {
      "code": "Running"
    }
  }
}

Stop Agent Pool

Permintaan sampel

HTTP

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

{
  "properties": {
    "powerState": {
      "code": "Stopped"
    }
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Stopping",
    "count": 0,
    "enableAutoScaling": false,
    "minCount": null,
    "maxCount": null,
    "powerState": {
      "code": "Stopped"
    }
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Stopping",
    "count": 0,
    "enableAutoScaling": false,
    "minCount": null,
    "maxCount": null,
    "powerState": {
      "code": "Stopped"
    }
  }
}

Update Agent Pool

Permintaan sampel

HTTP

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Respon sampel

Kode status:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Kode status:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Updating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Definisi

Nama	Deskripsi
AgentPool	Kumpulan Agen.
AgentPoolMode	Mode kumpulan agen.
AgentPoolNetworkProfile	Pengaturan jaringan kumpulan agen.
AgentPoolSecurityProfile	Pengaturan keamanan kumpulan agen.
AgentPoolType	Jenis Kumpulan Agen.
AgentPoolUpgradeSettings	Pengaturan untuk memutakhirkan agentpool
AgentPoolWindowsProfile	Profil spesifik kumpulan agen Windows.
CloudError	Respons kesalahan dari layanan Kontainer.
CloudErrorBody	Respons kesalahan dari layanan Kontainer.
code	Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan
CreationData	Data yang digunakan saat membuat sumber daya target dari sumber daya sumber.
GPUInstanceProfile	GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.
IPTag	Berisi IPTag yang terkait dengan objek .
KubeletConfig	Konfigurasi kubelet simpul agen.
KubeletDiskType	Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.
LinuxOSConfig	Konfigurasi OS simpul agen Linux.
OSDiskType	Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen.
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.
PortRange	Rentang port.
PowerState	Menjelaskan Status Daya kluster
Protocol	Protokol jaringan port.
ScaleDownMode	Menjelaskan bagaimana VM ditambahkan atau dihapus dari Kumpulan Agen. Lihatstatus penagihan .
ScaleSetEvictionPolicy	Kebijakan pengeluaran Set Skala Komputer Virtual.
ScaleSetPriority	Prioritas Set Skala Komputer Virtual.
SysctlConfig	Pengaturan Sysctl untuk simpul agen Linux.
WorkloadRuntime	Menentukan jenis beban kerja yang dapat dijalankan simpul.

AgentPool

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		ID sumber daya yang sepenuhnya memenuhi syarat dari Grup Reservasi Kapasitas untuk menyediakan komputer virtual dari grup Komputer Virtual yang dipesan. AKS akan mengaitkan kumpulan agen yang ditentukan dengan Grup Reservasi Kapasitas.
properties.count	integer		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 untuk 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 game, di mana konsol perlu membuat koneksi langsung ke komputer virtual cloud untuk meminimalkan hop. Untuk informasi selengkapnya, lihat menetapkan IP publik per simpul. Defaultnya adalah false.
properties.enableUltraSSD	boolean		Apakah akan mengaktifkan UltraSSD
properties.gpuInstanceProfile	GPUInstanceProfile		GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.
properties.hostGroupID	string		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 simpul agen. 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. Konfigurasi OS simpul agen Linux.
properties.maxCount	integer		Jumlah maksimum simpul untuk penskalaan otomatis
properties.maxPods	integer		Jumlah maksimum pod yang dapat berjalan pada simpul.
properties.minCount	integer		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		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		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.podSubnetID	string		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		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.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.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		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

AgentPoolMode

Mode kumpulan agen.

Nama	Jenis	Deskripsi
System	string	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	string	Kumpulan agen pengguna terutama untuk menghosting pod aplikasi Anda.

AgentPoolNetworkProfile

Pengaturan jaringan kumpulan agen.

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

AgentPoolSecurityProfile

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.

AgentPoolType

Jenis Kumpulan Agen.

Nama	Jenis	Deskripsi
AvailabilitySet	string	Penggunaan ini sangat tidak disarankan.
VirtualMachineScaleSets	string	Buat Kumpulan Agen yang didukung oleh Set Skala Komputer Virtual.

AgentPoolUpgradeSettings

Pengaturan untuk memutakhirkan agentpool

Nama	Jenis	Deskripsi
drainTimeoutInMinutes	integer	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 1. Untuk informasi selengkapnya, termasuk praktik terbaik, lihat: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
nodeSoakDurationInMinutes	integer	Durasi rendam 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.

AgentPoolWindowsProfile

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.

CloudError

Respons kesalahan dari layanan Kontainer.

Nama	Jenis	Deskripsi
error	CloudErrorBody	Detail tentang kesalahan.

CloudErrorBody

Respons kesalahan dari layanan Kontainer.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	CloudErrorBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

code

Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan

Nama	Jenis	Deskripsi
Running	string	Kluster sedang berjalan.
Stopped	string	Kluster dihentikan.

CreationData

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

Nama	Jenis	Deskripsi
sourceResourceId	string	Ini adalah ID ARM dari objek sumber yang akan digunakan untuk membuat objek target.

GPUInstanceProfile

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

Nama	Jenis	Deskripsi
MIG1g	string
MIG2g	string
MIG3g	string
MIG4g	string
MIG7g	string

IPTag

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

Konfigurasi kubelet simpul agen.

Nama	Jenis	Deskripsi
allowedUnsafeSysctls	string[]	Daftar sysctl yang tidak aman atau pola sysctl yang tidak aman (berakhiran *).
containerLogMaxFiles	integer	Jumlah maksimum file log kontainer yang dapat ada untuk kontainer. Angka harus ≥ 2.
containerLogMaxSizeMB	integer	Ukuran maksimum (misalnya 10Mi) file log kontainer sebelum diputar.
cpuCfsQuota	boolean	Jika pemberlakuan kuota CPU CFS diaktifkan untuk kontainer yang menentukan batas CPU. Defaultnya adalah true.
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	Persentase penggunaan disk setelah pengumpulan sampah gambar selalu dijalankan. Untuk menonaktifkan pengumpulan sampah gambar, atur ke 100. Defaultnya adalah 85%
imageGcLowThreshold	integer	Persentase penggunaan disk sebelum pengumpulan sampah gambar tidak pernah dijalankan. Ini tidak dapat diatur lebih tinggi dari imageGcHighThreshold. Defaultnya adalah 80%
podMaxPids	integer	Jumlah maksimum proses per pod.
topologyManagerPolicy	string	Kebijakan Manajer Topologi yang akan digunakan. Untuk informasi selengkapnya, lihat Kubernetes Topology Manager. Defaultnya adalah 'none'. Nilai yang diizinkan adalah 'none', 'best-effort', 'restricted', dan 'single-numa-node'.

KubeletDiskType

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

Nama	Jenis	Deskripsi
OS	string	Kubelet akan menggunakan disk OS untuk datanya.
Temporary	string	Kubelet akan menggunakan disk sementara untuk datanya.

LinuxOSConfig

Konfigurasi OS simpul agen Linux.

Nama	Jenis	Deskripsi
swapFileSizeMB	integer	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.

OSDiskType

Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen.

Nama	Jenis	Deskripsi
Ephemeral	string	Disk OS sementara hanya disimpan di komputer host, sama seperti disk sementara. Ini memberikan latensi baca/tulis yang lebih rendah, bersama dengan penskalaan node dan peningkatan kluster yang lebih cepat.
Managed	string	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.

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.

Nama	Jenis	Deskripsi
AzureLinux	string	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.
CBLMariner	string	OSSKU yang tidak digunakan lagi. Microsoft menyarankan agar penyebaran baru memilih 'AzureLinux' sebagai gantinya.
Ubuntu	string	Gunakan Ubuntu sebagai OS untuk gambar simpul.
Windows2019	string	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	string	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

Jenis sistem operasi. Defaultnya adalah Linux.

Nama	Jenis	Deskripsi
Linux	string	Gunakan Linux.
Windows	string	Gunakan Windows.

PortRange

Rentang port.

Nama	Jenis	Deskripsi
portEnd	integer	Port maksimum yang disertakan dalam rentang. Ini harus berkisar dari 1 hingga 65535, dan lebih besar dari atau sama dengan portStart.
portStart	integer	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

Menjelaskan Status Daya kluster

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

Protocol

Protokol jaringan port.

Nama	Jenis	Deskripsi
TCP	string	Protokol TCP.
UDP	string	Protokol UDP.

ScaleDownMode

Menjelaskan bagaimana VM ditambahkan atau dihapus dari Kumpulan Agen. Lihatstatus penagihan .

Nama	Jenis	Deskripsi
Deallocate	string	Coba mulai instans yang dibatalkan alokasinya (jika ada) selama peningkatan skala dan batalkan alokasi instans selama penurunan skala.
Delete	string	Buat instans baru selama peningkatan skala dan hapus instans selama penurunan skala.

ScaleSetEvictionPolicy

Kebijakan pengeluaran Set Skala Komputer Virtual.

Nama	Jenis	Deskripsi
Deallocate	string	Simpul dalam Set Skala yang mendasar dari kumpulan simpul diatur ke status dihentikan-dibatalkan alokasinya setelah pengeluaran. Simpul dalam jumlah status yang dihentikan alokasinya terhadap kuota komputasi Anda dan dapat menyebabkan masalah dengan penskalaan atau peningkatan kluster.
Delete	string	Simpul di Set Skala yang mendasar dari kumpulan simpul dihapus saat dikeluarkan.

ScaleSetPriority

Prioritas Set Skala Komputer Virtual.

Nama	Jenis	Deskripsi
Regular	string	VM reguler akan digunakan.
Spot	string	VM prioritas spot akan digunakan. Tidak ada SLA untuk simpul spot. Lihat spot di AKS untuk informasi selengkapnya.

SysctlConfig

Pengaturan Sysctl untuk simpul agen Linux.

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

WorkloadRuntime

Menentukan jenis beban kerja yang dapat dijalankan simpul.

Nama	Jenis	Deskripsi
OCIContainer	string	Simpul akan menggunakan Kubelet untuk menjalankan beban kerja kontainer OCI standar.
WasmWasi	string	Simpul akan menggunakan Krustlet untuk menjalankan beban kerja WASM menggunakan penyedia WASI (Pratinjau).