Machines - Create Or Update

서비스:: AKS

API 버전:: 2026-01-02-preview

지정된 에이전트 풀에서 컴퓨터를 만들거나 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	에이전트 풀의 이름입니다.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	시스템의 호스트 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
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]$	관리되는 클러스터 리소스의 이름입니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 헤더

Name	필수	형식	Description
if-match		string	엔터티가 이 문자열과 일치하는 경우에만 요청을 진행해야 합니다.
if-none-match		string	요청은 이 문자열과 일치하는 엔터티가 없는 경우에만 진행해야 합니다.

요청 본문

Name	형식	Description
properties	MachineProperties	컴퓨터의 속성

응답

Name	형식	Description
200 OK	Machine	리소스 '머신' 업데이트 작업이 성공했습니다
201 Created	Machine	리소스 '머신' 생성 작업 성공 헤더 Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

Machine

리소스 '머신' 업데이트 작업이 성공했습니다

201 Created

Machine

리소스 '머신' 생성 작업 성공

헤더

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Create/Update Machine

샘플 요청

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

샘플 응답

상태 코드:: 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"
  ]
}

상태 코드:: 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"
  ]
}

정의

Name	Description
AgentPoolArtifactStreamingProfile	에이전트 풀의 아티팩트 스트리밍 프로필.
AgentPoolMode	에이전트 풀의 모드입니다. 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	에이전트 풀의 SSH access 메서드.
AgentPoolWindowsProfile	Windows 에이전트 풀의 특정 프로필입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DriftAction	기계의 드리프트 동작. 관리 클러스터 속성의 변경으로 인해 시스템이 예상 상태에서 벗어나 수정 작업이 필요한지 여부를 나타냅니다.
DriverType	Windows 에이전트 풀을 만들 때 설치할 GPU 드라이버 유형을 지정합니다. 제공되지 않은 경우 AKS는 시스템 호환성에 따라 드라이버를 선택합니다. AgentPool을 만든 후에는 변경할 수 없습니다. Linux AgentPools에서는 설정할 수 없습니다. Linux AgentPools의 경우 시스템 호환성에 따라 드라이버가 선택됩니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
GPUDriver	GPU 드라이버를 설치할지 여부입니다. 지정하지 않으면 기본값은 Install입니다.
GPUInstanceProfile	지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.
GPUProfile	에이전트 풀에 대한 GPU 설정입니다.
IPFamily	주소가 IPv4 또는 IPv6 제품군에 속하는지 확인하려면
IPTag	개체와 연결된 IPTag를 포함합니다.
KubeletConfig	에이전트 노드의 Kubelet 구성입니다. 자세한 내용은 AKS 사용자 지정 노드 구성 참조하세요.
KubeletDiskType	emptyDir 볼륨의 위치, 컨테이너 런타임 데이터 루트, 그리고 Kubelet 일시적 storage의 위치를 결정합니다.
LinuxOSConfig	Linux 에이전트 노드의 OS 구성. 자세한 내용은 AKS 사용자 지정 노드 구성 참조하세요.
LocalDNSForwardDestination	localDNS에서 전달할 DNS 쿼리의 대상 서버입니다.
LocalDNSForwardPolicy	업스트림 DNS 서버를 선택하기 위한 정책을 전달합니다. 자세한 내용은 forward plugin 을 참조하십시오.
LocalDNSMode	localDNS에 대한 활성화 모드입니다.
LocalDNSOverride	localDNS 프로필을 재정의합니다.
LocalDNSProfile	VnetDNS 및 KubeDNS 재정의를 사용하여 노드별 로컬 DNS를 구성합니다. LocalDNS는 AKS 클러스터에서 DNS 확인의 성능과 안정성을 향상시키는 데 도움이 됩니다. 자세한 내용은 aka.ms/aks/localdns 참조하십시오.
LocalDNSProtocol	TCP를 적용하거나 localDNS에서 업스트림 DNS 서버로의 연결에 UDP 프로토콜을 선호합니다.
LocalDNSQueryLogging	localDNS의 DNS 쿼리에 대한 로그 수준입니다.
LocalDNSServeStale	부실 데이터 제공에 대한 정책입니다. 자세한 내용은 캐시 플러그인을 참조하십시오.
LocalDNSState	localDNS의 시스템 생성 상태입니다.
Machine	기계. 기본 가상 머신에 대한 세부 정보를 포함합니다. 여기서는 머신이 표시될 수 있지만 kubectl get 노드에는 표시되지 않습니다. 컴퓨터가 Kubernetes API 서버에 아직 등록되지 않았기 때문일 수 있습니다.
MachineBillingProfile	기계 청구와 관련된 속성들입니다.
MachineHardwareProfile	컴퓨터의 하드웨어 및 GPU 설정입니다.
MachineIpAddress	컴퓨터 IP 주소 세부 정보입니다.
MachineKubernetesProfile	머신에서 사용하는 Kubernetes 구성입니다.
MachineNetworkProperties	컴퓨터의 네트워크 속성
MachineOSProfile	시스템에서 사용하는 운영 체제 및 디스크입니다.
MachineOSProfileLinuxProfile	Linux 머신의 특정 프로필입니다.
MachineProperties	컴퓨터의 속성
MachineSecurityProfile	컴퓨터의 보안 설정입니다.
MachineStatus	컴퓨터에 대한 읽기 전용 정보를 포함합니다.
ManagementMode	관리 GPU 경험은 GPU 드라이버 위에 데이터 센터 GPU 관리자(DCGM) 지표와 같은 모니터링용 추가 요소를 설치합니다. 설치된 내용에 대한 자세한 내용은 aka.ms/aks/managed-gpu 를 참고하세요.
MigStrategy	관리형 MIG 지원에 사용할 MIG(다중 인스턴스 GPU) 전략을 설정합니다. 다양한 전략에 대한 자세한 정보는 aka.ms/aks/managed-gpu 를 방문하세요. 지정하지 않은 경우, 기본값은 None입니다.
NvidiaGPUProfile	NVIDIA 전용 GPU 설정
OSDiskType	에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 Ephemeral OS를 참조하세요.
OSSKU	에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. OSType이 Windows 경우 Kubernetes가 <= 1.25인 경우 Kubernetes가 >= 1.24 또는 Windows2022인 경우 기본값은 Windows2019입니다.
OSType	운영 체제 유형입니다. 기본값은 Linux입니다.
ScaleSetEvictionPolicy	Virtual Machine Scale Set 제거 정책입니다. 퇴거 정책에는 퇴거 시 VM에 어떤 to do이 있는지 명시되어 있습니다. 기본값은 삭제입니다. 퇴거에 관한 자세한 내용은 spot VMs
ScaleSetPriority	Virtual Machine Scale Set 우선 순위입니다.
SeccompDefault	모든 워크로드에 적용되는 기본 seccomp 프로필을 지정합니다. 지정하지 않으면 기본적으로 'Unconfined'가 사용됩니다.
SysctlConfig	Linux 에이전트 노드에 대한 Sysctl 설정입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
VmState	가상 머신 상태입니다. 기본 가상 시스템의 현재 상태를 나타냅니다.
WorkloadRuntime	노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

