Managed Clusters - List

서비스:: AKS

API 버전:: 2026-08-01

지정된 구독의 관리되는 클러스터 목록을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/managedClusters?api-version=2026-08-01

URI 매개 변수

속성	In(다음 안에)	필수	형식	Description
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

속성	형식	Description
200 OK	ManagedClusterListResult	Azure 운영이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

속성	Description
user_impersonation	사용자 계정을 사칭하다

예제

List Managed Clusters

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/managedClusters?api-version=2026-08-01


/**
 * Samples for ManagedClusters List.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-08-01/ManagedClustersList.json
     */
    /**
     * Sample code: List Managed Clusters.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void listManagedClusters(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getManagedClusters().list(com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python managed_clusters_list.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.managed_clusters.list()
    for item in response:
        print(item)


# x-ms-original-file: 2026-08-01/ManagedClustersList.json
if __name__ == "__main__":
    main()

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

package armcontainerservice_test

import (
	"context"
	"log"

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

// Generated from example definition: 2026-08-01/ManagedClustersList.json
func ExampleManagedClustersClient_NewListPager() {
	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)
	}
	pager := clientFactory.NewManagedClustersClient().NewListPager(nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armcontainerservice.ManagedClustersClientListResponse{
		// 	ManagedClusterListResult: armcontainerservice.ManagedClusterListResult{
		// 		Value: []*armcontainerservice.ManagedCluster{
		// 			{
		// 				Name: to.Ptr("clustername1"),
		// 				Type: to.Ptr("Microsoft.ContainerService/managedClusters"),
		// 				ETag: to.Ptr("nvweuib"),
		// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1"),
		// 				Location: to.Ptr("location1"),
		// 				Properties: &armcontainerservice.ManagedClusterProperties{
		// 					AgentPoolProfiles: []*armcontainerservice.ManagedClusterAgentPoolProfile{
		// 						{
		// 							Name: to.Ptr("nodepool1"),
		// 							Count: to.Ptr[int32](3),
		// 							CurrentOrchestratorVersion: to.Ptr("1.9.6"),
		// 							ETag: to.Ptr("byuefvwi"),
		// 							MaxPods: to.Ptr[int32](110),
		// 							OrchestratorVersion: to.Ptr("1.9.6"),
		// 							OSType: to.Ptr(armcontainerservice.OSTypeLinux),
		// 							ProvisioningState: to.Ptr("Succeeded"),
		// 							VMSize: to.Ptr("Standard_DS1_v2"),
		// 						},
		// 					},
		// 					CurrentKubernetesVersion: to.Ptr("1.9.6"),
		// 					DiskEncryptionSetID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"),
		// 					DNSPrefix: to.Ptr("dnsprefix1"),
		// 					EnableRBAC: to.Ptr(false),
		// 					Fqdn: to.Ptr("dnsprefix1-abcd1234.hcp.eastus.azmk8s.io"),
		// 					KubernetesVersion: to.Ptr("1.9.6"),
		// 					LinuxProfile: &armcontainerservice.LinuxProfile{
		// 						AdminUsername: to.Ptr("azureuser"),
		// 						SSH: &armcontainerservice.SSHConfiguration{
		// 							PublicKeys: []*armcontainerservice.SSHPublicKey{
		// 								{
		// 									KeyData: to.Ptr("keydata"),
		// 								},
		// 							},
		// 						},
		// 					},
		// 					MaxAgentPools: to.Ptr[int32](1),
		// 					NetworkProfile: &armcontainerservice.NetworkProfile{
		// 						DNSServiceIP: to.Ptr("10.0.0.10"),
		// 						NetworkPlugin: to.Ptr(armcontainerservice.NetworkPluginKubenet),
		// 						PodCidr: to.Ptr("10.244.0.0/16"),
		// 						ServiceCidr: to.Ptr("10.0.0.0/16"),
		// 					},
		// 					NodeResourceGroup: to.Ptr("MC_rg1_clustername1_location1"),
		// 					ProvisioningState: to.Ptr("Succeeded"),
		// 					ServicePrincipalProfile: &armcontainerservice.ManagedClusterServicePrincipalProfile{
		// 						ClientID: to.Ptr("clientid"),
		// 					},
		// 				},
		// 				Tags: map[string]*string{
		// 					"archv2": to.Ptr(""),
		// 					"tier": to.Ptr("production"),
		// 				},
		// 			},
		// 		},
		// 	},
		// }
	}
}

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "name": "clustername1",
      "type": "Microsoft.ContainerService/managedClusters",
      "eTag": "nvweuib",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
      "location": "location1",
      "properties": {
        "agentPoolProfiles": [
          {
            "name": "nodepool1",
            "count": 3,
            "currentOrchestratorVersion": "1.9.6",
            "eTag": "byuefvwi",
            "maxPods": 110,
            "orchestratorVersion": "1.9.6",
            "osType": "Linux",
            "provisioningState": "Succeeded",
            "vmSize": "Standard_DS1_v2"
          }
        ],
        "currentKubernetesVersion": "1.9.6",
        "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
        "dnsPrefix": "dnsprefix1",
        "enableRBAC": false,
        "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
        "kubernetesVersion": "1.9.6",
        "linuxProfile": {
          "adminUsername": "azureuser",
          "ssh": {
            "publicKeys": [
              {
                "keyData": "keydata"
              }
            ]
          }
        },
        "maxAgentPools": 1,
        "networkProfile": {
          "dnsServiceIP": "10.0.0.10",
          "networkPlugin": "kubenet",
          "podCidr": "10.244.0.0/16",
          "serviceCidr": "10.0.0.0/16"
        },
        "nodeResourceGroup": "MC_rg1_clustername1_location1",
        "provisioningState": "Succeeded",
        "servicePrincipalProfile": {
          "clientId": "clientid"
        }
      },
      "tags": {
        "archv2": "",
        "tier": "production"
      }
    }
  ]
}

정의

속성	Description
AccelerationMode	고급 네트워크 가속 옵션을 활성화합니다. 이를 통해 사용자는 BPF 호스트 라우팅을 사용하여 가속을 구성할 수 있습니다. 이는 Cilium 데이터플레인에서만 활성화할 수 있습니다. 지정하지 않으면 기본값은 없음(가속 없음)입니다. 가속 모드는 기존 클러스터에서 변경할 수 있습니다. 자세한 설명은 참조하십시오 https://aka.ms/acnsperformance
AdvancedNetworking	클러스터에서 관찰 가능성 및 보안 기능 제품군을 사용하도록 설정하기 위한 고급 네트워킹 프로필입니다. 자세한 내용은 aka.ms/aksadvancednetworking 참조하세요.
AdvancedNetworkingObservability	기록 컨텍스트를 사용하여 고급 네트워크 메트릭 및 흐름 로그를 사용하도록 설정하는 관찰성 프로필입니다.
AdvancedNetworkingPerformance	Cilium 기반 Azure CNI를 사용하는 클러스터에서 성능 향상 기능을 활성화하는 프로파일.
AdvancedNetworkingSecurity	cilium 기반 클러스터에서 보안 기능을 사용하도록 설정하는 보안 프로필입니다.
AdvancedNetworkingSecurityTransitEncryption	Cilium 기반 클러스터에 대한 암호화 구성입니다. 사용하도록 설정하면 Cilium 관리 Pod 간의 모든 트래픽이 노드 경계를 벗어날 때 암호화됩니다.
AdvancedNetworkPolicies	고급 네트워크 정책을 사용하도록 설정합니다. 이를 통해 사용자는 계층 7 네트워크 정책(FQDN, HTTP, Kafka)을 구성할 수 있습니다. 정책 자체는 Cilium 네트워크 정책 리소스를 통해 구성해야 합니다.https://docs.cilium.io/en/latest/security/policy/index.html 이는 cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 security.enabled가 true로 설정된 경우 기본값은 FQDN입니다.
AgentPoolArtifactStreamingProfile	에이전트 풀의 아티팩트 스트리밍 프로필.
AgentPoolGatewayProfile	관리형 클러스터 게이트웨이 에이전트 풀의 프로필입니다.
AgentPoolMode	에이전트 풀의 모드입니다. 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolNetworkProfile	에이전트 풀의 네트워크 설정입니다.
AgentPoolSecurityProfile	에이전트 풀의 보안 설정입니다.
AgentPoolSSHAccess	에이전트 풀의 SSH access 메서드.
AgentPoolStatus	에이전트 풀에 대한 읽기 전용 정보를 포함합니다.
AgentPoolType	에이전트 풀의 형식입니다.
AgentPoolUpgradeSettings	에이전트 풀 업그레이드 설정
AgentPoolWindowsProfile	Windows 에이전트 풀의 특정 프로필입니다.
ArtifactSource	아티팩트 원본입니다. 아티팩트가 다운로드되는 원본입니다.
AutoScaleProfile	자동 크기 조정에 대한 사양입니다.
AzureKeyVaultKms	보안 프로필에 대한 Azure Key Vault 키 관리 서비스 설정입니다.
BackendPoolType	관리되는 인바운드 Load Balancer 백엔드풀의 유형입니다.
ClusterUpgradeSettings	클러스터 업그레이드에 대한 설정입니다.
Code	클러스터가 실행 중인지 또는 중지되었는지 여부를 알려줍니다.
ContainerNetworkLogs	Azure Monitor에서 컨테이너 네트워크 로그 수집에 허용된 값들. 일 때`Enabled`, 인지되는 특정 로그 유형은 관련 CRD에 의해 제어되며, 기본값은 입니다.`Disabled` 자세한 내용은 참조 https://aka.ms/ContainerNetworkLogsDoc 하세요 https://aka.ms/acns/howtoenablecnl .
ContainerServiceLinuxProfile	컨테이너 서비스 클러스터의 Linux VM에 대한 프로필입니다.
ContainerServiceNetworkProfile	네트워크 구성의 프로필입니다.
ContainerServiceSshConfiguration	Azure에서 실행되는 Linux 기반 VM에 대한 SSH 구성입니다.
ContainerServiceSshPublicKey	SSH 인증서 공개 키 데이터에 대한 정보를 포함합니다.
createdByType	리소스를 만든 ID 유형입니다.
CreationData	원본 리소스에서 대상 리소스를 만들 때 사용되는 데이터입니다.
DelegatedResource	위임된 리소스 속성 - 내부 전용입니다.
DRANETMode	에이전트 풀을 위한 DRANET 모드입니다.
DRANETProfile	에이전트 풀의 DRANET 설정.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
Expander	확장할 때 사용할 확장기입니다. 지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기 참조하세요.
ExtendedLocation	확장된 위치의 복합 형식입니다.
ExtendedLocationTypes	extendedLocation의 형식입니다.
GatewayAPIIstioEnabled	Istio를 관리 인그레스와 함께 App Routing을 위한 게이트웨이 API 구현을 활성화할지 여부.
GPUDriver	GPU 드라이버를 설치할지 여부입니다. 지정하지 않으면 기본값은 Install입니다.
GPUInstanceProfile	지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.
GPUProfile	에이전트 풀에 대한 GPU 설정입니다.
InfrastructureEncryption	서비스 관리형 키를 사용하여 Kubernetes 리소스 개체의 미사용 암호화를 사용하도록 설정할지 여부입니다. 이에 대한 자세한 내용은 에서 찾을 https://aka.ms/aks/kubernetesResourceObjectEncryption수 있습니다.
IPFamily	주소가 IPv4 또는 IPv6 제품군에 속하는지 확인하려면
IPTag	개체와 연결된 IPTag를 포함합니다.
IstioCertificateAuthority	Istio Service Mesh CA(인증 기관) 구성. 지금은 여기에 설명된 대로 플러그 인 인증서만 지원합니다https://aka.ms/asm-plugin-ca
IstioComponents	Istio 구성 요소 구성
IstioEgressGateway	Istio 송신 게이트웨이 구성.
IstioIngressGateway	Istio 수신 게이트웨이 구성. 현재는 `aks-istio-ingressgateway-external`라는 하나의 외부 수신 게이트웨이와 `aks-istio-ingressgateway-internal`라는 하나의 내부 수신 게이트웨이를 지원합니다.
IstioIngressGatewayMode	수신 게이트웨이의 모드입니다.
IstioPluginCertificateAuthority	Service Mesh에 대한 플러그 인 인증서 정보입니다.
IstioServiceMesh	Istio 서비스 메시 구성.
KeyVaultNetworkAccessTypes	key vault의 네트워크 access. key vault의 네트워크 access. 가능한 값은 `Public` 및 `Private`입니다. `Public`는 key vault가 모든 네트워크에서 공access을 허용함을 의미합니다. `Private`는 key vault가 공공 access을 비활성화하고 private link을 가능하게 함을 의미합니다. 기본값은 `Public`입니다.
KubeletConfig	에이전트 노드의 Kubelet 구성입니다. 자세한 내용은 AKS 사용자 지정 노드 구성 참조하세요.
KubeletDiskType	emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.
KubernetesResourceObjectEncryptionProfile	서비스 관리형 키를 사용하여 Kubernetes 리소스 개체의 미사용 암호화. 이에 대한 자세한 내용은 에서 찾을 https://aka.ms/aks/kubernetesResourceObjectEncryption수 있습니다.
KubernetesSupportPlan	AKS 관리형 클러스터에 대한 다양한 지원 계층
LicenseType	Windows VM에 사용할 라이선스 유형입니다. 자세한 내용은 Azure 하이브리드 사용자 혜택을 참조하세요.
LinuxOSConfig	Linux 에이전트 노드의 OS 구성. 자세한 내용은 AKS 사용자 지정 노드 구성 참조하세요.
LoadBalancerSku	관리되는 클러스터용 load balancer sku입니다. 기본값은 'standard'입니다. 부하 분산기 SKU의 차이에 대한 자세한 내용은 Azure Load Balancer SKU를 참조하세요.
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의 시스템 생성 상태입니다.
ManagedCluster	관리형 클러스터.
ManagedClusterAADProfile	AADProfile은 Azure Active Directory 통합에 대한 특성을 지정합니다. 자세한 내용은 AKS관리되는 AAD를 참조하세요.
ManagedClusterAddonProfile	관리형 클러스터에 대한 Kubernetes 추가 기능 프로필입니다.
ManagedClusterAddonProfileIdentity	이 추가 기능에서 사용하는 사용자 할당 ID의 정보입니다.
ManagedClusterAgentPoolProfile	컨테이너 서비스 에이전트 풀에 대한 프로필입니다.
ManagedClusterAIToolchainOperatorProfile	운영자를 사용하도록 설정하면 AKS 관리형 CRD 및 컨트롤러 집합이 클러스터에 설치됩니다. 운영자는 유추 및/또는 학습 목적으로 OSS 모델의 배포를 자동화합니다. 미리 설정된 모델 집합을 제공하고 이에 대한 분산 유추를 사용하도록 설정합니다.
ManagedClusterAPIServerAccessProfile	관리형 클러스터 API 서버에 대한 액세스 프로필입니다.
ManagedClusterAppRoutingIstio	Gateway API와 App Routing을 통한 관리된 인그레스를 위한 사이드카 없는 Istio 제어 플레인 설정. 게이트웨이 API를 통한 인그레스 사용에 관한 정보는 참고 https://aka.ms/gateway-on-istio 하세요.
ManagedClusterAutoUpgradeProfile	관리되는 클러스터에 대한 자동 업그레이드 프로필입니다.
ManagedClusterAzureMonitorProfile	관리된 클러스터를 모니터링하는 Azure Monitor 애드온 프로필.
ManagedClusterAzureMonitorProfileAppMonitoring	AKS용 애플리케이션 모니터링 프로필.
ManagedClusterAzureMonitorProfileAppMonitoringAutoInstrumentation	AKS용 애플리케이션 모니터링 자동 계측. Microsoft OpenTelemetry 배포판을 통해 워크로드를 자동으로 계측하여 OpenTelemetry 지표, 로그, 추적을 수집하는 웹훅을 배포합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.
ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryLogsAndTraces	애플리케이션 모니터링 OpenTelemetry 로그와 추적 프로필은 AKS입니다. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션의 OpenTelemetry 로그와 추적을 수집합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.
ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryMetrics	애플리케이션 모니터링 OpenTelemetry Metrics AKS 프로파일. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션의 OpenTelemetry 지표를 수집합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.
ManagedClusterAzureMonitorProfileContainerInsights	Azure Monitor Container Insights profile. Kubernetes 이벤트, 인벤토리, 컨테이너 stdout 및 stderr 로그 수집 구성을 나타냅니다. 개요는 aka.ms/AzureMonitorContainerInsights 참조하세요.
ManagedClusterAzureMonitorProfileKubeStateMetrics	Azure Managed Prometheus 추가 기능에 대한 Kube 상태 메트릭 프로필입니다. 이러한 선택적 설정은 추가 기능과 함께 배포되는 kube-state-metrics Pod에 대한 것입니다. 자세한 내용은 aka.ms/AzureManagedPrometheus-optional-parameters 참조하세요.
ManagedClusterAzureMonitorProfileMetrics	Prometheus 추가 기능에 대한 Azure Monitor 관리 서비스에 대한 메트릭 프로필입니다. 기본 Kubernetes 인프라 메트릭을 수집하여 Azure Monitor 작업 영역으로 보내고 사용자 지정 대상에 대한 추가 스크래핑을 구성합니다. 개요는 aka.ms/AzureManagedPrometheus 참조하세요.
ManagedClusterAzureMonitorProfileMetricsControlPlane	Control plane metrics collection profile for the Azure Managed Prometheus addon. 관리되는 제어 평면 컴포넌트(kube-apiserver, etcd 등)에서 운영 런타임 메트릭을 수집하도록 구성합니다. 개요는 aka.ms/aks/controlplane-metrics 를 참고하세요.
ManagedClusterBootstrapProfile	부트스트랩 프로필입니다.
ManagedClusterCostAnalysis	클러스터에 대한 비용 분석 구성
ManagedClusterHostedSystemProfile	호스팅된 시스템 애드온에 대한 설정입니다.
ManagedClusterHTTPProxyConfig	클러스터 HTTP 프록시 구성.
ManagedClusterIdentity	관리되는 클러스터의 ID입니다.
ManagedClusterIngressProfile	컨테이너 서비스 클러스터에 대한 수신 프로필입니다.
ManagedClusterIngressProfileGatewayConfiguration	관리형 게이트웨이 API CRD에 대한 구성. 자세한 내용은 https://aka.ms/k8s-gateway-api를 참조하세요.
ManagedClusterIngressProfileNginx	관리된 클러스터 인그레스 프로필을 위한 Nginx 인그레스 컨트롤러 설정.
ManagedClusterIngressProfileWebAppRouting	수신 프로필에 대한 애플리케이션 라우팅 추가 기능 설정입니다.
ManagedClusterListResult	ManagedCluster 리스트 작업의 응답.
ManagedClusterLoadBalancerProfile	관리형 클러스터 부하 분산 장치의 프로필입니다.
ManagedClusterLoadBalancerProfileManagedOutboundIPs	클러스터 부하 분산 장치에 대한 원하는 관리형 아웃바운드 IP입니다.
ManagedClusterLoadBalancerProfileOutboundIPPrefixes	클러스터 부하 분산 장치에 대한 원하는 아웃바운드 IP 접두사 리소스입니다.
ManagedClusterLoadBalancerProfileOutboundIPs	클러스터 부하 분산 장치에 필요한 아웃바운드 IP 리소스입니다.
ManagedClusterManagedOutboundIPProfile	관리형 클러스터의 관리되는 아웃바운드 IP 리소스 프로필입니다.
ManagedClusterMetricsProfile	ManagedCluster에 대한 메트릭 프로필입니다.
ManagedClusterNATGatewayProfile	관리형 클러스터 NAT 게이트웨이의 프로필입니다.
ManagedClusterNATGatewaySku	관리형 클러스터 NAT 게이트웨이의 SKU입니다.
ManagedClusterNodeProvisioningProfile	관리되는 클러스터용 노드 프로비저닝 프로필.
ManagedClusterNodeResourceGroupProfile	관리되는 클러스터에 대한 노드 리소스 그룹 잠금 프로필입니다.
ManagedClusterOIDCIssuerProfile	관리형 클러스터의 OIDC 발급자 프로필입니다.
ManagedClusterPodIdentity	관리형 클러스터에 할당된 Pod ID에 대한 세부 정보입니다.
ManagedClusterPodIdentityException	특정 레이블이 있는 Pod가 NMI(노드 관리 ID) 서버에서 가로채지 않고 IMDS(Azure Instance Metadata Service) 엔드포인트에 액세스할 수 있도록 하는 Pod ID 예외입니다. 자세한 내용은 특정 Pod/애플리케이션 AAD Pod ID를 사용하지 않도록 설정하는 참조하세요.
ManagedClusterPodIdentityProfile	관리형 클러스터의 Pod ID 프로필입니다. Pod ID 통합에 대한 자세한 내용은 AAD Pod ID 사용하는 참조하세요.
ManagedClusterPodIdentityProvisioningError	Pod ID 프로비저닝의 오류 응답입니다.
ManagedClusterPodIdentityProvisioningErrorBody	Pod ID 프로비저닝의 오류 응답입니다.
ManagedClusterPodIdentityProvisioningInfo	포드 신원 프로비저닝 정보.
ManagedClusterPodIdentityProvisioningState	Pod ID의 현재 프로비저닝 상태입니다.
ManagedClusterPropertiesAutoScalerProfile	사용하도록 설정된 경우 클러스터 자동 크기 조정기에 적용할 매개 변수
ManagedClusterSecurityProfile	컨테이너 서비스 클러스터에 대한 보안 프로필입니다.
ManagedClusterSecurityProfileDefender	보안 프로필에 대한 Microsoft Defender 설정입니다.
ManagedClusterSecurityProfileDefenderSecurityGating	Microsoft Defender의 보안 게이팅 설정. 이는 Defender for Containers 보안 결과를 바탕으로 컨테이너 이미지 배포 자격을 검증합니다. Admission Controller를 사용하여 보안 기준을 충족하지 않는 이미지의 배포를 감사하거나 차단합니다.
ManagedClusterSecurityProfileDefenderSecurityGatingIdentity	Defender에서 레지스트리 접근을 위한 보안 게이팅에서 사용되는 신원 매핑.
ManagedClusterSecurityProfileDefenderSecurityMonitoring	보안 프로필 위협 검색에 대한 Microsoft Defender 설정입니다.
ManagedClusterSecurityProfileImageCleaner	Image Cleaner는 노드에서 사용되지 않는 이미지를 제거하여 디스크 공간을 확보하고 공격 노출 영역을 줄이는 데 도움이 됩니다. 다음은 보안 프로필에 대한 설정입니다.
ManagedClusterSecurityProfileWorkloadIdentity	보안 프로필에 대한 워크로드 ID 설정입니다.
ManagedClusterServicePrincipalProfile	클러스터가 Azure API를 조작할 때 사용할 서비스 주체 신원에 관한 정보입니다.
ManagedClusterSKU	관리형 클러스터의 SKU입니다.
ManagedClusterSKUName	관리되는 클러스터 SKU의 이름입니다.
ManagedClusterSKUTier	관리되는 클러스터 SKU의 계층입니다. 지정하지 않으면 기본값은 'Free'입니다. 자세한 내용은 AKS 가격 티어를 참조하세요.
ManagedClusterStaticEgressGatewayProfile	클러스터에 대한 정적 송신 게이트웨이 추가 기능 구성입니다.
ManagedClusterStatus	관리형 클러스터에 대한 읽기 전용 정보를 포함합니다.
ManagedClusterStorageProfile	컨테이너 서비스 클러스터에 대한 스토리지 프로필입니다.
ManagedClusterStorageProfileBlobCSIDriver	스토리지 프로필에 대한 AzureBlob CSI 드라이버 설정입니다.
ManagedClusterStorageProfileDiskCSIDriver	스토리지 프로필에 대한 AzureDisk CSI 드라이버 설정입니다.
ManagedClusterStorageProfileFileCSIDriver	스토리지 프로필에 대한 AzureFile CSI 드라이버 설정입니다.
ManagedClusterStorageProfileSnapshotController	스토리지 프로필에 대한 스냅샷 컨트롤러 설정입니다.
ManagedClusterWebAppRoutingGatewayAPIImplementations	App Routing을 이용한 관리 인그레스에 사용되는 게이트웨이 API 제공자 구성.
ManagedClusterWindowsProfile	관리되는 클러스터의 Windows VM에 대한 프로필입니다.
ManagedClusterWorkloadAutoScalerProfile	관리되는 클러스터에 대한 워크로드 자동 크기 조정기 프로필입니다.
ManagedClusterWorkloadAutoScalerProfileKeda	워크로드 자동 크기 조정기 프로필에 대한 KEDA(Kubernetes 이벤트 기반 자동 크기 조정) 설정입니다.
ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler	워크로드 자동 크기 조정기 프로필에 대한 VPA(Vertical Pod Autoscaler) 설정입니다.
ManagedGatewayType	관리형 게이트웨이 API 설치에 대한 구성입니다. 지정하지 않으면 기본값은 '사용 안 함'입니다. 자세한 내용은 https://aka.ms/k8s-gateway-api를 참조하세요.
ManagedServiceIdentityUserAssignedIdentitiesValue	사용자 할당 ID 속성입니다.
ManagementMode	관리 GPU 경험은 GPU 드라이버 위에 데이터 센터 GPU 관리자(DCGM) 지표와 같은 모니터링용 추가 요소를 설치합니다. 설치된 내용에 대한 자세한 내용은 aka.ms/aks/managed-gpu 를 참고하세요.
ManualScaleProfile	컴퓨터 수에 대한 사양입니다.
NetworkDataplane	Kubernetes 클러스터에서 사용되는 네트워크 데이터 평면입니다.
NetworkMode	Azure CNI가 설정한 네트워크 모드입니다. networkPlugin이 'azure'가 아닌 경우 지정할 수 없습니다.
NetworkPlugin	Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 플러그 인입니다.
NetworkPluginMode	네트워크 플러그 인에서 사용해야 하는 모드입니다.
NetworkPolicy	Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 정책입니다.
NginxIngressControllerType	기본 NginxIngressController 사용자 지정 리소스에 대한 수신 형식
NodeOSUpgradeChannel	노드 OS 업그레이드 채널. 노드의 OS가 업데이트되는 방식입니다. 기본값은 NodeImage입니다.
NodeProvisioningDefaultNodePools	노드 프로비저닝을 위해 구성된 기본 Karpenter NodePool(CRD) 집합입니다. 이 필드는 모드가 '자동'이 아니면 효과가 없습니다. 경고: 기존 클러스터에서 이를 자동에서 없음으로 변경하면 기본 Karpenter NodePools가 삭제되어 해당 풀과 연결된 노드가 드레이닝되고 삭제됩니다. 해당 작업에 의해 축출된 파드를 사용할 준비가 된 유휴 노드가 없는 한 이 작업을 수행하지 않는 것이 좋습니다. 지정하지 않으면 기본값은 Auto입니다. 자세한 내용은 aka.ms/aks/nap#node-pools 참조하십시오.
NodeProvisioningMode	노드 프로비저닝 모드입니다. 지정하지 않으면 기본값은 수동입니다.
NvidiaGPUProfile	NVIDIA 전용 GPU 설정
OSDiskType	에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요.
OSSKU	에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. 기본 설정은 Kubernetes <= 1.24 시에는 Windows2019, OSType가 Windows 시에는 Windows2022 >= 1.25입니다.
OSType	운영 체제 유형입니다. 기본값은 Linux입니다.
OutboundIPPrefixes	관리되는 NAT 게이트웨이를 위한 원하는 아웃바운드 IP 프리픽스 리소스. NAT 게이트웨이 V2와만 호환됩니다.
OutboundIPs	관리형 NAT 게이트웨이를 위한 원하는 아웃바운드 IP 자원.
OutboundType	아웃바운드(송신) 라우팅 메서드입니다. 클러스터를 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다. 자세한 내용은 egress outbound type을 참조하세요.
PodIPAllocationMode	파드 IP 할당 모드. 에이전트 풀의 Pod에 대한 IP 할당 모드입니다. podSubnetId와 함께 사용해야 합니다. 기본값은 'DynamicIndividual'입니다.
PortRange	포트 범위입니다.
PowerState	클러스터의 전원 상태를 설명합니다.
PrivateLinkResource	프라이빗 링크 리소스
Protocol	포트의 네트워크 프로토콜입니다.
ProxyRedirectionMechanism	트래픽 리디렉션 모드입니다.
PublicNetworkAccess	PublicNetworkAccess를 사용합니다. AKS의 공용 네트워크 access 허용 또는 거부
ResourceIdentityType	관리되는 클러스터에 사용되는 ID 유형입니다. 자세한 내용은 AKS의 use 관리 식별을 참조하세요.
ResourceReference	Azure 리소스에 대한 참조입니다.
RestrictionLevel	클러스터의 노드 리소스 그룹에 적용되는 제한 수준입니다. 지정하지 않으면 기본값은 'Unrestricted'입니다.
ScaleDownMode	VM을 에이전트 풀에 추가하거나 에이전트 풀에서 제거하는 방법에 대해 설명합니다. 청구 상태를 참조하세요.
ScaleProfile	VirtualMachines 에이전트 풀의 크기를 조정하는 방법에 대한 사양입니다.
ScaleSetEvictionPolicy	Virtual Machine Scale Set 제거 정책입니다. 퇴거 정책에는 퇴거 시 VM에 어떤 to do이 있는지 명시되어 있습니다. 기본값은 삭제입니다. 퇴거에 관한 자세한 내용은 spot VMs
ScaleSetPriority	Virtual Machine Scale Set 우선 순위입니다.
SchedulerConfigMode	이 스케줄러 인스턴스에 대한 구성 사용자 지정 모드입니다.
SchedulerInstanceProfile	AKS가 관리하는 스케줄러 특정 인스턴스와 관련된 설정이 포함된 프로필.
SchedulerProfile	AKS가 관리하는 각 스케줄러 설정 모드 같은 스케줄러 관련 설정이 포함된 프로필. https://aka.ms/aks/scheduler-profile을(를) 참조하세요.
ServiceMeshMode	서비스 메시의 모드입니다.
ServiceMeshProfile	관리되는 클러스터에 대한 서비스 메시 프로필입니다.
SysctlConfig	Linux 에이전트 노드에 대한 Sysctl 설정입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TransitEncryptionType	Pod 간 암호화를 구성합니다. 이는 Cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 기본값은 None입니다.
UndrainableNodeBehavior	업그레이드하는 동안 표시할 수 없는 노드에 대한 동작을 정의합니다. 그리기 불가능한 노드의 가장 일반적인 원인은 Pod 중단 예산(PDB)이지만, Pod 종료 유예 기간과 같은 다른 문제는 노드당 남은 드레이닝 시간 제한을 초과하거나 Pod가 여전히 실행 중인 상태일 수도 있습니다.
UpgradeChannel	자동 업그레이드를 위한 업그레이드 채널입니다. 기본값은 'none'입니다. 자세한 내용은 AKS 클러스터 자동 업그레이드 채널 설정을 참조하세요.
UpgradeOverrideSettings	클러스터를 업그레이드할 때 재정의에 대한 설정입니다.
UserAssignedIdentity	사용자 할당 ID에 대한 세부 정보입니다.
VirtualMachineNodes	동일한 vm 크기의 노드 그룹에 대한 현재 상태입니다.
VirtualMachinesProfile	VirtualMachines 에이전트 풀의 사양입니다.
WindowsGmsaProfile	관리되는 클러스터의 Windows gMSA 프로필입니다.
WorkloadRuntime	노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

AccelerationMode

열거형

고급 네트워크 가속 옵션을 활성화합니다. 이를 통해 사용자는 BPF 호스트 라우팅을 사용하여 가속을 구성할 수 있습니다. 이는 Cilium 데이터플레인에서만 활성화할 수 있습니다. 지정하지 않으면 기본값은 없음(가속 없음)입니다. 가속 모드는 기존 클러스터에서 변경할 수 있습니다. 자세한 설명은 참조하십시오 https://aka.ms/acnsperformance

값	Description
BpfVeth	veth 디바이스 모드로 eBPF 호스트 라우팅을 활성화합니다.
None	가속 옵션을 비활성화합니다.

AdvancedNetworking

Object

클러스터에서 관찰 가능성 및 보안 기능 제품군을 사용하도록 설정하기 위한 고급 네트워킹 프로필입니다. 자세한 내용은 aka.ms/aksadvancednetworking 참조하세요.

속성	형식	Description
enabled	boolean	AKS 클러스터에서의 가시성 및 보안에 대한 고급 네트워킹 기능의 사용을 나타냅니다. true로 설정하면 명시적으로 사용하지 않도록 설정하지 않는 한 모든 관찰 가능성 및 보안 기능이 사용하도록 설정됩니다. 지정하지 않으면 기본값은 false입니다.
observability	AdvancedNetworkingObservability	기록 컨텍스트를 사용하여 고급 네트워크 메트릭 및 흐름 로그를 사용하도록 설정하는 관찰성 프로필입니다.
performance	AdvancedNetworkingPerformance	Cilium 기반 Azure CNI를 사용하는 클러스터에서 성능 향상 기능을 활성화하는 프로파일.
security	AdvancedNetworkingSecurity	cilium 기반 클러스터에서 보안 기능을 사용하도록 설정하는 보안 프로필입니다.

AdvancedNetworkingObservability

Object

기록 컨텍스트를 사용하여 고급 네트워크 메트릭 및 흐름 로그를 사용하도록 설정하는 관찰성 프로필입니다.

속성	형식	Description
enabled	boolean	클러스터에서 고급 네트워킹 관찰 기능의 활성화를 나타냅니다.

AdvancedNetworkingPerformance

Object

Cilium 기반 Azure CNI를 사용하는 클러스터에서 성능 향상 기능을 활성화하는 프로파일.

속성	형식	Default value	Description
accelerationMode	AccelerationMode	None	고급 네트워크 가속 옵션을 활성화합니다. 이를 통해 사용자는 BPF 호스트 라우팅을 사용하여 가속을 구성할 수 있습니다. 이는 Cilium 데이터플레인에서만 활성화할 수 있습니다. 지정하지 않으면 기본값은 없음(가속 없음)입니다. 가속 모드는 기존 클러스터에서 변경할 수 있습니다. 자세한 설명은 참조하십시오 https://aka.ms/acnsperformance

AdvancedNetworkingSecurity

Object

cilium 기반 클러스터에서 보안 기능을 사용하도록 설정하는 보안 프로필입니다.

속성	형식	Description
advancedNetworkPolicies	AdvancedNetworkPolicies	고급 네트워크 정책을 사용하도록 설정합니다. 이를 통해 사용자는 계층 7 네트워크 정책(FQDN, HTTP, Kafka)을 구성할 수 있습니다. 정책 자체는 Cilium 네트워크 정책 리소스를 통해 구성해야 합니다.https://docs.cilium.io/en/latest/security/policy/index.html 이는 cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 security.enabled가 true로 설정된 경우 기본값은 FQDN입니다.
enabled	boolean	이 기능을 사용하면 사용자가 DNS(FQDN) 이름을 기반으로 네트워크 정책을 구성할 수 있습니다. cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 기본값은 false입니다.
transitEncryption	AdvancedNetworkingSecurityTransitEncryption	Cilium 기반 클러스터에 대한 암호화 구성입니다. 사용하도록 설정하면 Cilium 관리 Pod 간의 모든 트래픽이 노드 경계를 벗어날 때 암호화됩니다.

AdvancedNetworkingSecurityTransitEncryption

Object

Cilium 기반 클러스터에 대한 암호화 구성입니다. 사용하도록 설정하면 Cilium 관리 Pod 간의 모든 트래픽이 노드 경계를 벗어날 때 암호화됩니다.

속성	형식	Description
type	TransitEncryptionType	Pod 간 암호화를 구성합니다. 이는 Cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 기본값은 None입니다.

AdvancedNetworkPolicies

열거형

고급 네트워크 정책을 사용하도록 설정합니다. 이를 통해 사용자는 계층 7 네트워크 정책(FQDN, HTTP, Kafka)을 구성할 수 있습니다. 정책 자체는 Cilium 네트워크 정책 리소스를 통해 구성해야 합니다.https://docs.cilium.io/en/latest/security/policy/index.html 이는 cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 security.enabled가 true로 설정된 경우 기본값은 FQDN입니다.

값	Description
L7	계층 7 네트워크 정책(FQDN, HTTP/S, Kafka)을 활성화합니다. 이 옵션은 FQDN 옵션의 상위 집합입니다.
FQDN	FQDN 기반 네트워크 정책 사용
None	계층 7 네트워크 정책(FQDN, HTTP/S, Kafka) 비활성화

AgentPoolArtifactStreamingProfile

Object

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

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

AgentPoolGatewayProfile

Object

관리형 클러스터 게이트웨이 에이전트 풀의 프로필입니다.

속성	형식	Default value	Description
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 31	31	게이트웨이 에이전트 풀은 각 정적 송신 게이트웨이에 대해 하나의 공용 IPPrefix를 연결하여 공용 송신을 제공합니다. 공용 IPPrefix의 크기는 사용자가 선택해야 합니다. 에이전트 풀의 각 노드는 IPPrefix에서 하나의 IP로 할당됩니다. 따라서 IPPrefix 크기는 게이트웨이 에이전트 풀의 크기에 대한 한도 역할을 합니다. Azure 공용 IPPrefix 크기 제한으로 인해 유효한 값 범위는 [28, 31](/31 = 노드/IP 2개, /30 = 노드/IP 4개, /29 = 노드/IP 8개, /28 = 노드/IP 16개)입니다. 기본값은 31입니다.

AgentPoolMode

열거형

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

값	Description
System	시스템 에이전트 풀은 주로 CoreDNS 및 메트릭 서버와 같은 중요한 시스템 Pod를 호스팅하는 데 사용됩니다. 시스템 에이전트 풀 osType은 Linux여야 합니다. 시스템 에이전트 풀 VM SKU에는 2vCPU 및 4GB 이상의 메모리가 있어야 합니다.
User	사용자 에이전트 풀은 주로 애플리케이션 Pod를 호스팅하기 위한 것입니다.
Gateway	게이트웨이 에이전트 풀은 Pod에 정적 송신 IP를 제공하는 데만 사용됩니다. 자세한 내용은 https://aka.ms/aks/static-egress-gateway를 참조하세요.

AgentPoolNetworkProfile

Object

에이전트 풀의 네트워크 설정입니다.

속성	형식	Description
allowedHostPorts	PortRange[]	access가 허용되는 포트 범위. 지정된 범위는 겹칠 수 있습니다.
applicationSecurityGroups	string[] (arm-id)	에이전트 풀을 만들 때 연결할 애플리케이션 보안 그룹의 ID입니다.
dranet	DRANETProfile	에이전트 풀의 DRANET 설정.
nodePublicIPTags	IPTag[]	인스턴스 수준 공용 IP의 IPTag입니다.

AgentPoolSecurityProfile

Object

에이전트 풀의 보안 설정입니다.

속성	형식	Description
enableSecureBoot	boolean	보안 부팅은 서명된 운영 체제와 드라이버만 부팅할 수 있도록 하는 신뢰할 수 있는 시작의 기능입니다. 자세한 내용은 aka.ms/aks/trustedlaunch 참조하세요. 지정하지 않으면 기본값은 false입니다.
enableVTPM	boolean	vTPM은 노드에서 로컬로 유지되는 키 및 측정값에 대한 전용 보안 자격 증명 모음을 구성하기 위한 신뢰할 수 있는 시작 기능입니다. 자세한 내용은 aka.ms/aks/trustedlaunch 참조하세요. 지정하지 않으면 기본값은 false입니다.
sshAccess	AgentPoolSSHAccess	에이전트 풀의 SSH access 메서드.

AgentPoolSSHAccess

열거형

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

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

AgentPoolStatus

Object

에이전트 풀에 대한 읽기 전용 정보를 포함합니다.

속성	형식	Description
provisioningError	ErrorDetail	에이전트 풀의 오류 세부 정보입니다. 오류에 대한 자세한 정보를 유지합니다. 오류가 없으면 이 필드는 생략됩니다.

AgentPoolType

열거형

에이전트 풀의 형식입니다.

값	Description
VirtualMachineScaleSets	Virtual Machine Scale Set에서 지원되는 에이전트 풀을 만듭니다.
AvailabilitySet	이 사용은 권장되지 않습니다.
VirtualMachines	단일 인스턴스 VM 오케스트레이션 모드로 지원되는 에이전트 풀을 만듭니다.

AgentPoolUpgradeSettings

Object

에이전트 풀 업그레이드 설정

속성	형식	Description
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	노드에 대한 드레이닝 시간 제한입니다. Pod 제거 및 노드당 정상 종료를 대기하는 데 걸리는 시간(분)입니다. 이 제거 대기 시간은 Pod 중단 예산을 기다리는 것을 존중합니다. 이 시간을 초과하면 업그레이드가 실패합니다. 지정하지 않으면 기본값은 30분입니다.
maxSurge	string	업그레이드 중에 급증한 노드의 최대 수 또는 백분율입니다. 정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 지정하지 않으면 기본값은 10%. 모범 사례를 포함한 자세한 내용은 다음을 참조하세요. https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable	string	업그레이드하는 동안 동시에 사용할 수 없는 노드의 최대 수 또는 백분율입니다. 정수(예: '1') 또는 백분율(예: '5%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 지정하지 않으면 기본값은 0입니다. 모범 사례를 포함한 자세한 내용은 다음을 참조하세요. https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes	integer (int32) minimum: 0 maximum: 30	노드의 담근 시간입니다. 노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다. 지정하지 않으면 기본값은 0분입니다.
undrainableNodeBehavior	UndrainableNodeBehavior	업그레이드하는 동안 표시할 수 없는 노드에 대한 동작을 정의합니다. 그리기 불가능한 노드의 가장 일반적인 원인은 Pod 중단 예산(PDB)이지만, Pod 종료 유예 기간과 같은 다른 문제는 노드당 남은 드레이닝 시간 제한을 초과하거나 Pod가 여전히 실행 중인 상태일 수도 있습니다.

AgentPoolWindowsProfile

Object

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

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

ArtifactSource

열거형

아티팩트 원본입니다. 아티팩트가 다운로드되는 원본입니다.

값	Description
Cache	캐시를 사용하여 Azure Container Registry에서 이미지 끌어오기
Direct	Microsoft Artifact Registry에서 이미지 끌어오기

AutoScaleProfile

Object

자동 크기 조정에 대한 사양입니다.

속성	형식	Description
maxCount	integer (int32)	지정된 크기의 최대 노드 수입니다.
minCount	integer (int32)	지정된 크기의 최소 노드 수입니다.
size	string	'Standard_E4s_v3', 'Standard_E16s_v3' 또는 'Standard_D16s_v5'과 같이 AKS에서 만들고 크기를 조정하는 데 사용할 VM 크기입니다.

AzureKeyVaultKms

Object

보안 프로필에 대한 Azure Key Vault 키 관리 서비스 설정입니다.

속성	형식	Default value	Description
enabled	boolean		Azure Key Vault 키 관리 서비스를 사용하도록 설정할지 여부입니다. 기본값은 false입니다.
keyId	string		Azure Key Vault 키의 식별자. 자세한 내용은 Azure Key Vault 키 식별자를 참조하세요. 이 속성은 Azure Key Vault 키 관리 서비스가 활성화되었을 때 필요하며, 서비스가 비활성화될 때는 생략해야 합니다. API 버전 2026-07-01과 2026-07-02-preview부터는 버전 관리 키 식별자는 기존 KMS 경험을 사용하고, 버전 제한 키 식별자는 새로운 KMS 경험을 사용합니다. 자세한 내용은 KMS 데이터 암호화 개념을 참조하세요.
keyVaultNetworkAccess	KeyVaultNetworkAccessTypes	Public	key vault의 네트워크 access. key vault의 네트워크 access. 가능한 값은 `Public` 및 `Private`입니다. `Public`는 key vault가 모든 네트워크에서 공access을 허용함을 의미합니다. `Private`는 key vault가 공공 access을 비활성화하고 private link을 가능하게 함을 의미합니다. 기본값은 `Public`입니다.
keyVaultResourceId	string (arm-id)		키 자격 증명 모음의 리소스 ID입니다. keyVaultNetworkAccess가 `Private`경우 이 필드는 필수이며 유효한 리소스 ID여야 합니다. keyVaultNetworkAccess가 `Public`필드를 비워 둡니다.

BackendPoolType

열거형

관리되는 인바운드 Load Balancer 백엔드풀의 유형입니다.

값	Description
NodeIPConfiguration	관리되는 인바운드 Load Balancer 백엔드풀의 유형입니다. https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#configure-load-balancer-backend;
NodeIP	관리되는 인바운드 Load Balancer 백엔드풀의 유형입니다. https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#configure-load-balancer-backend;

ClusterUpgradeSettings

Object

클러스터 업그레이드에 대한 설정입니다.

속성	형식	Description
overrideSettings	UpgradeOverrideSettings	재정의에 대한 설정입니다.

Code

열거형

클러스터가 실행 중인지 또는 중지되었는지 여부를 알려줍니다.

값	Description
Running	클러스터가 실행 중입니다.
Stopped	클러스터가 중지되었습니다.

ContainerNetworkLogs

열거형

Azure Monitor에서 컨테이너 네트워크 로그 수집에 허용된 값들. 일 때Enabled, 인지되는 특정 로그 유형은 관련 CRD에 의해 제어되며, 기본값은 입니다.Disabled 자세한 내용은 참조 https://aka.ms/ContainerNetworkLogsDoc 하세요 https://aka.ms/acns/howtoenablecnl .

값	Description
Disabled	Azure 모니터의 컨테이너 네트워크 로그 인제스팅이 비활성화되었습니다
Enabled	Azure 모니터에서 컨테이너 네트워크 로그 인제스팅이 활성화되어 있습니다

ContainerServiceLinuxProfile

Object

컨테이너 서비스 클러스터의 Linux VM에 대한 프로필입니다.

속성	형식	Description
adminUsername	string pattern: ^[A-Za-z][-A-Za-z0-9_]*$	Linux VM에 사용할 관리자 사용자 이름입니다.
ssh	ContainerServiceSshConfiguration	Azure에서 실행되는 리눅스 기반 VM의 SSH 구성입니다.

ContainerServiceNetworkProfile

Object

네트워크 구성의 프로필입니다.

속성	형식	Default value	Description
advancedNetworking	AdvancedNetworking		클러스터에서 관찰 가능성 및 보안 기능 제품군을 사용하도록 설정하기 위한 고급 네트워킹 프로필입니다. 자세한 내용은 aka.ms/aksadvancednetworking 참조하세요.
dnsServiceIP	string pattern: ^(?:(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]\|2[0-4][0-9]\|[01]?[0-9][0-9]?)$	10.0.0.10	Kubernetes DNS 서비스에 할당된 IP 주소입니다. serviceCidr에 지정된 Kubernetes 서비스 주소 범위 내에 있어야 합니다.
ipFamilies	IPFamily[]		클러스터에서 사용할 수 있는 IP 버전을 지정하는 데 사용되는 IP 패밀리입니다. IP 패밀리는 단일 스택 또는 이중 스택 클러스터를 결정하는 데 사용됩니다. 단일 스택의 경우 예상 값은 IPv4입니다. 이중 스택의 경우 예상 값은 IPv4 및 IPv6입니다.
loadBalancerProfile	ManagedClusterLoadBalancerProfile		클러스터 load balancer의 프로필.
loadBalancerSku	LoadBalancerSku		관리되는 클러스터용 load balancer sku입니다. 기본값은 'standard'입니다. 부하 분산기 SKU의 차이에 대한 자세한 내용은 Azure Load Balancer SKU를 참조하세요.
natGatewayProfile	ManagedClusterNATGatewayProfile		클러스터 NAT 게이트웨이의 프로필입니다.
networkDataplane	NetworkDataplane		Kubernetes 클러스터에서 사용되는 네트워크 데이터 평면입니다.
networkMode	NetworkMode		Azure CNI가 설정한 네트워크 모드입니다. networkPlugin이 'azure'가 아닌 경우 지정할 수 없습니다.
networkPlugin	NetworkPlugin		Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 플러그 인입니다.
networkPluginMode	NetworkPluginMode		네트워크 플러그 인에서 사용해야 하는 모드입니다.
networkPolicy	NetworkPolicy		Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 정책입니다.
outboundType	OutboundType	loadBalancer	아웃바운드(송신) 라우팅 메서드입니다. 클러스터를 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다. 자세한 내용은 egress outbound type을 참조하세요.
podCidr	string pattern: ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$	10.244.0.0/16	kubenet을 사용할 때 Pod IP를 할당할 CIDR 표기법 IP 범위입니다.
podCidrs	string[]		CIDR 표기법 IP 범위는 Pod IP를 할당할 범위입니다. 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 하나씩 두 개의 CIDR이 필요합니다.
serviceCidr	string pattern: ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$	10.0.0.0/16	서비스 클러스터 IP를 할당할 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위와 겹치지 않아야 합니다.
serviceCidrs	string[]		CIDR 표기법 IP 범위는 서비스 클러스터 IP를 할당할 범위입니다. 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 하나씩 두 개의 CIDR이 필요합니다. 서브넷 IP 범위와 겹치지 않아야 합니다.
staticEgressGatewayProfile	ManagedClusterStaticEgressGatewayProfile		정적 송신 게이트웨이 추가 기능에 대한 프로필입니다. 정적 송신 게이트웨이에 대한 자세한 내용은 다음을 참조하세요 https://aka.ms/aks/static-egress-gateway.

ContainerServiceSshConfiguration

Object

Azure에서 실행되는 Linux 기반 VM에 대한 SSH 구성입니다.

속성	형식	Description
publicKeys	ContainerServiceSshPublicKey[]	Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다. 최대 1키를 지정할 수 있습니다.

ContainerServiceSshPublicKey

Object

SSH 인증서 공개 키 데이터에 대한 정보를 포함합니다.

속성	형식	Description
keyData	string	SSH를 통해 VM으로 인증하는 데 사용되는 인증서 공개 키입니다. 인증서는 헤더가 있거나 없는 PEM 형식이어야 합니다.

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

CreationData

Object

원본 리소스에서 대상 리소스를 만들 때 사용되는 데이터입니다.

속성	형식	Description
sourceResourceId	string (arm-id)	대상 개체를 만드는 데 사용할 원본 개체의 ARM ID입니다.

DelegatedResource

Object

위임된 리소스 속성 - 내부 전용입니다.

속성	형식	Description
location	string	원본 리소스 위치 - 내부 전용입니다.
referralResource	string	조회 위임의 위임 ID(선택 사항) - 내부 전용입니다.
resourceId	string	위임된 리소스의 ARM 리소스 ID입니다. 내부 용도로만 사용됩니다.
tenantId	string (uuid)	위임된 리소스의 테넌트 ID입니다. 내부 용도로만 사용됩니다.

DRANETMode

열거형

에이전트 풀을 위한 DRANET 모드입니다.

값	Description
Unmanaged	DRANET은 AKS에서 관리하지 않습니다.
Managed	DRANET은 AKS가 관리합니다.

DRANETProfile

Object

에이전트 풀의 DRANET 설정.

속성	형식	Description
mode	DRANETMode	에이전트 풀을 위한 DRANET 모드입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보

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

ErrorDetail

Object

오류 세부 정보입니다.

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

ErrorResponse

Object

오류 응답

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

Expander

열거형

확장할 때 사용할 확장기입니다. 지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기 참조하세요.

값	Description
least-waste	강화 후 유휴 CPU가 가장 적은 노드 그룹(연결된 경우 사용되지 않는 메모리)을 선택합니다. 이는 높은 CPU 또는 높은 메모리 노드와 같이 노드 클래스가 다르고 해당 리소스가 많이 필요한 보류 중인 Pod가 있는 경우에만 확장하려는 경우에 유용합니다.
most-pods	확장할 때 가장 많은 Pod를 예약할 수 있는 노드 그룹을 선택합니다. 이는 nodeSelector를 사용하여 특정 Pod가 특정 노드에 있는지 확인하는 경우에 유용합니다. 이렇게 하면 자동 크기 조정기가 한 번에 여러 개의 작은 노드를 추가할 수 있으므로 더 큰 노드와 더 작은 노드를 선택할 수 없습니다.
priority	사용자가 할당한 우선 순위가 가장 높은 노드 그룹을 선택합니다. 구성은 여기자세한 내용에 설명되어 있습니다.
random	노드 그룹의 크기를 다르게 조정할 필요가 없는 경우에 사용됩니다.

ExtendedLocation

Object

확장된 위치의 복합 형식입니다.

속성	형식	Description
name	string	확장된 위치의 이름입니다.
type	ExtendedLocationTypes	확장된 위치의 형식입니다.

ExtendedLocationTypes

열거형

extendedLocation의 형식입니다.

값	Description
EdgeZone	Azure Edge Zone 확장 위치 유형.

GatewayAPIIstioEnabled

열거형

Istio를 관리 인그레스와 함께 App Routing을 위한 게이트웨이 API 구현을 활성화할지 여부.

값	Description
Enabled	사이드카 없는 Istio 컨트롤플레인을 사용하여 게이트웨이 API를 통한 관리된 인그레스를 가능하게 합니다.
Disabled	게이트웨이 API를 통한 관리된 인그레스를 위한 사이드카 없는 istio 제어 평면을 비활성화합니다.

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 설정입니다.

속성	형식	Description
driver	GPUDriver	GPU 드라이버를 설치할지 여부입니다. 지정하지 않으면 기본값은 Install입니다.
nvidia	NvidiaGPUProfile	NVIDIA 전용 GPU 설정.

InfrastructureEncryption

열거형

서비스 관리형 키를 사용하여 Kubernetes 리소스 개체의 미사용 암호화를 사용하도록 설정할지 여부입니다. 이에 대한 자세한 내용은 에서 찾을 https://aka.ms/aks/kubernetesResourceObjectEncryption수 있습니다.

값	Description
Enabled	서비스 관리형 키를 사용하는 Kubernetes 리소스 개체의 미사용 암호화가 사용하도록 설정됩니다. 이에 대한 자세한 내용은 에서 찾을 https://aka.ms/aks/kubernetesResourceObjectEncryption수 있습니다.

IPFamily

열거형

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

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

IPTag

Object

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

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

IstioCertificateAuthority

Object

Istio Service Mesh CA(인증 기관) 구성. 지금은 여기에 설명된 대로 플러그 인 인증서만 지원합니다https://aka.ms/asm-plugin-ca

속성	형식	Description
plugin	IstioPluginCertificateAuthority	Service Mesh에 대한 플러그 인 인증서 정보입니다.

IstioComponents

Object

Istio 구성 요소 구성

속성	형식	Description
egressGateways	IstioEgressGateway[]	Istio 송신 게이트웨이.
ingressGateways	IstioIngressGateway[]	Istio 수신 게이트웨이.
proxyRedirectionMechanism	ProxyRedirectionMechanism	트래픽 리디렉션 모드입니다.

IstioEgressGateway

Object

Istio 송신 게이트웨이 구성.

속성	형식	Description
enabled	boolean	송신 게이트웨이를 사용하도록 설정할지 여부입니다.
gatewayConfigurationName	string	Istio 추가 기능 송신 게이트웨이에 대한 게이트웨이 구성 사용자 지정 리소스의 이름입니다. Istio 송신 게이트웨이를 사용하도록 설정할 때 지정해야 합니다. Istio 송신 게이트웨이가 배포될 동일한 네임스페이스에 배포되어야 합니다.
name	string pattern: [a-z0-9]([-a-z0-9][a-z0-9])?(\.[a-z0-9]([-a-z0-9][a-z0-9])?)*	Istio 추가 기능 송신 게이트웨이의 이름입니다.
namespace	string	Istio 추가 기능 송신 게이트웨이를 배포해야 하는 네임스페이스입니다. 지정되지 않은 경우 기본값은 aks-istio-egress입니다.

IstioIngressGateway

Object

Istio 수신 게이트웨이 구성. 현재는 aks-istio-ingressgateway-external라는 하나의 외부 수신 게이트웨이와 aks-istio-ingressgateway-internal라는 하나의 내부 수신 게이트웨이를 지원합니다.

속성	형식	Description
enabled	boolean	수신 게이트웨이를 사용하도록 설정할지 여부입니다.
mode	IstioIngressGatewayMode	수신 게이트웨이의 모드입니다.

IstioIngressGatewayMode

열거형

수신 게이트웨이의 모드입니다.

값	Description
External	수신 게이트웨이에는 공용 IP 주소가 할당되며 공개적으로 액세스할 수 있습니다.
Internal	수신 게이트웨이에는 내부 IP 주소가 할당되며 공개적으로 액세스할 수 없습니다.

IstioPluginCertificateAuthority

Object

Service Mesh에 대한 플러그 인 인증서 정보입니다.

속성	형식	Description
certChainObjectName	string	Azure Key Vault의 Certificate chain object name.
certObjectName	string	Azure Key Vault의 Intermediate certificate object name.
keyObjectName	string	Azure Key Vault의 Intermediate certificate private key object name.
keyVaultId	string (arm-id)	Key Vault의 자원 ID입니다.
rootCertObjectName	string	Azure Key Vault의 루트 인증서 객체 이름.

IstioServiceMesh

Object

Istio 서비스 메시 구성.

속성	형식	Description
certificateAuthority	IstioCertificateAuthority	Istio Service Mesh CA(인증 기관) 구성. 지금은 여기에 설명된 대로 플러그 인 인증서만 지원합니다https://aka.ms/asm-plugin-ca
components	IstioComponents	Istio 구성 요소 구성
revisions	string[]	Istio 컨트롤 플레인의 수정 버전 목록입니다. 업그레이드가 진행 중이 아닌 경우 이 값은 하나의 값을 보유합니다. 카나리아 업그레이드가 진행 중인 경우 두 개의 연속 값만 보유할 수 있습니다. 자세한 내용은 다음을 참조하세요. https://learn.microsoft.com/en-us/azure/aks/istio-upgrade

KeyVaultNetworkAccessTypes

열거형

key vault의 네트워크 access. key vault의 네트워크 access. 가능한 값은 Public 및 Private입니다. Public는 key vault가 모든 네트워크에서 공access을 허용함을 의미합니다. Private는 key vault가 공공 access을 비활성화하고 private link을 가능하게 함을 의미합니다. 기본값은 Public입니다.

값	Description
Public	키 금고는 모든 네트워크에서 공개 접근을 허용합니다.
Private	키 볼트는 공개 접근을 비활성화하고 프라이빗 링크를 활성화합니다.

KubeletConfig

Object

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

속성	형식	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당 최대 프로세스 수입니다.
topologyManagerPolicy	string	사용할 토폴로지 관리자 정책입니다. 자세한 내용은 Kubernetes 토폴로지 관리자를 참조하세요. 기본값은 'none'입니다. 허용되는 값은 'none', 'best-effort', 'restricted' 및 'single-numa-node'입니다.

KubeletDiskType

열거형

emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.

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

KubernetesResourceObjectEncryptionProfile

Object

서비스 관리형 키를 사용하여 Kubernetes 리소스 개체의 미사용 암호화. 이에 대한 자세한 내용은 에서 찾을 https://aka.ms/aks/kubernetesResourceObjectEncryption수 있습니다.

속성	형식	Description
infrastructureEncryption	InfrastructureEncryption	서비스 관리형 키를 사용하여 Kubernetes 리소스 개체의 미사용 암호화를 사용하도록 설정할지 여부입니다. 이에 대한 자세한 내용은 에서 찾을 https://aka.ms/aks/kubernetesResourceObjectEncryption수 있습니다.

KubernetesSupportPlan

열거형

AKS 관리형 클러스터에 대한 다양한 지원 계층

값	Description
KubernetesOfficial	버전에 대한 지원은 오픈 소스 Kubernetes 제품과 동일합니다. 공식 Kubernetes 오픈 소스 커뮤니티는 릴리스 후 1년 동안 버전을 지원합니다.
AKSLongTermSupport	버전에 대한 지원은 KubernetesOfficial 지원(1년)을 지나 확장되었습니다. AKS는 총 2년간의 지원을 위해 1년 동안 CVE를 계속 패치합니다.

LicenseType

열거형

Windows VM에 사용할 라이선스 유형입니다. 자세한 내용은 Azure 하이브리드 사용자 혜택을 참조하세요.

값	Description
None	추가 라이선스가 적용되지 않습니다.
Windows_Server	Windows VM에 대한 Azure 하이브리드 사용자 혜택을 사용하도록 설정합니다.

LinuxOSConfig

Object

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

속성	형식	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참조하세요.

LoadBalancerSku

열거형

관리되는 클러스터용 load balancer sku입니다. 기본값은 'standard'입니다. 부하 분산기 SKU의 차이에 대한 자세한 내용은 Azure Load Balancer SKU를 참조하세요.

값	Description
standard	표준 Load Balancer를 사용하세요. 권장되는 Load Balancer SKU입니다. 관리되는 클러스터에서 부하 분산 장치를 사용하는 방법에 대한 자세한 내용은 표준 Load Balancer 문서를 참조하세요.
basic	기능이 제한된 기본 Load Balancer를 사용하세요.

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 프로필을 재정의합니다.

속성	형식	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 참조하십시오.

속성	형식	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가 비활성화되어 있습니다.

ManagedCluster

Object

관리형 클러스터.

속성	형식	Description
eTag	string	eTag가 응답 본문에 제공된 경우 일반적인 etag 규칙에 따라 헤더로 제공될 수도 있습니다. 엔터티 태그는 동일한 요청된 리소스에서 둘 이상의 엔터티를 비교하는 데 사용됩니다. HTTP/1.1은 etag(섹션 14.19), If-Match(섹션 14.24), If-None-Match(섹션 14.26) 및 If-Range(섹션 14.27) 헤더 필드에 엔터티 태그를 사용합니다.
extendedLocation	ExtendedLocation	Virtual Machine의 확장된 위치입니다.
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedClusterIdentity	구성된 경우 관리되는 클러스터의 ID입니다.
kind	string	이는 주로 포털에서 다양한 종류의 UI 환경을 노출하는 데 사용됩니다.
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties.aadProfile	ManagedClusterAADProfile	Azure Active Directory config.
properties.addonProfiles	<string, ManagedClusterAddonProfile>	관리형 클러스터 추가 기능의 프로필입니다.
properties.agentPoolProfiles	ManagedClusterAgentPoolProfile[]	에이전트 풀 속성입니다.
properties.aiToolchainOperatorProfile	ManagedClusterAIToolchainOperatorProfile	전체 클러스터에 적용되는 AI 도구 체인 연산자 설정입니다.
properties.apiServerAccessProfile	ManagedClusterAPIServerAccessProfile	관리형 클러스터 API 서버에 대한 액세스 프로필입니다.
properties.autoScalerProfile	ManagedClusterPropertiesAutoScalerProfile	사용하도록 설정된 경우 클러스터 자동 크기 조정기에 적용할 매개 변수
properties.autoUpgradeProfile	ManagedClusterAutoUpgradeProfile	자동 업그레이드 구성입니다.
properties.azureMonitorProfile	ManagedClusterAzureMonitorProfile	관리된 클러스터를 모니터링하는 Azure Monitor 애드온 프로필.
properties.azurePortalFQDN	string	관리 클러스터에 접근하기 위해 Azure Portal에서 사용하는 특별한 FQDN. 이 FQDN은 Azure Portal에서만 사용할 수 있으며 다른 클라이언트에서는 사용하지 말아야 합니다. Azure Portal은 일부 응답에서 특정 교차 출처 자원 공유(CORS) 헤더를 요구하는데, Kubernetes APIServer는 기본적으로 이를 처리하지 않습니다. 이 특별한 FQDN은 CORS를 지원하여 Azure Portal이 제대로 작동할 수 있도록 합니다.
properties.bootstrapProfile	ManagedClusterBootstrapProfile	클러스터 부트스트랩 구성의 프로필입니다.
properties.currentKubernetesVersion	string	관리형 클러스터가 실행 중인 Kubernetes 버전입니다. kubernetesVersion이 major.minor.patch<>완전히 지정된 버전인 경우 이 필드는 정확히 동일합니다. kubernetesVersion이 major.minor<>경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다.
properties.disableLocalAccounts	boolean	관리형 클러스터에서 로컬 계정을 사용하지 않도록 설정해야 하는 경우 true로 설정하면 이 클러스터에 대해 정적 자격 증명 가져오기가 비활성화됩니다. AAD를 사용하도록 설정된 관리형 클러스터에서만 사용해야 합니다. 자세한 내용은 로컬 계정사용하지 않도록 설정하는 참조하세요.
properties.diskEncryptionSetID	string (arm-id)	미사용 암호화를 사용하도록 설정하는 데 사용할 디스크 암호화 집합의 리소스 ID입니다. 이 양식은 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/diskEncryptionSets/{encryptionSetName}'
properties.dnsPrefix	string	관리형 클러스터의 DNS 접두사입니다. 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다.
properties.enableFIPS	boolean	클러스터 수준에서 FIPS 모드를 활성화할지 여부. 활성화되면 이 설정은 노드 운영체제, 애드온, 관리되는 컨테이너화된 구성 요소 등 모든 AKS 관리 구성 요소에 대해 FIPS 준수를 강제합니다. 자세한 내용은 클러스터 전체 FIPS 활성화 를 참조하세요. 이 속성이 활성화되면 클러스터 내 모든 노드 풀도 FIPS가 활성화되어야 합니다. 이 속성은 안정적인 API 버전에서 제공되지만, 클러스터 전체 FIPS는 여전히 미리보기 기능으로 남아 있습니다. 이 속성이 true로 설정된 클러스터 상태의 쓰기 요청은 구독 기능 등록이 필요합니다 `Microsoft.ContainerService/EnableFIPSPreview` .
properties.enableRBAC	boolean	쿠버네티스 Role-Based Access Control 활성화 여부.
properties.fqdn	string	마스터 풀의 FQDN입니다.
properties.fqdnSubdomain	string	사용자 지정 프라이빗 dns 영역이 있는 프라이빗 클러스터의 FQDN 하위 도메인입니다. 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다.
properties.hostedSystemProfile	ManagedClusterHostedSystemProfile	호스팅된 시스템 애드온에 대한 설정입니다. 자세한 내용은 https://aka.ms/aks/automatic/systemcomponents를 참조하세요.
properties.httpProxyConfig	ManagedClusterHTTPProxyConfig	HTTP 프록시 서버를 사용하여 클러스터를 프로비전하기 위한 구성입니다.
properties.identityProfile	<string, UserAssignedIdentity>	관리되는 클러스터와 연결된 사용자 ID입니다. 이 ID는 kubelet에서 사용됩니다. 사용자 할당 ID는 하나만 허용됩니다. 유일하게 허용되는 키는 "kubeletidentity"이며, "resourceId" 값이 있습니다: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}".
properties.ingressProfile	ManagedClusterIngressProfile	관리되는 클러스터에 대한 수신 프로필입니다.
properties.kubernetesVersion	string	사용자가 지정한 Kubernetes의 버전입니다. 패치 버전 <major.minor.patch> (예: 1.20.13) 및 <major.minor> (예: 1.20)가 모두 지원됩니다. major.minor<를 지정하면 >지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터가 만들어지면(예: 1.14.x -< 1.14) 동일한 >major.minor>로 클러스터를 업데이트하면 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. 지원되는 AKS 클러스터를 업그레이드하는 경우 Kubernetes 부 버전을 건너뛸 수 없습니다. 모든 업그레이드는 주 버전 번호로 순차적으로 수행되어야 합니다. 예를 들어 1.14.x -> 1.15.x 또는 1.15.x -> 1.16.x 간의 업그레이드는 허용되지만 1.14.x -> 1.16.x는 허용되지 않습니다. 자세한 내용은 AKS 클러스터 업그레이드하는 참조하세요.
properties.linuxProfile	ContainerServiceLinuxProfile	관리형 클러스터의 Linux VM에 대한 프로필입니다.
properties.maxAgentPools	integer (int32)	관리되는 클러스터에 대한 에이전트 풀의 최대 수입니다.
properties.metricsProfile	ManagedClusterMetricsProfile	선택적 클러스터 메트릭 구성입니다.
properties.networkProfile	ContainerServiceNetworkProfile	네트워크 구성 프로필입니다.
properties.nodeProvisioningProfile	ManagedClusterNodeProvisioningProfile	전체 클러스터에 적용되는 노드 프로비저닝 설정입니다.
properties.nodeResourceGroup	string	에이전트 풀 노드를 포함하는 리소스 그룹의 이름입니다.
properties.nodeResourceGroupProfile	ManagedClusterNodeResourceGroupProfile	노드 리소스 그룹 구성의 프로필입니다.
properties.oidcIssuerProfile	ManagedClusterOIDCIssuerProfile	관리형 클러스터의 OIDC 발급자 프로필입니다.
properties.podIdentityProfile	ManagedClusterPodIdentityProfile	관리형 클러스터의 Pod ID 프로필입니다. AAD Pod ID 통합에 대한 자세한 내용은 AAD Pod ID 사용하는 참조하세요.
properties.powerState	PowerState	클러스터의 전원 상태입니다.
properties.privateFQDN	string	프라이빗 클러스터의 FQDN입니다.
properties.privateLinkResources	PrivateLinkResource[]	클러스터와 연결된 프라이빗 링크 리소스입니다.
properties.provisioningState	string	현재 프로비저닝 상태입니다.
properties.publicNetworkAccess	PublicNetworkAccess	PublicNetworkAccess를 사용합니다. AKS의 공용 네트워크 access 허용 또는 거부
properties.resourceUID	string	resourceUID는 ARM ResourceId를 다시 사용하는 ManagedClusters(예: 만들기, 삭제, 시퀀스 만들기)를 고유하게 식별합니다.
properties.schedulerProfile	SchedulerProfile	AKS가 관리하는 각 스케줄러 설정 모드 같은 스케줄러 관련 설정이 포함된 프로필. https://aka.ms/aks/scheduler-profile을(를) 참조하세요.
properties.securityProfile	ManagedClusterSecurityProfile	관리되는 클러스터에 대한 보안 프로필입니다.
properties.serviceMeshProfile	ServiceMeshProfile	관리되는 클러스터에 대한 서비스 메시 프로필입니다.
properties.servicePrincipalProfile	ManagedClusterServicePrincipalProfile	클러스터가 Azure API를 조작할 때 사용할 서비스 주체 신원에 관한 정보입니다.
properties.status	ManagedClusterStatus	관리형 클러스터에 대한 읽기 전용 정보를 포함합니다.
properties.storageProfile	ManagedClusterStorageProfile	관리되는 클러스터에 대한 스토리지 프로필입니다.
properties.supportPlan	KubernetesSupportPlan	관리형 클러스터에 대한 지원 계획입니다. 지정되지 않은 경우 기본값은 'KubernetesOfficial'입니다.
properties.upgradeSettings	ClusterUpgradeSettings	클러스터 업그레이드에 대한 설정입니다.
properties.windowsProfile	ManagedClusterWindowsProfile	관리형 클러스터 내 Windows VM용 프로필입니다.
properties.workloadAutoScalerProfile	ManagedClusterWorkloadAutoScalerProfile	관리되는 클러스터에 대한 워크로드 자동 크기 조정기 프로필입니다.
sku	ManagedClusterSKU	관리되는 클러스터 SKU입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ManagedClusterAADProfile

Object

AADProfile은 Azure Active Directory 통합에 대한 특성을 지정합니다. 자세한 내용은 AKS관리되는 AAD를 참조하세요.

속성	형식	Description
adminGroupObjectIDs	string[]	클러스터의 관리자 역할을 맡게 될 AAD 그룹 개체 ID 목록입니다.
clientAppID	string	(사용되지 않음) 클라이언트 AAD 애플리케이션 ID입니다. https://aka.ms/aks/aad-legacy에서 자세히 알아보세요.
enableAzureRBAC	boolean	Kubernetes 권한 부여에 Azure RBAC를 사용하도록 설정할지 여부입니다.
managed	boolean	관리되는 AAD를 사용하도록 설정할지 여부입니다.
serverAppID	string	(사용되지 않음) 서버 AAD 애플리케이션 ID입니다. https://aka.ms/aks/aad-legacy에서 자세히 알아보세요.
serverAppSecret	string (password)	(사용되지 않음) 서버 AAD 애플리케이션 비밀입니다. https://aka.ms/aks/aad-legacy에서 자세히 알아보세요.
tenantID	string	인증에 사용할 AAD 테넌트 ID입니다. 지정하지 않으면 배포 구독의 테넌트가 사용합니다.

ManagedClusterAddonProfile

Object

관리형 클러스터에 대한 Kubernetes 추가 기능 프로필입니다.

속성	형식	Description
config	object	추가 기능을 구성하기 위한 키-값 쌍입니다.
enabled	boolean	추가 기능을 사용할 수 있는지 여부입니다.
identity	ManagedClusterAddonProfileIdentity	이 추가 기능에서 사용하는 사용자 할당 ID의 정보입니다.

ManagedClusterAddonProfileIdentity

Object

이 추가 기능에서 사용하는 사용자 할당 ID의 정보입니다.

속성	형식	Description
clientId	string	사용자 할당 ID의 클라이언트 ID입니다.
objectId	string	사용자 할당 ID의 개체 ID입니다.
resourceId	string (arm-id)	사용자 할당 ID의 리소스 ID입니다.

ManagedClusterAgentPoolProfile

Object

컨테이너 서비스 에이전트 풀에 대한 프로필입니다.

속성	형식	Default value	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile		AKS에서 아티팩트 스트리밍을 사용하기 위한 구성입니다.
availabilityZones	string[]		노드에 사용할 수 있는 Availability zones 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다.
capacityReservationGroupID	string (arm-id)		Capacity Reservation Group의 완전 자격화된 리소스 ID를 사용하여 예약된 Virtual Machines 그룹에서 virtual machines를 제공합니다. 이 형태는 '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Compute/capacityreservationgroups/{capacityReservationGroupName}' 입니다. 고객은 지정된 CRG를 가진 에이전트풀을 생성하는 데 사용합니다. 자세한 내용은 Capacity Reservation를 참조하세요
count	integer (int32)		Docker 컨테이너를 호스트할 에이전트(VM) 수입니다. 허용되는 값은 사용자 풀의 경우 0~1000(포함) 범위에 있어야 하고, 시스템 풀의 경우 1~1000(포함) 범위에 있어야 합니다. 기본값은 1입니다.
creationData	CreationData		노드 풀이 스냅샷을 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다.
currentOrchestratorVersion	string		에이전트 풀이 실행 중인 Kubernetes의 버전입니다. orchestratorVersion이 major.minor.patch<>완전히 지정된 버전인 경우 이 필드는 정확히 동일합니다. orchestratorVersion이 major.minor<>경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다.
eTag	string		낙관적 동시성을 구현하는 데 사용되는 고유한 읽기 전용 문자열입니다. eTag 값은 리소스가 업데이트될 때 변경됩니다. 후속 요청에 대한 eTag 값과 함께 if-match 또는 if-none-match 헤더를 지정하여 일반 eTag 규칙에 따라 낙관적 동시성을 사용하도록 설정합니다.
enableAutoScaling	boolean		자동 크기 조정기를 사용하도록 설정할지 여부
enableEncryptionAtHost	boolean		호스트 기반 OS 및 데이터 드라이브 암호화를 사용하도록 설정할지 여부입니다. 이 기능은 특정 VM 크기와 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption
enableFIPS	boolean		FIPS 사용 OS를 사용할지 여부입니다. 자세한 내용은 FIPS 지원 노드 풀 추가를 참조하세요.
enableNodePublicIP	boolean		각 노드에 자체 공용 IP가 할당되는지 여부입니다. 일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 자세한 내용은 노드별 공인 IP 할당을 참조하세요. 기본값은 false입니다.
enableUltraSSD	boolean		UltraSSD를 사용하도록 설정할지 여부
gatewayProfile	AgentPoolGatewayProfile		게이트웨이 모드에서 관리되는 에이전트 풀과 관련된 프로필입니다. 에이전트 풀 모드가 게이트웨이가 아닌 경우 이 필드를 설정할 수 없습니다.
gpuInstanceProfile	GPUInstanceProfile		지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.
gpuProfile	GPUProfile		에이전트 풀에 대한 GPU 설정입니다.
hostGroupID	string (arm-id)		가상 머신을 프로비전할 전용 호스트 그룹의 정규화된 리소스 ID로, 만든 시나리오에서만 사용되며 설정된 후에는 변경할 수 없습니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure dedicated hosts를 참조하세요.
kubeletConfig	KubeletConfig		에이전트 풀 노드의 Kubelet 구성입니다.
kubeletDiskType	KubeletDiskType		emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.
linuxOSConfig	LinuxOSConfig		Linux 에이전트 노드의 OS 구성입니다.
localDNSProfile	LocalDNSProfile		VnetDNS 및 KubeDNS 재정의를 사용하여 노드별 로컬 DNS를 구성합니다. LocalDNS는 AKS 클러스터에서 DNS 확인의 성능과 안정성을 향상시키는 데 도움이 됩니다. 자세한 내용은 aka.ms/aks/localdns 참조하십시오.
maxCount	integer (int32)		자동 크기 조정을 위한 최대 노드 수
maxPods	integer (int32)		노드에서 실행할 수 있는 최대 Pod 수입니다.
messageOfTheDay	string		Base64로 인코딩된 Linux 노드에 대한 오늘의 메시지입니다. 디코딩 후 /etc/motd에 기록될 base64로 인코딩된 문자열입니다. 이렇게 하면 Linux 노드에 대한 오늘의 메시지를 사용자 지정할 수 있습니다. Windows 노드에 대해 지정해서는 안 됩니다. 정적 문자열이어야 합니다(즉, 원시로 인쇄되고 스크립트로 실행되지 않음).
minCount	integer (int32)		자동 크기 조정을 위한 최소 노드 수
mode	AgentPoolMode		에이전트 풀의 모드입니다. 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools
name	string pattern: ^[a-z][a-z0-9]{0,11}$		구독 및 리소스 그룹의 컨텍스트에서 에이전트 풀 프로필의 고유 이름입니다. Windows 에이전트 풀 이름은 6자 이내여야 합니다.
networkProfile	AgentPoolNetworkProfile		에이전트 풀의 네트워크 관련 설정입니다.
nodeImageVersion	string		노드 이미지 버전입니다. 이 값을 설정하면 agentPool 롤백이 발생합니다. 값은 의 `recentlyUsedVersions` 값만 허용됩니다.
nodeLabels	object		에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다.
nodePublicIPPrefixID	string (arm-id)		VM 노드에서 IP를 사용해야 하는 공용 IP 접두사 ID입니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다.
nodeTaints	string[]		노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다.
orchestratorVersion	string		사용자가 지정한 Kubernetes의 버전입니다. 패치 버전 <major.minor.patch> (예: 1.20.13) 및 <major.minor> (예: 1.20)가 모두 지원됩니다. major.minor<를 지정하면 >지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터가 만들어지면(예: 1.14.x -< 1.14) 동일한 >major.minor>로 클러스터를 업데이트하면 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 node pool를 참조하세요.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다.
osDiskType	OSDiskType		에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요.
osSKU	OSSKU		에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. 기본 설정은 Kubernetes <= 1.24 시에는 Windows2019, OSType가 Windows 시에는 Windows2022 >= 1.25입니다.
osType	OSType	Linux	운영 체제 유형입니다. 기본값은 Linux입니다.
podIPAllocationMode	PodIPAllocationMode		파드 IP 할당 모드. 에이전트 풀의 Pod에 대한 IP 할당 모드입니다. podSubnetId와 함께 사용해야 합니다. 기본값은 'DynamicIndividual'입니다.
podSubnetID	string (arm-id)		Pod가 시작될 때 조인할 서브넷의 ID입니다. 생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
powerState	PowerState		에이전트 풀이 실행 중인지 아니면 중지되었는지 여부입니다. 에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공한 경우에만 중지할 수 있습니다.
provisioningState	string		현재 배포 또는 프로비저닝 상태입니다.
proximityPlacementGroupID	string (arm-id)		근접 배치 그룹의 ID입니다.
scaleDownMode	ScaleDownMode		에이전트 풀을 스케일링할 때 사용할 스케일 다운 모드입니다. 클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다.
scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	Virtual Machine Scale Set 제거 정책입니다. 퇴거 정책에는 퇴거 시 VM에 어떤 to do이 있는지 명시되어 있습니다. 기본값은 삭제입니다. 퇴거에 관한 자세한 내용은 spot VMs
scaleSetPriority	ScaleSetPriority	Regular	Virtual Machine Scale Set 우선 순위입니다.
securityProfile	AgentPoolSecurityProfile		에이전트 풀의 보안 설정입니다.
spotMaxPrice	number (float)	-1	스폿 인스턴스에 대해 지불할 최대 가격(미국 달러)입니다. 가능한 값은 0보다 크거나 -1 10진수 값으로, 기본 가격이 주문형으로 up-to 것을 나타냅니다. 가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 현물 가격에 대한 자세한 내용은 spot VM 가격
status	AgentPoolStatus		에이전트 풀에 대한 읽기 전용 정보를 포함합니다.
tags	object		에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다.
type	AgentPoolType		에이전트 풀의 형식입니다.
upgradeSettings	AgentPoolUpgradeSettings		에이전트 풀 업그레이드 설정
virtualMachineNodesStatus	VirtualMachineNodes[]		VirtualMachines 에이전트 풀의 노드 상태입니다.
virtualMachinesProfile	VirtualMachinesProfile		VirtualMachines 에이전트 풀의 사양입니다.
vmSize	string		에이전트 풀 VM의 크기입니다. VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 제대로 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/quotas-skus-regions
vnetSubnetID	string (arm-id)		에이전트 풀 노드 및 선택적으로 Pod가 시작할 때 조인할 서브넷의 ID입니다. 지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
windowsProfile	AgentPoolWindowsProfile		Windows 에이전트 풀의 특정 프로필입니다.
workloadRuntime	WorkloadRuntime		노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

ManagedClusterAIToolchainOperatorProfile

Object

운영자를 사용하도록 설정하면 AKS 관리형 CRD 및 컨트롤러 집합이 클러스터에 설치됩니다. 운영자는 유추 및/또는 학습 목적으로 OSS 모델의 배포를 자동화합니다. 미리 설정된 모델 집합을 제공하고 이에 대한 분산 유추를 사용하도록 설정합니다.

속성	형식	Description
enabled	boolean	AI 툴체인 연산자를 클러스터에 사용할 수 있도록 할지 여부입니다. AI 도구 체인 연산자가 활성화되었는지 여부를 나타냅니다.

ManagedClusterAPIServerAccessProfile

Object

관리형 클러스터 API 서버에 대한 액세스 프로필입니다.

속성	형식	Description
authorizedIPRanges	string[]	Kubernetes API 서버에 액세스할 수 있는 권한이 부여된 IP 범위입니다. IP 범위는 CIDR 형식(예: 137.117.106.88/29)으로 지정됩니다. 이 기능은 Public IP Per Node를 사용하는 클러스터나 Basic Load Balancer를 사용하는 클러스터와는 호환되지 않습니다. 자세한 내용은 API 서버 허가된 IP 범위를 참조하세요.
disableRunCommand	boolean	클러스터에 대한 실행 명령을 사용하지 않도록 설정할지 여부입니다.
enablePrivateCluster	boolean	클러스터를 프라이빗 클러스터로 만들지 여부입니다. 자세한 내용은 Creating a private AKS cluster를 참조하세요.
enablePrivateClusterPublicFQDN	boolean	프라이빗 클러스터에 대한 추가 공용 FQDN을 만들지 여부를 지정합니다.
enableVnetIntegration	boolean	클러스터에 apiserver vnet 통합을 사용하도록 설정할지 여부입니다. 자세한 내용은 aka.ms/AksVnetIntegration 참조하십시오.
privateDNSZone	string	클러스터에 대한 프라이빗 DNS 영역 모드입니다. 기본값은 System입니다. 자세한 내용은 configure private DNS zone를 참조하세요. 허용되는 값은 'system' 및 'none'입니다.
subnetId	string (arm-id)	apiserver vnet 통합을 사용할 때 사용할 서브넷입니다. BYO Vnet을 사용하여 새 클러스터를 생성하거나 apiserver vnet 통합을 사용하도록 기존 클러스터를 업데이트할 때 필요합니다.

ManagedClusterAppRoutingIstio

Object

Gateway API와 App Routing을 통한 관리된 인그레스를 위한 사이드카 없는 Istio 제어 플레인 설정. 게이트웨이 API를 통한 인그레스 사용에 관한 정보는 참고 https://aka.ms/gateway-on-istio 하세요.

속성	형식	Description
mode	GatewayAPIIstioEnabled	Istio를 관리 인그레스와 함께 App Routing을 위한 게이트웨이 API 구현을 활성화할지 여부.

ManagedClusterAutoUpgradeProfile

Object

관리되는 클러스터에 대한 자동 업그레이드 프로필입니다.

속성	형식	Description
nodeOSUpgradeChannel	NodeOSUpgradeChannel	노드 OS 업그레이드 채널. 노드의 OS가 업데이트되는 방식입니다. 기본값은 NodeImage입니다.
upgradeChannel	UpgradeChannel	자동 업그레이드를 위한 업그레이드 채널입니다. 기본값은 'none'입니다. 자세한 내용은 AKS 클러스터 자동 업그레이드 채널 설정을 참조하세요.

ManagedClusterAzureMonitorProfile

Object

관리된 클러스터를 모니터링하는 Azure Monitor 애드온 프로필.

속성	형식	Description
appMonitoring	ManagedClusterAzureMonitorProfileAppMonitoring	Kubernetes 애플리케이션 컨테이너에 대한 애플리케이션 모니터링 프로필입니다. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션 로그, 메트릭 및 추적을 자동 계측하여 수집합니다. 개요는 aka.ms/AzureMonitorApplicationMonitoring 참조하세요.
containerInsights	ManagedClusterAzureMonitorProfileContainerInsights	클러스터에 대해 Azure Monitor Container Insights를 활성화하고 설정하도록 설정하세요. 이 기능은 Kubernetes 이벤트, 인벤토리, 컨테이너 상태 및 stderr 로그를 수집합니다. 개요는 aka.ms/AzureMonitorContainerInsights 참조하세요.
metrics	ManagedClusterAzureMonitorProfileMetrics	Prometheus 추가 기능에 대한 Azure Monitor 관리 서비스에 대한 메트릭 프로필입니다. 기본 Kubernetes 인프라 메트릭을 수집하여 Azure Monitor 작업 영역으로 보내고 사용자 지정 대상에 대한 추가 스크래핑을 구성합니다. 개요는 aka.ms/AzureManagedPrometheus 참조하세요.

ManagedClusterAzureMonitorProfileAppMonitoring

Object

AKS용 애플리케이션 모니터링 프로필.

속성	형식	Description
autoInstrumentation	ManagedClusterAzureMonitorProfileAppMonitoringAutoInstrumentation	AKS용 애플리케이션 모니터링 자동 계측. Microsoft OpenTelemetry 배포판을 통해 워크로드를 자동으로 계측하여 OpenTelemetry 지표, 로그, 추적을 수집하는 웹훅을 배포합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.
openTelemetryLogsAndTraces	ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryLogsAndTraces	애플리케이션 모니터링 OpenTelemetry 로그와 추적 프로필은 AKS입니다. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션의 OpenTelemetry 로그와 추적을 수집합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.
openTelemetryMetrics	ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryMetrics	애플리케이션 모니터링 OpenTelemetry Metrics AKS 프로파일. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션의 OpenTelemetry 지표를 수집합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.

ManagedClusterAzureMonitorProfileAppMonitoringAutoInstrumentation

Object

AKS용 애플리케이션 모니터링 자동 계측. Microsoft OpenTelemetry 배포판을 통해 워크로드를 자동으로 계측하여 OpenTelemetry 지표, 로그, 추적을 수집하는 웹훅을 배포합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.

속성	형식	Description
enabled	boolean	애플리케이션 모니터링 자동 계측이 활성화되었는지 여부를 나타냅니다.

ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryLogsAndTraces

Object

애플리케이션 모니터링 OpenTelemetry 로그와 추적 프로필은 AKS입니다. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션의 OpenTelemetry 로그와 추적을 수집합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.

속성	형식	Description
enabled	boolean	Application Monitoring OpenTelemetry Logs and traces가 활성화되어 있는지 여부를 나타냅니다.
grpcPort	integer (int64)	OpenTelemetry GRPC 로그와 트레이싱의 호스트 포트입니다. 명시하지 않은 경우, 기본 포트는 28332입니다.
httpPort	integer (int64)	OpenTelemetry HTTP/PROTOBUF 로그와 추적의 호스트 포트입니다. 지정하지 않으면 기본 포트는 28331입니다.

ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryMetrics

Object

애플리케이션 모니터링 OpenTelemetry Metrics AKS 프로파일. Azure Monitor OpenTelemetry 기반 SDK를 사용하여 애플리케이션의 OpenTelemetry 지표를 수집합니다. 개요는 참고 https://aka.ms/AKSAppMonitoringDocs 및 https://aka.ms/AzureMonitorApplicationMonitoring 참조.

속성	형식	Description
enabled	boolean	애플리케이션 모니터링 OpenTelemetry 메트릭이 활성화되어 있는지 여부를 나타냅니다.
grpcPort	integer (int64)	OpenTelemetry GRPC 지표의 호스트 포트입니다. 명시하지 않은 경우, 기본 포트는 28334입니다.
httpPort	integer (int64)	OpenTelemetry HTTP/PROTOBUF 메트릭의 호스트 포트입니다. 지정하지 않으면 기본 포트는 28333입니다.

ManagedClusterAzureMonitorProfileContainerInsights

Object

Azure Monitor Container Insights profile. Kubernetes 이벤트, 인벤토리, 컨테이너 stdout 및 stderr 로그 수집 구성을 나타냅니다. 개요는 aka.ms/AzureMonitorContainerInsights 참조하세요.

속성	형식	Description
containerNetworkLogs	ContainerNetworkLogs	Azure Monitor 設定容器 네트워크 로그s ingestion. 인제스트되는 로그 유형은 관련 CRD에 의해 제어됩니다; 명시되지 않은 경우, 기본값은 입니다.`Disabled` 자세한 내용은 참조 https://aka.ms/ContainerNetworkLogsDoc 하세요 https://aka.ms/acns/howtoenablecnl .
disablePrometheusMetricsScraping	boolean	prometheus 메트릭 스크래핑이 비활성화되었는지 여부를 나타냅니다. 지정하지 않으면 기본값이 false(프로메테우스 스크래핑)로 설정되어 있습니다.
enabled	boolean	Azure Monitor Container Insights Logs Addon이 활성화되어 있는지 여부를 나타냅니다.
logAnalyticsWorkspaceResourceId	string (arm-id)	Azure Log Analytics Workspace for storageing Azure Monitor Container Insights Logs의 Fully Qualified ARM Resource ID.
syslogPort	integer (int64)	syslog 호스트 포트입니다. 지정하지 않으면 기본 포트는 28330입니다.

ManagedClusterAzureMonitorProfileKubeStateMetrics

Object

Azure Managed Prometheus 추가 기능에 대한 Kube 상태 메트릭 프로필입니다. 이러한 선택적 설정은 추가 기능과 함께 배포되는 kube-state-metrics Pod에 대한 것입니다. 자세한 내용은 aka.ms/AzureManagedPrometheus-optional-parameters 참조하세요.

속성	형식	Description
metricAnnotationsAllowList	string	리소스의 레이블 메트릭에 사용할 Kubernetes 주석 키의 쉼표로 구분된 목록입니다(예: 'namespaces=[kubernetes.io/team,...],pods=[kubernetes.io/team],...'). 기본적으로 메트릭에는 리소스 이름 및 네임스페이스 레이블만 포함됩니다.
metricLabelsAllowlist	string	리소스의 레이블 메트릭에 사용할 추가 Kubernetes 레이블 키의 쉼표로 구분된 목록입니다(예: 'namespaces=[k8s-label-1,k8s-label-n,...],pods=[app],...'). 기본적으로 메트릭에는 리소스 이름 및 네임스페이스 레이블만 포함됩니다.

ManagedClusterAzureMonitorProfileMetrics

Object

Prometheus 추가 기능에 대한 Azure Monitor 관리 서비스에 대한 메트릭 프로필입니다. 기본 Kubernetes 인프라 메트릭을 수집하여 Azure Monitor 작업 영역으로 보내고 사용자 지정 대상에 대한 추가 스크래핑을 구성합니다. 개요는 aka.ms/AzureManagedPrometheus 참조하세요.

속성	형식	Description
controlPlane	ManagedClusterAzureMonitorProfileMetricsControlPlane	Control plane metrics collection profile for the Azure Managed Prometheus addon. 관리되는 제어 평면 컴포넌트(kube-apiserver, etcd 등)에서 운영 런타임 메트릭을 수집하도록 구성합니다. 개요는 aka.ms/aks/controlplane-metrics 를 참고하세요.
enabled	boolean	Prometheus 모니터링에 Azure Managed Prometheus 추가 기능을 사용하거나 사용하지 않도록 설정할지 여부입니다. 사용 및 비활성화에 대한 자세한 내용은 aka.ms/AzureManagedPrometheus-aks-enable 참조하세요.
kubeStateMetrics	ManagedClusterAzureMonitorProfileKubeStateMetrics	Azure Managed Prometheus 추가 기능에 대한 Kube 상태 메트릭 프로필입니다. 이러한 선택적 설정은 추가 기능과 함께 배포되는 kube-state-metrics Pod에 대한 것입니다. 자세한 내용은 aka.ms/AzureManagedPrometheus-optional-parameters 참조하세요.

ManagedClusterAzureMonitorProfileMetricsControlPlane

Object

Control plane metrics collection profile for the Azure Managed Prometheus addon. 관리되는 제어 평면 컴포넌트(kube-apiserver, etcd 등)에서 운영 런타임 메트릭을 수집하도록 구성합니다. 개요는 aka.ms/aks/controlplane-metrics 를 참고하세요.

속성	형식	Description
enabled	boolean	Azure Managed Prometheus 애드온에서 제어 평면 지표 수집을 활성화하거나 비활성화할지 여부. 기본값은 비활성화됩니다. 자세한 내용은 aka.ms/aks/controlplane-metrics 참조.

ManagedClusterBootstrapProfile

Object

부트스트랩 프로필입니다.

속성	형식	Default value	Description
artifactSource	ArtifactSource	Direct	아티팩트 원본입니다. 아티팩트가 다운로드되는 원본입니다.
containerRegistryId	string (arm-id)		Azure Container Registry 리소스 ID입니다. 레지스트리에는 프라이빗 네트워크 액세스, 프리미엄 SKU 및 영역 중복성이 있어야 합니다.

ManagedClusterCostAnalysis

Object

클러스터에 대한 비용 분석 구성

속성	형식	Description
enabled	boolean	비용 분석을 사용할지 여부입니다. 이 기능을 사용하려면 관리형 클러스터 sku.tier를 '표준' 또는 '프리미엄'으로 설정해야 합니다. 이를 사용하도록 설정하면 Kubernetes 네임스페이스 및 배포 세부 정보가 Azure 포털의 비용 분석 보기에 추가됩니다. 지정하지 않으면 기본값은 false입니다. 자세한 내용은 aka.ms/aks/docs/cost-analysis 참조하세요.

ManagedClusterHostedSystemProfile

Object

호스팅된 시스템 애드온에 대한 설정입니다.

속성	형식	Description
enabled	boolean	클러스터에 대해 호스팅된 시스템 애드온을 사용하도록 설정할지 여부입니다.
nodeSubnetID	string (arm-id)	테넌트 내 워크로드 포드를 실행하기 위해 노드 자동 프로비저닝으로 관리되는 워커 노드가 합류할 서브넷의 ID. 이 기능은 반`systemNodeSubnetID`드시 와 , 와 함께 `apiserverAccessProfile.subnetId` 제공되어야 하며, 세 서브넷 ID 모두 동일한 VNet에 있어야 합니다. 지정하지 않으면 AKS가 관리 자원 그룹 내에 기본 /16 CIDR을 사용해 서브넷을 생성합니다.
systemNodeSubnetID	string (arm-id)	중요한 시스템 애드온을 실행하기 위해 AKS가 관리 및 호스팅하는 시스템 노드가 가입할 서브넷의 ID. 이 ID는 와 `nodeSubnetID`, 와 함께 `apiserverAccessProfile.subnetId` 제공되어야 하며, 세 서브넷 ID 모두 동일한 VNet에 속해야 합니다. 지정하지 않으면 AKS가 관리 자원 그룹 내에 기본 /26 CIDR을 사용해 서브넷을 생성합니다.

ManagedClusterHTTPProxyConfig

Object

클러스터 HTTP 프록시 구성.

속성	형식	Description
enabled	boolean	HTTP 프록시를 활성화할지 여부입니다. 비활성화하면 지정된 프록시 구성이 포드와 노드에 설정되지 않습니다. 지정하지 않으면 기본값은 true입니다.
httpProxy	string	사용할 HTTP 프록시 서버 엔드포인트입니다.
httpsProxy	string	사용할 HTTPS 프록시 서버 엔드포인트입니다.
noProxy	string[]	프록시를 통과해서는 안 되는 엔드포인트입니다.
trustedCa	string	프록시 서버에 연결하는 데 사용할 대체 CA 인증서입니다.

ManagedClusterIdentity

Object

관리되는 클러스터의 ID입니다.

속성	형식	Description
delegatedResources	<string, DelegatedResource>	이 관리형 클러스터에 할당된 위임된 ID 리소스입니다. 이 설정은 다른 Azure 리소스 제공자에서만 가능하며, 관리된 클러스터는 위임된 한 개의 아이덴티티 리소스만 허용합니다. 내부용으로만 사용됩니다.
principalId	string	마스터 구성 요소에서 사용되는 시스템 할당 ID의 보안 주체 ID입니다.
tenantId	string	마스터 구성 요소에서 사용되는 시스템 할당 ID의 테넌트 ID입니다.
type	ResourceIdentityType	관리되는 클러스터에 사용되는 ID 유형입니다. 자세한 내용은 AKS의 use 관리 식별을 참조하세요.
userAssignedIdentities	<string, ManagedServiceIdentityUserAssignedIdentitiesValue>	관리되는 클러스터와 연결된 사용자 ID입니다. 이 ID는 제어 평면에서 사용됩니다. 사용자 할당 ID는 하나만 허용됩니다. 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID여야 합니다.

ManagedClusterIngressProfile

Object

컨테이너 서비스 클러스터에 대한 수신 프로필입니다.

속성	형식	Description
gatewayAPI	ManagedClusterIngressProfileGatewayConfiguration	관리형 게이트웨이 API 설치에 대한 설정
webAppRouting	ManagedClusterIngressProfileWebAppRouting	수신 프로필에 대한 앱 라우팅 설정입니다. https://learn.microsoft.com/en-us/azure/aks/app-routing?tabs=default%2Cdeploy-app-default이 기능에 대한 개요 및 온보딩 가이드를 찾을 수 있습니다.

ManagedClusterIngressProfileGatewayConfiguration

Object

관리형 게이트웨이 API CRD에 대한 구성. 자세한 내용은 https://aka.ms/k8s-gateway-api를 참조하세요.

속성	형식	Description
installation	ManagedGatewayType	관리형 게이트웨이 API 설치에 대한 구성입니다. 지정하지 않으면 기본값은 '사용 안 함'입니다. 자세한 내용은 https://aka.ms/k8s-gateway-api를 참조하세요.

ManagedClusterIngressProfileNginx

Object

관리된 클러스터 인그레스 프로필을 위한 Nginx 인그레스 컨트롤러 설정.

속성	형식	Description
defaultIngressControllerType	NginxIngressControllerType	기본 NginxIngressController 사용자 지정 리소스에 대한 수신 형식

ManagedClusterIngressProfileWebAppRouting

Object

수신 프로필에 대한 애플리케이션 라우팅 추가 기능 설정입니다.

속성	형식	Description
dnsZoneResourceIds	string[] (arm-id)	애플리케이션 라우팅 추가 기능과 연결할 DNS 영역의 리소스 ID입니다. 애플리케이션 라우팅 추가 기능을 사용하도록 설정한 경우에만 사용됩니다. 공용 DNS와 private DNS 존은 서로 다른 자원 그룹에 속할 수 있지만, 모든 공용 DNS 존은 반드시 같은 자원 그룹에 속해야 하며, 모든 private DNS 존도 동일한 자원 그룹에 있어야 합니다.
enabled	boolean	애플리케이션 라우팅 추가 기능을 사용하도록 설정할지 여부입니다.
gatewayAPIImplementations	ManagedClusterWebAppRoutingGatewayAPIImplementations	App Routing을 이용한 관리 인그레스에 사용되는 게이트웨이 API 제공자 구성. 게이트웨이 API에 대한 자세한 내용은 참고 https://aka.ms/k8s-gateway-api 하세요.
identity	UserAssignedIdentity	애플리케이션 라우팅 추가 기능의 관리 ID입니다. 예를 들어 연결된 Azure DNS 리소스를 관리하고 Azure Key Vault에서 인증서를 가져오기 위해 권한을 부여해야 하는 ID입니다. 자세한 지침은 추가 기능 대한 이 개요를 참조하세요.
nginx	ManagedClusterIngressProfileNginx	기본 NginxIngressController에 대한 구성입니다. 자세한 내용은 https://learn.microsoft.com/en-us/azure/aks/app-routing-nginx-configuration#the-default-nginx-ingress-controller.

ManagedClusterListResult

Object

ManagedCluster 리스트 작업의 응답.

속성	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	ManagedCluster[]	이 페이지의 ManagedCluster 항목들

ManagedClusterLoadBalancerProfile

Object

관리형 클러스터 부하 분산 장치의 프로필입니다.

속성	형식	Default value	Description
allocatedOutboundPorts	integer (int32) minimum: 0 maximum: 64000	0	VM당 할당된 SNAT 포트의 원하는 수입니다. 허용되는 값의 범위는 0에서 64000(포함)입니다. 기본 값은 0이라 Azure가 동적으로 포트 할당을 합니다.
backendPoolType	BackendPoolType	NodeIPConfiguration	관리되는 인바운드 Load Balancer 백엔드풀의 유형입니다.
effectiveOutboundIPs	ResourceReference[]		클러스터 부하 분산 장치의 효과적인 아웃바운드 IP 리소스입니다.
enableMultipleStandardLoadBalancers	boolean		AKS 클러스터당 여러 표준 부하 분산 장치를 사용하도록 설정합니다.
idleTimeoutInMinutes	integer (int32) minimum: 4 maximum: 120	30	원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 30분입니다.
managedOutboundIPs	ManagedClusterLoadBalancerProfileManagedOutboundIPs		클러스터 부하 분산 장치에 대한 원하는 관리형 아웃바운드 IP입니다.
outboundIPPrefixes	ManagedClusterLoadBalancerProfileOutboundIPPrefixes		클러스터 부하 분산 장치에 대한 원하는 아웃바운드 IP 접두사 리소스입니다.
outboundIPs	ManagedClusterLoadBalancerProfileOutboundIPs		클러스터 부하 분산 장치에 필요한 아웃바운드 IP 리소스입니다.

ManagedClusterLoadBalancerProfileManagedOutboundIPs

Object

클러스터 부하 분산 장치에 대한 원하는 관리형 아웃바운드 IP입니다.

속성	형식	Default value	Description
count	integer (int32) minimum: 1 maximum: 100	1	클러스터 load balancer를 위해 Azure가 생성/관리하는 원하는 IPv4 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 1입니다.
countIPv6	integer (int32) minimum: 0 maximum: 100	0	클러스터 load balancer를 위해 Azure가 생성/관리하는 원하는 IPv6 아웃바운드 IP 수량입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 단일 스택의 경우 0이고 이중 스택의 경우 1입니다.

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

Object

클러스터 부하 분산 장치에 대한 원하는 아웃바운드 IP 접두사 리소스입니다.

속성	형식	Description
publicIPPrefixes	ResourceReference[]	공용 IP 접두사 리소스 목록입니다.

ManagedClusterLoadBalancerProfileOutboundIPs

Object

클러스터 부하 분산 장치에 필요한 아웃바운드 IP 리소스입니다.

속성	형식	Description
publicIPs	ResourceReference[]	공용 IP 리소스 목록입니다.

ManagedClusterManagedOutboundIPProfile

Object

관리형 클러스터의 관리되는 아웃바운드 IP 리소스 프로필입니다.

속성	형식	Default value	Description
count	integer (int32) minimum: 1 maximum: 16	1	Azure 생성/관리하는 원하는 아웃바운드 IP 수입니다. 허용되는 값은 1에서 16(포함) 범위여야 합니다. 기본값은 1입니다.
countIPv6	integer (int32) minimum: 1 maximum: 16		Azure가 생성/관리하는 원하는 IPv6 아웃바운드 IP 수. 허용되는 값은 1에서 16(포함) 범위여야 합니다.

ManagedClusterMetricsProfile

Object

ManagedCluster에 대한 메트릭 프로필입니다.

속성	형식	Description
costAnalysis	ManagedClusterCostAnalysis	Kubernetes별 자세한 리소스 비용 분석을 위한 구성입니다.

ManagedClusterNATGatewayProfile

Object

관리형 클러스터 NAT 게이트웨이의 프로필입니다.

속성	형식	Default value	Description
effectiveOutboundIPs	ResourceReference[]		클러스터 NAT 게이트웨이의 효과적인 아웃바운드 IP 리소스입니다.
idleTimeoutInMinutes	integer (int32) minimum: 4 maximum: 120	4	원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 4분입니다.
managedOutboundIPProfile	ManagedClusterManagedOutboundIPProfile		클러스터 NAT 게이트웨이의 관리되는 아웃바운드 IP 리소스 프로필입니다.
outboundIPPrefixes	OutboundIPPrefixes		관리되는 NAT 게이트웨이를 위한 원하는 아웃바운드 IP 프리픽스 리소스. NAT 게이트웨이 V2와만 호환됩니다.
outboundIPs	OutboundIPs		관리형 NAT 게이트웨이를 위한 원하는 아웃바운드 IP 자원.
sku	ManagedClusterNATGatewaySku		관리형 클러스터 NAT 게이트웨이의 SKU입니다. 해당 지역에서 제공되는 경우에는 기본값이 'StandardV2'이며, 그렇지 않으면 'Standard'로 표시됩니다.

ManagedClusterNATGatewaySku

열거형

관리형 클러스터 NAT 게이트웨이의 SKU입니다.

값	Description
Standard	표준 SKU NAT 게이트웨이를 사용하세요.
StandardV2	StandardV2 SKU NAT 게이트웨이를 사용하세요. 이 기능이 제공되는 지역의 신규 클러스터는 기본 모드입니다.

ManagedClusterNodeProvisioningProfile

Object

관리되는 클러스터용 노드 프로비저닝 프로필.

속성	형식	Default value	Description
defaultNodePools	NodeProvisioningDefaultNodePools	Auto	노드 프로비저닝을 위해 구성된 기본 Karpenter NodePool(CRD) 집합입니다. 이 필드는 모드가 '자동'이 아니면 효과가 없습니다. 경고: 기존 클러스터에서 이를 자동에서 없음으로 변경하면 기본 Karpenter NodePools가 삭제되어 해당 풀과 연결된 노드가 드레이닝되고 삭제됩니다. 해당 작업에 의해 축출된 파드를 사용할 준비가 된 유휴 노드가 없는 한 이 작업을 수행하지 않는 것이 좋습니다. 지정하지 않으면 기본값은 Auto입니다. 자세한 내용은 aka.ms/aks/nap#node-pools 참조하십시오.
mode	NodeProvisioningMode		노드 프로비저닝 모드입니다. 지정하지 않으면 기본값은 수동입니다.

ManagedClusterNodeResourceGroupProfile

Object

관리되는 클러스터에 대한 노드 리소스 그룹 잠금 프로필입니다.

속성	형식	Description
restrictionLevel	RestrictionLevel	클러스터의 노드 리소스 그룹에 적용되는 제한 수준입니다. 지정하지 않으면 기본값은 'Unrestricted'입니다.

ManagedClusterOIDCIssuerProfile

Object

관리형 클러스터의 OIDC 발급자 프로필입니다.

속성	형식	Description
enabled	boolean	OIDC 발급자를 사용할 수 있는지 여부입니다.
issuerURL	string	관리형 클러스터의 OIDC 발급자 URL입니다.

ManagedClusterPodIdentity

Object

관리형 클러스터에 할당된 Pod ID에 대한 세부 정보입니다.

속성	형식	Description
bindingSelector	string	AzureIdentityBinding 리소스에 사용할 바인딩 선택기입니다.
identity	UserAssignedIdentity	사용자가 할당한 ID 세부 정보입니다.
name	string	Pod ID의 이름입니다.
namespace	string	Pod ID의 네임스페이스입니다.
provisioningInfo	ManagedClusterPodIdentityProvisioningInfo	포드 아이덴티티의 프로비저닝 정보입니다.
provisioningState	ManagedClusterPodIdentityProvisioningState	Pod ID의 현재 프로비저닝 상태입니다.

ManagedClusterPodIdentityException

Object

특정 레이블이 있는 Pod가 NMI(노드 관리 ID) 서버에서 가로채지 않고 IMDS(Azure Instance Metadata Service) 엔드포인트에 액세스할 수 있도록 하는 Pod ID 예외입니다. 자세한 내용은 특정 Pod/애플리케이션 AAD Pod ID를 사용하지 않도록 설정하는 참조하세요.

속성	형식	Description
name	string	Pod ID 예외의 이름입니다.
namespace	string	Pod ID 예외의 네임스페이스입니다.
podLabels	object	일치시킬 Pod 레이블입니다.

ManagedClusterPodIdentityProfile

Object

관리형 클러스터의 Pod ID 프로필입니다. Pod ID 통합에 대한 자세한 내용은 AAD Pod ID 사용하는 참조하세요.

속성	형식	Description
allowNetworkPluginKubenet	boolean	Kubenet 네트워킹을 사용하여 클러스터에서 Pod ID를 실행할 수 있는지 여부입니다. AAD Pod ID의 보안 관련 특성 및 IP 스푸핑의 위험으로 인해 Kubenet에서 실행이 기본적으로 비활성화됩니다. 자세한 내용은 Using Kubenet 네트워크 플러그인 with AAD Pod Identity를 참조하세요.
enabled	boolean	Pod ID 추가 기능을 사용할 수 있는지 여부입니다.
userAssignedIdentities	ManagedClusterPodIdentity[]	클러스터에서 사용할 Pod ID입니다.
userAssignedIdentityExceptions	ManagedClusterPodIdentityException[]	허용할 Pod ID 예외입니다.

ManagedClusterPodIdentityProvisioningError

Object

Pod ID 프로비저닝의 오류 응답입니다.

속성	형식	Description
error	ManagedClusterPodIdentityProvisioningErrorBody	오류에 대한 세부 정보입니다.

ManagedClusterPodIdentityProvisioningErrorBody

Object

Pod ID 프로비저닝의 오류 응답입니다.

속성	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	ManagedClusterPodIdentityProvisioningErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

ManagedClusterPodIdentityProvisioningInfo

Object

포드 신원 프로비저닝 정보.

속성	형식	Description
error	ManagedClusterPodIdentityProvisioningError	Pod ID 할당 오류(있는 경우)입니다.

ManagedClusterPodIdentityProvisioningState

열거형

Pod ID의 현재 프로비저닝 상태입니다.

값	Description
Assigned	포드 정체성이 할당됩니다.
Canceled	포드 신원 할당이 취소되었습니다.
Deleting	포드 아이덴티티가 삭제되고 있습니다.
Failed	포드 신원 할당에 실패했습니다.
Succeeded	포드 신원 할당에 성공했습니다.
Updating	포드 신원이 업데이트되고 있습니다.

ManagedClusterPropertiesAutoScalerProfile

Object

사용하도록 설정된 경우 클러스터 자동 크기 조정기에 적용할 매개 변수

속성	형식	Description
balance-similar-node-groups	string	비슷한 노드 풀을 검색하고 두 노드 풀의 노드 수를 균형 있게 조정합니다. 유효한 값은 'true' 및 'false'입니다.
daemonset-eviction-for-empty-nodes	boolean	데몬셋 파드는 빈 노드에서 정상적으로 종료된다. true로 설정하면 노드를 삭제하기 전에 빈 노드의 모든 디먼셋 Pod가 제거됩니다. 디먼셋 Pod를 제거할 수 없는 경우 크기 조정을 위해 다른 노드가 선택됩니다. false로 설정하면 디먼셋 Pod가 삭제되거나 제거되지 않고 노드가 삭제됩니다.
daemonset-eviction-for-occupied-nodes	boolean	데몬셋 파드는 비어 있지 않은 노드에서 정상적으로 종료된다. true로 설정하면 노드를 삭제하기 전에 점유된 노드의 모든 디먼셋 Pod가 제거됩니다. 디먼셋 Pod를 제거할 수 없는 경우 크기 조정을 위해 다른 노드가 선택됩니다. false로 설정하면 디먼셋 Pod가 삭제되거나 제거되지 않고 노드가 삭제됩니다.
expander	Expander	확장할 때 사용할 확장기입니다. 지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기 참조하세요.
ignore-daemonsets-utilization	boolean	CA는 축소를 위한 리소스 사용률을 계산할 때 DaemonSet Pod를 무시해야 합니다. true로 설정하면 디먼셋에서 사용하는 리소스는 스케일 다운 결정을 내릴 때 고려됩니다.
max-empty-bulk-delete	string	동시에 삭제할 수 있는 빈 노드의 최대 수입니다. 이는 양의 정수여야 합니다. 기본값은 10입니다.
max-graceful-termination-sec	string	클러스터 자동 크기 조정기가 노드 규모를 축소하려고 할 때 Pod 종료를 기다리는 최대 시간(초)입니다. 기본값은 600입니다.
max-node-provision-time	string	자동 크기 조정기가 노드가 프로비전될 때까지 대기하는 최대 시간입니다. 기본값은 '15m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.
max-total-unready-percentage	string	클러스터에서 준비되지 않은 노드의 최대 백분율입니다. 이 비율을 초과하면 클러스터 자동 크기 조정기가 작업을 중지합니다. 기본값은 45입니다. 최대값은 100이고 최소값은 0입니다.
new-pod-scale-up-delay	string	특정 연령이 되기 전에 예약되지 않은 Pod를 무시합니다. kubernetes 스케줄러가 모든 Pod를 예약하기 전에 CA가 작동하지 않도록 하는 버스트/일괄 처리 확장과 같은 시나리오의 경우 특정 기간이 되기 전에 예약되지 않은 Pod를 무시하도록 CA에 지시할 수 있습니다. 기본값은 '0s'입니다. 값은 정수 다음에 단위(초의 경우 's', 분은 'm', 시간 단위는 'h' 등)여야 합니다.
ok-total-unready-count	string	max-total-unready-percentage에 관계없이 허용되는 읽지 않은 노드 수입니다. 정수여야 합니다. 기본값은 3입니다.
scale-down-delay-after-add	string	스케일 업 후 스케일 다운 평가가 다시 시작되는 시점은 얼마나 걸립니까? 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.
scale-down-delay-after-delete	string	노드 삭제 후 스케일 다운 평가가 다시 시작되기 전까지의 경과 시간입니다. 기본값은 검색 간격입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.
scale-down-delay-after-failure	string	스케일 다운 실패 후 스케일 다운 평가가 다시 시작되기 전까지의 경과 시간입니다. 기본값은 '3m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.
scale-down-unneeded-time	string	노드가 스케일 다운에 적합하기 전에 불필요한 기간을 지정해야 합니다. 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.
scale-down-unready-time	string	준비되지 않은 노드가 축소될 수 있기 전에 불필요해야 하는 기간입니다. 기본값은 '20m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.
scale-down-utilization-threshold	string	요청된 리소스의 합계로 정의된 노드 사용률 수준은 용량으로 나뉘어 있으며, 그 아래 노드는 축소로 간주될 수 있습니다. 기본값은 '0.5'입니다.
scan-interval	string	스케일 업 또는 다운을 위해 클러스터를 다시 평가하는 빈도입니다. 기본값은 '10'입니다. 값은 정수(초)여야 합니다.
skip-nodes-with-local-storage	string	클러스터 자동 스케일러가 로컬 storage가 있는 노드(예: EmptyDir나 HostPath)가 있는 노드를 삭제하지 않는다면, 기본값은 true입니다.
skip-nodes-with-system-pods	string	클러스터 자동 스케일러가 kube-system에서 파드가 있는 노드 삭제를 건너뛰는 경우(데몬셋 또는 미러 파드 제외). 기본값은 true입니다.

ManagedClusterSecurityProfile

Object

컨테이너 서비스 클러스터에 대한 보안 프로필입니다.

속성	형식	Description
azureKeyVaultKms	AzureKeyVaultKms	Azure Key Vault는 보안 프로필에 대한 키 관리 서비스 설정을.
customCATrustCertificates	string[] (byte)	클러스터의 모든 노드에서 트러스트 저장소에 추가될 최대 10개의 base64로 인코딩된 CA 목록입니다. 자세한 내용은 사용자 지정 CA 트러스트 인증서를 참조하세요.
defender	ManagedClusterSecurityProfileDefender	보안 프로필에 대한 Microsoft Defender 설정입니다.
imageCleaner	ManagedClusterSecurityProfileImageCleaner	보안 프로필에 대한 이미지 클리너 설정입니다.
kubernetesResourceObjectEncryptionProfile	KubernetesResourceObjectEncryptionProfile	Kubernetes 리소스 개체의 미사용 암호화. 이에 대한 자세한 내용은 아래에서 찾을 수 있습니다. https://aka.ms/aks/kubernetesResourceObjectEncryption
workloadIdentity	ManagedClusterSecurityProfileWorkloadIdentity	보안 프로필에 대한 워크로드 ID 설정입니다. 워크로드 ID를 사용하면 Kubernetes 애플리케이션이 Azure AD를 사용하여 Azure 클라우드 리소스에 안전하게 액세스할 수 있습니다. 자세한 내용은 https://aka.ms/aks/wi를 참조하세요.

ManagedClusterSecurityProfileDefender

Object

보안 프로필에 대한 Microsoft Defender 설정입니다.

속성	형식	Description
logAnalyticsWorkspaceResourceId	string (arm-id)	Microsoft Defender와 연관된 로그 분석 작업 공간의 자원 ID. Microsoft Defender 사용하도록 설정된 경우 이 필드는 필수이며 유효한 작업 영역 리소스 ID여야 합니다. Microsoft Defender 사용하지 않도록 설정되면 필드를 비워 둡니다.
securityGating	ManagedClusterSecurityProfileDefenderSecurityGating	Microsoft Defender의 보안 게이팅 설정. 이는 Defender for Containers 보안 결과를 바탕으로 컨테이너 이미지 배포 자격을 검증합니다. Admission Controller를 사용하여 보안 기준을 충족하지 않는 이미지의 배포를 감사하거나 차단합니다. 자세한 내용은 https://aka.ms/KubernetesDefenderAuditRule를 참조하세요.
securityMonitoring	ManagedClusterSecurityProfileDefenderSecurityMonitoring	Microsoft Defender의 클라우드 보안 프로필 위협 탐지.

ManagedClusterSecurityProfileDefenderSecurityGating

Object

Microsoft Defender의 보안 게이팅 설정. 이는 Defender for Containers 보안 결과를 바탕으로 컨테이너 이미지 배포 자격을 검증합니다. Admission Controller를 사용하여 보안 기준을 충족하지 않는 이미지의 배포를 감사하거나 차단합니다.

속성	형식	Description
allowSecretAccess	boolean	등록 권한이 관리 신원이 아닌 비밀 식별 방식으로 부여되는 동안에만 사용됩니다. Defender 게이팅 에이전트가 레지스트리에서 이미지를 가져올 클러스터 비밀에 대한 접근 권한을 부여할지 여부를 설정합니다. 비밀 접근이 거부되고 레지스트리가 풀 비밀을 요구하면, 애드온은 이미지 검증을 수행하지 않습니다. 기본값은 거짓입니다.
enabled	boolean	Defender 보안 게이팅을 사용하도록 설정할지 여부입니다. 게이팅 기능이 활성화되면 컨테이너 이미지를 스캔하고 구성된 보안 규칙에 따라 보안 기준을 충족하지 않는 이미지의 배포를 감사하거나 차단합니다. 자세한 내용은 https://aka.ms/KubernetesDefenderAuditRule를 참조하세요.
identities	ManagedClusterSecurityProfileDefenderSecurityGatingIdentity[]	입학 담당자가 등록부에서 보안 산출물을 추출할 때 사용하는 신원 목록입니다. 이러한 ID는 클러스터에서 컨테이너 이미지를 끌어오는 데 사용하는 것과 동일한 ID입니다. 이 신원성 설정에 대한 자세한 내용은 .를 참조하세요 https://learn.microsoft.com/en-us/azure/defender-for-cloud/gated-deployment-infrastructure-as-code.

ManagedClusterSecurityProfileDefenderSecurityGatingIdentity

Object

Defender에서 레지스트리 접근을 위한 보안 게이팅에서 사용되는 신원 매핑.

속성	형식	Description
azureContainerRegistry	string	ID를 사용할 컨테이너 레지스트리입니다. 여기에 지정된 ID에 연결된 페더레이션 ID 자격 증명이 있어야 합니다.
identity	UserAssignedIdentity	레지스트리에 access하는 데 사용되는 아이덴티티 객체

ManagedClusterSecurityProfileDefenderSecurityMonitoring

Object

보안 프로필 위협 검색에 대한 Microsoft Defender 설정입니다.

속성	형식	Description
enabled	boolean	Defender 위협 탐지를 사용하도록 설정할지 여부

ManagedClusterSecurityProfileImageCleaner

Object

Image Cleaner는 노드에서 사용되지 않는 이미지를 제거하여 디스크 공간을 확보하고 공격 노출 영역을 줄이는 데 도움이 됩니다. 다음은 보안 프로필에 대한 설정입니다.

속성	형식	Description
enabled	boolean	AKS 클러스터에서 Image Cleaner를 사용하도록 설정할지 여부입니다.
intervalHours	integer (int32)	이미지 클리너 검색 간격(시간)입니다.

ManagedClusterSecurityProfileWorkloadIdentity

Object

보안 프로필에 대한 워크로드 ID 설정입니다.

속성	형식	Description
enabled	boolean	워크로드 ID를 사용하도록 설정할지 여부입니다.

ManagedClusterServicePrincipalProfile

Object

클러스터가 Azure API를 조작할 때 사용할 서비스 주체 신원에 관한 정보입니다.

속성	형식	Description
clientId	string	서비스 주체의 ID입니다.
secret	string (password)	일반 텍스트로 서비스 주체와 연결된 비밀 암호입니다.

ManagedClusterSKU

Object

관리형 클러스터의 SKU입니다.

속성	형식	Description
name	ManagedClusterSKUName	관리되는 클러스터 SKU의 이름입니다.
tier	ManagedClusterSKUTier	관리되는 클러스터 SKU의 계층입니다. 지정하지 않으면 기본값은 'Free'입니다. 자세한 내용은 AKS 가격 티어를 참조하세요.

ManagedClusterSKUName

열거형

관리되는 클러스터 SKU의 이름입니다.

값	Description
Base	AKS 컨트롤 플레인의 기본 옵션입니다.
Automatic	자동 클러스터는 클러스터 및 워크로드 설정, 확장성 및 보안에 대한 AKS 모범 사례 및 권장 사항을 따르는 구성을 사용하여 대부분의 프로덕션 워크로드를 실행하도록 최적화되어 있습니다. 자동 클러스터에 대한 자세한 내용은 aka.ms/aks/automatic 를 참조하세요.

ManagedClusterSKUTier

열거형

관리되는 클러스터 SKU의 계층입니다. 지정하지 않으면 기본값은 'Free'입니다. 자세한 내용은 AKS 가격 티어를 참조하세요.

값	Description
Premium	클러스터에는 '표준'에 포함된 모든 기능 외에도 프리미엄 기능이 있습니다. 프리미엄을 사용하면 특정 Kubernetes 버전에 대해 LongTermSupport(aka.ms/aks/lts)를 선택할 수 있습니다.
Standard	중요 업무용 워크로드 및 프로덕션 워크로드에 권장됩니다. Kubernetes 컨트롤 플레인 자동 크기 조정, 워크로드 집약적 테스트 및 클러스터당 최대 5,000개의 노드를 포함합니다. 가용성 영역을 사용하는 클러스터에 대해 99.95% Kubernetes API 서버 엔드포인트의 가용성을 보장하고 가용성 영역을 사용하지 않는 클러스터에 대해 99.9% 가용성을 보장합니다.
Free	클러스터 관리는 무료이지만 VM, 스토리지 및 네트워킹 사용량에 대한 요금이 청구됩니다. 노드가 10개 미만인 실험, 학습, 간단한 테스트 또는 워크로드에 가장 적합합니다. 프로덕션 사용 사례에는 권장되지 않습니다.

ManagedClusterStaticEgressGatewayProfile

Object

클러스터에 대한 정적 송신 게이트웨이 추가 기능 구성입니다.

속성	형식	Description
enabled	boolean	Static Egress Gateway 애드온을 활성화합니다. 정적 송신 게이트웨이 추가 기능을 사용할 수 있는지 여부를 나타냅니다.

ManagedClusterStatus

Object

관리형 클러스터에 대한 읽기 전용 정보를 포함합니다.

속성	형식	Description
provisioningError	ErrorDetail	관리되는 클러스터의 오류 세부 정보입니다. 오류에 대한 자세한 정보를 유지합니다. 오류가 없으면 이 필드는 생략됩니다.

ManagedClusterStorageProfile

Object

컨테이너 서비스 클러스터에 대한 스토리지 프로필입니다.

속성	형식	Description
blobCSIDriver	ManagedClusterStorageProfileBlobCSIDriver	스토리지 프로필에 대한 AzureBlob CSI 드라이버 설정입니다.
diskCSIDriver	ManagedClusterStorageProfileDiskCSIDriver	스토리지 프로필에 대한 AzureDisk CSI 드라이버 설정입니다.
fileCSIDriver	ManagedClusterStorageProfileFileCSIDriver	스토리지 프로필에 대한 AzureFile CSI 드라이버 설정입니다.
snapshotController	ManagedClusterStorageProfileSnapshotController	스토리지 프로필에 대한 스냅샷 컨트롤러 설정입니다.

ManagedClusterStorageProfileBlobCSIDriver

Object

스토리지 프로필에 대한 AzureBlob CSI 드라이버 설정입니다.

속성	형식	Description
enabled	boolean	AzureBlob CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 false입니다.

ManagedClusterStorageProfileDiskCSIDriver

Object

스토리지 프로필에 대한 AzureDisk CSI 드라이버 설정입니다.

속성	형식	Description
enabled	boolean	AzureDisk CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다.

ManagedClusterStorageProfileFileCSIDriver

Object

스토리지 프로필에 대한 AzureFile CSI 드라이버 설정입니다.

속성	형식	Description
enabled	boolean	AzureFile CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다.

ManagedClusterStorageProfileSnapshotController

Object

스토리지 프로필에 대한 스냅샷 컨트롤러 설정입니다.

속성	형식	Description
enabled	boolean	스냅샷 컨트롤러를 사용하도록 설정할지 여부입니다. 기본값은 true입니다.

ManagedClusterWebAppRoutingGatewayAPIImplementations

Object

App Routing을 이용한 관리 인그레스에 사용되는 게이트웨이 API 제공자 구성.

속성	형식	Description
appRoutingIstio	ManagedClusterAppRoutingIstio	Gateway API와 App Routing을 통한 관리된 인그레스를 위한 사이드카 없는 Istio 제어 플레인 설정. 게이트웨이 API를 통한 인그레스 사용에 관한 정보는 참고 https://aka.ms/gateway-on-istio 하세요.

ManagedClusterWindowsProfile

Object

관리되는 클러스터의 Windows VM에 대한 프로필입니다.

속성	형식	Description
adminPassword	string (password)	관리자 계정의 암호를 지정합니다. 최소 길이: 8자 최대 길이: 123자 복잡성 요구 사항: 아래의 4개 조건 중 3개 조건을 충족해야 합니다. 하위 문자가 있습니다. 대문자 자릿수가 있습니다. 특수 문자가 있음(Regex 일치 [\W_]) 허용되지 않는 값: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"
adminUsername	string	관리자 계정의 이름을 지정합니다. 제한: ""로 끝날 수 없습니다. 허용 안 함 값: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". 최소 길이: 1자 최대 길이: 20자
enableCSIProxy	boolean	CSI 프록시를 사용하도록 설정할지 여부입니다. CSI 프록시에 대한 자세한 내용은 저장소CSI 프록시 GitHub를 참조하세요.
gmsaProfile	WindowsGmsaProfile	관리되는 클러스터의 Windows gMSA 프로필입니다.
licenseType	LicenseType	Windows VM에 사용할 라이선스 유형입니다. 자세한 내용은 Azure 하이브리드 사용자 혜택을 참조하세요.

ManagedClusterWorkloadAutoScalerProfile

Object

관리되는 클러스터에 대한 워크로드 자동 크기 조정기 프로필입니다.

속성	형식	Description
keda	ManagedClusterWorkloadAutoScalerProfileKeda	워크로드 자동 크기 조정기 프로필에 대한 KEDA(Kubernetes 이벤트 기반 자동 크기 조정) 설정입니다.
verticalPodAutoscaler	ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler	워크로드 자동 크기 조정기 프로필에 대한 VPA(Vertical Pod Autoscaler) 설정입니다.

ManagedClusterWorkloadAutoScalerProfileKeda

Object

워크로드 자동 크기 조정기 프로필에 대한 KEDA(Kubernetes 이벤트 기반 자동 크기 조정) 설정입니다.

속성	형식	Description
enabled	boolean	KEDA를 사용하도록 설정할지 여부입니다.

ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler

Object

워크로드 자동 크기 조정기 프로필에 대한 VPA(Vertical Pod Autoscaler) 설정입니다.

속성	형식	Default value	Description
enabled	boolean	False	VPA를 사용하도록 설정할지 여부입니다. 기본값은 거짓입니다.

ManagedGatewayType

열거형

관리형 게이트웨이 API 설치에 대한 구성입니다. 지정하지 않으면 기본값은 '사용 안 함'입니다. 자세한 내용은 https://aka.ms/k8s-gateway-api를 참조하세요.

값	Description
Disabled	게이트웨이 API CRD는 클러스터에서 조정되지 않습니다.
Standard	표준 릴리스 채널의 Gateway API CRD는 클러스터에 조정됩니다. 쿠버네티스 버전에 어떤 번들이 설치될지 확인 https://aka.ms/gateway-api-versions 해 보세요.

ManagedServiceIdentityUserAssignedIdentitiesValue

Object

사용자 할당 ID 속성입니다.

속성	형식	Description
clientId	string	사용자 할당 ID의 클라이언트 ID입니다.
principalId	string	사용자 할당 ID의 보안 주체 ID입니다.

ManagementMode

열거형

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

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

ManualScaleProfile

Object

컴퓨터 수에 대한 사양입니다.

속성	형식	Description
count	integer (int32)	노드 수입니다.
size	string	'Standard_E4s_v3', 'Standard_E16s_v3' 또는 'Standard_D16s_v5'과 같이 AKS에서 만들고 크기를 조정하는 데 사용할 VM 크기입니다.

NetworkDataplane

열거형

Kubernetes 클러스터에서 사용되는 네트워크 데이터 평면입니다.

값	Description
azure	Azure 네트워크 데이터 평면을 사용합니다.
cilium	Cilium 네트워크 데이터 평면을 사용합니다. 자세한 내용은 Cilium Azure CNI를 참조하세요.

NetworkMode

열거형

Azure CNI가 설정한 네트워크 모드입니다. networkPlugin이 'azure'가 아닌 경우 지정할 수 없습니다.

값	Description
transparent	브리지가 만들어지지 않습니다. Pod 간 Intra-VM 통신은 Azure CNI에서 만든 IP 경로를 통해 진행됩니다. 자세한 내용은 투명 모드 참조하세요.
bridge	더 이상 지원되지 않습니다.

NetworkPlugin

열거형

Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 플러그 인입니다.

값	Description
azure	Azure CNI 네트워크 플러그 인을 사용합니다. 자세한 내용은 Azure CNI(고급) 네트워킹 참조하세요.
kubenet	Kubenet 네트워크 플러그 인을 사용합니다. 자세한 내용은 Kubenet(기본) 네트워킹 참조하세요.
none	CNI 플러그 인이 사전 설치되어 있지 않습니다. 자세한 내용은 BYO CNI 참조하세요.

NetworkPluginMode

열거형

네트워크 플러그 인에서 사용해야 하는 모드입니다.

값	Description
overlay	networkPlugin=azure와 함께 사용되는 Pod는 PodCIDR 주소 공간에서 IP를 제공하지만 Kubenet의 경로 테이블 방법이 아닌 Azure 라우팅 도메인을 사용합니다. 자세한 내용은 을 방문하십시오 https://aka.ms/aks/azure-cni-overlay.

NetworkPolicy

열거형

Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 정책입니다.

값	Description
none	네트워크 정책은 적용되지 않습니다. NetworkPolicy를 지정하지 않은 경우 기본값입니다.
calico	Calico 네트워크 정책을 사용합니다. 자세한 내용은 Azure 및 Calico 정책 차이점을 참조하세요.
azure	Azure 네트워크 정책을 사용합니다. 자세한 내용은 Azure 및 Calico 정책 차이점을 참조하세요.
cilium	Cilium을 사용하여 네트워크 정책을 적용합니다. 이를 위해서는 networkDataplane이 'cilium'이어야 합니다.

NginxIngressControllerType

열거형

기본 NginxIngressController 사용자 지정 리소스에 대한 수신 형식

값	Description
AnnotationControlled	기본 NginxIngressController가 만들어집니다. 사용자는 기본 NginxIngressController 사용자 지정 리소스를 편집하여 부하 분산 장치 주석을 구성할 수 있습니다.
External	기본 NginxIngressController가 만들어지고 연산자가 외부 부하 분산 장치를 프로비전합니다. 기본 loadbalancer를 내부로 만들기 위한 주석은 덮어씁니다.
Internal	기본 NginxIngressController가 만들어지고 연산자가 내부 부하 분산 장치를 프로비전합니다. 기본 loadbalancer를 외부로 만들기 위한 모든 주석을 덮어씁니다.
None	기본 수신 컨트롤러는 만들어지지 않습니다. 존재하는 경우 시스템에서 삭제되지 않습니다. 원하는 경우 사용자는 기본 NginxIngressController 사용자 지정 리소스를 수동으로 삭제해야 합니다.

NodeOSUpgradeChannel

열거형

노드 OS 업그레이드 채널. 노드의 OS가 업데이트되는 방식입니다. 기본값은 NodeImage입니다.

값	Description
None	OS 또는 VHD를 롤링하여 머신 OS를 업데이트하려고 시도하지 않습니다. 즉, 보안 업데이트에 대한 책임이 있습니다.
Unmanaged	OS 업데이트는 OS 기본 제공 패치 인프라를 통해 자동으로 적용됩니다. 새로 확장된 컴퓨터는 처음에는 패치가 적용되지 않으며 OS의 인프라에 의해 어느 시점에 패치됩니다. 이 옵션의 동작은 문제의 OS에 따라 달라집니다. Ubuntu 및 Mariner는 UTC 06:00 경에 하루에 한 번 무인 업그레이드를 통해 보안 패치를 적용합니다. Windows는 보안 패치를 자동으로 적용하지 않으므로 추가 공지가 있을 때까지 이 옵션은 None과 동일합니다.
NodeImage	AKS는 매주 주기에 보안 수정 및 버그를 포함하는 새로 패치된 VHD로 노드를 업데이트합니다. VHD 업데이트 컴퓨터는 유지 관리 기간 및 서지 설정에 따라 해당 VHD에 다시 설치됩니다. AKS가 이미지를 호스트할 때 이 옵션을 선택할 때 추가 VHD 비용이 발생하지 않습니다.
SecurityPatch	AKS는 테스트된 보안 업데이트를 사용하여 노드를 다운로드하고 업데이트합니다. 이러한 업데이트는 유지 관리 기간 설정을 적용하고 새 노드에서 사용되는 새 VHD를 생성합니다. 경우에 따라 업데이트를 적용할 수 없는 경우도 있습니다. 이러한 경우 변경 내용을 적용하기 위해 기존 노드도 새로 생성된 VHD로 다시 이미지화됩니다. 이 옵션을 사용하면 리소스 그룹에서 새 보안 패치 VHD를 호스트하는 데 드는 추가 비용이 발생합니다.

NodeProvisioningDefaultNodePools

열거형

노드 프로비저닝을 위해 구성된 기본 Karpenter NodePool(CRD) 집합입니다. 이 필드는 모드가 '자동'이 아니면 효과가 없습니다. 경고: 기존 클러스터에서 이를 자동에서 없음으로 변경하면 기본 Karpenter NodePools가 삭제되어 해당 풀과 연결된 노드가 드레이닝되고 삭제됩니다. 해당 작업에 의해 축출된 파드를 사용할 준비가 된 유휴 노드가 없는 한 이 작업을 수행하지 않는 것이 좋습니다. 지정하지 않으면 기본값은 Auto입니다. 자세한 내용은 aka.ms/aks/nap#node-pools 참조하십시오.

값	Description
None	Karpenter NodePool은 자동으로 프로비저닝되지 않습니다. 사용자가 하나 이상의 NodePool CRD 인스턴스를 생성하지 않는 한 자동 확장이 발생하지 않습니다.
Auto	Karpenter NodePools의 표준 집합이 프로비저닝됩니다

NodeProvisioningMode

열거형

노드 프로비저닝 모드입니다. 지정하지 않으면 기본값은 수동입니다.

값	Description
Manual	노드는 사용자가 수동으로 프로비전합니다.
Auto	노드는 Karpenter를 사용하여 AKS에 의해 자동으로 프로비저닝됩니다(자세한 내용은 aka.ms/aks/nap 참조). 고정 크기 노드 풀은 여전히 만들 수 있지만 노드 풀 자동 크기 조정은 만들 수 없습니다. 자세한 내용은 aka.ms/aks/nap 참조하세요.

NvidiaGPUProfile

Object

NVIDIA 전용 GPU 설정

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

OSDiskType

열거형

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

값

Description

Managed

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

Ephemeral

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

OSSKU

열거형

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

값	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.
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 컨테이너를 실행할 수 없으며, 그 반대도 마찬가지입니다.
Ubuntu2404	노드 이미지의 OS로 Ubuntu2404를 사용하지만 Ubuntu 24.04는 모든 노드 풀에 대해 지원되지 않을 수 있습니다. 제한 사항 및 지원되는 kubernetes 버전은 다음을 참조하세요. https://aka.ms/aks/supported-ubuntu-versions
AzureContainerLinux	노드 이미지는 Azure Container Linux를 OS로 사용하세요. Azure Container Linux는 Azure Linux를 기반으로 구축된 컨테이너 최적화, 보안 중심의 리눅스 OS로, 변경 불가능한 파일 시스템을 갖추고 있습니다. ACL은 Flatcar Container Linux 프로젝트에서 파생되었으며, Flatcar의 검증된 컨테이너 우선, 불변 설계를 기반으로 하며, Azure Linux 패키지, 서비스, Azure 및 AKS 수명주기와의 심층 통합을 추가했습니다. 자세한 내용은 https://aka.ms/azurecontainerlinux를 참조하세요.

OSType

열거형

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

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

OutboundIPPrefixes

Object

관리되는 NAT 게이트웨이를 위한 원하는 아웃바운드 IP 프리픽스 리소스. NAT 게이트웨이 V2와만 호환됩니다.

속성	형식	Description
publicIPPrefixes	string[] (arm-id)	공용 IP 접두사 리소스 목록입니다.

OutboundIPs

Object

관리형 NAT 게이트웨이를 위한 원하는 아웃바운드 IP 자원.

속성	형식	Description
publicIPs	string[] (arm-id)	공용 IP 리소스 목록입니다.

OutboundType

열거형

아웃바운드(송신) 라우팅 메서드입니다. 클러스터를 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다. 자세한 내용은 egress outbound type을 참조하세요.

값	Description
loadBalancer	부하 분산 장치는 AKS 할당 공용 IP를 통해 송신하는 데 사용됩니다. 'loadBalancer' 형식의 Kubernetes 서비스를 지원합니다. 자세한 내용은 아웃바운드 형식 부하 분산 장치참조하세요.
userDefinedRouting	송신 경로는 사용자가 정의해야 합니다. 이 시나리오는 고급 시나리오이며 적절한 네트워크 구성이 필요합니다. 자세한 내용은 아웃바운드 형식 사용자DefinedRouting참조하세요.
managedNATGateway	AKS 관리 NAT 게이트웨이는 송신에 사용됩니다.
userAssignedNATGateway	클러스터 서브넷에 연결된 사용자 할당 NAT 게이트웨이가 송신에 사용됩니다. 이 시나리오는 고급 시나리오이며 적절한 네트워크 구성이 필요합니다.
none	AKS 클러스터는 아웃바운드 형식으로 설정되지 않습니다. 모든 AKS 노드는 Azure VM 기본 아웃바운드 동작을 따릅니다. https://azure.microsoft.com/en-us/updates/default-outbound-access-for-vms-in-azure-will-be-retired-transition-to-a-new-method-of-internet-access/ 를 참조하세요.

PodIPAllocationMode

열거형

파드 IP 할당 모드. 에이전트 풀의 Pod에 대한 IP 할당 모드입니다. podSubnetId와 함께 사용해야 합니다. 기본값은 'DynamicIndividual'입니다.

값

Description

DynamicIndividual

각 노드는 파드에 할당할 수 있는 인접하지 않은 IP 주소 목록과 함께 할당된다. 크기가 /16 이하인 중소 서브넷을 최대화하는 데 더 적합합니다. 고객이 podIPAllocationMode를 명시적으로 지정하지 않는 경우 동적 IP 할당이 있는 Azure CNI 클러스터는 기본적으로 이 모드로 설정됩니다.

StaticBlock

각 노드는 노드당 maxPod를 충족하기 위해 블록당 크기 /28 = 16 IP의 CIDR 블록을 정적으로 할당합니다. >=(maxPods/ 16)의 CIDR 블록 수입니다. 단일 IP가 아닌 블록은 Azure Vnet 개인 IP 제한인 65K에 대해 계산됩니다. 따라서 블록 모드는 클러스터에서 65K Pod의 현재 제한보다 많은 더 큰 워크로드를 실행하는 데 적합합니다. 이 모드는 /15 이상의 더 큰 서브넷으로 크기를 조정하는 데 더 적합합니다.

PortRange

Object

포트 범위입니다.

속성	형식	Description
portEnd	integer (int32) minimum: 1 maximum: 65535	범위에 포함된 최대 포트입니다. 범위는 1에서 65535까지여야 하며 portStart보다 크거나 같아야 합니다.
portStart	integer (int32) minimum: 1 maximum: 65535	범위에 포함된 최소 포트입니다. 범위는 1에서 65535까지이고 portEnd보다 작거나 같아야 합니다.
protocol	Protocol	포트의 네트워크 프로토콜입니다.

PowerState

Object

클러스터의 전원 상태를 설명합니다.

속성	형식	Description
code	Code	클러스터가 실행 중인지 또는 중지되었는지 여부를 알려줍니다.

PrivateLinkResource

Object

프라이빗 링크 리소스

속성	형식	Description
groupId	string	리소스의 그룹 ID입니다.
id	string	private link 리소스의 ID입니다.
name	string	프라이빗 링크 리소스의 이름입니다. 자세한 내용은 명명 규칙 을 참조하세요.
privateLinkServiceID	string (arm-id)	리소스의 프라이빗 링크 서비스 ID이며, 이 필드는 내부적으로 NRP에만 노출됩니다.
requiredMembers	string[]	리소스의 RequiredMembers
type	string	리소스 종류입니다.

Protocol

열거형

포트의 네트워크 프로토콜입니다.

값	Description
TCP	TCP 프로토콜입니다.
UDP	UDP 프로토콜입니다.

ProxyRedirectionMechanism

열거형

트래픽 리디렉션 모드입니다.

값	Description
InitContainers	Istio는 트래픽을 리디렉션하기 위해 각 Pod에 init 컨테이너를 삽입합니다(NET_ADMIN 및 NET_RAW 필요).
CNIChaining	Istio는 트래픽을 리디렉션하기 위해 연결된 CNI 플러그인을 설치합니다(권장).

PublicNetworkAccess

열거형

PublicNetworkAccess를 사용합니다. AKS의 공용 네트워크 access 허용 또는 거부

값	Description
Enabled	managedCluster에 대한 인바운드/아웃바운드가 허용됩니다.
Disabled	managedCluster에 대한 인바운드 트래픽이 비활성화되고 managedCluster의 트래픽이 허용됩니다.

ResourceIdentityType

열거형

관리되는 클러스터에 사용되는 ID 유형입니다. 자세한 내용은 AKS의 use 관리 식별을 참조하세요.

값	Description
SystemAssigned	암시적으로 생성된 시스템 할당 관리 ID를 사용하여 클러스터 리소스를 관리합니다. 제어 플레인의 마스터 컴포넌트인 kube-controller-manager는 시스템 할당된 관리 신원을 사용하여 Azure 자원을 조작합니다.
UserAssigned	사용자 지정 ID를 사용하여 클러스터 리소스를 관리합니다. 제어 플레인의 마스터 컴포넌트인 kube-controller-manager는 지정된 사용자 지정 관리 신원을 사용하여 Azure 자원을 조작합니다.
None	관리되는 클러스터에 관리 ID를 사용하지 말고 서비스 주체가 대신 사용됩니다.

ResourceReference

Object

Azure 리소스에 대한 참조입니다.

속성	형식	Description
id	string (arm-id)	완전 자격화된 Azure 리소스 ID.

RestrictionLevel

열거형

클러스터의 노드 리소스 그룹에 적용되는 제한 수준입니다. 지정하지 않으면 기본값은 'Unrestricted'입니다.

값	Description
Unrestricted	모든 RBAC 권한은 관리되는 노드 리소스 그룹에 허용됩니다.
ReadOnly	관리되는 노드 리소스 그룹에 대해 */읽기 RBAC 권한만 허용됨

