Machines - Create Or Update

Layanan:: AKS

Versi API:: 2026-01-02-preview

Membuat atau memperbarui komputer di kumpulan agen yang ditentukan.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/machines/{machineName}?api-version=2026-01-02-preview

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.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Nama host mesin.
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.

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	MachineProperties	Properti komputer

Respons

Nama	Jenis	Deskripsi
200 OK	Machine	Operasi pembaruan 'Mesin' sumber daya berhasil
201 Created	Machine	Operasi pembuatan 'Mesin' sumber daya berhasil Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

Machine

Operasi pembaruan 'Mesin' sumber daya berhasil

201 Created

Machine

Operasi pembuatan 'Mesin' sumber daya berhasil

Header

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

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/Update Machine

Permintaan sampel

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1?api-version=2026-01-02-preview

{
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "tags": {
      "name1": "val1"
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python machine_create_update.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="SUBSCRIPTION_ID",
    )

    response = client.machines.begin_create_or_update(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
        machine_name="machine1",
        parameters={
            "properties": {
                "hardware": {"vmSize": "Standard_DS1_v2"},
                "kubernetes": {
                    "kubeletDiskType": "OS",
                    "maxPods": 110,
                    "nodeLabels": {"key1": "val1"},
                    "nodeTaints": ["Key1=Value1:NoSchedule"],
                    "orchestratorVersion": "1.30",
                },
                "mode": "User",
                "operatingSystem": {"enableFIPS": False, "osSKU": "Ubuntu", "osType": "Linux"},
                "priority": "Spot",
                "tags": {"name1": "val1"},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-01-02-preview/MachineCreate_Update.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/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v9"
)

// Generated from example definition: 2026-01-02-preview/MachineCreate_Update.json
func ExampleMachinesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewMachinesClient().BeginCreateOrUpdate(ctx, "rg1", "clustername1", "agentpool1", "machine1", armcontainerservice.Machine{
		Properties: &armcontainerservice.MachineProperties{
			Hardware: &armcontainerservice.MachineHardwareProfile{
				VMSize: to.Ptr("Standard_DS1_v2"),
			},
			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
				MaxPods:         to.Ptr[int32](110),
				NodeLabels: map[string]*string{
					"key1": to.Ptr("val1"),
				},
				NodeTaints: []*string{
					to.Ptr("Key1=Value1:NoSchedule"),
				},
				OrchestratorVersion: to.Ptr("1.30"),
			},
			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
			OperatingSystem: &armcontainerservice.MachineOSProfile{
				EnableFIPS: to.Ptr(false),
				OSSKU:      to.Ptr(armcontainerservice.OSSKUUbuntu),
				OSType:     to.Ptr(armcontainerservice.OSTypeLinux),
			},
			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
			Tags: map[string]*string{
				"name1": to.Ptr("val1"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %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 = armcontainerservice.MachinesClientCreateOrUpdateResponse{
	// 	Machine: &armcontainerservice.Machine{
	// 		Name: to.Ptr("machine1"),
	// 		Type: to.Ptr("Microsoft.ContainerService/managedClusters/agentPools/machines"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1"),
	// 		Properties: &armcontainerservice.MachineProperties{
	// 			Hardware: &armcontainerservice.MachineHardwareProfile{
	// 				VMSize: to.Ptr("Standard_DS1_v2"),
	// 			},
	// 			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
	// 				CurrentOrchestratorVersion: to.Ptr("1.30.6"),
	// 				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
	// 				MaxPods: to.Ptr[int32](110),
	// 				NodeLabels: map[string]*string{
	// 					"key1": to.Ptr("val1"),
	// 				},
	// 				NodeName: to.Ptr("aks-nodepool1-machine1-25481572-vm0"),
	// 				NodeTaints: []*string{
	// 					to.Ptr("Key1=Value1:NoSchedule"),
	// 				},
	// 				OrchestratorVersion: to.Ptr("1.30"),
	// 			},
	// 			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
	// 			NodeImageVersion: to.Ptr("AKSUbuntu:1604:2023.03.11"),
	// 			OperatingSystem: &armcontainerservice.MachineOSProfile{
	// 				EnableFIPS: to.Ptr(false),
	// 				OSSKU: to.Ptr(armcontainerservice.OSSKUUbuntu),
	// 				OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 			},
	// 			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
	// 			ProvisioningState: to.Ptr("Succeeded"),
	// 			Status: &armcontainerservice.MachineStatus{
	// 				CreationTimestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-02T12:00:00Z"); return t}()),
	// 				DriftAction: to.Ptr(armcontainerservice.DriftActionSynced),
	// 				VMState: to.Ptr(armcontainerservice.VMStateRunning),
	// 			},
	// 			Tags: map[string]*string{
	// 				"name1": to.Ptr("val1"),
	// 			},
	// 		},
	// 		Zones: []*string{
	// 			to.Ptr("1"),
	// 		},
	// 	},
	// }
}

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

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Succeeded",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

Kode status:: 201

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Creating",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

Definisi

Nama	Deskripsi
AgentPoolArtifactStreamingProfile	Profil streaming artefak untuk kumpulan agen.
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
AgentPoolSSHAccess	SSH access metode kumpulan agen.
AgentPoolWindowsProfile	Profil spesifik kumpulan agen Windows.
createdByType	Jenis identitas yang membuat sumber daya.
DriftAction	Aksi drift mesin. Menunjukkan apakah komputer telah menyimpang dari status yang diharapkan karena perubahan dalam properti kluster terkelola, yang memerlukan tindakan korektif.
DriverType	Tentukan jenis driver GPU yang akan diinstal saat membuat kumpulan agen Windows. Jika tidak disediakan, AKS memilih driver berdasarkan kompatibilitas sistem. Ini tidak dapat diubah setelah AgentPool dibuat. Ini tidak dapat diatur pada Linux AgentPools. Untuk Linux AgentPools, driver dipilih berdasarkan kompatibilitas sistem.
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.
IPFamily	Untuk menentukan apakah alamat termasuk dalam keluarga IPv4 atau IPv6
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, root data runtime kontainer, dan Kubelet ephemeral storage.
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.
Machine	Sebuah mesin. Berisi detail tentang komputer virtual yang mendasar. Mesin mungkin terlihat di sini tetapi tidak di kubectl get node; jika demikian mungkin karena mesin belum terdaftar di Kubernetes API Server.
MachineBillingProfile	Properti yang berkaitan dengan penagihan mesin.
MachineHardwareProfile	Pengaturan perangkat keras dan GPU mesin.
MachineIpAddress	Detail alamat IP komputer.
MachineKubernetesProfile	Konfigurasi Kubernetes yang digunakan oleh mesin.
MachineNetworkProperties	properti jaringan komputer
MachineOSProfile	Sistem operasi dan disk yang digunakan oleh mesin.
MachineOSProfileLinuxProfile	Profil spesifik mesin Linux.
MachineProperties	Properti komputer
MachineSecurityProfile	Pengaturan keamanan mesin.
MachineStatus	Berisi informasi baca-saja tentang mesin.
ManagementMode	Pengalaman GPU Terkelola menginstal komponen tambahan, seperti metrik Manajer GPU Pusat Data (DCGM) untuk pemantauan, di atas driver GPU untuk Anda. Untuk detail lebih lanjut tentang apa yang dipasang, lihat aka.ms/aks/managed-gpu.
MigStrategy	Mengatur strategi MIG (GPU Multi-Instance) yang akan digunakan untuk dukungan MIG terkelola. Untuk informasi lebih lanjut tentang berbagai strategi, kunjungi aka.ms/aks/managed-gpu. Jika tidak ditentukan, defaultnya adalah Tidak Ada.
NvidiaGPUProfile	Pengaturan GPU khusus NVIDIA
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, lihat Ephemeral OS.
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.
ScaleSetEvictionPolicy	Kebijakan penggusuran Set Skala Komputer Virtual. Kebijakan penggusuran menentukan apa yang to do dengan VM saat diusir. Defaultnya adalah Hapus. Untuk informasi selengkapnya tentang penggusuran, lihat spot VMs
ScaleSetPriority	Prioritas Set Skala Komputer Virtual.
SeccompDefault	Menentukan profil seccomp default yang diterapkan ke semua beban kerja. Jika tidak ditentukan, 'Tidak terkonfinisi' akan digunakan secara default.
SysctlConfig	Pengaturan Sysctl untuk simpul agen Linux.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
VmState	Status komputer virtual. Menunjukkan status saat ini dari komputer virtual yang mendasarinya.
WorkloadRuntime	Menentukan jenis beban kerja yang dapat dijalankan simpul.

AgentPoolArtifactStreamingProfile

Objek

Profil streaming artefak untuk kumpulan agen.

Nama	Jenis	Deskripsi
enabled	boolean	Streaming artefak mempercepat cold-start kontainer pada node melalui pemuatan gambar sesuai permintaan. Untuk menggunakan fitur ini, gambar kontainer juga harus mengaktifkan streaming artefak di ACR. Jika tidak ditentukan, defaultnya adalah false.

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.
ManagedSystem	ManagedSystem adalah kumpulan sistem yang dikelola oleh AKS. Kumpulan menskalakan secara dinamis sesuai dengan penggunaan kluster, dan memiliki kemampuan pemantauan dan penyembuhan otomatis tambahan. Hanya ada satu kumpulan ManagedSystem, dan disarankan untuk menghapus semua kumpulan sistem lainnya untuk pengalaman terbaik.
Machines	Kumpulan agen mesin didedikasikan untuk menghosting mesin. Hanya operasi terbatas, seperti pembuatan dan penghapusan, yang diizinkan di tingkat kumpulan. Silakan gunakan API alat berat untuk mengelola siklus hidup alat berat penuh.

AgentPoolSSHAccess

Enumerasi

SSH access metode kumpulan agen.

Nilai	Deskripsi
LocalUser	Dapatkah SSH ke simpul sebagai pengguna lokal menggunakan kunci privat.
Disabled	Layanan SSH akan dinonaktifkan pada simpul.
EntraId	SSH ke node dengan integrasi EntraID. Informasi lebih lanjut dapat ditemukan di bawah https://aka.ms/aks/ssh/aad

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.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DriftAction

Enumerasi

Aksi drift mesin. Menunjukkan apakah komputer telah menyimpang dari status yang diharapkan karena perubahan dalam properti kluster terkelola, yang memerlukan tindakan korektif.

Nilai	Deskripsi
Synced	Mesin sudah mutakhir.
Recreate	Mesin telah melayang dan perlu dihapus dan dibuat ulang.

DriverType

Enumerasi

Tentukan jenis driver GPU yang akan diinstal saat membuat kumpulan agen Windows. Jika tidak disediakan, AKS memilih driver berdasarkan kompatibilitas sistem. Ini tidak dapat diubah setelah AgentPool dibuat. Ini tidak dapat diatur pada Linux AgentPools. Untuk Linux AgentPools, driver dipilih berdasarkan kompatibilitas sistem.

Nilai	Deskripsi
GRID	Instal driver GRID untuk GPU, cocok untuk aplikasi yang memerlukan dukungan virtualisasi.
CUDA	Instal driver CUDA untuk GPU, yang dioptimalkan untuk tugas komputasi dalam komputasi ilmiah dan aplikasi intensif data.

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[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran 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	Profil instans GPU MIG 1g.
MIG2g	Profil instans GPU MIG 2g.
MIG3g	Profil instans GPU MIG 3g.
MIG4g	Profil instans GPU MIG 4g.
MIG7g	Profil instans GPU MIG 7g.

GPUProfile

Objek

Pengaturan GPU untuk Kumpulan Agen.

Nama	Jenis	Deskripsi
driver	GPUDriver	Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.
driverType	DriverType	Tentukan jenis driver GPU yang akan diinstal saat membuat kumpulan agen Windows. Jika tidak disediakan, AKS memilih driver berdasarkan kompatibilitas sistem. Ini tidak dapat diubah setelah AgentPool dibuat. Ini tidak dapat diatur pada Linux AgentPools. Untuk Linux AgentPools, driver dipilih berdasarkan kompatibilitas sistem.
nvidia	NvidiaGPUProfile	Pengaturan GPU khusus NVIDIA.

IPFamily

Enumerasi

Untuk menentukan apakah alamat termasuk dalam keluarga IPv4 atau IPv6

Nilai	Deskripsi
IPv4	Keluarga IPv4
IPv6	Keluarga IPv6

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 {i>file
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.
seccompDefault	SeccompDefault	Menentukan profil seccomp default yang diterapkan ke semua beban kerja. Jika tidak ditentukan, 'Tidak terkonfinisi' akan digunakan secara default.
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, root data runtime kontainer, dan Kubelet ephemeral storage.

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.

Machine

Objek

Sebuah mesin. Berisi detail tentang komputer virtual yang mendasar. Mesin mungkin terlihat di sini tetapi tidak di kubectl get node; jika demikian mungkin karena mesin belum terdaftar di Kubernetes API Server.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	MachineProperties	Properti komputer
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"
zones	string[]	Zona Ketersediaan tempat mesin berada.

MachineBillingProfile

Objek

Properti yang berkaitan dengan penagihan mesin.

Nama	Jenis	Nilai default	Deskripsi
spotMaxPrice	number (float)	-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. Untuk detail selengkapnya tentang harga spot, lihat harga VM spot

MachineHardwareProfile

Objek

Pengaturan perangkat keras dan GPU mesin.

Nama	Jenis	Deskripsi
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.
gpuProfile	GPUProfile	Pengaturan GPU mesin.
ultraSsdEnabled	boolean	Apakah akan mengaktifkan UltraSSD
vmSize	string	Ukuran VM. 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

MachineIpAddress

Objek

Detail alamat IP komputer.

Nama	Jenis	Deskripsi
family	IPFamily	Untuk menentukan apakah alamat termasuk dalam keluarga IPv4 atau IPv6
ip	string	Alamat IPv4 atau IPv6 mesin

MachineKubernetesProfile

Objek

Konfigurasi Kubernetes yang digunakan oleh mesin.

Nama	Jenis	Deskripsi
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Konfigurasi untuk menggunakan streaming artefak di AKS.
currentOrchestratorVersion	string	Versi Kubernetes yang berjalan di mesin. Jika orchestratorVersion adalah versi <major.minor.patch> yang ditentukan sepenuhnya, bidang ini akan sama persis dengannya. Jika orchestratorVersion adalah <major.minor>, bidang ini akan berisi versi major.minor.patch lengkap <yang> digunakan.
kubeletConfig	KubeletConfig	Konfigurasi Kubelet pada mesin.
kubeletDiskType	KubeletDiskType	Menentukan penempatan volume emptyDir, root data runtime kontainer, dan Kubelet ephemeral storage.
maxPods	integer (int32)	Jumlah maksimum pod yang dapat berjalan pada simpul.
nodeInitializationTaints	string[]	Noda ditambahkan pada node selama pembuatan yang tidak akan direkonsiliasi oleh AKS. Taint ini tidak akan direkonsiliasi oleh AKS dan dapat dihapus dengan panggilan kubectl. Taint ini memungkinkan konfigurasi yang diperlukan berjalan sebelum simpul siap untuk menerima beban kerja, misalnya 'key1=value1:NoSchedule' yang kemudian dapat dihapus dengan `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	Label node pada mesin.
nodeName	string	Nama simpul dalam kluster Kubernetes.
nodeTaints	string[]	Noda ditambahkan ke simpul baru selama pembuatan mesin. Misalnya, key=value:NoSchedule.
orchestratorVersion	string	Versi Kubernetes yang ditentukan oleh pengguna. Baik versi <patch major.minor.patch> dan <major.minor> didukung. Ketika <major.minor> ditentukan, versi patch terbaru yang didukung dipilih secara otomatis.
workloadRuntime	WorkloadRuntime	Menentukan jenis beban kerja yang dapat dijalankan simpul.

MachineNetworkProperties

Objek

properti jaringan komputer

Nama	Jenis	Deskripsi
enableNodePublicIP	boolean	Apakah mesin dialokasikan IP publiknya sendiri. Beberapa skenario mungkin mengharuskan mesin 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. Defaultnya adalah false.
ipAddresses	MachineIpAddress[]	IPv4, alamat IPv6 mesin
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}
nodePublicIPTags	IPTag[]	IPTag IP publik tingkat instans.
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}
vnetSubnetID	string (arm-id)	ID subnet yang node dan pod opsional akan bergabung saat 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}

MachineOSProfile

Objek

Sistem operasi dan disk yang digunakan oleh mesin.

Nama	Jenis	Nilai default	Deskripsi
enableFIPS	boolean		Apakah akan menggunakan OS berkemampuan FIPS.
linuxProfile	MachineOSProfileLinuxProfile		Profil spesifik mesin Linux.
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.
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, lihat Ephemeral OS.
osSKU	OSSKU		Menentukan SKU OS yang digunakan oleh kumpulan agen. Jika tidak ditentukan, defaultnya adalah Ubuntu jika OSType=Linux atau Windows2019 jika OSType=Windows. Dan OSSKU Windows default akan diubah ke Windows2022 setelah Windows2019 tidak digunakan lagi.
osType	OSType	Linux	Jenis sistem operasi. Defaultnya adalah Linux.
windowsProfile	AgentPoolWindowsProfile		Profil spesifik mesin Windows.

MachineOSProfileLinuxProfile

Objek

Profil spesifik mesin Linux.

Nama	Jenis	Deskripsi
linuxOSConfig	LinuxOSConfig	Konfigurasi OS mesin Linux.
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).

MachineProperties

Objek

Properti komputer

Nama	Jenis	Nilai default	Deskripsi
billing	MachineBillingProfile		Properti yang berkaitan dengan penagihan mesin.
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.
evictionPolicy	ScaleSetEvictionPolicy	Delete	Kebijakan penggusuran untuk mesin. Ini tidak dapat ditentukan kecuali prioritasnya adalah 'Spot'. Jika tidak ditentukan, defaultnya adalah 'Hapus'.
hardware	MachineHardwareProfile		Pengaturan perangkat keras dan GPU mesin.
kubernetes	MachineKubernetesProfile		Konfigurasi Kubernetes yang digunakan oleh mesin.
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.
mode	AgentPoolMode		Mesin hanya mengizinkan mode 'Sistem' dan 'Pengguna'.
network	MachineNetworkProperties		properti jaringan komputer
nodeImageVersion	string		Versi gambar simpul.
operatingSystem	MachineOSProfile		Sistem operasi dan disk yang digunakan oleh mesin.
priority	ScaleSetPriority	Regular	Prioritas untuk mesin. Jika tidak ditentukan, defaultnya adalah 'Reguler'.
provisioningState	string		Status penyebaran atau provisi saat ini.
resourceId	string (arm-id)		ID sumber daya Azure mesin. Ini dapat digunakan untuk MENDAPATKAN Instans VM yang mendasarinya
security	MachineSecurityProfile		Pengaturan keamanan mesin.
status	MachineStatus		Berisi informasi baca-saja tentang mesin.
tags	object		Tag yang akan dipertahankan pada mesin.

MachineSecurityProfile

Objek

Pengaturan keamanan mesin.

Nama	Jenis	Deskripsi
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
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	SSH access metode kumpulan agen.

MachineStatus

Objek

Berisi informasi baca-saja tentang mesin.

Nama	Jenis	Deskripsi
creationTimestamp	string (date-time)	Menentukan waktu di mana mesin dibuat.
driftAction	DriftAction	Aksi drift mesin. Menunjukkan apakah komputer telah menyimpang dari status yang diharapkan karena perubahan dalam properti kluster terkelola, yang memerlukan tindakan korektif.
driftReason	string	Alasan penyimpangan mesin. Memberikan informasi terperinci tentang mengapa mesin melayang. Bidang ini dihilangkan jika mesin sudah diperbarui.
provisioningError	ErrorDetail	Kesalahan merinci informasi mesin. Mempertahankan info terperinci tentang kegagalan. Jika tidak ada kesalahan, bidang ini dihilangkan.
vmState	VmState	Status komputer virtual. Menunjukkan status saat ini dari komputer virtual yang mendasarinya.

ManagementMode

Enumerasi

Pengalaman GPU Terkelola menginstal komponen tambahan, seperti metrik Manajer GPU Pusat Data (DCGM) untuk pemantauan, di atas driver GPU untuk Anda. Untuk detail lebih lanjut tentang apa yang dipasang, lihat aka.ms/aks/managed-gpu.

Nilai	Deskripsi
Unmanaged	Pengalaman GPU terkelola dinonaktifkan untuk GPU NVIDIA.
Managed	Pengalaman GPU terkelola diaktifkan untuk GPU NVIDIA.

MigStrategy

Enumerasi

Mengatur strategi MIG (GPU Multi-Instance) yang akan digunakan untuk dukungan MIG terkelola. Untuk informasi lebih lanjut tentang berbagai strategi, kunjungi aka.ms/aks/managed-gpu. Jika tidak ditentukan, defaultnya adalah Tidak Ada.

Nilai	Deskripsi
None	Jangan menetapkan strategi MIG. Jika sebelumnya Anda memiliki satu set, ini akan menggantinya dan mengatur hapus strategi MIG yang ditetapkan.
Single	Tetapkan strategi MIG untuk MIG terkelola sebagai tunggal.
Mixed	Atur strategi MIG untuk MIG terkelola sebagai campuran.

NvidiaGPUProfile

Objek

Pengaturan GPU khusus NVIDIA

Nama	Jenis	Deskripsi
managementMode	ManagementMode	Pengalaman GPU Terkelola menginstal komponen tambahan, seperti metrik Manajer GPU Pusat Data (DCGM) untuk pemantauan, di atas driver GPU untuk Anda. Untuk detail lebih lanjut tentang apa yang dipasang, lihat aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Mengatur strategi MIG (GPU Multi-Instance) yang akan digunakan untuk dukungan MIG terkelola. Untuk informasi lebih lanjut tentang berbagai strategi, kunjungi aka.ms/aks/managed-gpu. Jika tidak ditentukan, defaultnya adalah Tidak Ada.

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, lihat Ephemeral OS.

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
Ubuntu	Gunakan Ubuntu sebagai OS untuk gambar simpul.
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.
Mariner	OSSKU yang tidak digunakan lagi. Microsoft menyarankan agar penyebaran baru memilih 'AzureLinux' sebagai gantinya.
Flatcar	Gunakan Flatcar Container Linux sebagai OS untuk gambar node. Flatcar adalah OS Linux yang dioptimalkan untuk kontainer dan berfokus pada keamanan, dengan sistem file yang tidak dapat diubah dan bagian dari Cloud Native Computing Foundation (CNCF). Untuk informasi selengkapnya tentang Flatcar Container Linux untuk AKS, lihat aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	OSSKU yang tidak digunakan lagi. Microsoft menyarankan agar penyebaran baru memilih 'AzureLinux' sebagai gantinya.
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.
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
Windows2025	Gunakan Windows2025 sebagai OS untuk gambar node. Tidak didukung untuk kumpulan simpul sistem. Windows2025 mendukung kontainer Windows2022 dan Windows 2025; itu tidak dapat menjalankan kontainer Windows2019 dan sebaliknya.
WindowsAnnual	Gunakan versi Saluran Tahunan Windows sebagai OS untuk gambar simpul. Tidak didukung untuk kumpulan simpul sistem. Detail tentang gambar kontainer yang didukung dan versi kubernetes di bawah versi Saluran Tahunan AKS yang berbeda dapat dilihat di https://aka.ms/aks/windows-annual-channel-details.
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 lihat https://aka.ms/aks/supported-ubuntu-versions

OSType

Enumerasi

Jenis sistem operasi. Defaultnya adalah Linux.

Nilai	Deskripsi
Linux	Gunakan Linux.
Windows	Gunakan Windows.

ScaleSetEvictionPolicy

Enumerasi

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

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.

SeccompDefault

Enumerasi

Menentukan profil seccomp default yang diterapkan ke semua beban kerja. Jika tidak ditentukan, 'Tidak terkonfinisi' akan digunakan secara default.

Nilai	Deskripsi
Unconfined	Tidak ada profil seccomp yang diterapkan, memungkinkan semua panggilan sistem.
RuntimeDefault	Profil seccomp default untuk runtime kontainer diterapkan, yang membatasi panggilan sistem tertentu untuk keamanan yang ditingkatkan.

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.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

VmState

Enumerasi

Status komputer virtual. Menunjukkan status saat ini dari komputer virtual yang mendasarinya.

Nilai	Deskripsi
Running	Mesin virtual saat ini sedang berjalan.
Deleted	Mesin virtual telah dihapus oleh pengguna atau karena penggusuran tempat.

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).
KataMshvVmIsolation	Simpul dapat menggunakan (Kata + Cloud Hypervisor + Hyper-V) untuk mengaktifkan Pod berbasis VM Berlapis (Pratinjau). 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. Konvensi penamaan ini akan tidak digunakan lagi dalam rilis mendatang untuk mendukung KataVmIsolation.
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.

Bagikan melalui

Machines - Create Or Update

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

Create/Update Machine

Permintaan sampel

Respon sampel

Definisi

AgentPoolArtifactStreamingProfile

AgentPoolMode

AgentPoolSSHAccess

AgentPoolWindowsProfile

createdByType

DriftAction

DriverType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPFamily

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

Machine

MachineBillingProfile

MachineHardwareProfile

MachineIpAddress

MachineKubernetesProfile

MachineNetworkProperties

MachineOSProfile

MachineOSProfileLinuxProfile

MachineProperties

MachineSecurityProfile

MachineStatus

ManagementMode

MigStrategy

NvidiaGPUProfile

OSDiskType

OSSKU

OSType

ScaleSetEvictionPolicy

ScaleSetPriority

SeccompDefault

SysctlConfig

systemData

VmState

WorkloadRuntime