AgentPoolArtifactStreamingProfile

Object

에이전트 풀의 아티팩트 스트리밍 프로필.

Name	형식	Description
enabled	boolean	아티팩트 스트리밍은 주문형 이미지 로드를 통해 노드에서 컨테이너의 콜드 시작 속도를 향상합니다. 이 기능을 사용하려면 컨테이너 이미지도 ACR에서 아티팩트 스트리밍을 사용하도록 설정해야 합니다. 지정하지 않으면 기본값은 false입니다.

AgentPoolMode

열거형

에이전트 풀의 모드입니다. 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools

값	Description
System	시스템 에이전트 풀은 주로 CoreDNS 및 metrics-server와 같은 중요한 시스템 Pod를 호스팅하기 위한 것입니다. 시스템 에이전트 풀 osType은 Linux여야 합니다. 시스템 에이전트 풀 VM SKU에는 2vCPU 및 4GB 이상의 메모리가 있어야 합니다.
User	사용자 에이전트 풀은 주로 애플리케이션 Pod를 호스팅하기 위한 것입니다.
Gateway	게이트웨이 에이전트 풀은 포드에 정적 송신 IP를 제공하는 데 전념합니다. 자세한 내용은 https://aka.ms/aks/static-egress-gateway를 참조하세요.
ManagedSystem	ManagedSystem은 AKS에서 관리하는 시스템 풀입니다. 풀은 클러스터 사용량에 따라 동적으로 확장되며 자동화된 모니터링 및 복구 기능이 추가로 있습니다. ManagedSystem 풀은 하나만 있을 수 있으며 최상의 경험을 위해 다른 모든 시스템 풀을 삭제하는 것이 좋습니다.
Machines	컴퓨터 에이전트 풀은 컴퓨터 호스팅 전용입니다. 만들기 및 삭제와 같은 제한된 작업만 풀 수준에서 허용됩니다. 컴퓨터 API를 사용하여 전체 컴퓨터 수명 주기를 관리하세요.

AgentPoolSSHAccess

열거형

에이전트 풀의 SSH access 메서드.

값	Description
LocalUser	프라이빗 키를 사용하여 로컬 사용자로 노드에 SSH할 수 있습니다.
Disabled	노드에서 SSH 서비스가 꺼집니다.
EntraId	EntraId 통합을 사용하여 노드에 SSH를 연결합니다. 자세한 내용은 아래에서 찾을 수 있습니다. https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Object

Windows 에이전트 풀의 특정 프로필입니다.

Name	형식	Description
disableOutboundNat	boolean	Windows 노드에서 OutboundNAT를 비활성화할지 여부입니다. 기본값은 false입니다. 아웃바운드 NAT는 클러스터 outboundType이 NAT 게이트웨이이고 Windows 에이전트 풀에 노드 공용 IP가 활성화되지 않은 경우에만 사용하지 않도록 설정할 수 있습니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DriftAction

열거형

기계의 드리프트 동작. 관리 클러스터 속성의 변경으로 인해 시스템이 예상 상태에서 벗어나 수정 작업이 필요한지 여부를 나타냅니다.

값	Description
Synced	기기가 최신 상태입니다.
Recreate	기계가 표류하여 삭제하고 다시 만들어야 합니다.

DriverType

열거형

Windows 에이전트 풀을 만들 때 설치할 GPU 드라이버 유형을 지정합니다. 제공되지 않은 경우 AKS는 시스템 호환성에 따라 드라이버를 선택합니다. AgentPool을 만든 후에는 변경할 수 없습니다. Linux AgentPools에서는 설정할 수 없습니다. Linux AgentPools의 경우 시스템 호환성에 따라 드라이버가 선택됩니다.

값	Description
GRID	가상화 지원이 필요한 애플리케이션에 적합한 GPU용 GRID 드라이버를 설치합니다.
CUDA	과학 컴퓨팅 및 데이터 집약적 애플리케이션의 계산 작업에 최적화된 GPU용 CUDA 드라이버를 설치합니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