ScaleDownMode

열거형

VM을 에이전트 풀에 추가하거나 에이전트 풀에서 제거하는 방법에 대해 설명합니다. 청구 상태를 참조하세요.

값	Description
Delete	스케일 업 중에 새 인스턴스를 만들고 스케일 다운 중에 인스턴스를 제거합니다.
Deallocate	스케일 업 중에 할당 취소된 인스턴스(있는 경우)를 시작하고 스케일 다운 중에 인스턴스의 할당을 취소하려고 시도합니다.

ScaleProfile

Object

VirtualMachines 에이전트 풀의 크기를 조정하는 방법에 대한 사양입니다.

속성	형식	Description
autoscale	AutoScaleProfile[]	미리 정의된 크기 범위 내에서 VirtualMachines 에이전트 풀의 크기를 자동으로 조정하는 방법에 대한 사양입니다. 각 프로필은 특정 VM SKU를 대상으로 하며 독립적으로 평가됩니다. 프로필 간 확장 결정은 클러스터 자동 스케일러 확장기로 제어되며, `ManagedCluster.properties.autoScalerProfile.expander`.
manual	ManualScaleProfile[]	VirtualMachines 에이전트 풀을 고정 크기로 확장하는 방법에 대한 사양입니다.

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이 사용됩니다.

SchedulerConfigMode

열거형

이 스케줄러 인스턴스에 대한 구성 사용자 지정 모드입니다.

값	Description
Default	구성 사용자 정의가 없습니다. 기본 구성을 사용합니다.
ManagedByCRD	구성 사용자 지정을 활성화합니다. 고객은 CRD를 통해 스케줄러 구성을 지정할 수 있습니다. 자세한 내용은 aka.ms/aks/scheduler-crd 참조하십시오.

SchedulerInstanceProfile

Object

AKS가 관리하는 스케줄러 특정 인스턴스와 관련된 설정이 포함된 프로필.

속성	형식	Description
schedulerConfigMode	SchedulerConfigMode	AKS가 관리하는 스케줄러가 사용하는 구성 모드입니다.

SchedulerProfile

Object

AKS가 관리하는 각 스케줄러 설정 모드 같은 스케줄러 관련 설정이 포함된 프로필. https://aka.ms/aks/scheduler-profile을(를) 참조하세요.

속성	형식	Description
upstream	SchedulerInstanceProfile	kube-scheduler 상류 변형과 관련된 설정이 포함된 프로필(https://github.com/kubernetes/kubernetes/tree/master/pkg/scheduler.

ServiceMeshMode

열거형

서비스 메시의 모드입니다.

값	Description
Istio	AKS 추가 기능으로 배포된 Istio입니다.
Disabled	메시를 사용할 수 없습니다.

ServiceMeshProfile

Object

관리되는 클러스터에 대한 서비스 메시 프로필입니다.

속성	형식	Description
istio	IstioServiceMesh	Istio 서비스 메시 구성.
mode	ServiceMeshMode	서비스 메시의 모드입니다.

SysctlConfig

Object

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

속성	형식	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

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

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

TransitEncryptionType

열거형

Pod 간 암호화를 구성합니다. 이는 Cilium 기반 클러스터에서만 사용하도록 설정할 수 있습니다. 지정하지 않으면 기본값은 None입니다.

값	Description
WireGuard	WireGuard 암호화를 활성화합니다. https://docs.cilium.io/en/latest/security/network/encryption-wireguard/ 사용 사례 및 구현 세부 정보를 참조하십시오.
None	전송 데이터 암호화 비활성화

UndrainableNodeBehavior

열거형

업그레이드하는 동안 표시할 수 없는 노드에 대한 동작을 정의합니다. 그리기 불가능한 노드의 가장 일반적인 원인은 Pod 중단 예산(PDB)이지만, Pod 종료 유예 기간과 같은 다른 문제는 노드당 남은 드레이닝 시간 제한을 초과하거나 Pod가 여전히 실행 중인 상태일 수도 있습니다.

값

Description

Cordon

AKS는 차단된 노드를 코돈하고 업그레이드하는 동안 서지 노드로 바꿉니다. 차단된 노드는 코드되고 서지 노드로 대체됩니다. 차단된 노드에는 'kubernetes.azure.com/upgrade-status:Quarantined' 레이블이 있습니다. 서지 노드는 차단된 각 노드에 대해 유지됩니다. 다른 모든 서지 노드를 삭제하기 위해 최선의 노력을 기울입니다. 차단된 노드를 대체할 수 있는 서지 노드가 충분한 경우 업그레이드 작업 및 관리되는 클러스터가 실패 상태입니다. 그렇지 않으면 업그레이드 작업 및 관리되는 클러스터가 취소된 상태가 됩니다.

Schedule

AKS는 차단된 노드를 예약 가능으로 표시하지만 차단된 노드는 업그레이드되지 않습니다. 모든 서지 노드를 삭제하기 위해 최선을 다합니다. 차단된 노드가 있는 경우 업그레이드 작업 및 관리되는 클러스터가 실패 상태입니다.

UpgradeChannel

열거형

자동 업그레이드를 위한 업그레이드 채널입니다. 기본값은 'none'입니다. 자세한 내용은 AKS 클러스터 자동 업그레이드 채널 설정을 참조하세요.

값	Description
rapid	지원되는 최신 부 버전에서 클러스터를 지원되는 최신 패치 릴리스로 자동으로 업그레이드합니다. 클러스터가 N-2 부 버전에서 N이 지원되는 최신 부 버전인 Kubernetes 버전인 경우 클러스터는 먼저 N-1 부 버전에서 지원되는 최신 패치 버전으로 업그레이드합니다. 예를 들어 클러스터가 버전 1.17.7 및 버전 1.17.9, 1.18.4, 1.18.6 및 1.19.1을 실행하는 경우 클러스터는 먼저 1.18.6으로 업그레이드된 다음 1.19.1로 업그레이드됩니다.
stable	클러스터를 부 버전 N-1에서 지원되는 최신 패치 릴리스로 자동으로 업그레이드합니다. 여기서 N은 지원되는 최신 부 버전입니다. 예를 들어 클러스터가 버전 1.17.7 및 버전 1.17.9, 1.18.4, 1.18.6 및 1.19.1을 실행하는 경우 클러스터는 1.18.6으로 업그레이드됩니다.
patch	부 버전을 동일하게 유지하면서 클러스터를 사용할 수 있게 되면 클러스터를 지원되는 최신 패치 버전으로 자동으로 업그레이드합니다. 예를 들어 클러스터가 버전 1.17.7 및 버전 1.17.9, 1.18.4, 1.18.6 및 1.19.1을 실행하는 경우 클러스터는 1.17.9로 업그레이드됩니다.
node-image	노드 이미지를 사용 가능한 최신 버전으로 자동으로 업그레이드합니다. 대신 Kubernetes 버전 패치와 별도로 노드 OS 패치를 구성할 수 있으므로 nodeOSUpgradeChannel을 사용하는 것이 좋습니다.
none	자동 업그레이드를 사용하지 않도록 설정하고 클러스터를 현재 버전의 Kubernetes에 유지합니다.

UpgradeOverrideSettings

Object

클러스터를 업그레이드할 때 재정의에 대한 설정입니다.

속성	형식	Description
forceUpgrade	boolean	클러스터를 강제로 업그레이드할지 여부입니다. 이 옵션은 사용되지 않는 API 사용량 확인과 같은 업그레이드 보호를 무시하도록 업그레이드 작업에 지시합니다. 주의해서만 이 옵션을 사용하도록 설정합니다.
until	string (date-time)	재정의가 유효할 때까지. 이는 업그레이드 시작 시간과만 일치하며 업그레이드가 진행됨에 따라 만료되더라도 `until` 업그레이드가 시작되면 효과가 변경되지 않습니다. 이 필드는 기본적으로 설정되지 않습니다. 재정의가 적용되려면 반드시 설정해야 합니다.

UserAssignedIdentity

Object

사용자 할당 ID에 대한 세부 정보입니다.

속성	형식	Description
clientId	string	사용자 할당 ID의 클라이언트 ID입니다.
objectId	string	사용자 할당 ID의 개체 ID입니다.
resourceId	string (arm-id)	사용자 할당 ID의 리소스 ID입니다.

VirtualMachineNodes

Object

동일한 vm 크기의 노드 그룹에 대한 현재 상태입니다.

속성	형식	Description
count	integer (int32)	노드 수입니다.
size	string	이 노드 그룹을 호스트하는 데 사용되는 에이전트의 VM 크기입니다.

VirtualMachinesProfile

Object

VirtualMachines 에이전트 풀의 사양입니다.

속성	형식	Description
scale	ScaleProfile	VirtualMachines 에이전트 풀의 크기를 조정하는 방법에 대한 사양입니다.

WindowsGmsaProfile

Object

관리되는 클러스터의 Windows gMSA 프로필입니다.

속성	형식	Description
dnsServer	string	Windows gMSA에 대한 DNS 서버를 지정합니다. 관리형 클러스터를 만드는 데 사용되는 vnet에서 DNS 서버를 구성한 경우 빈 상태로 설정합니다.
enabled	boolean	Windows gMSA를 사용하도록 설정할지 여부입니다. 관리되는 클러스터에서 Windows gMSA를 사용하도록 설정할지 여부를 지정합니다.
rootDomainName	string	Windows gMSA의 루트 도메인 이름을 지정합니다. 관리형 클러스터를 만드는 데 사용되는 vnet에서 DNS 서버를 구성한 경우 빈 상태로 설정합니다.

WorkloadRuntime

열거형

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

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