GPUDriver

열거형

GPU 드라이버를 설치할지 여부입니다. 지정하지 않으면 기본값은 Install입니다.

값	Description
Install	드라이버를 설치합니다.
None	드라이버 설치를 건너뜁니다.

GPUInstanceProfile

열거형

지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.

값	Description
MIG1g	MIG 1g GPU 인스턴스 프로필.
MIG2g	MIG 2G GPU 인스턴스 프로필.
MIG3g	MIG 3G GPU 인스턴스 프로필.
MIG4g	MIG 4G GPU 인스턴스 프로필.
MIG7g	MIG 7g GPU 인스턴스 프로필.

GPUProfile

Object

에이전트 풀에 대한 GPU 설정입니다.

Name	형식	Description
driver	GPUDriver	GPU 드라이버를 설치할지 여부입니다. 지정하지 않으면 기본값은 Install입니다.
driverType	DriverType	Windows 에이전트 풀을 만들 때 설치할 GPU 드라이버 유형을 지정합니다. 제공되지 않은 경우 AKS는 시스템 호환성에 따라 드라이버를 선택합니다. AgentPool을 만든 후에는 변경할 수 없습니다. Linux AgentPools에서는 설정할 수 없습니다. Linux AgentPools의 경우 시스템 호환성에 따라 드라이버가 선택됩니다.
nvidia	NvidiaGPUProfile	NVIDIA 전용 GPU 설정.

IPFamily

열거형

주소가 IPv4 또는 IPv6 제품군에 속하는지 확인하려면

값	Description
IPv4	IPv4 제품군
IPv6	IPv6 제품군

IPTag

Object

개체와 연결된 IPTag를 포함합니다.

Name	형식	Description
ipTagType	string	IP 태그 유형입니다. 예: RoutingPreference.
tag	string	공용 IP와 연결된 IP 태그의 값입니다. 예: 인터넷.

KubeletConfig

Object

에이전트 노드의 Kubelet 구성입니다. 자세한 내용은 AKS 사용자 지정 노드 구성 참조하세요.

Name	형식	Description
allowedUnsafeSysctls	string[]	안전하지 않은 sysctls 또는 안전하지 않은 sysctl 패턴(끝 `*`)의 허용된 목록입니다.
containerLogMaxFiles	integer (int32) minimum: 2	컨테이너에 대해 존재할 수 있는 컨테이너 로그 파일의 최대 수입니다. 숫자는 ≥ 2여야 합니다.
containerLogMaxSizeMB	integer (int32)	회전하기 전의 컨테이너 로그 파일의 최대 크기(예: 10Mi)입니다.
cpuCfsQuota	boolean	CPU 제한을 지정하는 컨테이너에 대해 CPU CFS 할당량 적용을 사용하도록 설정한 경우 기본값은 true입니다.
cpuCfsQuotaPeriod	string	CPU CFS 할당량 기간 값입니다. 기본값은 '100ms'입니다. 유효한 값은 선택적 분수와 단위 접미사가 있는 소수 자릿수의 시퀀스입니다. 예: '300ms', '2h45m'. 지원되는 단위는 'ns', 'us', 'ms', 's', 'm' 및 'h'입니다.
cpuManagerPolicy	string	사용할 CPU 관리자 정책입니다. 기본값은 'none'입니다. 자세한 내용은 Kubernetes CPU 관리 정책을 참조하세요. 허용되는 값은 'none' 및 'static'입니다.
failSwapOn	boolean	true로 설정하면 노드에서 교환이 활성화된 경우 Kubelet이 시작되지 않습니다.
imageGcHighThreshold	integer (int32)	이미지 가비지 수집이 항상 실행되는 후 디스크 사용량의 백분율입니다. 이미지 가비지 수집을 사용하지 않도록 설정하려면 100으로 설정합니다. 기본값은 85%
imageGcLowThreshold	integer (int32)	이미지 가비지 수집이 실행되지 않는 이전의 디스크 사용 비율입니다. imageGcHighThreshold보다 높게 설정할 수 없습니다. 기본값은 80%
podMaxPids	integer (int32)	Pod당 최대 프로세스 수입니다.
seccompDefault	SeccompDefault	모든 워크로드에 적용되는 기본 seccomp 프로필을 지정합니다. 지정하지 않으면 기본적으로 'Unconfined'가 사용됩니다.
topologyManagerPolicy	string	사용할 토폴로지 관리자 정책입니다. 자세한 내용은 Kubernetes 토폴로지 관리자를 참조하세요. 기본값은 'none'입니다. 허용되는 값은 'none', 'best-effort', 'restricted' 및 'single-numa-node'입니다.

KubeletDiskType

열거형

emptyDir 볼륨의 위치, 컨테이너 런타임 데이터 루트, 그리고 Kubelet 일시적 storage의 위치를 결정합니다.

값	Description
OS	Kubelet은 데이터에 OS 디스크를 사용합니다.
Temporary	Kubelet은 데이터에 임시 디스크를 사용합니다.

LinuxOSConfig

Object

Linux 에이전트 노드의 OS 구성. 자세한 내용은 AKS 사용자 지정 노드 구성 참조하세요.

Name	형식	Description
swapFileSizeMB	integer (int32)	각 노드에서 만들 스왑 파일의 크기(MB)입니다.
sysctls	SysctlConfig	Linux 에이전트 노드에 대한 Sysctl 설정입니다.
transparentHugePageDefrag	string	커널이 메모리 압축을 적극적으로 사용하여 더 많은 거대한 페이지를 사용할 수 있도록 해야 하는지 여부입니다. 유효한 값은 'always', 'defer', 'defer+madvise', 'madvise' 및 'never'입니다. 기본값은 'madvise'입니다. 자세한 내용은 Transparent Hugepages참조하세요.
transparentHugePageEnabled	string	투명한 거대한 페이지를 사용할 수 있는지 여부입니다. 유효한 값은 'always', 'madvise' 및 'never'입니다. 기본값은 'always'입니다. 자세한 내용은 Transparent Hugepages참조하세요.

LocalDNSForwardDestination

열거형

localDNS에서 전달할 DNS 쿼리의 대상 서버입니다.

값	Description
ClusterCoreDNS	localDNS에서 클러스터 CoreDNS로 DNS 쿼리를 전달합니다.
VnetDNS	localDNS에서 VNET에 구성된 DNS 서버로 DNS 쿼리를 전달합니다. VNET에는 여러 DNS 서버를 구성할 수 있습니다.

LocalDNSForwardPolicy

열거형

업스트림 DNS 서버를 선택하기 위한 정책을 전달합니다. 자세한 내용은 forward plugin 을 참조하십시오.

값	Description
Sequential	순차적 업스트림 DNS 서버 선택을 구현합니다. 자세한 내용은 forward plugin 을 참조하십시오.
RoundRobin	라운드 로빈 업스트림 DNS 서버 선택을 구현합니다. 자세한 내용은 forward plugin 을 참조하십시오.
Random	임의의 업스트림 DNS 서버 선택을 구현합니다. 자세한 내용은 forward plugin 을 참조하십시오.

LocalDNSMode

열거형

localDNS에 대한 활성화 모드입니다.

값	Description
Preferred	현재 오케스트레이터 버전이 이 기능을 지원하는 경우 localDNS를 사용하도록 설정하는 것이 좋습니다.
Required	localDNS를 사용하도록 설정합니다.
Disabled	localDNS를 비활성화합니다.

LocalDNSOverride

Object

localDNS 프로필을 재정의합니다.

Name	형식	Default value	Description
cacheDurationInSeconds	integer (int32)	3600	캐시 최대 TTL(초)입니다. 자세한 내용은 캐시 플러그인을 참조하십시오.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	localDNS에서 전달할 DNS 쿼리의 대상 서버입니다.
forwardPolicy	LocalDNSForwardPolicy	Sequential	업스트림 DNS 서버를 선택하기 위한 정책을 전달합니다. 자세한 내용은 forward plugin 을 참조하십시오.
maxConcurrent	integer (int32)	1000	최대 동시 쿼리 수입니다. 자세한 내용은 forward plugin 을 참조하십시오.
protocol	LocalDNSProtocol	PreferUDP	TCP를 적용하거나 localDNS에서 업스트림 DNS 서버로의 연결에 UDP 프로토콜을 선호합니다.
queryLogging	LocalDNSQueryLogging	Error	localDNS의 DNS 쿼리에 대한 로그 수준입니다.
serveStale	LocalDNSServeStale	Immediate	부실 데이터 제공에 대한 정책입니다. 자세한 내용은 캐시 플러그인을 참조하십시오.
serveStaleDurationInSeconds	integer (int32)	3600	부실 지속 시간(초)을 제공합니다. 자세한 내용은 캐시 플러그인을 참조하십시오.

LocalDNSProfile

Object

VnetDNS 및 KubeDNS 재정의를 사용하여 노드별 로컬 DNS를 구성합니다. LocalDNS는 AKS 클러스터에서 DNS 확인의 성능과 안정성을 향상시키는 데 도움이 됩니다. 자세한 내용은 aka.ms/aks/localdns 참조하십시오.

Name	형식	Default value	Description
kubeDNSOverrides	<string, LocalDNSOverride>		KubeDNS 재정의는 dnsPolicy:ClusterFirst(KubeDNS 트래픽이라고 함)가 있는 파드의 DNS 트래픽에 적용된다.
mode	LocalDNSMode	Preferred	localDNS에 대한 활성화 모드입니다.
state	LocalDNSState		localDNS의 시스템 생성 상태입니다.
vnetDNSOverrides	<string, LocalDNSOverride>		VnetDNS 재정의는 dnsPolicy:default 또는 kubelet(VnetDNS 트래픽이라고 함)이 있는 Pod의 DNS 트래픽에 적용됩니다.

LocalDNSProtocol

열거형

TCP를 적용하거나 localDNS에서 업스트림 DNS 서버로의 연결에 UDP 프로토콜을 선호합니다.

값	Description
PreferUDP	localDNS에서 업스트림 DNS 서버로의 연결에 UDP 프로토콜을 선호합니다.
ForceTCP	localDNS에서 업스트림 DNS 서버로의 연결에 TCP 프로토콜을 적용합니다.

LocalDNSQueryLogging

열거형

localDNS의 DNS 쿼리에 대한 로그 수준입니다.

값	Description
Error	localDNS에서 오류 로깅을 사용하도록 설정합니다. 자세한 내용은 errors 플러그인을 참조하세요.
Log	localDNS에서 쿼리 로깅을 사용하도록 설정합니다. 자세한 내용은 로그 플러그인을 참조하십시오.

LocalDNSServeStale

열거형

부실 데이터 제공에 대한 정책입니다. 자세한 내용은 캐시 플러그인을 참조하십시오.

값	Description
Verify	검증을 통해 오래된 데이터를 제공합니다. 먼저 만료된 항목을 클라이언트로 보내기 전에 원본에서 항목을 여전히 사용할 수 없는지 확인합니다. 자세한 내용은 캐시 플러그인을 참조하십시오.
Immediate	오래된 데이터를 즉시 제공합니다. 원본에서 항목을 사용할 수 있는지 확인하기 전에 만료된 항목을 클라이언트로 보냅니다. 자세한 내용은 캐시 플러그인을 참조하십시오.
Disable	부실 데이터 제공을 비활성화합니다.

LocalDNSState

열거형

localDNS의 시스템 생성 상태입니다.

값	Description
Enabled	localDNS가 활성화되었습니다.
Disabled	localDNS가 비활성화되어 있습니다.

Machine

Object

기계. 기본 가상 머신에 대한 세부 정보를 포함합니다. 여기서는 머신이 표시될 수 있지만 kubectl get 노드에는 표시되지 않습니다. 컴퓨터가 Kubernetes API 서버에 아직 등록되지 않았기 때문일 수 있습니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties	MachineProperties	컴퓨터의 속성
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"
zones	string[]	컴퓨터가 있는 가용 영역입니다.

MachineBillingProfile

Object

기계 청구와 관련된 속성들입니다.

Name	형식	Default value	Description
spotMaxPrice	number (float)	-1	스폿 인스턴스에 대해 지불할 최대 가격(미국 달러)입니다. 가능한 값은 0보다 크거나 -1 10진수 값으로, 기본 가격이 주문형으로 up-to 것을 나타냅니다. 현물 가격에 대한 자세한 내용은 spot VM 가격

MachineHardwareProfile

Object

컴퓨터의 하드웨어 및 GPU 설정입니다.

Name	형식	Description
gpuInstanceProfile	GPUInstanceProfile	지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.
gpuProfile	GPUProfile	컴퓨터의 GPU 설정입니다.
ultraSsdEnabled	boolean	UltraSSD를 사용하도록 설정할지 여부
vmSize	string	VM의 크기입니다. VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 제대로 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Object

컴퓨터 IP 주소 세부 정보입니다.

Name	형식	Description
family	IPFamily	주소가 IPv4 또는 IPv6 제품군에 속하는지 확인하려면
ip	string	기기의 IPv4 또는 IPv6 주소

MachineKubernetesProfile

Object

머신에서 사용하는 Kubernetes 구성입니다.

Name	형식	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	AKS에서 아티팩트 스트리밍을 사용하기 위한 구성입니다.
currentOrchestratorVersion	string	컴퓨터에서 실행 중인 Kubernetes의 버전입니다. orchestratorVersion이 완전히 지정된 version <major.minor.patch>인 경우 이 필드는 정확히 동일합니다. orchestratorVersion이 major.minor<인 >경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다.
kubeletConfig	KubeletConfig	머신의 Kubelet 구성.
kubeletDiskType	KubeletDiskType	emptyDir 볼륨의 위치, 컨테이너 런타임 데이터 루트, 그리고 Kubelet 일시적 storage의 위치를 결정합니다.
maxPods	integer (int32)	노드에서 실행할 수 있는 최대 Pod 수입니다.
nodeInitializationTaints	string[]	만드는 동안 노드에 추가된 taint는 AKS에서 조정되지 않습니다. 이러한 taint는 AKS에서 조정되지 않으며 kubectl 호출을 사용하여 제거할 수 있습니다. 이러한 taint를 사용하면 노드가 워크로드를 수락할 준비가 되기 전에 필요한 구성을 실행할 수 있습니다(예: 'key1=value1:NoSchedule'). `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	시스템의 노드 레이블입니다.
nodeName	string	Kubernetes 클러스터의 노드 이름입니다.
nodeTaints	string[]	머신을 생성하는 동안 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다.
orchestratorVersion	string	사용자가 지정한 Kubernetes의 버전입니다. 패치 버전 <major.minor.patch> 및 <major.minor> 가 모두 지원됩니다. major.minor<를 지정하면 >지원되는 최신 패치 버전이 자동으로 선택됩니다.
workloadRuntime	WorkloadRuntime	노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

MachineNetworkProperties

Object

컴퓨터의 네트워크 속성

Name	형식	Description
enableNodePublicIP	boolean	컴퓨터에 자체 공용 IP가 할당되었는지 여부입니다. 일부 시나리오에서는 컴퓨터가 자체 전용 공용 IP 주소를 받아야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 기본값은 false입니다.
ipAddresses	MachineIpAddress[]	기기의 IPv4, IPv6 주소
nodePublicIPPrefixID	string (arm-id)	VM 노드에서 IP를 사용해야 하는 공용 IP 접두사 ID입니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다.
nodePublicIPTags	IPTag[]	인스턴스 수준 공용 IP의 IPTag입니다.
podSubnetID	string (arm-id)	Pod가 시작될 때 조인할 서브넷의 ID입니다. 생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
vnetSubnetID	string (arm-id)	시작 시 노드와 선택적으로 Pod가 조인할 서브넷의 ID입니다. 지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.

MachineOSProfile

Object

시스템에서 사용하는 운영 체제 및 디스크입니다.

Name	형식	Default value	Description
enableFIPS	boolean		FIPS 사용 OS를 사용할지 여부입니다.
linuxProfile	MachineOSProfileLinuxProfile		Linux 머신의 특정 프로필입니다.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다.
osDiskType	OSDiskType		에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 Ephemeral OS를 참조하세요.
osSKU	OSSKU		에이전트 풀에서 사용하는 OS SKU를 지정합니다. 지정하지 않으면 OSType=Linux인 경우 기본값은 Ubuntu이고 OSType=Windows인 경우 Windows2019입니다. 또한 Windows 2019가 사용되지 않는 경우 기본 Windows OSSKU가 Windows2022로 변경됩니다.
osType	OSType	Linux	운영 체제 유형입니다. 기본값은 Linux입니다.
windowsProfile	AgentPoolWindowsProfile		Windows 컴퓨터의 특정 프로필입니다.

MachineOSProfileLinuxProfile

Object

Linux 머신의 특정 프로필입니다.

Name	형식	Description
linuxOSConfig	LinuxOSConfig	Linux 컴퓨터의 OS 구성입니다.
messageOfTheDay	string	Base64로 인코딩된 Linux 노드에 대한 오늘의 메시지입니다. 디코딩 후 /etc/motd에 기록될 base64로 인코딩된 문자열입니다. 이렇게 하면 Linux 노드에 대한 오늘의 메시지를 사용자 지정할 수 있습니다. Windows 노드에 대해 지정해서는 안 됩니다. 정적 문자열이어야 합니다(즉, 원시로 인쇄되고 스크립트로 실행되지 않음).

MachineProperties

Object

컴퓨터의 속성

Name	형식	Default value	Description
billing	MachineBillingProfile		기계 청구와 관련된 속성들입니다.
eTag	string		낙관적 동시성을 구현하는 데 사용되는 고유한 읽기 전용 문자열입니다. eTag 값은 리소스가 업데이트될 때 변경됩니다. 후속 요청에 대한 eTag 값과 함께 if-match 또는 if-none-match 헤더를 지정하여 일반 eTag 규칙에 따라 낙관적 동시성을 사용하도록 설정합니다.
evictionPolicy	ScaleSetEvictionPolicy	Delete	기계에 대한 퇴거 정책. 우선순위가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다.
hardware	MachineHardwareProfile		컴퓨터의 하드웨어 및 GPU 설정입니다.
kubernetes	MachineKubernetesProfile		머신에서 사용하는 Kubernetes 구성입니다.
localDNSProfile	LocalDNSProfile		VnetDNS 및 KubeDNS 재정의를 사용하여 노드별 로컬 DNS를 구성합니다. LocalDNS는 AKS 클러스터에서 DNS 확인의 성능과 안정성을 향상시키는 데 도움이 됩니다. 자세한 내용은 aka.ms/aks/localdns 참조하십시오.
mode	AgentPoolMode		기계는 '시스템' 및 '사용자' 모드만 허용합니다.
network	MachineNetworkProperties		컴퓨터의 네트워크 속성
nodeImageVersion	string		노드 이미지의 버전입니다.
operatingSystem	MachineOSProfile		시스템에서 사용하는 운영 체제 및 디스크입니다.
priority	ScaleSetPriority	Regular	컴퓨터의 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다.
provisioningState	string		현재 배포 또는 프로비저닝 상태입니다.
resourceId	string (arm-id)		머신의 Azure 리소스 ID입니다. 기본 VM 인스턴스를 GET하는 데 사용할 수 있습니다.
security	MachineSecurityProfile		컴퓨터의 보안 설정입니다.
status	MachineStatus		컴퓨터에 대한 읽기 전용 정보를 포함합니다.
tags	object		컴퓨터에 유지할 태그입니다.

MachineSecurityProfile

Object

컴퓨터의 보안 설정입니다.

Name	형식	Description
enableEncryptionAtHost	boolean	호스트 기반 OS 및 데이터 드라이브 암호화를 사용하도록 설정할지 여부입니다. 이 기능은 특정 VM 크기와 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	보안 부팅은 서명된 운영 체제와 드라이버만 부팅할 수 있도록 하는 신뢰할 수 있는 시작의 기능입니다. 자세한 내용은 aka.ms/aks/trustedlaunch 참조하세요. 지정하지 않으면 기본값은 false입니다.
enableVTPM	boolean	vTPM은 노드에서 로컬로 유지되는 키 및 측정값에 대한 전용 보안 자격 증명 모음을 구성하기 위한 신뢰할 수 있는 시작 기능입니다. 자세한 내용은 aka.ms/aks/trustedlaunch 참조하세요. 지정하지 않으면 기본값은 false입니다.
sshAccess	AgentPoolSSHAccess	에이전트 풀의 SSH access 메서드.

MachineStatus

Object

컴퓨터에 대한 읽기 전용 정보를 포함합니다.

Name	형식	Description
creationTimestamp	string (date-time)	머신이 생성된 시간을 지정합니다.
driftAction	DriftAction	기계의 드리프트 동작. 관리 클러스터 속성의 변경으로 인해 시스템이 예상 상태에서 벗어나 수정 작업이 필요한지 여부를 나타냅니다.
driftReason	string	기계 드리프트의 이유. 기계가 표류한 이유에 대한 자세한 정보를 제공합니다. 기기가 최신 상태인 경우 이 필드는 생략됩니다.
provisioningError	ErrorDetail	오류는 기기의 세부 정보입니다. 실패에 대한 자세한 정보를 보존합니다. 오류가 없는 경우 이 필드는 생략됩니다.
vmState	VmState	가상 머신 상태입니다. 기본 가상 시스템의 현재 상태를 나타냅니다.

ManagementMode

열거형

관리 GPU 경험은 GPU 드라이버 위에 데이터 센터 GPU 관리자(DCGM) 지표와 같은 모니터링용 추가 요소를 설치합니다. 설치된 내용에 대한 자세한 내용은 aka.ms/aks/managed-gpu 를 참고하세요.

값	Description
Unmanaged	NVIDIA GPU에서는 관리 GPU 경험이 비활성화되어 있습니다.
Managed	NVIDIA GPU에서는 관리 GPU 경험이 활성화되어 있습니다.

MigStrategy

열거형

관리형 MIG 지원에 사용할 MIG(다중 인스턴스 GPU) 전략을 설정합니다. 다양한 전략에 대한 자세한 정보는 aka.ms/aks/managed-gpu 를 방문하세요. 지정하지 않은 경우, 기본값은 None입니다.

값	Description
None	MIG 전략을 세우지 마세요. 이전에 한 세트가 있었다면, 이 모드가 그 전략을 덮어쓰고 MIG 전략을 제거합니다.
Single	관리 MIG의 MIG 전략을 단일로 설정하세요.
Mixed	관리 MIG의 MIG 전략을 혼합으로 설정하세요.

NvidiaGPUProfile

Object

NVIDIA 전용 GPU 설정

Name	형식	Description
managementMode	ManagementMode	관리 GPU 경험은 GPU 드라이버 위에 데이터 센터 GPU 관리자(DCGM) 지표와 같은 모니터링용 추가 요소를 설치합니다. 설치된 내용에 대한 자세한 내용은 aka.ms/aks/managed-gpu 를 참고하세요.
migStrategy	MigStrategy	관리형 MIG 지원에 사용할 MIG(다중 인스턴스 GPU) 전략을 설정합니다. 다양한 전략에 대한 자세한 정보는 aka.ms/aks/managed-gpu 를 방문하세요. 지정하지 않은 경우, 기본값은 None입니다.

OSDiskType

열거형

에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 Ephemeral OS를 참조하세요.

값	Description
Managed	Azure는 VM을 다른 호스트로 재배치해야 하는 경우 데이터 손실을 방지하기 위해 가상 머신의 운영 체제 디스크를 Azure Storage에 복제합니다. 컨테이너는 로컬 상태를 유지하도록 설계되지 않았기 때문에 이 동작은 느린 노드 프로비저닝 및 더 높은 읽기/쓰기 대기 시간을 포함하여 몇 가지 단점을 제공하면서 제한된 값을 제공합니다.
Ephemeral	임시 OS 디스크는 임시 디스크와 마찬가지로 호스트 컴퓨터에만 저장됩니다. 이렇게 하면 더 빠른 노드 크기 조정 및 클러스터 업그레이드와 함께 읽기/쓰기 대기 시간이 줄어듭니다.

값

Description

Managed

Azure는 VM을 다른 호스트로 재배치해야 하는 경우 데이터 손실을 방지하기 위해 가상 머신의 운영 체제 디스크를 Azure Storage에 복제합니다. 컨테이너는 로컬 상태를 유지하도록 설계되지 않았기 때문에 이 동작은 느린 노드 프로비저닝 및 더 높은 읽기/쓰기 대기 시간을 포함하여 몇 가지 단점을 제공하면서 제한된 값을 제공합니다.

Ephemeral

임시 OS 디스크는 임시 디스크와 마찬가지로 호스트 컴퓨터에만 저장됩니다. 이렇게 하면 더 빠른 노드 크기 조정 및 클러스터 업그레이드와 함께 읽기/쓰기 대기 시간이 줄어듭니다.

OSSKU

열거형

에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. OSType이 Windows 경우 Kubernetes가 <= 1.25인 경우 Kubernetes가 >= 1.24 또는 Windows2022인 경우 기본값은 Windows2019입니다.

값	Description
Ubuntu	노드 이미지의 OS로 Ubuntu를 사용합니다.
AzureLinux	노드 이미지에 대한 OS로 AzureLinux를 사용합니다. Azure Linux는 Microsoft에서 빌드한 컨테이너 최적화 Linux 배포판으로, 자세한 내용은 https://aka.ms/azurelinux 방문하세요.
AzureLinux3	AzureLinux3을 노드 이미지의 OS로 사용합니다. Azure Linux는 Microsoft에서 빌드한 컨테이너 최적화 Linux 배포판으로, 자세한 내용은 https://aka.ms/azurelinux 방문하세요. 제한 사항은 을 참조하십시오 https://aka.ms/aks/node-images. OS 마이그레이션 지침은 을 참조하십시오 https://aka.ms/aks/upgrade-os-version.
Mariner	사용되지 않는 OSSKU입니다. 대신 새 배포에서 'AzureLinux'를 선택하는 것이 좋습니다.
Flatcar	Flatcar Container Linux를 노드 이미지의 OS로 사용합니다. Flatcar는 컨테이너에 최적화되고 보안에 중점을 둔 Linux OS로, 변경할 수 없는 파일 시스템과 CNCF(Cloud Native Computing Foundation)의 일부를 갖추고 있습니다. AKS용 Flatcar Container Linux에 대한 자세한 내용은 aka.ms/aks/flatcar-container-linux-for-aks 참조하세요.
CBLMariner	사용되지 않는 OSSKU입니다. 대신 새 배포에서 'AzureLinux'를 선택하는 것이 좋습니다.
Windows2019	노드 이미지의 OS로 Windows2019를 사용합니다. 시스템 노드 풀에 대해 지원되지 않습니다. Windows2019는 Windows2019 컨테이너만 지원합니다. Windows2022 컨테이너를 실행할 수 없으며 그 반대의 경우도 마찬가지입니다.
Windows2022	노드 이미지의 OS로 Windows2022를 사용합니다. 시스템 노드 풀에 대해 지원되지 않습니다. Windows2022는 Windows2022 컨테이너만 지원합니다. Windows2019 컨테이너를 실행할 수 없으며 그 반대의 경우도 마찬가지입니다.
Ubuntu2204	Ubuntu2204를 노드 이미지의 OS로 사용하지만 Ubuntu 22.04는 모든 노드 풀에 대해 지원되지 않을 수 있습니다. 제한 사항 및 지원되는 Kubernetes 버전은 https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Windows2025를 노드 이미지의 OS로 사용합니다. 시스템 노드 풀에 대해 지원되지 않습니다. Windows2025는 Windows2022 및 Windows 2025 컨테이너를 지원합니다. Windows2019 컨테이너를 실행할 수 없으며 그 반대의 경우도 마찬가지입니다.
WindowsAnnual	노드 이미지에 대한 OS로 Windows 연간 채널 버전을 사용합니다. 시스템 노드 풀에 대해 지원되지 않습니다. 다양한 AKS 연간 채널 버전에서 지원되는 컨테이너 이미지 및 kubernetes 버전에 대한 세부 정보는 https://aka.ms/aks/windows-annual-channel-details확인할 수 있습니다.
Ubuntu2404	노드 이미지의 OS로 Ubuntu2404를 사용하지만 Ubuntu 24.04는 모든 노드 풀에 대해 지원되지 않을 수 있습니다. 제한 사항 및 지원되는 kubernetes 버전은 다음을 참조하세요. https://aka.ms/aks/supported-ubuntu-versions

OSType

열거형

운영 체제 유형입니다. 기본값은 Linux입니다.

값	Description
Linux	Linux를 사용합니다.
Windows	Windows를 사용합니다.

ScaleSetEvictionPolicy

열거형

Virtual Machine Scale Set 제거 정책입니다. 퇴거 정책에는 퇴거 시 VM에 어떤 to do이 있는지 명시되어 있습니다. 기본값은 삭제입니다. 퇴거에 관한 자세한 내용은 spot VMs

값	Description
Delete	노드 풀의 기본 확장 집합에 있는 노드는 제거될 때 삭제됩니다.
Deallocate	노드 풀의 기본 확장 집합에 있는 노드는 제거 시 중지됨-할당 취소 상태로 설정됩니다. 중지된 할당 취소 상태의 노드가 컴퓨팅 할당량에 대해 계산 할당량에 대해 계산되고 클러스터 크기 조정 또는 업그레이드에 문제가 발생할 수 있습니다.

ScaleSetPriority

열거형

Virtual Machine Scale Set 우선 순위입니다.

값	Description
Spot	스폿 우선 순위 VM이 사용됩니다. 스폿 노드에 대한 SLA가 없습니다. 자세한 내용은 AKS 지점을 참조하세요.
Regular	일반 VM이 사용됩니다.

SeccompDefault

열거형

모든 워크로드에 적용되는 기본 seccomp 프로필을 지정합니다. 지정하지 않으면 기본적으로 'Unconfined'가 사용됩니다.

값	Description
Unconfined	seccomp 프로파일이 적용되지 않아 모든 시스템 호출이 허용됩니다.
RuntimeDefault	컨테이너 런타임에 대한 기본 seccomp 프로파일이 적용되어 보안 강화를 위해 특정 시스템 호출을 제한합니다.

SysctlConfig

Object

Linux 에이전트 노드에 대한 Sysctl 설정입니다.

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

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

VmState

열거형

가상 머신 상태입니다. 기본 가상 시스템의 현재 상태를 나타냅니다.

값	Description
Running	가상 시스템이 현재 실행 중입니다.
Deleted	가상 머신이 사용자에 의해 삭제되었거나 스팟 제거로 인해 삭제되었습니다.

WorkloadRuntime

열거형

노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

값	Description
OCIContainer	노드는 Kubelet을 사용하여 표준 OCI 컨테이너 워크로드를 실행합니다.
WasmWasi	노드는 Krustlet을 사용하여 WASI 공급자(미리 보기)를 사용하여 WASM 워크로드를 실행합니다.
KataMshvVmIsolation	노드는 (Kata + 클라우드 하이퍼바이저 + Hyper-V)를 사용하여 중첩된 VM 기반 Pod(미리 보기)를 사용하도록 설정할 수 있습니다. Hyper-V를 사용하기 때문에 AKS 노드 OS 자체는 Hyper-V의 중첩된 VM(루트 OS)입니다. 따라서 Dv3 시리즈와 같은 중첩된 가상화를 지원하는 VM 시리즈에서만 사용할 수 있습니다. 이 명명 규칙은 KataVmIsolation을 위해 향후 릴리스에서 더 이상 사용되지 않습니다.
KataVmIsolation	노드는 (Kata + Cloud Hypervisor + Hyper-V)를 사용하여 중첩된 VM 기반 Pod를 사용하도록 설정할 수 있습니다. Hyper-V를 사용하기 때문에 AKS 노드 OS 자체는 Hyper-V의 중첩된 VM(루트 OS)입니다. 따라서 Dv3 시리즈와 같은 중첩된 가상화를 지원하는 VM 시리즈에서만 사용할 수 있습니다.

다음을 통해 공유

Machines - Create Or Update

URI 매개 변수

요청 헤더

요청 본문

응답

보안

azure_auth

범위

예제

Create/Update Machine

샘플 요청

샘플 응답

정의

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