Microsoft.ContainerService managedClusters 2024-01-02-preview

  • [アーティクル]

Bicep リソース定義

managedClusters リソースの種類は、次をターゲットとする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

注釈

使用可能なアドオンの詳細については、「アドオン、拡張機能、およびその他のAzure Kubernetes Serviceとの統合」を参照してください。

リソース形式

Microsoft.ContainerService/managedClusters リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.ContainerService/managedClusters@2024-01-02-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'Base'
    tier: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  identity: {
    delegatedResources: {
      {customized property}: {
        location: 'string'
        referralResource: 'string'
        resourceId: 'string'
        tenantId: 'string'
      }
    }
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    aadProfile: {
      adminGroupObjectIDs: [
        'string'
      ]
      clientAppID: 'string'
      enableAzureRBAC: bool
      managed: bool
      serverAppID: 'string'
      serverAppSecret: 'string'
      tenantID: 'string'
    }
    addonProfiles: {
      {customized property}: {
        config: {
          {customized property}: 'string'
        }
        enabled: bool
      }
    }
    agentPoolProfiles: [
      {
        artifactStreamingProfile: {
          enabled: bool
        }
        availabilityZones: [
          'string'
        ]
        capacityReservationGroupID: 'string'
        count: int
        creationData: {
          sourceResourceId: 'string'
        }
        enableAutoScaling: bool
        enableCustomCATrust: bool
        enableEncryptionAtHost: bool
        enableFIPS: bool
        enableNodePublicIP: bool
        enableUltraSSD: bool
        gpuInstanceProfile: 'string'
        gpuProfile: {
          installGPUDriver: bool
        }
        hostGroupID: 'string'
        kubeletConfig: {
          allowedUnsafeSysctls: [
            'string'
          ]
          containerLogMaxFiles: int
          containerLogMaxSizeMB: int
          cpuCfsQuota: bool
          cpuCfsQuotaPeriod: 'string'
          cpuManagerPolicy: 'string'
          failSwapOn: bool
          imageGcHighThreshold: int
          imageGcLowThreshold: int
          podMaxPids: int
          topologyManagerPolicy: 'string'
        }
        kubeletDiskType: 'string'
        linuxOSConfig: {
          swapFileSizeMB: int
          sysctls: {
            fsAioMaxNr: int
            fsFileMax: int
            fsInotifyMaxUserWatches: int
            fsNrOpen: int
            kernelThreadsMax: int
            netCoreNetdevMaxBacklog: int
            netCoreOptmemMax: int
            netCoreRmemDefault: int
            netCoreRmemMax: int
            netCoreSomaxconn: int
            netCoreWmemDefault: int
            netCoreWmemMax: int
            netIpv4IpLocalPortRange: 'string'
            netIpv4NeighDefaultGcThresh1: int
            netIpv4NeighDefaultGcThresh2: int
            netIpv4NeighDefaultGcThresh3: int
            netIpv4TcpFinTimeout: int
            netIpv4TcpkeepaliveIntvl: int
            netIpv4TcpKeepaliveProbes: int
            netIpv4TcpKeepaliveTime: int
            netIpv4TcpMaxSynBacklog: int
            netIpv4TcpMaxTwBuckets: int
            netIpv4TcpTwReuse: bool
            netNetfilterNfConntrackBuckets: int
            netNetfilterNfConntrackMax: int
            vmMaxMapCount: int
            vmSwappiness: int
            vmVfsCachePressure: int
          }
          transparentHugePageDefrag: 'string'
          transparentHugePageEnabled: 'string'
        }
        maxCount: int
        maxPods: int
        messageOfTheDay: 'string'
        minCount: int
        mode: 'string'
        name: 'string'
        networkProfile: {
          allowedHostPorts: [
            {
              portEnd: int
              portStart: int
              protocol: 'string'
            }
          ]
          applicationSecurityGroups: [
            'string'
          ]
          nodePublicIPTags: [
            {
              ipTagType: 'string'
              tag: 'string'
            }
          ]
        }
        nodeInitializationTaints: [
          'string'
        ]
        nodeLabels: {
          {customized property}: 'string'
        }
        nodePublicIPPrefixID: 'string'
        nodeTaints: [
          'string'
        ]
        orchestratorVersion: 'string'
        osDiskSizeGB: int
        osDiskType: 'string'
        osSKU: 'string'
        osType: 'string'
        podIPAllocationMode: 'string'
        podSubnetID: 'string'
        powerState: {
          code: 'string'
        }
        proximityPlacementGroupID: 'string'
        scaleDownMode: 'string'
        scaleSetEvictionPolicy: 'string'
        scaleSetPriority: 'string'
        securityProfile: {
          enableSecureBoot: bool
          enableVTPM: bool
          sshAccess: 'string'
        }
        spotMaxPrice: json('decimal-as-string')
        tags: {}
        type: 'string'
        upgradeSettings: {
          drainTimeoutInMinutes: int
          maxSurge: 'string'
          nodeSoakDurationInMinutes: int
        }
        virtualMachineNodesStatus: [
          {
            count: int
            size: 'string'
          }
        ]
        virtualMachinesProfile: {
          scale: {
            manual: [
              {
                count: int
                sizes: [
                  'string'
                ]
              }
            ]
          }
        }
        vmSize: 'string'
        vnetSubnetID: 'string'
        windowsProfile: {
          disableOutboundNat: bool
        }
        workloadRuntime: 'string'
      }
    ]
    aiToolchainOperatorProfile: {
      enabled: bool
    }
    apiServerAccessProfile: {
      authorizedIPRanges: [
        'string'
      ]
      disableRunCommand: bool
      enablePrivateCluster: bool
      enablePrivateClusterPublicFQDN: bool
      enableVnetIntegration: bool
      privateDNSZone: 'string'
      subnetId: 'string'
    }
    autoScalerProfile: {
      'balance-similar-node-groups': 'string'
      'daemonset-eviction-for-empty-nodes': bool
      'daemonset-eviction-for-occupied-nodes': bool
      expander: 'string'
      'ignore-daemonsets-utilization': bool
      'max-empty-bulk-delete': 'string'
      'max-graceful-termination-sec': 'string'
      'max-node-provision-time': 'string'
      'max-total-unready-percentage': 'string'
      'new-pod-scale-up-delay': 'string'
      'ok-total-unready-count': 'string'
      'scale-down-delay-after-add': 'string'
      'scale-down-delay-after-delete': 'string'
      'scale-down-delay-after-failure': 'string'
      'scale-down-unneeded-time': 'string'
      'scale-down-unready-time': 'string'
      'scale-down-utilization-threshold': 'string'
      'scan-interval': 'string'
      'skip-nodes-with-local-storage': 'string'
      'skip-nodes-with-system-pods': 'string'
    }
    autoUpgradeProfile: {
      nodeOSUpgradeChannel: 'string'
      upgradeChannel: 'string'
    }
    azureMonitorProfile: {
      logs: {
        appMonitoring: {
          enabled: bool
        }
        containerInsights: {
          enabled: bool
          logAnalyticsWorkspaceResourceId: 'string'
          windowsHostLogs: {
            enabled: bool
          }
        }
      }
      metrics: {
        appMonitoringOpenTelemetryMetrics: {
          enabled: bool
        }
        enabled: bool
        kubeStateMetrics: {
          metricAnnotationsAllowList: 'string'
          metricLabelsAllowlist: 'string'
        }
      }
    }
    bootstrapProfile: {
      artifactSource: 'string'
      containerRegistryId: 'string'
    }
    creationData: {
      sourceResourceId: 'string'
    }
    disableLocalAccounts: bool
    diskEncryptionSetID: 'string'
    dnsPrefix: 'string'
    enableNamespaceResources: bool
    enablePodSecurityPolicy: bool
    enableRBAC: bool
    fqdnSubdomain: 'string'
    httpProxyConfig: {
      httpProxy: 'string'
      httpsProxy: 'string'
      noProxy: [
        'string'
      ]
      trustedCa: 'string'
    }
    identityProfile: {
      {customized property}: {
        clientId: 'string'
        objectId: 'string'
        resourceId: 'string'
      }
    }
    ingressProfile: {
      webAppRouting: {
        dnsZoneResourceIds: [
          'string'
        ]
        enabled: bool
      }
    }
    kubernetesVersion: 'string'
    linuxProfile: {
      adminUsername: 'string'
      ssh: {
        publicKeys: [
          {
            keyData: 'string'
          }
        ]
      }
    }
    metricsProfile: {
      costAnalysis: {
        enabled: bool
      }
    }
    networkProfile: {
      dnsServiceIP: 'string'
      ipFamilies: [
        'string'
      ]
      kubeProxyConfig: {
        enabled: bool
        ipvsConfig: {
          scheduler: 'string'
          tcpFinTimeoutSeconds: int
          tcpTimeoutSeconds: int
          udpTimeoutSeconds: int
        }
        mode: 'string'
      }
      loadBalancerProfile: {
        allocatedOutboundPorts: int
        backendPoolType: 'string'
        effectiveOutboundIPs: [
          {
            id: 'string'
          }
        ]
        enableMultipleStandardLoadBalancers: bool
        idleTimeoutInMinutes: int
        managedOutboundIPs: {
          count: int
          countIPv6: int
        }
        outboundIPPrefixes: {
          publicIPPrefixes: [
            {
              id: 'string'
            }
          ]
        }
        outboundIPs: {
          publicIPs: [
            {
              id: 'string'
            }
          ]
        }
      }
      loadBalancerSku: 'string'
      monitoring: {
        enabled: bool
      }
      natGatewayProfile: {
        effectiveOutboundIPs: [
          {
            id: 'string'
          }
        ]
        idleTimeoutInMinutes: int
        managedOutboundIPProfile: {
          count: int
        }
      }
      networkDataplane: 'string'
      networkMode: 'string'
      networkPlugin: 'string'
      networkPluginMode: 'overlay'
      networkPolicy: 'string'
      outboundType: 'string'
      podCidr: 'string'
      podCidrs: [
        'string'
      ]
      serviceCidr: 'string'
      serviceCidrs: [
        'string'
      ]
    }
    nodeProvisioningProfile: {
      mode: 'string'
    }
    nodeResourceGroup: 'string'
    nodeResourceGroupProfile: {
      restrictionLevel: 'string'
    }
    oidcIssuerProfile: {
      enabled: bool
    }
    podIdentityProfile: {
      allowNetworkPluginKubenet: bool
      enabled: bool
      userAssignedIdentities: [
        {
          bindingSelector: 'string'
          identity: {
            clientId: 'string'
            objectId: 'string'
            resourceId: 'string'
          }
          name: 'string'
          namespace: 'string'
        }
      ]
      userAssignedIdentityExceptions: [
        {
          name: 'string'
          namespace: 'string'
          podLabels: {
            {customized property}: 'string'
          }
        }
      ]
    }
    privateLinkResources: [
      {
        groupId: 'string'
        id: 'string'
        name: 'string'
        requiredMembers: [
          'string'
        ]
        type: 'string'
      }
    ]
    publicNetworkAccess: 'string'
    safeguardsProfile: {
      excludedNamespaces: [
        'string'
      ]
      level: 'string'
      version: 'string'
    }
    securityProfile: {
      azureKeyVaultKms: {
        enabled: bool
        keyId: 'string'
        keyVaultNetworkAccess: 'string'
        keyVaultResourceId: 'string'
      }
      customCATrustCertificates: [
        any
      ]
      defender: {
        logAnalyticsWorkspaceResourceId: 'string'
        securityMonitoring: {
          enabled: bool
        }
      }
      imageCleaner: {
        enabled: bool
        intervalHours: int
      }
      imageIntegrity: {
        enabled: bool
      }
      nodeRestriction: {
        enabled: bool
      }
      workloadIdentity: {
        enabled: bool
      }
    }
    serviceMeshProfile: {
      istio: {
        certificateAuthority: {
          plugin: {
            certChainObjectName: 'string'
            certObjectName: 'string'
            keyObjectName: 'string'
            keyVaultId: 'string'
            rootCertObjectName: 'string'
          }
        }
        components: {
          egressGateways: [
            {
              enabled: bool
              nodeSelector: {
                {customized property}: 'string'
              }
            }
          ]
          ingressGateways: [
            {
              enabled: bool
              mode: 'string'
            }
          ]
        }
        revisions: [
          'string'
        ]
      }
      mode: 'string'
    }
    servicePrincipalProfile: {
      clientId: 'string'
      secret: 'string'
    }
    storageProfile: {
      blobCSIDriver: {
        enabled: bool
      }
      diskCSIDriver: {
        enabled: bool
        version: 'string'
      }
      fileCSIDriver: {
        enabled: bool
      }
      snapshotController: {
        enabled: bool
      }
    }
    supportPlan: 'string'
    upgradeSettings: {
      overrideSettings: {
        forceUpgrade: bool
        until: 'string'
      }
    }
    windowsProfile: {
      adminPassword: 'string'
      adminUsername: 'string'
      enableCSIProxy: bool
      gmsaProfile: {
        dnsServer: 'string'
        enabled: bool
        rootDomainName: 'string'
      }
      licenseType: 'string'
    }
    workloadAutoScalerProfile: {
      keda: {
        enabled: bool
      }
      verticalPodAutoscaler: {
        addonAutoscaling: 'string'
        enabled: bool
      }
    }
  }
}

プロパティ値

managedClusters

名前 説明 値
name リソース名 string (必須)

文字制限: 1 から 63

有効な文字:
英数字、アンダースコア、およびハイフン。

先頭と末尾には英数字を使用します。
location リソースが保存されている地理的な場所 string (必須)
tags リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku マネージド クラスター SKU。 ManagedClusterSKU
extendedLocation 仮想マシンの拡張された場所。 ExtendedLocation
identity マネージド クラスターの ID (構成されている場合)。 ManagedClusterIdentity
properties マネージド クラスターのプロパティ。 ManagedClusterProperties

ExtendedLocation

名前 説明 値
name 拡張場所の名前。 string
type 拡張された場所の型。 'EdgeZone'

ManagedClusterIdentity

名前 説明 値
delegatedResources このマネージド クラスターに割り当てられている委任された ID リソース。 これは、別の Azure リソース プロバイダーでのみ設定でき、マネージド クラスターは 1 つの委任された ID リソースのみを受け入れます。 内部使用のみです。 DelegatedResources
型 詳細については、「 AKS でのマネージド ID の使用」を参照してください。 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID である必要があります。 ManagedClusterIdentityUserAssignedIdentities

DelegatedResources

名前 説明 値
{カスタマイズされたプロパティ} DelegatedResource

DelegatedResource

名前 説明 [値]
location ソース リソースの場所 - 内部使用のみ。 string
referralResource 紹介委任の委任 ID (省略可能) - 内部使用のみ。 string
resourceId 委任されたリソースの ARM リソース ID -内部使用のみ。 string
tenantId 委任されたリソースのテナント ID - 内部使用のみ。 string

制約:
最小長 = 36
最大長 = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedClusterIdentityUserAssignedIdentities

名前 説明 値
{カスタマイズされたプロパティ} ManagedServiceIdentityUserAssignedIdentitiesValue

ManagedServiceIdentityUserAssignedIdentitiesValue

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

ManagedClusterProperties

名前 説明 値
aadProfile Azure Active Directory の構成。 ManagedClusterAADProfile
addonProfiles マネージド クラスター アドオンのプロファイル。 ManagedClusterPropertiesAddonProfiles
agentPoolProfiles エージェント プールのプロパティ。 ManagedClusterAgentPoolProfile[]
aiToolchainOperatorProfile クラスター全体に適用される AI ツールチェーン演算子の設定。 ManagedClusterAIToolchainOperatorProfile
apiServerAccessProfile マネージド クラスター API サーバーのアクセス プロファイル。 ManagedClusterAPIServerAccessProfile
autoScalerProfile 有効になっている場合にクラスター オートスケーラーに適用されるパラメーター ManagedClusterPropertiesAutoScalerProfile
autoUpgradeProfile 自動アップグレード構成。 ManagedClusterAutoUpgradeProfile
azureMonitorProfile コンテナー サービス クラスターの Prometheus アドオン プロファイル ManagedClusterAzureMonitorProfile
bootstrapProfile クラスターブートストラップ構成のプロファイル。 ManagedClusterBootstrapProfile
creationData スナップショットを使用してクラスターを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 CreationData
disableLocalAccounts true に設定すると、このクラスターで静的資格情報の取得が無効になります。 これは、AAD が有効になっているマネージド クラスターでのみ使用する必要があります。 詳細については、「 ローカル アカウントを無効にする」を参照してください。 [bool]
diskEncryptionSetID これは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' の形式です。 string
dnsPrefix これは、マネージド クラスターが作成された後は更新できません。 string
enableNamespaceResources 既定値は false です。 マネージド クラスターの作成と更新時に有効または無効にすることができます。 ARM リソースとしての名前空間の詳細については、「」を参照してください https://aka.ms/NamespaceARMResource 。 [bool]
enablePodSecurityPolicy (非推奨)Kubernetes ポッドのセキュリティ ポリシー (プレビュー) を有効にするかどうか。 PodSecurityPolicy は Kubernetes v1.21 で非推奨となり、v1.25 の Kubernetes から削除されました。 詳細については、 と を参照 https://aka.ms/k8s/psp してください。 https://aka.ms/aks/psp. [bool]
enableRBAC Kubernetes Role-Based Access Control を有効にするかどうか。 [bool]
fqdnSubdomain これは、マネージド クラスターが作成された後は更新できません。 string
httpProxyConfig HTTP プロキシ サーバーを使用してクラスターをプロビジョニングするための構成。 ManagedClusterHttpProxyConfig
identityProfile クラスターに関連付けられている ID。 ManagedClusterPropertiesIdentityProfile
ingressProfile マネージド クラスターのイングレス プロファイル。 ManagedClusterIngressProfile
kubernetesVersion サポートされている AKS クラスターをアップグレードする際に、Kubernetes マイナー バージョンをスキップすることはできません。 すべてのアップグレードは、メジャー バージョン番号で順番に実行する必要があります。 たとえば、1.14.x から> 1.15.x または 1.15.x -> 1.16.x の間のアップグレードは許可されますが、1.14.x -> 1.16.x は許可されません。 詳細については 、AKS クラスターのアップグレード に関するページを参照してください。 string
linuxProfile マネージド クラスター内の Linux VM のプロファイル。 ContainerServiceLinuxProfile
metricsProfile オプションのクラスター メトリック構成。 ManagedClusterMetricsProfile
networkProfile ネットワーク構成プロファイル。 ContainerServiceNetworkProfile
nodeProvisioningProfile クラスター全体に適用されるノード プロビジョニング設定。 ManagedClusterNodeProvisioningProfile
nodeResourceGroup エージェント プール ノードを含むリソース グループの名前。 string
nodeResourceGroupProfile ノード リソース グループ構成プロファイル。 ManagedClusterNodeResourceGroupProfile
oidcIssuerProfile マネージド クラスターの OIDC 発行者プロファイル。 ManagedClusterOidcIssuerProfile
podIdentityProfile AAD ポッド ID の統合の詳細については、「AAD ポッド ID の使用」を参照してください。 ManagedClusterPodIdentityProfile
privateLinkResources クラスターに関連付けられているプライベート リンク リソース。 PrivateLinkResource[]
publicNetworkAccess AKS のパブリック ネットワーク アクセスを許可または拒否する 'Disabled'
'Enabled'
'SecuredByPerimeter'
safeguardsProfile セーフガード プロファイルには、特定のクラスターのすべてのセーフガード情報が保持されます SafeguardsProfile
securityProfile マネージド クラスターのセキュリティ プロファイル。 ManagedClusterSecurityProfile
serviceMeshProfile マネージド クラスターのサービス メッシュ プロファイル。 ServiceMeshProfile
servicePrincipalProfile Azure API の操作に使用するクラスターのサービス プリンシパル ID に関する情報。 ManagedClusterServicePrincipalProfile
storageProfile マネージド クラスターのストレージ プロファイル。 ManagedClusterStorageProfile
supportPlan マネージド クラスターのサポート プラン。 指定しない場合、既定値は 'KubernetesOfficial' です。 'AKSLongTermSupport'
'KubernetesOfficial'
upgradeSettings クラスターをアップグレードするための設定。 ClusterUpgradeSettings
windowsProfile マネージド クラスター内の Windows VM のプロファイル。 ManagedClusterWindowsProfile
workloadAutoScalerProfile マネージド クラスターのワークロード自動スケーラー プロファイル。 ManagedClusterWorkloadAutoScalerProfile

ManagedClusterAADProfile

名前 説明 値
adminGroupObjectIDs クラスターの管理者ロールを持つ AAD グループ オブジェクト ID の一覧。 string[]
clientAppID (非推奨)クライアント AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
enableAzureRBAC Kubernetes 承認に対して Azure RBAC を有効にするかどうか。 [bool]
キー管理 マネージド AAD を有効にするかどうか。 [bool]
serverAppID (非推奨)サーバー AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
serverAppSecret (非推奨)サーバー AAD アプリケーション シークレット。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
tenantID 認証に使用する AAD テナント ID。 指定しない場合、 はデプロイ サブスクリプションのテナントを使用します。 string

ManagedClusterPropertiesAddonProfiles

名前 説明 値
{カスタマイズされたプロパティ} ManagedClusterAddonProfile

ManagedClusterAddonProfile

名前 説明 値
config アドオンを構成するためのキーと値のペア。 ManagedClusterAddonProfileConfig
enabled アドオンが有効かどうか。 bool (必須)

ManagedClusterAddonProfileConfig

名前 説明 値
{カスタマイズされたプロパティ} string

ManagedClusterAgentPoolProfile

名前 説明 値
artifactStreamingProfile AKS で成果物ストリーミングを使用するための構成。 AgentPoolArtifactStreamingProfile
availabilityZones ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。 string[]
capacityReservationGroupID AKS は、指定されたエージェント プールを容量予約グループに関連付けます。 string
count Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。 INT
creationData スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 CreationData
enableAutoScaling 自動スケーラーを有効にするかどうか [bool]
enableCustomCATrust true に設定すると、AKS は機能が有効になっていることを示すラベルをノードに追加し、ホスト サービスと共にデーモンセットをデプロイして、ユーザーが指定した base64 でエンコードされた証明書の一覧からノード信頼ストアにカスタム証明機関を同期します。 既定値は false です。 [bool]
enableEncryptionAtHost これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「/azure/aks/enable-host-encryption」を参照してください。 [bool]
enableFIPS 詳細については、「 FIPS 対応ノード プールの追加 」を参照してください。 [bool]
enableNodePublicIP シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオとしては、ゲームのワークロードがあります。この場合、ホップを最小限に抑えるために、コンソールをクラウド仮想マシンに直接接続する必要があります。 詳細については、「 ノードごとにパブリック IP を割り当てる」を参照してください。 既定値は false です。 [bool]
enableUltraSSD UltraSSD を有効にするかどうか [bool]
gpuInstanceProfile サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用する GPUInstanceProfile。 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
gpuProfile エージェント プールの GPU 設定。 AgentPoolGPUProfile
hostGroupID これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName} の形式です。 詳細については、「 Azure 専用ホスト」を参照してください。 string
kubeletConfig エージェント プール ノードの Kubelet 構成。 KubeletConfig
kubeletDiskType emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。 'OS'
'一時'
linuxOSConfig Linux エージェント ノードの OS 構成。 LinuxOSConfig
maxCount 自動スケーリングのノードの最大数 INT
maxPods ノードで実行できるポッドの最大数。 INT
messageOfTheDay デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードのその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。 string
minCount 自動スケーリング用のノードの最小数 INT
mode クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、「/azure/aks/use-system-pools」を参照してください。 'System'
'User'
name Windows エージェント プール名は 6 文字以下にする必要があります。 string (必須)

制約:
Pattern = ^[a-z][a-z0-9]{0,11}$
networkProfile エージェント プールのネットワーク関連の設定。 AgentPoolNetworkProfile
nodeInitializationTaints これらのテイントは AKS によって調整されず、kubectl 呼び出しで削除できます。 このフィールドはノード プールの作成後に変更できますが、再作成を必要とする別の操作 (ノード イメージのアップグレードなど) が発生するまで、ノードは新しいテイントで再作成されません。 これらのテイントを使用すると、ノードがワークロードを受け入れる準備が整う前に必要な構成を実行できます(例: 'key1=value1:NoSchedule' を使用して削除できます) kubectl taint nodes node1 key1=value1:NoSchedule- string[]
nodeLabels エージェント プール内のすべてのノードにわたって永続化されるノード ラベル。 ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。 string
nodeTaints ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。 string[]
orchestratorVersion パッチ バージョン {major.minor.patch} と {major.minor} の両方がサポートされています。 {major.minor} を指定すると、サポートされている最新のパッチ バージョンが自動的に選択されます。 エージェント プールを作成後に同じ {major.minor} で更新しても、新しいパッチ バージョンが使用可能な場合でも、アップグレードはトリガーされません。 AKS クラスター内のノード プールは、すべて同じ Kubernetes のバージョンにアップグレードするのがベスト プラクティスです。 ノード プールのバージョンは、コントロール プレーンと同じメジャー バージョンである必要があります。 ノード プールの "マイナー" バージョンは、コントロール プレーンのバージョンの 2 つ以内の "マイナー" バージョンでなければなりません。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳細については、 ノード プールのアップグレードに関するページを参照してください。 string
osDiskSizeGB マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。 INT

制約:
最小値 = 0
最大値 = 2048
osDiskType VM でサポートされ、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後は変更できない場合があります。 詳細については、「 エフェメラル OS」を参照してください。 'エフェメラル'
'Managed'
osSKU エージェント プールで使用される OS SKU を指定します。 指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。 また、Windows 2019 が非推奨になった後、既定の Windows OSSKU は Windows2022 に変更されます。 'AzureLinux'
'CBLMariner'
'Mariner'
'Ubuntu'
'Windows2019'
'Windows2022'
'WindowsAnnual'
osType オペレーティング システムの種類。 既定値は Linux です。 'Linux'
'Windows'
podIPAllocationMode エージェント プール内のポッドの IP 割り当てモード。 podSubnetId と共に使用する必要があります。 既定値は "DynamicIndividual" です。 'DynamicIndividual'
'StaticBlock'
podSubnetID 省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、「vnetSubnetID」を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 string
powerState エージェント プールが最初に作成されたとき、最初は実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールを停止できるのは、エージェント プールが実行中で、プロビジョニング状態が [成功] の場合のみです PowerState
proximityPlacementGroupID 近接配置グループの ID。 string
scaleDownMode これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合、既定では Delete になります。 '割り当て解除'
'Delete'
scaleSetEvictionPolicy scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。 '割り当て解除'
'Delete'
scaleSetPriority 仮想マシン スケール セットの優先度。 指定しない場合、既定値は 'Regular' です。 'Regular'
'Spot'
securityProfile エージェント プールのセキュリティ設定。 AgentPoolSecurityProfile
spotMaxPrice 使用できる値は、0 より大きい 10 進値または -1 です。これは、オンデマンド価格を支払う意欲を示します。 スポット価格の詳細については、「 スポット VM の価格 」を参照してください。10 進値を指定するには、 json() 関数を使用します。 int または json decimal
tags エージェント プール仮想マシン スケール セットに永続化するタグ。 object
型 エージェント プールの種類。 'AvailabilitySet'
'VirtualMachineScaleSets'
'VirtualMachines'
upgradeSettings エージェント プールをアップグレードするための設定 AgentPoolUpgradeSettings
virtualMachineNodesStatus VirtualMachines エージェント プール内のノードの状態。 VirtualMachineNodes[]
virtualMachinesProfile VirtualMachines エージェント プールの仕様。 VirtualMachinesProfile
vmSize VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、CPU など) が含まれていると、ポッドが正しく実行されない可能性があります。 制限付き VM サイズの詳細については、「/azure/aks/quotas-skus-regions」を参照してください。 string
vnetSubnetID これを指定しない場合は、VNET とサブネットが生成され、使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 string
windowsProfile Windows エージェント プールの特定のプロファイル。 AgentPoolWindowsProfile
workloadRuntime ノードで実行できるワークロードの種類を決定します。 'KataMshvVmIsolation'
'OCIContainer'
'WasmWasi'

AgentPoolArtifactStreamingProfile

名前 説明 値
enabled 成果物ストリーミングは、オンデマンドのイメージ読み込みを通じて、ノード上のコンテナーのコールド スタートを高速化します。 この機能を使用するには、コンテナー イメージで ACR での成果物ストリーミングも有効にする必要があります。 指定しない場合、既定値は false です。 [bool]

CreationData

名前 説明 値
sourceResourceId これは、ターゲット オブジェクトの作成に使用されるソース オブジェクトの ARM ID です。 string

AgentPoolGPUProfile

名前 説明 値
installGPUDriver エージェント プールの vmSize に GPU が含まれている場合は既定値は true、それ以外の場合は false です。 GPU ドライバーのインストールは、VM に GPU リソースが関連付けられている場合にのみ true に設定できます。 このフィールドを false に設定すると、GPU ドライバーの自動インストールが防止されます。 その場合、GPU を使用できるようにするには、ユーザーが GPU ドライバーのインストールを自分で実行する必要があります。 [bool]

KubeletConfig

名前 説明 値
allowedUnsafeSysctls 安全でない sysctls または安全でない sysctl パターンの一覧を許可します (末尾 *は )。 string[]
containerLogMaxFiles コンテナーに表示できるコンテナー ログ ファイルの最大数。 数値は 2 ≥する必要があります。 INT

制約:
最小値 = 2
containerLogMaxSizeMB コンテナー ログ ファイルがローテーションされる前の最大サイズ (10Mi など)。 INT
cpuCfsQuota 既定値は true です。 [bool]
cpuCfsQuotaPeriod 既定値は '100 ミリ秒' です。 有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。 たとえば、'300ms'、'2h45m' などです。 サポートされているユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。 string
cpuManagerPolicy 既定値は 'none' です。 詳細については、「 Kubernetes CPU 管理ポリシー 」を参照してください。 使用できる値は、'none' と 'static' です。 string
failSwapOn true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。 [bool]
imageGcHighThreshold イメージ ガベージ コレクションを無効にするには、100 に設定します。 既定値は 85% です INT
imageGcLowThreshold imageGcHighThreshold より高く設定することはできません。 既定値は 80% です INT
podMaxPids ポッドあたりのプロセスの最大数。 INT
topologyManagerPolicy 詳細については、「 Kubernetes Topology Manager」を参照してください。 既定値は 'none' です。 使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。 string

LinuxOSConfig

名前 説明 値
swapFileSizeMB 各ノードに作成されるスワップ ファイルのサイズ (MB)。 INT
sysctls Linux エージェント ノードの Sysctl 設定。 SysctlConfig
transparentHugePageDefrag 有効な値は、'always'、'defer'、'defer+madvise'、'madvise'、および 'never' です。 既定値は 'madvise' です。 詳細については、「 Transparent Hugepages」を参照してください。 string
transparentHugePageEnabled 有効な値は、'always'、'madvise'、および 'never' です。 既定値は 'always' です。 詳細については、「 Transparent Hugepages」を参照してください。 string

SysctlConfig

名前 説明 値
fsAioMaxNr Sysctl setting fs.aio-max-nr. INT
fsFileMax Sysctl setting fs.file-max. INT
fsInotifyMaxUserWatches sysctl setting fs.inotify.max_user_watches. INT
fsNrOpen Sysctl の設定fs.nr_open。 INT
kernelThreadsMax sysctl setting kernel.threads-max. INT
netCoreNetdevMaxBacklog Sysctl の設定net.core.netdev_max_backlog。 INT
netCoreOptmemMax Sysctl の設定net.core.optmem_max。 INT
netCoreRmemDefault Sysctl の設定net.core.rmem_default。 INT
netCoreRmemMax Sysctl の設定net.core.rmem_max。 INT
netCoreSomaxconn net.core.somaxconn を設定する Sysctl。 INT
netCoreWmemDefault Sysctl 設定net.core.wmem_default。 INT
netCoreWmemMax Sysctl の設定net.core.wmem_max。 INT
netIpv4IpLocalPortRange Sysctl の設定net.ipv4.ip_local_port_range。 string
netIpv4NeighDefaultGcThresh1 Sysctl の設定net.ipv4.neigh.default.gc_thresh1。 INT
netIpv4NeighDefaultGcThresh2 Sysctl の設定net.ipv4.neigh.default.gc_thresh2。 INT
netIpv4NeighDefaultGcThresh3 Sysctl の設定net.ipv4.neigh.default.gc_thresh3。 INT
netIpv4TcpFinTimeout Sysctl 設定net.ipv4.tcp_fin_timeout。 INT
netIpv4TcpkeepaliveIntvl Sysctl の設定net.ipv4.tcp_keepalive_intvl。 INT

制約:
最小値 = 10
最大値 = 90
netIpv4TcpKeepaliveProbes Sysctl の設定net.ipv4.tcp_keepalive_probes。 INT
netIpv4TcpKeepaliveTime Sysctl 設定net.ipv4.tcp_keepalive_time。 INT
netIpv4TcpMaxSynBacklog Sysctl の設定net.ipv4.tcp_max_syn_backlog。 INT
netIpv4TcpMaxTwBuckets Sysctl の設定net.ipv4.tcp_max_tw_buckets。 INT
netIpv4TcpTwReuse Sysctl 設定net.ipv4.tcp_tw_reuse。 [bool]
netNetfilterNfConntrackBuckets Sysctl の設定net.netfilter.nf_conntrack_buckets。 INT

制約:
最小値 = 65536
最大値 = 524288
netNetfilterNfConntrackMax Sysctl の設定net.netfilter.nf_conntrack_max。 INT

制約:
最小値 = 131072
最大値 = 2097152
vmMaxMapCount sysctl setting vm.max_map_count. INT
vmSwappiness Sysctl setting vm.swappiness. INT
vmVfsCachePressure Sysctl 設定vm.vfs_cache_pressure。 INT

AgentPoolNetworkProfile

名前 説明 値
allowedHostPorts アクセスが許可されているポート範囲。 指定された範囲は重複することができます。 PortRange[]
applicationSecurityGroups エージェント プールが作成時に関連付けるアプリケーション セキュリティ グループの ID。 string[]
nodePublicIPTags インスタンス レベルのパブリック IP の IP タグ。 IPTag[]

PortRange

名前 説明 値
portEnd 範囲に含まれる最大ポート。 範囲は 1 から 65535 で、portStart 以上である必要があります。 INT

制約:
最小値 = 1
最大値 = 65535
portStart 範囲に含まれる最小ポート。 範囲は 1 から 65535 で、portEnd 以下である必要があります。 INT

制約:
最小値 = 1
最大値 = 65535
protocol ポートのネットワーク プロトコル。 'TCP'
'UDP'

IPTag

名前 説明 値
ipTagType IP タグの種類。 例: RoutingPreference。 string
タグ パブリック IP に関連付けられている IP タグの値。 例: インターネット。 string

ManagedClusterAgentPoolProfilePropertiesNodeLabels

名前 説明 値
{カスタマイズされたプロパティ} string

PowerState

名前 説明 値
code クラスターが実行中か停止かを示します 'Running'
'Stopped'

AgentPoolSecurityProfile

名前 説明 値
enableSecureBoot セキュア ブートは、署名されたオペレーティング システムとドライバーのみが起動できるようにする、トラステッド起動の機能です。 詳細については、「aka.ms/aks/trustedlaunch」を参照してください。 指定しない場合、既定値は false です。 [bool]
enableVTPM vTPM は、ノード上でローカルに保持されているキーと測定用の専用のセキュリティで保護されたコンテナーを構成するためのトラステッド起動機能です。 詳細については、「aka.ms/aks/trustedlaunch」を参照してください。 指定しない場合、既定値は false です。 [bool]
sshAccess エージェント プールの SSH アクセス方法。 'Disabled'
'LocalUser'

AgentPoolUpgradeSettings

名前 説明 値
drainTimeoutInMinutes ポッドの削除とノードごとの正常終了を待機する時間 (分単位)。 この削除待機時間は、ポッド中断予算の待機を優先します。 この時間を超えると、アップグレードは失敗します。 指定しない場合、既定値は 30 分です。 INT

制約:
最小値 = 1
最大値 = 1440
maxSurge これは、整数 (例: '5') またはパーセンテージ ("50%" など) に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数ノードは切り上げられます。 指定しない場合は、1 が既定値です。 ベスト プラクティスを含む詳細については、「/azure/aks/upgrade-cluster#customize-node-surge-upgrade」を参照してください。 string
nodeSoakDurationInMinutes ノードをドレインした後、再イメージ化して次のノードに進む前に待機する時間 (分単位)。 指定しない場合、既定値は 0 分です。 INT

制約:
最小値 = 0
最大値 = 30

VirtualMachineNodes

名前 説明 値
count ノードの数。 INT
size このノード グループをホストするために使用されるエージェントの VM サイズ。 string

VirtualMachinesProfile

名前 説明 値
scale VirtualMachines エージェント プールのスケーリング方法に関する仕様。 ScaleProfile

ScaleProfile

名前 説明 値
manual VirtualMachines エージェント プールを固定サイズにスケーリングする方法に関する仕様。 ManualScaleProfile[]

ManualScaleProfile

名前 説明 値
count ノードの数。 INT

制約:
最小値 = 0
最大値 = 1000
サイズ 許可されている VM サイズの一覧。 AKS では、スケーリング時に最初に使用可能なものが使用されます。 VM のサイズが使用できない場合 (クォータやリージョンの容量の理由など)、AKS は次のサイズを使用します。 string[]

AgentPoolWindowsProfile

名前 説明 値
disableOutboundNat 既定値は false です。 アウトバウンド NAT は、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェント プールでノード パブリック IP が有効になっていない場合にのみ無効にすることができます。 [bool]

ManagedClusterAIToolchainOperatorProfile

名前 説明 値
enabled AI ツールチェーン演算子が有効かどうかを示します。 [bool]

ManagedClusterAPIServerAccessProfile

名前 説明 値
authorizedIPRanges IP 範囲は CIDR 形式で指定されます (例: 137.117.106.88/29)。 この機能は、ノードあたりのパブリック IP を使用するクラスター、または Basic Load Balancerを使用しているクラスターとは互換性がありません。 詳細については、 API サーバーの承認された IP 範囲に関するページを参照してください。 string[]
disableRunCommand クラスターの実行コマンドを無効にするかどうか。 [bool]
enablePrivateCluster 詳細については、「 プライベート AKS クラスターの作成」を参照してください。 [bool]
enablePrivateClusterPublicFQDN プライベート クラスター用に追加のパブリック FQDN を作成するかどうか。 [bool]
enableVnetIntegration クラスターの apiserver vnet 統合を有効にするかどうか。 [bool]
privateDNSZone 既定値は [システム] です。 詳細については、「 プライベート DNS ゾーンを構成する」を参照してください。 使用できる値は、'system' と 'none' です。 string
subnetId これは、次の場合に必要です: 1。 BYO Vnet を使用して新しいクラスターを作成する。2. 既存のクラスターを更新して apiserver vnet 統合を有効にする。 string

ManagedClusterPropertiesAutoScalerProfile

名前 説明 値
balance-similar-node-groups 有効な値は 'true' と 'false' です string
daemonset-eviction-for-empty-nodes true に設定すると、ノードを削除する前に、空のノード上のすべてのデーモンセット ポッドが削除されます。 デーモンセット ポッドを削除できない場合は、スケーリングのために別のノードが選択されます。 false に設定すると、デーモンセット ポッドが確実に削除または削除されることなく、ノードが削除されます。 [bool]
daemonset-eviction-for-occupied-nodes true に設定すると、ノードが削除される前に、占有ノード上のすべてのデーモンセット ポッドが削除されます。 デーモンセット ポッドを削除できない場合は、スケーリングのために別のノードが選択されます。 false に設定すると、デーモンセット ポッドが確実に削除または削除されることなく、ノードが削除されます。 [bool]
expander 使用可能な値は、'最小廃棄物'、'most-pods'、'priority'、'random' です。 '最小廃棄物'
'most-pods'
'priority'
'random'
ignore-daemonsets-utilization true に設定すると、スケールダウンの決定を行うときに、daemonset によって使用されるリソースが考慮されます。 [bool]
max-empty-bulk-delete 既定値は 10 です。 string
max-graceful-termination-sec 既定値は 600 です。 string
max-node-provision-time 既定値は '15m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
max-total-unready-percentage 既定値は 45 です。 最大値は 100、最小値は 0 です。 string
new-pod-scale-up-delay バーストまたはバッチ スケールのように、Kubernetes スケジューラによってすべてのポッドがスケジュールされる前に CA を動作させたくないシナリオの場合、一定の期間に達する前のスケジュールされていないポッドを無視するように CA に指示できます。 既定値は '0s' です。 値は整数の後に単位 (秒の場合は 's'、分の場合は 'm'、時間の場合は 'h' など) である必要があります。 string
ok-total-unready-count これは整数である必要があります。 既定値は 3 です。 string
scale-down-delay-after-add 既定値は '10m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-delay-after-delete 既定値はスキャン間隔です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-delay-after-failure 既定値は '3m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-unneeded-time 既定値は '10m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-unready-time 既定値は '20m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-utilization-threshold 既定値は '0.5' です。 string
scan-interval 既定値は '10' です。 値は整数値である必要があります。 string
skip-nodes-with-local-storage 既定値は true です。 string
skip-nodes-with-system-pods 既定値は true です。 string

ManagedClusterAutoUpgradeProfile

名前 説明 値
nodeOSUpgradeChannel 既定値は [アンマネージド] ですが、GA で NodeImage または SecurityPatch のいずれかに変更される場合があります。 'NodeImage'
'None'
'SecurityPatch'
'アンマネージド'
upgradeChannel 詳細については、 AKS クラスターの自動アップグレード チャネルの設定に関するページを参照してください。 'node-image'
'none'
'patch'
'rapid'
'stable'

ManagedClusterAzureMonitorProfile

名前 説明 値
logs Azure Monitor インフラストラクチャとアプリケーション ログのログ プロファイル。 すぐに使用できる Kubernetes インフラストラクチャ & アプリケーション ログを収集して、Azure Monitor に送信します。 概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileLogs
metrics prometheus サービス アドオンのメトリック プロファイル ManagedClusterAzureMonitorProfileMetrics

ManagedClusterAzureMonitorProfileLogs

名前 説明 値
appMonitoring Kubernetes アプリケーション コンテナーのアプリケーション監視プロファイル。 Azure Monitor OpenTelemetry ベースの SDK を使用して、アプリケーションの自動インストルメンテーションを通じてアプリケーション ログ、メトリック、トレースを収集します。 概要については、「aka.ms/AzureMonitorApplicationMonitoring」を参照してください。 ManagedClusterAzureMonitorProfileAppMonitoring
containerInsights Kubernetes イベント、インベントリ、コンテナー stdout & stderr ログなどの Azure Monitor Container Insights プロファイル。概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileContainerInsights

ManagedClusterAzureMonitorProfileAppMonitoring

名前 説明 値
enabled アプリケーション監視が有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileContainerInsights

名前 説明 値
enabled Azure Monitor Container Insights ログ アドオンが有効かどうかを示します。 [bool]
logAnalyticsWorkspaceResourceId Azure Monitor Container Insights ログを格納するための Azure Log Analytics ワークスペースの完全修飾 ARM リソース ID。 string
windowsHostLogs Kubernetes Windows ノードログ収集用の Windows ホスト ログ プロファイル。 ETW、イベント ログ、テキスト ログなどを収集します。概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileWindowsHostLogs

ManagedClusterAzureMonitorProfileWindowsHostLogs

名前 説明 値
enabled Azure Monitor Container Insights ログ アドオンに対して Windows ホスト ログ収集が有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileMetrics

名前 説明 値
appMonitoringOpenTelemetryMetrics Kubernetes アプリケーション コンテナー メトリックのアプリケーション監視オープン テレメトリ メトリック プロファイル。 Azure Monitor OpenTelemetry ベースの SDK を使用して、アプリケーションの自動インストルメンテーションを使用して OpenTelemetry メトリックを収集します。 概要については、「aka.ms/AzureMonitorApplicationMonitoring」を参照してください。 ManagedClusterAzureMonitorProfileAppMonitoringOpenTe...
enabled Prometheus コレクターを有効にするかどうか bool (必須)
kubeStateMetrics コンテナー サービス クラスターの prometheus アドオン プロファイルの Kube 状態メトリック ManagedClusterAzureMonitorProfileKubeStateMetrics

ManagedClusterAzureMonitorProfileAppMonitoringOpenTe...

名前 説明 値
enabled アプリケーション監視のオープン テレメトリ メトリックが有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileKubeStateMetrics

名前 説明 値
metricAnnotationsAllowList リソースのラベル メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りのリスト。 string
metricLabelsAllowlist リソースのラベル メトリックで使用される Kubernetes 注釈キーのコンマ区切りのリスト。 string

ManagedClusterBootstrapProfile

名前 説明 値
artifactSource 成果物のダウンロード元のソース。 'Cache'
'Direct'
containerRegistryId Azure Container Registryのリソース ID。 レジストリには、プライベート ネットワーク アクセス、Premium SKU、ゾーン冗長性が必要です。 string

ManagedClusterHttpProxyConfig

名前 説明 値
httpProxy 使用する HTTP プロキシ サーバー エンドポイント。 string
httpsProxy 使用する HTTPS プロキシ サーバー エンドポイント。 string
noProxy プロキシを経由しないエンドポイント。 string[]
trustedCa プロキシ サーバーへの接続に使用する代替 CA 証明書。 string

ManagedClusterPropertiesIdentityProfile

名前 説明 値
{カスタマイズされたプロパティ} UserAssignedIdentity

UserAssignedIdentity

名前 説明 値
clientId ユーザー割り当て ID のクライアント ID。 string
objectId ユーザー割り当て ID のオブジェクト ID。 string
resourceId ユーザー割り当て ID のリソース ID。 string

ManagedClusterIngressProfile

名前 説明 値
webAppRouting イングレス プロファイルの Web アプリ ルーティング設定。 ManagedClusterIngressProfileWebAppRouting

ManagedClusterIngressProfileWebAppRouting

名前 説明 値
dnsZoneResourceIds Web アプリ ルーティング アドオンに関連付ける DNS ゾーンのリソース ID。 Web アプリ ルーティングが有効になっている場合にのみ使用されます。 パブリック DNS ゾーンとプライベート DNS ゾーンは異なるリソース グループに含めることができますが、すべてのパブリック DNS ゾーンは同じリソース グループ内にあり、すべてのプライベート DNS ゾーンは同じリソース グループ内に存在する必要があります。 string[]

制約:
最大長 = 5
enabled Web アプリ ルーティングを有効にするかどうか。 [bool]

ContainerServiceLinuxProfile

名前 説明 値
adminUsername Linux VM に使用する管理者ユーザー名。 string (必須)

制約:
Pattern = ^[A-Za-z][-A-Za-z0-9_]*$
ssh Azure で実行されている Linux ベースの VM の SSH 構成。 ContainerServiceSshConfiguration (必須)

ContainerServiceSshConfiguration

名前 説明 値
publicKeys Linux ベースの VM で認証するために使用される SSH 公開キーの一覧。 最大 1 つのキーを指定できます。 ContainerServiceSshPublicKey[] (必須)

ContainerServiceSshPublicKey

名前 説明 値
keyData SSH 経由で VM で認証するために使用される証明書公開キー。 証明書は、ヘッダーの有無にかかわらず PEM 形式である必要があります。 string (必須)

ManagedClusterMetricsProfile

名前 説明 値
costAnalysis クラスターのコスト分析構成 ManagedClusterCostAnalysis

ManagedClusterCostAnalysis

名前 説明 値
enabled この機能を有効にするには、マネージド クラスター sku.tier を "Standard" に設定する必要があります。 これを有効にすると、Kubernetes 名前空間とデプロイの詳細がAzure portalの [コスト分析] ビューに追加されます。 指定しない場合、既定値は false です。 詳細については、「aka.ms/aks/docs/cost-analysis」を参照してください。 [bool]

ContainerServiceNetworkProfile

名前 説明 値
dnsServiceIP Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、serviceCidr で指定された Kubernetes サービス アドレス範囲内である必要があります。 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]?)$
ipFamilies IP ファミリは、単一スタッククラスターまたはデュアルスタック クラスターを決定するために使用されます。 単一スタックの場合、期待される値は IPv4 です。 デュアルスタックの場合、期待される値は IPv4 と IPv6 です。 次のいずれかを含む文字列配列:
'IPv4'
'IPv6'
kubeProxyConfig kube-proxy の構成のカスタマイズを保持します。 定義されていない値は、kube-proxy の既定の動作を使用します。 {version} が {メジャー バージョン}-{マイナー バージョン} 文字列で表される場所を確認します https://v{version}.docs.kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/ 。 Kubernetes バージョン 1.23 は '1-23' になります。 ContainerServiceNetworkProfileKubeProxyConfig
loadBalancerProfile クラスター ロード バランサーのプロファイル。 ManagedClusterLoadBalancerProfile
loadBalancerSku 既定値は 'standard' です。 ロード バランサー SKU の違いの詳細については、「Azure Load Balancer SKU」を参照してください。 'basic'
'standard'
監視 このアドオンは、ネットワーク監視を構成し、Prometheus 形式でネットワーク監視データを生成するために使用できます NetworkMonitoring
natGatewayProfile クラスター NAT ゲートウェイのプロファイル。 ManagedClusterNATGatewayProfile
networkDataplane Kubernetes クラスターで使用されるネットワーク データプレーン。 'azure'
'cilium'
networkMode networkPlugin が 'azure' 以外の場合は、これを指定できません。 'bridge'
'transparent'
networkPlugin Kubernetes ネットワークの構築に使用されるネットワーク プラグイン。 'azure'
'kubenet'
'none'
networkPluginMode Kubernetes ネットワークの構築に使用されるネットワーク プラグイン モード。 'overlay'
networkPolicy Kubernetes ネットワークの構築に使用されるネットワーク ポリシー。 'azure'
'calico'
'cilium'
'none'
outboundType これはクラスター作成時にのみ設定でき、後で変更することはできません。 詳細については、「 エグレス送信の種類」を参照してください。 'loadBalancer'
'managedNATGateway'
'userAssignedNATGateway'
'userDefinedRouting'
podCidr Kubenet を使用している場合、ポッド IP を割り当てる CIDR 表記の IP 範囲。 string

制約:
Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
podCidrs 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (IP ファミリ (IPv4/IPv6) ごとに 1 つ) が必要です。 string[]
serviceCidr Kubenet を使用している場合、サービス クラスター IP を割り当てる CIDR 表記の IP 範囲。 どのサブネット IP アドレスとも重複していてはなりません。 string

制約:
Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidrs 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (IP ファミリ (IPv4/IPv6) ごとに 1 つ) が必要です。 サブネット IP 範囲と重複しないようにする必要があります。 string[]

ContainerServiceNetworkProfileKubeProxyConfig

名前 説明 値
enabled クラスター上の kube-proxy で有効にするかどうか ('kubeProxyConfig' が存在しない場合は、これらのカスタマイズを行わずに既定で AKS で kube-proxy が有効になります)。 [bool]
ipvsConfig IPVS の構成のカスタマイズを保持します。 'mode' が 'IPVS' に設定されている場合にのみ指定できます。 ContainerServiceNetworkProfileKubeProxyConfigIpvsCon...
mode 使用するプロキシ モード ('IPTABLES' または 'IPVS') を指定する 'IPTABLES'
'IPVS'

ContainerServiceNetworkProfileKubeProxyConfigIpvsCon...

名前 説明 値
scheduler IPVS スケジューラの詳細については、以下を参照してください。 http://www.linuxvirtualserver.org/docs/scheduling.html. 'LeastConnection'
'RoundRobin'
tcpFinTimeoutSeconds FIN を受信した後の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT
tcpTimeoutSeconds アイドル状態の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT
udpTimeoutSeconds IPVS UDP パケットに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT

ManagedClusterLoadBalancerProfile

名前 説明 値
allocatedOutboundPorts VM ごとに割り当てられた SNAT ポートの必要な数。 使用できる値は、0 ~ 64000 (含む) の範囲です。 既定値は 0 で、その結果、Azure によってポートが動的に割り当てられます。 INT

制約:
最小値 = 0
最大値 = 64000
backendPoolType Managed inbound Load Balancer BackendPool の型。 'NodeIP'
'NodeIPConfiguration'
effectiveOutboundIPs クラスター ロード バランサーの有効な送信 IP リソース。 ResourceReference[]
enableMultipleStandardLoadBalancers AKS クラスターごとに複数の標準ロード バランサーを有効にするかどうか。 [bool]
idleTimeoutInMinutes 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値は、4 ~ 120 (含む) の範囲です。 既定値は 30 分です。 INT

制約:
最小値 = 4
最大値 = 120
managedOutboundIPs クラスター ロード バランサーに必要なマネージド送信 IP。 ManagedClusterLoadBalancerProfileManagedOutboundIPs
outboundIPPrefixes クラスター ロード バランサーの必要な送信 IP プレフィックス リソース。 ManagedClusterLoadBalancerProfileOutboundIPPrefixes
outboundIP クラスター ロード バランサーに必要な送信 IP リソース。 ManagedClusterLoadBalancerProfileOutboundIPs

ResourceReference

名前 説明 値
id 完全修飾 Azure リソース ID。 string

ManagedClusterLoadBalancerProfileManagedOutboundIPs

名前 説明 値
count クラスター ロード バランサー用に Azure によって作成または管理される IPv4 送信 IP の必要な数。 使用できる値は、1 ~ 100 (含む) の範囲である必要があります。 既定値は 1 です。 INT

制約:
最小値 = 1
最大値 = 100
countIPv6 クラスター ロード バランサー用に Azure によって作成または管理される IPv6 送信 IP の必要な数。 使用できる値は、1 ~ 100 (含む) の範囲である必要があります。 既定値は、単一スタックの場合は 0、デュアルスタックの場合は 1 です。 INT

制約:
最小値 = 0
最大値 = 100

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

名前 説明 値
publicIPPrefixes パブリック IP プレフィックス リソースの一覧。 ResourceReference[]

ManagedClusterLoadBalancerProfileOutboundIPs

名前 説明 値
publicIPs パブリック IP リソースの一覧。 ResourceReference[]

NetworkMonitoring

名前 説明 値
enabled クラスターでネットワーク監視プラグインを有効または無効にする [bool]

ManagedClusterNATGatewayProfile

名前 説明 値
effectiveOutboundIP クラスター NAT ゲートウェイの有効な送信 IP リソース。 ResourceReference[]
idleTimeoutInMinutes 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値は、4 ~ 120 (含む) の範囲です。 既定値は 4 分です。 INT

制約:
最小値 = 4
最大値 = 120
managedOutboundIPProfile クラスター NAT ゲートウェイのマネージド送信 IP リソースのプロファイル。 ManagedClusterManagedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

名前 説明 値
count Azure によって作成または管理される送信 IP の必要な数。 使用できる値は、1 ~ 16 (含む) の範囲である必要があります。 既定値は 1 です。 INT

制約:
最小値 = 1
最大値 = 16

ManagedClusterNodeProvisioningProfile

名前 説明 値
mode 自動に設定したモードを手動に戻すことはできません。 'Auto'
'Manual'

ManagedClusterNodeResourceGroupProfile

名前 説明 値
restrictionLevel クラスターのノード リソース グループに適用される制限レベル 'ReadOnly'
'Unrestricted'

ManagedClusterOidcIssuerProfile

名前 説明 値
enabled OIDC 発行者が有効になっているかどうか。 [bool]

ManagedClusterPodIdentityProfile

名前 説明 値
allowNetworkPluginKubenet Kubenet での実行は、AAD ポッド ID のセキュリティ関連の性質と IP スプーフィングのリスクにより、既定で無効になっています。 詳細については、「 AAD ポッド ID で Kubenet ネットワーク プラグインを使用 する」を参照してください。 [bool]
enabled ポッド ID アドオンが有効になっているかどうか。 [bool]
userAssignedIdentities クラスターで使用するポッド ID。 ManagedClusterPodIdentity[]
userAssignedIdentityExceptions 許可するポッド ID 例外。 ManagedClusterPodIdentityException[]

ManagedClusterPodIdentity

名前 説明 値
bindingSelector AzureIdentityBinding リソースに使用するバインド セレクター。 string
identity ユーザー割り当て ID の詳細。 UserAssignedIdentity (必須)
name ポッド ID の名前。 string (必須)
namespace ポッド ID の名前空間。 string (必須)

ManagedClusterPodIdentityException

名前 説明 値
name ポッド ID 例外の名前。 string (必須)
namespace ポッド ID 例外の名前空間。 string (必須)
podLabels 一致するポッド ラベル。 ManagedClusterPodIdentityExceptionPodLabels (必須)

ManagedClusterPodIdentityExceptionPodLabels

名前 説明 値
{カスタマイズされたプロパティ} string

PrivateLinkResource

名前 説明 値
groupId リソースのグループ ID。 string
id プライベート リンク リソースの ID。 string
name プライベート リンク リソースの名前。 string
requiredMembers リソースの RequiredMembers string[]
型 リソースの種類。 string

SafeguardsProfile

名前 説明 値
excludedNamespaces セーフガード チェックから除外された名前空間の一覧 string[]
レベル 使用するセーフガード レベル。 既定では、AKS が systemExcludedNamespaces 経由で除外するものを除くすべての名前空間に対してセーフガードが有効になっています '強制'
'Off'
'Warning' (必須)
version 使用する制約のバージョン string

ManagedClusterSecurityProfile

名前 説明 値
azureKeyVaultKms セキュリティ プロファイルの Azure Key Vaultキー管理サービスの設定。 AzureKeyVaultKms
customCATrustCertificates カスタム CA 信頼機能が有効になっているノードの信頼ストアに追加される、最大 10 個の base64 でエンコードされた CA の一覧。 詳細については、「カスタム CA 信頼証明書」を参照してください。 any[]

制約:
最大長 = 10
Defender セキュリティ プロファイルの設定をMicrosoft Defenderします。 ManagedClusterSecurityProfileDefender
imageCleaner セキュリティ プロファイルのイメージ クリーナー設定。 ManagedClusterSecurityProfileImageCleaner
imageIntegrity イメージの整合性は、署名によってイメージの整合性を検証するAzure Policyと連携する機能です。 イメージ署名を適用するためにAzure Policyが適用されていない限り、これは影響しません。 ポリシーを使用してこの機能を使用する方法については、「」を参照してください https://aka.ms/aks/image-integrity 。 ManagedClusterSecurityProfileImageIntegrity
nodeRestriction セキュリティ プロファイルのノード制限設定。 ManagedClusterSecurityProfileNodeRestriction
workloadIdentity セキュリティ プロファイルのワークロード ID 設定。 ワークロード ID を使用すると、Kubernetes アプリケーションは Azure AD を使用して Azure クラウド リソースに安全にアクセスできます。 詳細については、 https://aka.ms/aks/wi をご覧ください。 ManagedClusterSecurityProfileWorkloadIdentity

AzureKeyVaultKms

名前 説明 値
enabled Azure Key Vault キー管理サービスを有効にするかどうか。 既定値は false です。 [bool]
keyId Azure Key Vault キーの識別子。 詳細については、「 キー識別子の形式 」を参照してください。 Azure Key Vault キー管理サービスが有効になっている場合、このフィールドは必須であり、有効なキー識別子である必要があります。 Azure Key Vault キー管理サービスが無効になっている場合は、フィールドを空のままにします。 string
keyVaultNetworkAccess キー コンテナーのネットワーク アクセス。 設定可能な値は、Public および Private です。 Public は、キー コンテナーですべてのネットワークからのパブリック アクセスを許可することを意味します。 Private は、キー コンテナーがパブリック アクセスを無効にし、プライベート リンクを有効にすることを意味します。 既定値は Public です。 'Private'
'Public'
keyVaultResourceId キー コンテナーのリソース ID。 keyVaultNetworkAccess が の場合、 Privateこのフィールドは必須であり、有効なリソース ID である必要があります。 keyVaultNetworkAccess が の場合は Public、フィールドを空のままにします。 string

ManagedClusterSecurityProfileDefender

名前 説明 値
logAnalyticsWorkspaceResourceId Microsoft Defenderに関連付ける Log Analytics ワークスペースのリソース ID。 Microsoft Defenderが有効になっている場合、このフィールドは必須であり、有効なワークスペース リソース ID である必要があります。 Microsoft Defenderが無効になっている場合は、フィールドを空のままにします。 string
securityMonitoring セキュリティ プロファイルのクラウド設定の脅威検出をMicrosoft Defenderします。 ManagedClusterSecurityProfileDefenderSecurityMonitor...

ManagedClusterSecurityProfileDefenderSecurityMonitor...

名前 説明 値
enabled Defender 脅威検出を有効にするかどうか [bool]

ManagedClusterSecurityProfileImageCleaner

名前 説明 値
enabled AKS クラスターで Image Cleaner を有効にするかどうか。 [bool]
intervalHours イメージ クリーナーのスキャン間隔 (時間単位)。 INT

ManagedClusterSecurityProfileImageIntegrity

名前 説明 値
enabled イメージの整合性を有効にするかどうか。 既定値は false です。 [bool]

ManagedClusterSecurityProfileNodeRestriction

名前 説明 値
enabled ノード制限を有効にするかどうか [bool]

ManagedClusterSecurityProfileWorkloadIdentity

名前 説明 値
enabled ワークロード ID を有効にするかどうか。 [bool]

ServiceMeshProfile

名前 説明 値
istio Istio サービス メッシュの構成。 IstioServiceMesh
mode サービス メッシュのモード。 'Disabled'
'Istio' (必須)

IstioServiceMesh

名前 説明 値
certificateAuthority Istio Service Mesh Certificate Authority (CA) の構成。 現時点では、ここで説明するようにプラグイン証明書のみをサポートしています https://aka.ms/asm-plugin-ca IstioCertificateAuthority
components Istio コンポーネントの構成。 IstioComponents
リビジョン Istio コントロール プレーンのリビジョンの一覧。 アップグレードが進行中でない場合、これは 1 つの値を保持します。 カナリア アップグレードが進行中の場合、これは連続する 2 つの値のみを保持できます。 詳細については、「/azure/aks/istio-upgrade」を参照してください。 string[]

制約:
最大長 = 2

IstioCertificateAuthority

名前 説明 値
plugin Service Mesh のプラグイン証明書情報。 IstioPluginCertificateAuthority

IstioPluginCertificateAuthority

名前 説明 値
certChainObjectName Azure Key Vaultの証明書チェーン オブジェクト名。 string
certObjectName Azure Key Vaultの中間証明書オブジェクト名。 string
keyObjectName Azure Key Vaultの中間証明書秘密キー オブジェクト名。 string
keyVaultId Key Vaultのリソース ID。 string
rootCertObjectName Azure Key Vaultのルート証明書オブジェクト名。 string

IstioComponents

名前 説明 値
egressGateways Istio エグレス ゲートウェイ。 IstioEgressGateway[]
ingressGateways Istio イングレス ゲートウェイ。 IstioIngressGateway[]

IstioEgressGateway

名前 説明 値
enabled エグレス ゲートウェイを有効にするかどうか。 bool (必須)
nodeSelector エグレス ゲートウェイをスケジュールするための NodeSelector。 IstioEgressGatewayNodeSelector

IstioEgressGatewayNodeSelector

名前 説明 値
{カスタマイズされたプロパティ} string

IstioIngressGateway

名前 説明 値
enabled イングレス ゲートウェイを有効にするかどうか。 bool (必須)
mode イングレス ゲートウェイのモード。 'External'
'Internal' (必須)

ManagedClusterServicePrincipalProfile

名前 説明 値
clientId サービス プリンシパルの ID。 string (必須)
secret プレーン テキストでサービス プリンシパルに関連付けられているシークレット パスワード。 string

ManagedClusterStorageProfile

名前 説明 値
blobCSIDriver ストレージ プロファイルの AzureBlob CSI ドライバー設定。 ManagedClusterStorageProfileBlobCSIDriver
diskCSIDriver ストレージ プロファイルの AzureDisk CSI ドライバー設定。 ManagedClusterStorageProfileDiskCSIDriver
fileCSIDriver ストレージ プロファイルの AzureFile CSI ドライバー設定。 ManagedClusterStorageProfileFileCSIDriver
snapshotController ストレージ プロファイルのスナップショット コントローラー設定。 ManagedClusterStorageProfileSnapshotController

ManagedClusterStorageProfileBlobCSIDriver

名前 説明 値
enabled AzureBlob CSI ドライバーを有効にするかどうか。 既定値は false です。 [bool]

ManagedClusterStorageProfileDiskCSIDriver

名前 説明 値
enabled AzureDisk CSI ドライバーを有効にするかどうか。 既定値は、true です。 [bool]
version AzureDisk CSI ドライバーのバージョン。 既定値は v1 です。 string

ManagedClusterStorageProfileFileCSIDriver

名前 説明 値
enabled AzureFile CSI ドライバーを有効にするかどうか。 既定値は、true です。 [bool]

ManagedClusterStorageProfileSnapshotController

名前 説明 値
enabled スナップショット コントローラーを有効にするかどうか。 既定値は、true です。 [bool]

ClusterUpgradeSettings

名前 説明 値
overrideSettings オーバーライドの設定。 UpgradeOverrideSettings

UpgradeOverrideSettings

名前 説明 値
forceUpgrade クラスターを強制的にアップグレードするかどうか。 このオプションは、非推奨の API 使用状況の確認などのアップグレード保護をバイパスするようにアップグレード操作に指示します。 このオプションは注意して有効にしてください。 [bool]
until オーバーライドが有効になるまで。 これはアップグレードの開始時刻にのみ一致し、アップグレードが進むにつれて有効期限が切れた場合 until でも、アップグレードが開始されると有効性は変わらないことに注意してください。 このフィールドは既定では設定されていません。 オーバーライドを有効にするには、設定する必要があります。 string

ManagedClusterWindowsProfile

名前 説明 値
adminPassword 管理者アカウントのパスワードを指定します。

最小長: 8 文字

最大長: 123 文字

複雑さの要件: 以下の 4 つの条件のうち 3 つを満たす必要がある
文字が小さい
上の文字を含む
数字を含む
特殊文字があります (Regex match [\W_])

許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!"		 string
adminUsername 管理者アカウントの名前を指定します。

制限： "." で終わることはできません。

許可されていない値: "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 文字		 string (必須)
enableCSIProxy CSI プロキシの詳細については、 CSI プロキシの GitHub リポジトリを参照してください。 [bool]
gmsaProfile マネージド クラスター内の Windows gMSA プロファイル。 WindowsGmsaProfile
licenseType Windows VM に使用するライセンスの種類。 詳細については、「 Azure ハイブリッド ユーザー特典 」を参照してください。 'None'
'Windows_Server'

WindowsGmsaProfile

名前 説明 値
dnsServer Windows gMSA の DNS サーバーを指定します。

マネージド クラスターの作成に使用される vnet で DNS サーバーを構成している場合は、空に設定します。		 string
enabled マネージド クラスターで Windows gMSA を有効にするかどうかを指定します。 [bool]
rootDomainName Windows gMSA のルート ドメイン名を指定します。

マネージド クラスターの作成に使用される vnet で DNS サーバーを構成している場合は、空に設定します。		 string

ManagedClusterWorkloadAutoScalerProfile

名前 説明 値
keda ワークロード 自動スケーラー プロファイルの KEDA (Kubernetes イベント ドリブン自動スケーリング) 設定。 ManagedClusterWorkloadAutoScalerProfileKeda
verticalPodAutoscaler ManagedClusterWorkloadAutoScalerProfileVerticalPodAu...

ManagedClusterWorkloadAutoScalerProfileKeda

名前 説明 値
enabled KEDA を有効にするかどうか。 bool (必須)

ManagedClusterWorkloadAutoScalerProfileVerticalPodAu...

名前 説明 値
addonAutoscaling VPA アドオンが有効で、AKS で管理されるアドオンをスケーリングするように構成されているかどうか。 'Disabled'
'Enabled'
enabled クラスターで VPA アドオンを有効にするかどうか。 既定値は false です。 bool (必須)

ManagedClusterSKU

名前 説明 値
name マネージド クラスター SKU の名前。 'Base'
レベル 指定しない場合、既定値は 'Free' です。 詳細については、 AKS 価格レベル に関するページを参照してください。 'Free'
'Premium'
'Standard'

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
Azure Container Service (AKS) で Jenkins を使用する CI/CD

Azure にデプロイする		 コンテナーにより、アプリケーションの継続的なビルドとデプロイが非常に簡単になります。 Azure Container Service で Kubernetes を使用してこれらのコンテナーのデプロイを調整することで、コンテナーのレプリケート可能で管理可能なクラスターを実現できます。 コンテナー イメージを生成するための継続的ビルドを設定し、オーケストレーションすることで、デプロイのスピードと信頼性を向上させることができます。
Azure Gateway の min.io

Azure にデプロイする		 Blob Storage によってサポートされる S3 準拠ストレージ API を提供するための完全プライベート min.io Azure Gateway デプロイ
NAT ゲートウェイとApplication Gatewayを備えた AKS クラスター

Azure にデプロイする		 このサンプルでは、送信接続用の NAT ゲートウェイと受信接続用のApplication Gatewayを使用して AKS クラスターをデプロイする方法を示します。
プライベート AKS クラスターを作成する

Azure にデプロイする		 このサンプルでは、ジャンプボックス仮想マシンと共に仮想ネットワークにプライベート AKS クラスターを作成する方法を示します。
パブリック DNS ゾーンを使用してプライベート AKS クラスターを作成する

Azure にデプロイする		 このサンプルでは、パブリック DNS ゾーンを使用してプライベート AKS クラスターをデプロイする方法を示します。
マネージド Kubernetes クラスター (AKS) をデプロイする

Azure にデプロイする		 この ARM テンプレートは、高度なネットワーク機能を持つ AKS インスタンスを既存の仮想ネットワークにデプロイする方法を示しています。 さらに、選択したサービス プリンシパルには、AKS クラスターを含むサブネットに対してネットワーク共同作成者ロールが割り当てられます。
AAD (AKS) を使用してマネージド Kubernetes クラスターをデプロイする

Azure にデプロイする		 この ARM テンプレートは、既存の仮想ネットワークと Azure AD Integeration への高度なネットワーク機能を備えた AKS インスタンスのデプロイを示しています。 さらに、選択したサービス プリンシパルには、AKS クラスターを含むサブネットに対してネットワーク共同作成者ロールが割り当てられます。
Azure ML 用の AKS クラスターをデプロイする

Azure にデプロイする		 このテンプレートを使用すると、Azure ML にアタッチできる、既存の準拠 AKS クラスターをデプロイできます
Azure Container Service (AKS)

Azure にデプロイする		 Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする
Azure Container Service (AKS)

Azure にデプロイする		 Azure Linux コンテナー ホストを使用して Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする
Helm を使用した Azure Container Service (AKS)

Azure にデプロイする		 Helm を使用して Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする
Azure Kubernetes Service (AKS)

Azure にデプロイする		 Azure Kubernetes Service (AKS) を使用してマネージド Kubernetes クラスターをデプロイします
Application Gateway イングレス コントローラーを使用した AKS クラスター

Azure にデプロイする		 このサンプルでは、Application Gateway、Application Gatewayイングレス コントローラー、Azure Container Registry、Log Analytics、Key Vaultを使用して AKS クラスターをデプロイする方法を示します。

ARM テンプレート リソース定義

managedClusters リソースの種類は、次をターゲットとする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

注釈

使用可能なアドオンの詳細については、「アドオン、拡張機能、およびその他のAzure Kubernetes Serviceとの統合」を参照してください。

リソース形式

Microsoft.ContainerService/managedClusters リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.ContainerService/managedClusters",
  "apiVersion": "2024-01-02-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "Base",
    "tier": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "identity": {
    "delegatedResources": {
      "{customized property}": {
        "location": "string",
        "referralResource": "string",
        "resourceId": "string",
        "tenantId": "string"
      }
    },
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "aadProfile": {
      "adminGroupObjectIDs": [ "string" ],
      "clientAppID": "string",
      "enableAzureRBAC": "bool",
      "managed": "bool",
      "serverAppID": "string",
      "serverAppSecret": "string",
      "tenantID": "string"
    },
    "addonProfiles": {
      "{customized property}": {
        "config": {
          "{customized property}": "string"
        },
        "enabled": "bool"
      }
    },
    "agentPoolProfiles": [
      {
        "artifactStreamingProfile": {
          "enabled": "bool"
        },
        "availabilityZones": [ "string" ],
        "capacityReservationGroupID": "string",
        "count": "int",
        "creationData": {
          "sourceResourceId": "string"
        },
        "enableAutoScaling": "bool",
        "enableCustomCATrust": "bool",
        "enableEncryptionAtHost": "bool",
        "enableFIPS": "bool",
        "enableNodePublicIP": "bool",
        "enableUltraSSD": "bool",
        "gpuInstanceProfile": "string",
        "gpuProfile": {
          "installGPUDriver": "bool"
        },
        "hostGroupID": "string",
        "kubeletConfig": {
          "allowedUnsafeSysctls": [ "string" ],
          "containerLogMaxFiles": "int",
          "containerLogMaxSizeMB": "int",
          "cpuCfsQuota": "bool",
          "cpuCfsQuotaPeriod": "string",
          "cpuManagerPolicy": "string",
          "failSwapOn": "bool",
          "imageGcHighThreshold": "int",
          "imageGcLowThreshold": "int",
          "podMaxPids": "int",
          "topologyManagerPolicy": "string"
        },
        "kubeletDiskType": "string",
        "linuxOSConfig": {
          "swapFileSizeMB": "int",
          "sysctls": {
            "fsAioMaxNr": "int",
            "fsFileMax": "int",
            "fsInotifyMaxUserWatches": "int",
            "fsNrOpen": "int",
            "kernelThreadsMax": "int",
            "netCoreNetdevMaxBacklog": "int",
            "netCoreOptmemMax": "int",
            "netCoreRmemDefault": "int",
            "netCoreRmemMax": "int",
            "netCoreSomaxconn": "int",
            "netCoreWmemDefault": "int",
            "netCoreWmemMax": "int",
            "netIpv4IpLocalPortRange": "string",
            "netIpv4NeighDefaultGcThresh1": "int",
            "netIpv4NeighDefaultGcThresh2": "int",
            "netIpv4NeighDefaultGcThresh3": "int",
            "netIpv4TcpFinTimeout": "int",
            "netIpv4TcpkeepaliveIntvl": "int",
            "netIpv4TcpKeepaliveProbes": "int",
            "netIpv4TcpKeepaliveTime": "int",
            "netIpv4TcpMaxSynBacklog": "int",
            "netIpv4TcpMaxTwBuckets": "int",
            "netIpv4TcpTwReuse": "bool",
            "netNetfilterNfConntrackBuckets": "int",
            "netNetfilterNfConntrackMax": "int",
            "vmMaxMapCount": "int",
            "vmSwappiness": "int",
            "vmVfsCachePressure": "int"
          },
          "transparentHugePageDefrag": "string",
          "transparentHugePageEnabled": "string"
        },
        "maxCount": "int",
        "maxPods": "int",
        "messageOfTheDay": "string",
        "minCount": "int",
        "mode": "string",
        "name": "string",
        "networkProfile": {
          "allowedHostPorts": [
            {
              "portEnd": "int",
              "portStart": "int",
              "protocol": "string"
            }
          ],
          "applicationSecurityGroups": [ "string" ],
          "nodePublicIPTags": [
            {
              "ipTagType": "string",
              "tag": "string"
            }
          ]
        },
        "nodeInitializationTaints": [ "string" ],
        "nodeLabels": {
          "{customized property}": "string"
        },
        "nodePublicIPPrefixID": "string",
        "nodeTaints": [ "string" ],
        "orchestratorVersion": "string",
        "osDiskSizeGB": "int",
        "osDiskType": "string",
        "osSKU": "string",
        "osType": "string",
        "podIPAllocationMode": "string",
        "podSubnetID": "string",
        "powerState": {
          "code": "string"
        },
        "proximityPlacementGroupID": "string",
        "scaleDownMode": "string",
        "scaleSetEvictionPolicy": "string",
        "scaleSetPriority": "string",
        "securityProfile": {
          "enableSecureBoot": "bool",
          "enableVTPM": "bool",
          "sshAccess": "string"
        },
        "spotMaxPrice": "[json('decimal-as-string')]",
        "tags": {},
        "type": "string",
        "upgradeSettings": {
          "drainTimeoutInMinutes": "int",
          "maxSurge": "string",
          "nodeSoakDurationInMinutes": "int"
        },
        "virtualMachineNodesStatus": [
          {
            "count": "int",
            "size": "string"
          }
        ],
        "virtualMachinesProfile": {
          "scale": {
            "manual": [
              {
                "count": "int",
                "sizes": [ "string" ]
              }
            ]
          }
        },
        "vmSize": "string",
        "vnetSubnetID": "string",
        "windowsProfile": {
          "disableOutboundNat": "bool"
        },
        "workloadRuntime": "string"
      }
    ],
    "aiToolchainOperatorProfile": {
      "enabled": "bool"
    },
    "apiServerAccessProfile": {
      "authorizedIPRanges": [ "string" ],
      "disableRunCommand": "bool",
      "enablePrivateCluster": "bool",
      "enablePrivateClusterPublicFQDN": "bool",
      "enableVnetIntegration": "bool",
      "privateDNSZone": "string",
      "subnetId": "string"
    },
    "autoScalerProfile": {
      "balance-similar-node-groups": "string",
      "daemonset-eviction-for-empty-nodes": "bool",
      "daemonset-eviction-for-occupied-nodes": "bool",
      "expander": "string",
      "ignore-daemonsets-utilization": "bool",
      "max-empty-bulk-delete": "string",
      "max-graceful-termination-sec": "string",
      "max-node-provision-time": "string",
      "max-total-unready-percentage": "string",
      "new-pod-scale-up-delay": "string",
      "ok-total-unready-count": "string",
      "scale-down-delay-after-add": "string",
      "scale-down-delay-after-delete": "string",
      "scale-down-delay-after-failure": "string",
      "scale-down-unneeded-time": "string",
      "scale-down-unready-time": "string",
      "scale-down-utilization-threshold": "string",
      "scan-interval": "string",
      "skip-nodes-with-local-storage": "string",
      "skip-nodes-with-system-pods": "string"
    },
    "autoUpgradeProfile": {
      "nodeOSUpgradeChannel": "string",
      "upgradeChannel": "string"
    },
    "azureMonitorProfile": {
      "logs": {
        "appMonitoring": {
          "enabled": "bool"
        },
        "containerInsights": {
          "enabled": "bool",
          "logAnalyticsWorkspaceResourceId": "string",
          "windowsHostLogs": {
            "enabled": "bool"
          }
        }
      },
      "metrics": {
        "appMonitoringOpenTelemetryMetrics": {
          "enabled": "bool"
        },
        "enabled": "bool",
        "kubeStateMetrics": {
          "metricAnnotationsAllowList": "string",
          "metricLabelsAllowlist": "string"
        }
      }
    },
    "bootstrapProfile": {
      "artifactSource": "string",
      "containerRegistryId": "string"
    },
    "creationData": {
      "sourceResourceId": "string"
    },
    "disableLocalAccounts": "bool",
    "diskEncryptionSetID": "string",
    "dnsPrefix": "string",
    "enableNamespaceResources": "bool",
    "enablePodSecurityPolicy": "bool",
    "enableRBAC": "bool",
    "fqdnSubdomain": "string",
    "httpProxyConfig": {
      "httpProxy": "string",
      "httpsProxy": "string",
      "noProxy": [ "string" ],
      "trustedCa": "string"
    },
    "identityProfile": {
      "{customized property}": {
        "clientId": "string",
        "objectId": "string",
        "resourceId": "string"
      }
    },
    "ingressProfile": {
      "webAppRouting": {
        "dnsZoneResourceIds": [ "string" ],
        "enabled": "bool"
      }
    },
    "kubernetesVersion": "string",
    "linuxProfile": {
      "adminUsername": "string",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "string"
          }
        ]
      }
    },
    "metricsProfile": {
      "costAnalysis": {
        "enabled": "bool"
      }
    },
    "networkProfile": {
      "dnsServiceIP": "string",
      "ipFamilies": [ "string" ],
      "kubeProxyConfig": {
        "enabled": "bool",
        "ipvsConfig": {
          "scheduler": "string",
          "tcpFinTimeoutSeconds": "int",
          "tcpTimeoutSeconds": "int",
          "udpTimeoutSeconds": "int"
        },
        "mode": "string"
      },
      "loadBalancerProfile": {
        "allocatedOutboundPorts": "int",
        "backendPoolType": "string",
        "effectiveOutboundIPs": [
          {
            "id": "string"
          }
        ],
        "enableMultipleStandardLoadBalancers": "bool",
        "idleTimeoutInMinutes": "int",
        "managedOutboundIPs": {
          "count": "int",
          "countIPv6": "int"
        },
        "outboundIPPrefixes": {
          "publicIPPrefixes": [
            {
              "id": "string"
            }
          ]
        },
        "outboundIPs": {
          "publicIPs": [
            {
              "id": "string"
            }
          ]
        }
      },
      "loadBalancerSku": "string",
      "monitoring": {
        "enabled": "bool"
      },
      "natGatewayProfile": {
        "effectiveOutboundIPs": [
          {
            "id": "string"
          }
        ],
        "idleTimeoutInMinutes": "int",
        "managedOutboundIPProfile": {
          "count": "int"
        }
      },
      "networkDataplane": "string",
      "networkMode": "string",
      "networkPlugin": "string",
      "networkPluginMode": "overlay",
      "networkPolicy": "string",
      "outboundType": "string",
      "podCidr": "string",
      "podCidrs": [ "string" ],
      "serviceCidr": "string",
      "serviceCidrs": [ "string" ]
    },
    "nodeProvisioningProfile": {
      "mode": "string"
    },
    "nodeResourceGroup": "string",
    "nodeResourceGroupProfile": {
      "restrictionLevel": "string"
    },
    "oidcIssuerProfile": {
      "enabled": "bool"
    },
    "podIdentityProfile": {
      "allowNetworkPluginKubenet": "bool",
      "enabled": "bool",
      "userAssignedIdentities": [
        {
          "bindingSelector": "string",
          "identity": {
            "clientId": "string",
            "objectId": "string",
            "resourceId": "string"
          },
          "name": "string",
          "namespace": "string"
        }
      ],
      "userAssignedIdentityExceptions": [
        {
          "name": "string",
          "namespace": "string",
          "podLabels": {
            "{customized property}": "string"
          }
        }
      ]
    },
    "privateLinkResources": [
      {
        "groupId": "string",
        "id": "string",
        "name": "string",
        "requiredMembers": [ "string" ],
        "type": "string"
      }
    ],
    "publicNetworkAccess": "string",
    "safeguardsProfile": {
      "excludedNamespaces": [ "string" ],
      "level": "string",
      "version": "string"
    },
    "securityProfile": {
      "azureKeyVaultKms": {
        "enabled": "bool",
        "keyId": "string",
        "keyVaultNetworkAccess": "string",
        "keyVaultResourceId": "string"
      },
      "customCATrustCertificates": [ object ],
      "defender": {
        "logAnalyticsWorkspaceResourceId": "string",
        "securityMonitoring": {
          "enabled": "bool"
        }
      },
      "imageCleaner": {
        "enabled": "bool",
        "intervalHours": "int"
      },
      "imageIntegrity": {
        "enabled": "bool"
      },
      "nodeRestriction": {
        "enabled": "bool"
      },
      "workloadIdentity": {
        "enabled": "bool"
      }
    },
    "serviceMeshProfile": {
      "istio": {
        "certificateAuthority": {
          "plugin": {
            "certChainObjectName": "string",
            "certObjectName": "string",
            "keyObjectName": "string",
            "keyVaultId": "string",
            "rootCertObjectName": "string"
          }
        },
        "components": {
          "egressGateways": [
            {
              "enabled": "bool",
              "nodeSelector": {
                "{customized property}": "string"
              }
            }
          ],
          "ingressGateways": [
            {
              "enabled": "bool",
              "mode": "string"
            }
          ]
        },
        "revisions": [ "string" ]
      },
      "mode": "string"
    },
    "servicePrincipalProfile": {
      "clientId": "string",
      "secret": "string"
    },
    "storageProfile": {
      "blobCSIDriver": {
        "enabled": "bool"
      },
      "diskCSIDriver": {
        "enabled": "bool",
        "version": "string"
      },
      "fileCSIDriver": {
        "enabled": "bool"
      },
      "snapshotController": {
        "enabled": "bool"
      }
    },
    "supportPlan": "string",
    "upgradeSettings": {
      "overrideSettings": {
        "forceUpgrade": "bool",
        "until": "string"
      }
    },
    "windowsProfile": {
      "adminPassword": "string",
      "adminUsername": "string",
      "enableCSIProxy": "bool",
      "gmsaProfile": {
        "dnsServer": "string",
        "enabled": "bool",
        "rootDomainName": "string"
      },
      "licenseType": "string"
    },
    "workloadAutoScalerProfile": {
      "keda": {
        "enabled": "bool"
      },
      "verticalPodAutoscaler": {
        "addonAutoscaling": "string",
        "enabled": "bool"
      }
    }
  }
}

プロパティ値

managedClusters

名前 説明 値
type リソースの種類 'Microsoft.ContainerService/managedClusters'
apiVersion リソース API のバージョン '2024-01-02-preview'
name リソース名 string (必須)

文字制限: 1 から 63

有効な文字:
英数字、アンダースコア、およびハイフン。

先頭と末尾には英数字を使用します。
location リソースが保存されている地理的な場所 string (必須)
tags リソース タグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku マネージド クラスター SKU。 ManagedClusterSKU
extendedLocation 仮想マシンの拡張された場所。 ExtendedLocation
identity マネージド クラスターの ID (構成されている場合)。 ManagedClusterIdentity
properties マネージド クラスターのプロパティ。 ManagedClusterProperties

ExtendedLocation

名前 説明 値
name 拡張場所の名前。 string
type 拡張場所の型。 'EdgeZone'

ManagedClusterIdentity

名前 説明 値
delegatedResources このマネージド クラスターに割り当てられた委任された ID リソース。 これは別の Azure リソース プロバイダーでのみ設定でき、マネージド クラスターは委任された ID リソースを 1 つだけ受け入れます。 内部使用のみです。 DelegatedResources
型 詳細については、「 AKS でマネージド ID を使用する」を参照してください。 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID である必要があります。 ManagedClusterIdentityUserAssignedIdentities

DelegatedResources

名前 説明 値
{カスタマイズされたプロパティ} DelegatedResource

DelegatedResource

名前 説明 [値]
location ソース リソースの場所 - 内部使用のみ。 string
referralResource 紹介委任の委任 ID (省略可能) - 内部使用のみ。 string
resourceId 委任されたリソースの ARM リソース ID -内部使用のみ。 string
tenantId 委任されたリソースのテナント ID - 内部使用のみ。 string

制約:
最小長 = 36
最大長 = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedClusterIdentityUserAssignedIdentities

名前 説明 値
{カスタマイズされたプロパティ} ManagedServiceIdentityUserAssignedIdentitiesValue

ManagedServiceIdentityUserAssignedIdentitiesValue

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

ManagedClusterProperties

名前 説明 値
aadProfile Azure Active Directory の構成。 ManagedClusterAADProfile
addonProfiles マネージド クラスター アドオンのプロファイル。 ManagedClusterPropertiesAddonProfiles
agentPoolProfiles エージェント プールのプロパティ。 ManagedClusterAgentPoolProfile[]
aiToolchainOperatorProfile クラスター全体に適用される AI ツールチェーン演算子の設定。 ManagedClusterAIToolchainOperatorProfile
apiServerAccessProfile マネージド クラスター API サーバーのアクセス プロファイル。 ManagedClusterAPIServerAccessProfile
autoScalerProfile 有効になっている場合にクラスター オートスケーラーに適用されるパラメーター ManagedClusterPropertiesAutoScalerProfile
autoUpgradeProfile 自動アップグレード構成。 ManagedClusterAutoUpgradeProfile
azureMonitorProfile コンテナー サービス クラスターの Prometheus アドオン プロファイル ManagedClusterAzureMonitorProfile
bootstrapProfile クラスターブートストラップ構成のプロファイル。 ManagedClusterBootstrapProfile
creationData スナップショットを使用してクラスターを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 CreationData
disableLocalAccounts true に設定すると、このクラスターで静的資格情報の取得が無効になります。 これは、AAD が有効になっているマネージド クラスターでのみ使用する必要があります。 詳細については、「 ローカル アカウントを無効にする」を参照してください。 [bool]
diskEncryptionSetID これは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' の形式です。 string
dnsPrefix これは、マネージド クラスターが作成された後は更新できません。 string
enableNamespaceResources 既定値は false です。 マネージド クラスターの作成と更新時に有効または無効にすることができます。 ARM リソースとしての名前空間の詳細については、「」を参照してください https://aka.ms/NamespaceARMResource 。 [bool]
enablePodSecurityPolicy (非推奨)Kubernetes ポッドのセキュリティ ポリシー (プレビュー) を有効にするかどうか。 PodSecurityPolicy は Kubernetes v1.21 で非推奨となり、v1.25 の Kubernetes から削除されました。 詳細については、 と を参照 https://aka.ms/k8s/psp してください。 https://aka.ms/aks/psp. [bool]
enableRBAC Kubernetes Role-Based Access Control を有効にするかどうか。 [bool]
fqdnSubdomain これは、マネージド クラスターが作成された後は更新できません。 string
httpProxyConfig HTTP プロキシ サーバーを使用してクラスターをプロビジョニングするための構成。 ManagedClusterHttpProxyConfig
identityProfile クラスターに関連付けられている ID。 ManagedClusterPropertiesIdentityProfile
ingressProfile マネージド クラスターのイングレス プロファイル。 ManagedClusterIngressProfile
kubernetesVersion サポートされている AKS クラスターをアップグレードする際に、Kubernetes マイナー バージョンをスキップすることはできません。 すべてのアップグレードは、メジャー バージョン番号で順番に実行する必要があります。 たとえば、1.14.x から> 1.15.x または 1.15.x -> 1.16.x の間のアップグレードは許可されますが、1.14.x -> 1.16.x は許可されません。 詳細については 、AKS クラスターのアップグレード に関するページを参照してください。 string
linuxProfile マネージド クラスター内の Linux VM のプロファイル。 ContainerServiceLinuxProfile
metricsProfile オプションのクラスター メトリック構成。 ManagedClusterMetricsProfile
networkProfile ネットワーク構成プロファイル。 ContainerServiceNetworkProfile
nodeProvisioningProfile クラスター全体に適用されるノード プロビジョニング設定。 ManagedClusterNodeProvisioningProfile
nodeResourceGroup エージェント プール ノードを含むリソース グループの名前。 string
nodeResourceGroupProfile ノード リソース グループ構成プロファイル。 ManagedClusterNodeResourceGroupProfile
oidcIssuerProfile マネージド クラスターの OIDC 発行者プロファイル。 ManagedClusterOidcIssuerProfile
podIdentityProfile AAD ポッド ID の統合の詳細については、「AAD ポッド ID の使用」を参照してください。 ManagedClusterPodIdentityProfile
privateLinkResources クラスターに関連付けられているプライベート リンク リソース。 PrivateLinkResource[]
publicNetworkAccess AKS のパブリック ネットワーク アクセスを許可または拒否する 'Disabled'
'Enabled'
'SecuredByPerimeter'
safeguardsProfile セーフガード プロファイルには、特定のクラスターのすべてのセーフガード情報が保持されます SafeguardsProfile
securityProfile マネージド クラスターのセキュリティ プロファイル。 ManagedClusterSecurityProfile
serviceMeshProfile マネージド クラスターのサービス メッシュ プロファイル。 ServiceMeshProfile
servicePrincipalProfile Azure API の操作に使用するクラスターのサービス プリンシパル ID に関する情報。 ManagedClusterServicePrincipalProfile
storageProfile マネージド クラスターのストレージ プロファイル。 ManagedClusterStorageProfile
supportPlan マネージド クラスターのサポート プラン。 指定しない場合、既定値は 'KubernetesOfficial' です。 'AKSLongTermSupport'
'KubernetesOfficial'
upgradeSettings クラスターをアップグレードするための設定。 ClusterUpgradeSettings
windowsProfile マネージド クラスター内の Windows VM のプロファイル。 ManagedClusterWindowsProfile
workloadAutoScalerProfile マネージド クラスターのワークロード自動スケーラー プロファイル。 ManagedClusterWorkloadAutoScalerProfile

ManagedClusterAADProfile

名前 説明 値
adminGroupObjectIDs クラスターの管理者ロールを持つ AAD グループ オブジェクト ID の一覧。 string[]
clientAppID (非推奨)クライアント AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
enableAzureRBAC Kubernetes 承認に対して Azure RBAC を有効にするかどうか。 [bool]
キー管理 マネージド AAD を有効にするかどうか。 [bool]
serverAppID (非推奨)サーバー AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
serverAppSecret (非推奨)サーバー AAD アプリケーション シークレット。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
tenantID 認証に使用する AAD テナント ID。 指定しない場合、 はデプロイ サブスクリプションのテナントを使用します。 string

ManagedClusterPropertiesAddonProfiles

名前 説明 値
{カスタマイズされたプロパティ} ManagedClusterAddonProfile

ManagedClusterAddonProfile

名前 説明 値
config アドオンを構成するためのキーと値のペア。 ManagedClusterAddonProfileConfig
enabled アドオンが有効かどうか。 bool (必須)

ManagedClusterAddonProfileConfig

名前 説明 値
{カスタマイズされたプロパティ} string

ManagedClusterAgentPoolProfile

名前 説明 値
artifactStreamingProfile AKS で成果物ストリーミングを使用するための構成。 AgentPoolArtifactStreamingProfile
availabilityZones ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。 string[]
capacityReservationGroupID AKS は、指定されたエージェント プールを容量予約グループに関連付けます。 string
count Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。 INT
creationData スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 CreationData
enableAutoScaling 自動スケーラーを有効にするかどうか [bool]
enableCustomCATrust true に設定すると、AKS は機能が有効になっていることを示すラベルをノードに追加し、ホスト サービスと共にデーモンセットをデプロイして、ユーザーが指定した base64 でエンコードされた証明書の一覧からノード信頼ストアにカスタム証明機関を同期します。 既定値は false です。 [bool]
enableEncryptionAtHost これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「/azure/aks/enable-host-encryption」を参照してください。 [bool]
enableFIPS 詳細については、「 FIPS 対応ノード プールの追加 」を参照してください。 [bool]
enableNodePublicIP シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオとしては、ゲームのワークロードがあります。この場合、ホップを最小限に抑えるために、コンソールをクラウド仮想マシンに直接接続する必要があります。 詳細については、「 ノードごとにパブリック IP を割り当てる」を参照してください。 既定値は false です。 [bool]
enableUltraSSD UltraSSD を有効にするかどうか [bool]
gpuInstanceProfile サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用する GPUInstanceProfile。 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
gpuProfile エージェント プールの GPU 設定。 AgentPoolGPUProfile
hostGroupID これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName} の形式です。 詳細については、「 Azure 専用ホスト」を参照してください。 string
kubeletConfig エージェント プール ノードの Kubelet 構成。 KubeletConfig
kubeletDiskType emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。 'OS'
'一時'
linuxOSConfig Linux エージェント ノードの OS 構成。 LinuxOSConfig
maxCount 自動スケーリングのノードの最大数 INT
maxPods ノードで実行できるポッドの最大数。 INT
messageOfTheDay デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードに対するその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。 string
minCount 自動スケーリング用のノードの最小数 INT
mode クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、「/azure/aks/use-system-pools」を参照してください。 'System'
'User'
name Windows エージェント プール名は 6 文字以下にする必要があります。 string (必須)

制約:
Pattern = ^[a-z][a-z0-9]{0,11}$
networkProfile エージェント プールのネットワーク関連の設定。 AgentPoolNetworkProfile
nodeInitializationTaints これらのテイントは AKS によって調整されず、kubectl 呼び出しで削除できます。 このフィールドはノード プールの作成後に変更できますが、再作成を必要とする別の操作 (ノード イメージのアップグレードなど) が発生するまで、ノードは新しいテイントで再作成されません。 これらのテイントを使用すると、ノードがワークロードを受け入れる準備が整う前に必要な構成を実行できます。たとえば、'key1=value1:NoSchedule' を使用して削除できます kubectl taint nodes node1 key1=value1:NoSchedule- string[]
nodeLabels エージェント プール内のすべてのノードにわたって永続化されるノード ラベル。 ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。 string
nodeTaints ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。 string[]
orchestratorVersion パッチ バージョン {major.minor.patch} と {major.minor} の両方がサポートされています。 {major.minor} を指定すると、サポートされている最新のパッチ バージョンが自動的に選択されます。 エージェント プールを作成後に同じ {major.minor} で更新しても、新しいパッチ バージョンが使用可能であっても、アップグレードはトリガーされません。 AKS クラスター内のノード プールは、すべて同じ Kubernetes のバージョンにアップグレードするのがベスト プラクティスです。 ノード プールのバージョンは、コントロール プレーンと同じメジャー バージョンである必要があります。 ノード プールの "マイナー" バージョンは、コントロール プレーンのバージョンの 2 つ以内の "マイナー" バージョンでなければなりません。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳細については、「 ノード プールのアップグレード」を参照してください。 string
osDiskSizeGB マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定した vmSize に従って既定の osDisk サイズが適用されます。 INT

制約:
最小値 = 0
最大値 = 2048
osDiskType VM でサポートされ、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後は変更できない場合があります。 詳細については、「 エフェメラル OS」を参照してください。 'エフェメラル'
'Managed'
osSKU エージェント プールで使用される OS SKU を指定します。 指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。 既定の Windows OSSKU は、Windows2019 が非推奨になった後に Windows2022 に変更されます。 'AzureLinux'
'CBLMariner'
'Mariner'
'Ubuntu'
'Windows2019'
'Windows2022'
'WindowsAnnual'
osType オペレーティング システムの種類。 既定値は Linux です。 'Linux'
'Windows'
podIPAllocationMode エージェント プール内のポッドの IP 割り当てモード。 podSubnetId と共に使用する必要があります。 既定値は "DynamicIndividual" です。 'DynamicIndividual'
'StaticBlock'
podSubnetID 省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、「vnetSubnetID」を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 string
powerState エージェント プールが最初に作成されると、最初は実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールは、実行中でプロビジョニング状態が [成功] の場合にのみ停止できます PowerState
proximityPlacementGroupID 近接配置グループの ID。 string
scaleDownMode これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合、既定では Delete になります。 '割り当て解除'
'Delete'
scaleSetEvictionPolicy scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。 '割り当て解除'
'Delete'
scaleSetPriority 仮想マシン スケール セットの優先度。 指定しない場合、既定値は 'Regular' です。 'Regular'
'Spot'
securityProfile エージェント プールのセキュリティ設定。 AgentPoolSecurityProfile
spotMaxPrice 使用できる値は、0 より大きい 10 進値または -1 です。これは、オンデマンド価格を支払う意欲を示します。 スポット価格の詳細については、「 スポット VM の価格 」を参照してください。10 進値を指定するには、 json() 関数を使用します。 int または json decimal
tags エージェント プール仮想マシン スケール セットに永続化するタグ。 object
型 エージェント プールの種類。 'AvailabilitySet'
'VirtualMachineScaleSets'
'VirtualMachines'
upgradeSettings エージェント プールをアップグレードするための設定 AgentPoolUpgradeSettings
virtualMachineNodesStatus VirtualMachines エージェント プール内のノードの状態。 VirtualMachineNodes[]
virtualMachinesProfile VirtualMachines エージェント プールの仕様。 VirtualMachinesProfile
vmSize VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、CPU など) が含まれていると、ポッドが正しく実行されない可能性があります。 制限付き VM サイズの詳細については、「/azure/aks/quotas-skus-regions」を参照してください。 string
vnetSubnetID これを指定しない場合は、VNET とサブネットが生成され、使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 string
windowsProfile Windows エージェント プールの特定のプロファイル。 AgentPoolWindowsProfile
workloadRuntime ノードで実行できるワークロードの種類を決定します。 'KataMshvVmIsolation'
'OCIContainer'
'WasmWasi'

AgentPoolArtifactStreamingProfile

名前 説明 値
enabled 成果物ストリーミングは、オンデマンドのイメージ読み込みを通じて、ノード上のコンテナーのコールド スタートを高速化します。 この機能を使用するには、コンテナー イメージで ACR での成果物ストリーミングも有効にする必要があります。 指定しない場合、既定値は false です。 [bool]

CreationData

名前 説明 値
sourceResourceId これは、ターゲット オブジェクトの作成に使用されるソース オブジェクトの ARM ID です。 string

AgentPoolGPUProfile

名前 説明 値
installGPUDriver エージェント プールの vmSize に GPU が含まれている場合は既定値は true、それ以外の場合は false です。 GPU ドライバーのインストールは、VM に GPU リソースが関連付けられている場合にのみ true に設定できます。 このフィールドを false に設定すると、GPU ドライバーの自動インストールが防止されます。 その場合、GPU を使用できるようにするには、ユーザーが GPU ドライバーのインストールを自分で実行する必要があります。 [bool]

KubeletConfig

名前 説明 値
allowedUnsafeSysctls 安全でない sysctls または安全でない sysctl パターンの一覧を許可します (末尾 *は )。 string[]
containerLogMaxFiles コンテナーに表示できるコンテナー ログ ファイルの最大数。 数値は 2 ≥する必要があります。 INT

制約:
最小値 = 2
containerLogMaxSizeMB コンテナー ログ ファイルがローテーションされる前の最大サイズ (10Mi など)。 INT
cpuCfsQuota 既定値は true です。 [bool]
cpuCfsQuotaPeriod 既定値は '100 ミリ秒' です。 有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。 たとえば、'300ms'、'2h45m' などです。 サポートされているユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。 string
cpuManagerPolicy 既定値は 'none' です。 詳細については、「 Kubernetes CPU 管理ポリシー 」を参照してください。 使用できる値は、'none' と 'static' です。 string
failSwapOn true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。 [bool]
imageGcHighThreshold イメージ ガベージ コレクションを無効にするには、100 に設定します。 既定値は 85% です INT
imageGcLowThreshold imageGcHighThreshold より高く設定することはできません。 既定値は 80% です INT
podMaxPids ポッドあたりのプロセスの最大数。 INT
topologyManagerPolicy 詳細については、「 Kubernetes Topology Manager」を参照してください。 既定値は 'none' です。 使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。 string

LinuxOSConfig

名前 説明 値
swapFileSizeMB 各ノードに作成されるスワップ ファイルのサイズ (MB)。 INT
sysctls Linux エージェント ノードの Sysctl 設定。 SysctlConfig
transparentHugePageDefrag 有効な値は、'always'、'defer'、'defer+madvise'、'madvise'、および 'never' です。 既定値は 'madvise' です。 詳細については、「 Transparent Hugepages」を参照してください。 string
transparentHugePageEnabled 有効な値は、'always'、'madvise'、および 'never' です。 既定値は 'always' です。 詳細については、「 Transparent Hugepages」を参照してください。 string

SysctlConfig

名前 説明 値
fsAioMaxNr Sysctl setting fs.aio-max-nr. INT
fsFileMax Sysctl setting fs.file-max. INT
fsInotifyMaxUserWatches sysctl setting fs.inotify.max_user_watches. INT
fsNrOpen Sysctl の設定fs.nr_open。 INT
kernelThreadsMax sysctl setting kernel.threads-max. INT
netCoreNetdevMaxBacklog Sysctl の設定net.core.netdev_max_backlog。 INT
netCoreOptmemMax Sysctl の設定net.core.optmem_max。 INT
netCoreRmemDefault Sysctl の設定net.core.rmem_default。 INT
netCoreRmemMax Sysctl の設定net.core.rmem_max。 INT
netCoreSomaxconn net.core.somaxconn を設定する Sysctl。 INT
netCoreWmemDefault Sysctl 設定net.core.wmem_default。 INT
netCoreWmemMax Sysctl の設定net.core.wmem_max。 INT
netIpv4IpLocalPortRange Sysctl の設定net.ipv4.ip_local_port_range。 string
netIpv4NeighDefaultGcThresh1 Sysctl の設定net.ipv4.neigh.default.gc_thresh1。 INT
netIpv4NeighDefaultGcThresh2 Sysctl の設定net.ipv4.neigh.default.gc_thresh2。 INT
netIpv4NeighDefaultGcThresh3 Sysctl の設定net.ipv4.neigh.default.gc_thresh3。 INT
netIpv4TcpFinTimeout Sysctl 設定net.ipv4.tcp_fin_timeout。 INT
netIpv4TcpkeepaliveIntvl Sysctl 設定net.ipv4.tcp_keepalive_intvl。 INT

制約:
最小値 = 10
最大値 = 90
netIpv4TcpKeepaliveProbes Sysctl 設定net.ipv4.tcp_keepalive_probes。 INT
netIpv4TcpKeepaliveTime Sysctl 設定net.ipv4.tcp_keepalive_time。 INT
netIpv4TcpMaxSynBacklog Sysctl 設定net.ipv4.tcp_max_syn_backlog。 INT
netIpv4TcpMaxTwBuckets Sysctl 設定net.ipv4.tcp_max_tw_buckets。 INT
netIpv4TcpTwReuse Sysctl 設定net.ipv4.tcp_tw_reuse。 [bool]
netNetfilterNfConntrackBuckets Sysctl 設定net.netfilter.nf_conntrack_buckets。 INT

制約:
最小値 = 65536
最大値 = 524288
netNetfilterNfConntrackMax Sysctl 設定net.netfilter.nf_conntrack_max。 INT

制約:
最小値 = 131072
最大値 = 2097152
vmMaxMapCount Sysctl 設定vm.max_map_count です。 INT
vmSwappiness Sysctl 設定 vm.swappiness。 INT
vmVfsCachePressure Sysctl 設定vm.vfs_cache_pressure。 INT

AgentPoolNetworkProfile

名前 説明 値
allowedHostPorts アクセスが許可されているポート範囲。 指定された範囲は重複することが許可されます。 PortRange[]
applicationSecurityGroups エージェント プールの作成時に関連付けるアプリケーション セキュリティ グループの ID。 string[]
nodePublicIPTags インスタンス レベルのパブリック IP の IP タグ。 IPTag[]

PortRange

名前 説明 値
portEnd 範囲に含まれる最大ポート。 範囲は 1 から 65535 で、portStart 以上である必要があります。 INT

制約:
最小値 = 1
最大値 = 65535
portStart 範囲に含まれる最小ポート。 範囲は 1 から 65535 で、portEnd 以下である必要があります。 INT

制約:
最小値 = 1
最大値 = 65535
protocol ポートのネットワーク プロトコル。 'TCP'
'UDP'

IPTag

名前 説明 値
ipTagType IP タグの種類。 例: RoutingPreference。 string
タグ パブリック IP に関連付けられている IP タグの値。 例: インターネット。 string

ManagedClusterAgentPoolProfilePropertiesNodeLabels

名前 説明 値
{カスタマイズされたプロパティ} string

PowerState

名前 説明 値
code クラスターが実行中か停止かを示します 'Running'
'Stopped'

AgentPoolSecurityProfile

名前 説明 値
enableSecureBoot セキュア ブートは、署名されたオペレーティング システムとドライバーのみが起動できるようにするトラステッド起動の機能です。 詳細については、「aka.ms/aks/trustedlaunch」を参照してください。 指定しない場合、既定値は false です。 [bool]
enableVTPM vTPM は、ノード上でローカルに保持されているキーと測定用に専用のセキュリティで保護されたコンテナーを構成するためのトラステッド起動機能です。 詳細については、「aka.ms/aks/trustedlaunch」を参照してください。 指定しない場合、既定値は false です。 [bool]
sshAccess エージェント プールの SSH アクセス方法。 'Disabled'
'LocalUser'

AgentPoolUpgradeSettings

名前 説明 値
drainTimeoutInMinutes ポッドの削除とノードごとの正常終了を待機する時間 (分単位)。 この削除待機時間は、ポッドの中断予算での待機を優先します。 この時間を超えると、アップグレードは失敗します。 指定しない場合、既定値は 30 分です。 INT

制約:
最小値 = 1
最大値 = 1440
maxSurge これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定した場合は、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージです。 パーセンテージの場合、小数ノードは切り上げられます。 指定しない場合は、1 が既定値です。 ベスト プラクティスを含む詳細については、「/azure/aks/upgrade-cluster#customize-node-surge-upgrade」を参照してください。 string
nodeSoakDurationInMinutes ノードをドレインした後、再イメージ化して次のノードに進む前に待機する時間 (分単位)。 指定しない場合、既定値は 0 分です。 INT

制約:
最小値 = 0
最大値 = 30

VirtualMachineNodes

名前 説明 値
count ノードの数。 INT
size このノード グループをホストするために使用されるエージェントの VM サイズ。 string

VirtualMachinesProfile

名前 説明 値
scale VirtualMachines エージェント プールのスケーリング方法に関する仕様。 ScaleProfile

ScaleProfile

名前 説明 値
manual VirtualMachines エージェント プールを固定サイズにスケーリングする方法に関する仕様。 ManualScaleProfile[]

ManualScaleProfile

名前 説明 値
count ノードの数。 INT

制約:
最小値 = 0
最大値 = 1000
サイズ 許可されている VM サイズの一覧。 AKS では、スケーリング時に最初に使用可能なものが使用されます。 VM のサイズが使用できない場合 (クォータやリージョンの容量の理由など)、AKS は次のサイズを使用します。 string[]

AgentPoolWindowsProfile

名前 説明 値
disableOutboundNat 既定値は false です。 アウトバウンド NAT は、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェント プールでノード パブリック IP が有効になっていない場合にのみ無効にすることができます。 [bool]

ManagedClusterAIToolchainOperatorProfile

名前 説明 値
enabled AI ツールチェーン演算子が有効かどうかを示します。 [bool]

ManagedClusterAPIServerAccessProfile

名前 説明 値
authorizedIPRanges IP 範囲は CIDR 形式で指定されます (例: 137.117.106.88/29)。 この機能は、ノードあたりのパブリック IP を使用するクラスター、または Basic Load Balancerを使用しているクラスターとは互換性がありません。 詳細については、 API サーバーの承認された IP 範囲に関するページを参照してください。 string[]
disableRunCommand クラスターの実行コマンドを無効にするかどうか。 [bool]
enablePrivateCluster 詳細については、「 プライベート AKS クラスターの作成」を参照してください。 [bool]
enablePrivateClusterPublicFQDN プライベート クラスター用に追加のパブリック FQDN を作成するかどうか。 [bool]
enableVnetIntegration クラスターの apiserver vnet 統合を有効にするかどうか。 [bool]
privateDNSZone 既定値は [システム] です。 詳細については、「 プライベート DNS ゾーンを構成する」を参照してください。 使用できる値は、'system' と 'none' です。 string
subnetId これは、次の場合に必要です: 1。 BYO Vnet を使用して新しいクラスターを作成する。2. 既存のクラスターを更新して apiserver vnet 統合を有効にする。 string

ManagedClusterPropertiesAutoScalerProfile

名前 説明 値
balance-similar-node-groups 有効な値は 'true' と 'false' です string
daemonset-eviction-for-empty-nodes true に設定すると、ノードを削除する前に、空のノード上のすべてのデーモンセット ポッドが削除されます。 デーモンセット ポッドを削除できない場合は、スケーリングのために別のノードが選択されます。 false に設定すると、デーモンセット ポッドが確実に削除または削除されることなく、ノードが削除されます。 [bool]
daemonset-eviction-for-occupied-nodes true に設定すると、ノードが削除される前に、占有ノード上のすべてのデーモンセット ポッドが削除されます。 デーモンセット ポッドを削除できない場合は、スケーリングのために別のノードが選択されます。 false に設定すると、デーモンセット ポッドが確実に削除または削除されることなく、ノードが削除されます。 [bool]
expander 使用可能な値は、'最小廃棄物'、'most-pods'、'priority'、'random' です。 '最小廃棄物'
'most-pods'
'priority'
'random'
ignore-daemonsets-utilization true に設定すると、スケールダウンの決定を行うときに、daemonset によって使用されるリソースが考慮されます。 [bool]
max-empty-bulk-delete 既定値は 10 です。 string
max-graceful-termination-sec 既定値は 600 です。 string
max-node-provision-time 既定値は '15m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
max-total-unready-percentage 既定値は 45 です。 最大値は 100、最小値は 0 です。 string
new-pod-scale-up-delay バーストまたはバッチ スケールのように、Kubernetes スケジューラによってすべてのポッドがスケジュールされる前に CA を動作させたくないシナリオの場合、一定の期間に達する前のスケジュールされていないポッドを無視するように CA に指示できます。 既定値は '0s' です。 値は整数の後に単位 (秒の場合は 's'、分の場合は 'm'、時間の場合は 'h') である必要があります。 string
ok-total-unready-count これは整数である必要があります。 既定値は 3 です。 string
scale-down-delay-after-add 既定値は '10m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-delay-after-delete 既定値はスキャン間隔です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-delay-after-failure 既定値は '3m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-unneeded-time 既定値は '10m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-unready-time 既定値は '20m' です。 値は整数の後に 'm' を続ける必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-utilization-threshold 既定値は '0.5' です。 string
scan-interval 既定値は '10' です。 値は整数値である必要があります。 string
skip-nodes-with-local-storage 既定値は true です。 string
skip-nodes-with-system-pods 既定値は true です。 string

ManagedClusterAutoUpgradeProfile

名前 説明 値
nodeOSUpgradeChannel 既定値は [アンマネージド] ですが、GA で NodeImage または SecurityPatch のいずれかに変更される場合があります。 'NodeImage'
'None'
'SecurityPatch'
'アンマネージド'
upgradeChannel 詳細については、 AKS クラスターの自動アップグレード チャネルの設定に関するページを参照してください。 'node-image'
'none'
'patch'
'rapid'
'stable'

ManagedClusterAzureMonitorProfile

名前 説明 値
logs Azure Monitor インフラストラクチャとアプリケーション ログのログ プロファイル。 すぐに使用できる Kubernetes インフラストラクチャ & アプリケーション ログを収集して、Azure Monitor に送信します。 概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileLogs
metrics prometheus サービス アドオンのメトリック プロファイル ManagedClusterAzureMonitorProfileMetrics

ManagedClusterAzureMonitorProfileLogs

名前 説明 値
appMonitoring Kubernetes アプリケーション コンテナーのアプリケーション監視プロファイル。 Azure Monitor OpenTelemetry ベースの SDK を使用して、アプリケーションの自動インストルメンテーションを通じてアプリケーション ログ、メトリック、トレースを収集します。 概要については、「aka.ms/AzureMonitorApplicationMonitoring」を参照してください。 ManagedClusterAzureMonitorProfileAppMonitoring
containerInsights Kubernetes イベント、インベントリ、コンテナー stdout & stderr ログなどの Azure Monitor Container Insights プロファイル。概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileContainerInsights

ManagedClusterAzureMonitorProfileAppMonitoring

名前 説明 値
enabled アプリケーション監視が有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileContainerInsights

名前 説明 値
enabled Azure Monitor Container Insights ログ アドオンが有効かどうかを示します。 [bool]
logAnalyticsWorkspaceResourceId Azure Monitor Container Insights ログを格納するための Azure Log Analytics ワークスペースの完全修飾 ARM リソース ID。 string
windowsHostLogs Kubernetes Windows ノード ログ コレクションの Windows ホスト ログ プロファイル。 ETW、イベント ログ、テキスト ログなどを収集します。概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileWindowsHostLogs

ManagedClusterAzureMonitorProfileWindowsHostLogs

名前 説明 値
enabled Azure Monitor Container Insights ログ アドオンに対して Windows ホスト ログ収集が有効になっているかどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileMetrics

名前 説明 値
appMonitoringOpenTelemetryMetrics Kubernetes アプリケーション コンテナー メトリックのアプリケーション監視オープン テレメトリ メトリック プロファイル。 Azure Monitor OpenTelemetry ベースの SDK を使用して、アプリケーションの自動インストルメンテーションを使用して OpenTelemetry メトリックを収集します。 概要については、「aka.ms/AzureMonitorApplicationMonitoring」を参照してください。 ManagedClusterAzureMonitorProfileAppMonitoringOpenTe...
enabled Prometheus コレクターを有効にするかどうか bool (必須)
kubeStateMetrics コンテナー サービス クラスターの prometheus アドオン プロファイルの Kube 状態メトリック ManagedClusterAzureMonitorProfileKubeStateMetrics

ManagedClusterAzureMonitorProfileAppMonitoringOpenTe...

名前 説明 値
enabled アプリケーション監視のオープン テレメトリ メトリックが有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileKubeStateMetrics

名前 説明 値
metricAnnotationsAllowList リソースのラベル メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りのリスト。 string
metricLabelsAllowlist リソースのラベル メトリックで使用される Kubernetes 注釈キーのコンマ区切りのリスト。 string

ManagedClusterBootstrapProfile

名前 説明 値
artifactSource 成果物のダウンロード元のソース。 'Cache'
'Direct'
containerRegistryId Azure Container Registryのリソース ID。 レジストリには、プライベート ネットワーク アクセス、Premium SKU、ゾーン冗長性が必要です。 string

ManagedClusterHttpProxyConfig

名前 説明 値
httpProxy 使用する HTTP プロキシ サーバー エンドポイント。 string
httpsProxy 使用する HTTPS プロキシ サーバー エンドポイント。 string
noProxy プロキシを経由しないエンドポイント。 string[]
trustedCa プロキシ サーバーへの接続に使用する代替 CA 証明書。 string

ManagedClusterPropertiesIdentityProfile

名前 説明 値
{カスタマイズされたプロパティ} UserAssignedIdentity

UserAssignedIdentity

名前 説明 値
clientId ユーザー割り当て ID のクライアント ID。 string
objectId ユーザー割り当て ID のオブジェクト ID。 string
resourceId ユーザー割り当て ID のリソース ID。 string

ManagedClusterIngressProfile

名前 説明 値
webAppRouting イングレス プロファイルの Web アプリ ルーティング設定。 ManagedClusterIngressProfileWebAppRouting

ManagedClusterIngressProfileWebAppRouting

名前 説明 値
dnsZoneResourceIds Web アプリ ルーティング アドオンに関連付ける DNS ゾーンのリソース ID。 Web アプリ ルーティングが有効になっている場合にのみ使用されます。 パブリック DNS ゾーンとプライベート DNS ゾーンは異なるリソース グループに含めることができますが、すべてのパブリック DNS ゾーンは同じリソース グループ内にあり、すべてのプライベート DNS ゾーンは同じリソース グループ内に存在する必要があります。 string[]

制約:
最大長 = 5
enabled Web アプリ ルーティングを有効にするかどうか。 [bool]

ContainerServiceLinuxProfile

名前 説明 値
adminUsername Linux VM に使用する管理者ユーザー名。 string (必須)

制約:
Pattern = ^[A-Za-z][-A-Za-z0-9_]*$
ssh Azure で実行されている Linux ベースの VM の SSH 構成。 ContainerServiceSshConfiguration (必須)

ContainerServiceSshConfiguration

名前 説明 値
publicKeys Linux ベースの VM で認証するために使用される SSH 公開キーの一覧。 最大 1 つのキーを指定できます。 ContainerServiceSshPublicKey[] (必須)

ContainerServiceSshPublicKey

名前 説明 値
keyData SSH 経由で VM で認証するために使用される証明書公開キー。 証明書は、ヘッダーの有無にかかわらず PEM 形式である必要があります。 string (必須)

ManagedClusterMetricsProfile

名前 説明 値
costAnalysis クラスターのコスト分析構成 ManagedClusterCostAnalysis

ManagedClusterCostAnalysis

名前 説明 値
enabled この機能を有効にするには、Managed Cluster sku.tier を 'Standard' に設定する必要があります。 これを有効にすると、Kubernetes 名前空間とデプロイの詳細がAzure portalの [コスト分析] ビューに追加されます。 指定しない場合、既定値は false です。 詳細については、「aka.ms/aks/docs/cost-analysis」を参照してください。 [bool]

ContainerServiceNetworkProfile

名前 説明 値
dnsServiceIP Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、serviceCidr で指定された Kubernetes サービス アドレス範囲内にある必要があります。 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]?)$
ipFamilies IP ファミリは、単一スタッククラスターまたはデュアルスタック クラスターを決定するために使用されます。 単一スタックの場合、期待される値は IPv4 です。 デュアルスタックの場合、期待される値は IPv4 と IPv6 です。 次のいずれかを含む文字列配列:
'IPv4'
'IPv6'
kubeProxyConfig kube-proxy の構成のカスタマイズを保持します。 定義されていない値は、kube-proxy の既定の動作を使用します。 {version} が {メジャー バージョン}-{マイナー バージョン} 文字列で表される場所を参照してください https://v{version}.docs.kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/ 。 Kubernetes バージョン 1.23 は '1-23' になります。 ContainerServiceNetworkProfileKubeProxyConfig
loadBalancerProfile クラスター ロード バランサーのプロファイル。 ManagedClusterLoadBalancerProfile
loadBalancerSku 既定値は 'standard' です。 ロード バランサー SKU の違いの詳細については、「Azure Load Balancer SKU」を参照してください。 'basic'
'standard'
監視 このアドオンは、ネットワーク監視を構成し、Prometheus 形式でネットワーク監視データを生成するために使用できます NetworkMonitoring
natGatewayProfile クラスター NAT ゲートウェイのプロファイル。 ManagedClusterNATGatewayProfile
networkDataplane Kubernetes クラスターで使用されるネットワーク データプレーン。 'azure'
'cilium'
networkMode networkPlugin が 'azure' 以外の場合は、これを指定できません。 'bridge'
'transparent'
networkPlugin Kubernetes ネットワークの構築に使用されるネットワーク プラグイン。 'azure'
'kubenet'
'none'
networkPluginMode Kubernetes ネットワークの構築に使用されるネットワーク プラグイン モード。 'overlay'
networkPolicy Kubernetes ネットワークの構築に使用されるネットワーク ポリシー。 'azure'
'calico'
'cilium'
'none'
outboundType これはクラスター作成時にのみ設定でき、後で変更することはできません。 詳細については、「 エグレス送信の種類」を参照してください。 'loadBalancer'
'managedNATGateway'
'userAssignedNATGateway'
'userDefinedRouting'
podCidr Kubenet を使用している場合、ポッド IP を割り当てる CIDR 表記の IP 範囲。 string

制約:
Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
podCidrs 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークには、2 つの CIDR (IP ファミリごとに 1 つ (IPv4/IPv6) が必要です。 string[]
serviceCidr Kubenet を使用している場合、サービス クラスター IP を割り当てる CIDR 表記の IP 範囲。 どのサブネット IP アドレスとも重複していてはなりません。 string

制約:
Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidrs 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークには、2 つの CIDR (IP ファミリごとに 1 つ (IPv4/IPv6) が必要です。 サブネット IP 範囲と重複しないようにする必要があります。 string[]

ContainerServiceNetworkProfileKubeProxyConfig

名前 説明 値
enabled クラスター上の kube-proxy でを有効にするかどうか ('kubeProxyConfig' が存在しない場合、これらのカスタマイズを行わずに kube-proxy が既定で AKS で有効になります)。 [bool]
ipvsConfig IPVS の構成のカスタマイズを保持します。 'mode' が 'IPVS' に設定されている場合にのみ指定できます。 ContainerServiceNetworkProfileKubeProxyConfigIpvsCon...
mode 使用するプロキシ モード ('IPTABLES' または 'IPVS') を指定する 'IPTABLES'
'IPVS'

ContainerServiceNetworkProfileKubeProxyConfigIpvsCon...

名前 説明 値
scheduler IPVS スケジューラの詳細については、以下を参照してください。 http://www.linuxvirtualserver.org/docs/scheduling.html. 'LeastConnection'
'RoundRobin'
tcpFinTimeoutSeconds FIN を受信した後の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT
tcpTimeoutSeconds アイドル状態の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT
udpTimeoutSeconds IPVS UDP パケットに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT

ManagedClusterLoadBalancerProfile

名前 説明 値
allocatedOutboundPorts VM ごとに割り当てられた SNAT ポートの必要な数。 使用できる値は、0 ~ 64000 (含む) の範囲です。 既定値は 0 で、Azure でポートが動的に割り当てられます。 INT

制約:
最小値 = 0
最大値 = 64000
backendPoolType BackendPool Load Balancerマネージド受信の型。 'NodeIP'
'NodeIPConfiguration'
effectiveOutboundIP クラスター ロード バランサーの有効な送信 IP リソース。 ResourceReference[]
enableMultipleStandardLoadBalancers AKS クラスターごとに複数の標準ロード バランサーを有効にするかどうか。 [bool]
idleTimeoutInMinutes 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値は、4 ~ 120 (含む) の範囲です。 既定値は 30 分です。 INT

制約:
最小値 = 4
最大値 = 120
managedOutboundIPs クラスター ロード バランサーに必要なマネージド送信 IP。 ManagedClusterLoadBalancerProfileManagedOutboundIPs
outboundIPPrefixes クラスター ロード バランサーの必要な送信 IP プレフィックス リソース。 ManagedClusterLoadBalancerProfileOutboundIPPrefixes
outboundIP クラスター ロード バランサーに必要な送信 IP リソース。 ManagedClusterLoadBalancerProfileOutboundIPs

ResourceReference

名前 説明 値
id 完全修飾 Azure リソース ID。 string

ManagedClusterLoadBalancerProfileManagedOutboundIPs

名前 説明 値
count クラスター ロード バランサー用に Azure によって作成または管理される IPv4 送信 IP の必要な数。 使用できる値は、1 ~ 100 (含む) の範囲である必要があります。 既定値は 1 です。 INT

制約:
最小値 = 1
最大値 = 100
countIPv6 クラスター ロード バランサー用に Azure によって作成または管理される IPv6 送信 IP の必要な数。 使用できる値は、1 ~ 100 (含む) の範囲である必要があります。 既定値は、単一スタックの場合は 0、デュアル スタックの場合は 1 です。 INT

制約:
最小値 = 0
最大値 = 100

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

名前 説明 値
publicIPPrefixes パブリック IP プレフィックス リソースの一覧。 ResourceReference[]

ManagedClusterLoadBalancerProfileOutboundIPs

名前 説明 値
publicIP パブリック IP リソースの一覧。 ResourceReference[]

NetworkMonitoring

名前 説明 値
enabled クラスターでネットワーク監視プラグインを有効または無効にする [bool]

ManagedClusterNATGatewayProfile

名前 説明 値
effectiveOutboundIPs クラスター NAT ゲートウェイの有効な送信 IP リソース。 ResourceReference[]
idleTimeoutInMinutes 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値は、4 ~ 120 (含む) の範囲です。 既定値は 4 分です。 INT

制約:
最小値 = 4
最大値 = 120
managedOutboundIPProfile クラスター NAT ゲートウェイのマネージド送信 IP リソースのプロファイル。 ManagedClusterManagedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

名前 説明 値
count Azure によって作成または管理される送信 IP の必要な数。 使用できる値は、1 ~ 16 (含む) の範囲である必要があります。 既定値は 1 です。 INT

制約:
最小値 = 1
最大値 = 16

ManagedClusterNodeProvisioningProfile

名前 説明 値
mode 自動に設定したモードを手動に戻すことはできません。 'Auto'
'Manual'

ManagedClusterNodeResourceGroupProfile

名前 説明 値
restrictionLevel クラスターのノード リソース グループに適用される制限レベル 'ReadOnly'
'Unrestricted'

ManagedClusterOidcIssuerProfile

名前 説明 値
enabled OIDC 発行者が有効になっているかどうか。 [bool]

ManagedClusterPodIdentityProfile

名前 説明 値
allowNetworkPluginKubenet Kubenet での実行は、AAD ポッド ID のセキュリティ関連の性質と IP スプーフィングのリスクにより、既定で無効になっています。 詳細については、 AAD ポッド ID での Kubenet ネットワーク プラグインの使用 に関するページを参照してください。 [bool]
enabled ポッド ID アドオンが有効になっているかどうか。 [bool]
userAssignedIdentities クラスターで使用するポッド ID。 ManagedClusterPodIdentity[]
userAssignedIdentityExceptions 許可するポッド ID の例外。 ManagedClusterPodIdentityException[]

ManagedClusterPodIdentity

名前 説明 値
bindingSelector AzureIdentityBinding リソースに使用するバインド セレクター。 string
identity ユーザー割り当て ID の詳細。 UserAssignedIdentity (必須)
name ポッド ID の名前。 string (必須)
namespace ポッド ID の名前空間。 string (必須)

ManagedClusterPodIdentityException

名前 説明 値
name ポッド ID 例外の名前。 string (必須)
namespace ポッド ID 例外の名前空間。 string (必須)
podLabels 一致するポッド ラベル。 ManagedClusterPodIdentityExceptionPodLabels (必須)

ManagedClusterPodIdentityExceptionPodLabels

名前 説明 値
{カスタマイズされたプロパティ} string

PrivateLinkResource

名前 説明 値
groupId リソースのグループ ID。 string
id プライベート リンク リソースの ID。 string
name プライベート リンク リソースの名前。 string
requiredMembers リソースの RequiredMembers string[]
型 リソースの種類。 string

SafeguardsProfile

名前 説明 値
excludedNamespaces セーフガード チェックから除外された名前空間の一覧 string[]
レベル 使用するセーフガード レベル。 既定では、AKS が systemExcludedNamespaces 経由で除外するものを除くすべての名前空間に対してセーフガードが有効になっています '強制'
'Off'
'Warning' (必須)
version 使用する制約のバージョン string

ManagedClusterSecurityProfile

名前 説明 値
azureKeyVaultKms セキュリティ プロファイルの Azure Key Vaultキー管理サービスの設定。 AzureKeyVaultKms
customCATrustCertificates カスタム CA 信頼機能が有効になっているノードの信頼ストアに追加される、最大 10 個の base64 でエンコードされた CA の一覧。 詳細については、「カスタム CA 信頼証明書」を参照してください。 any[]

制約:
最大長 = 10
Defender セキュリティ プロファイルの設定をMicrosoft Defenderします。 ManagedClusterSecurityProfileDefender
imageCleaner セキュリティ プロファイルのイメージ クリーナー設定。 ManagedClusterSecurityProfileImageCleaner
imageIntegrity イメージの整合性は、署名によってイメージの整合性を検証するAzure Policyと連携する機能です。 イメージ署名を適用するためにAzure Policyが適用されていない限り、これは影響しません。 ポリシーを使用してこの機能を使用する方法については、「」を参照してください https://aka.ms/aks/image-integrity 。 ManagedClusterSecurityProfileImageIntegrity
nodeRestriction セキュリティ プロファイルのノード制限設定。 ManagedClusterSecurityProfileNodeRestriction
workloadIdentity セキュリティ プロファイルのワークロード ID 設定。 ワークロード ID を使用すると、Kubernetes アプリケーションは Azure AD を使用して Azure クラウド リソースに安全にアクセスできます。 詳細については、 https://aka.ms/aks/wi をご覧ください。 ManagedClusterSecurityProfileWorkloadIdentity

AzureKeyVaultKms

名前 説明 値
enabled Azure Key Vault キー管理サービスを有効にするかどうか。 既定値は false です。 [bool]
keyId Azure Key Vault キーの識別子。 詳細については、「 キー識別子の形式 」を参照してください。 Azure Key Vault キー管理サービスが有効になっている場合、このフィールドは必須であり、有効なキー識別子である必要があります。 Azure Key Vault キー管理サービスが無効になっている場合は、フィールドを空のままにします。 string
keyVaultNetworkAccess キー コンテナーのネットワーク アクセス。 設定可能な値は、Public および Private です。 Public は、キー コンテナーですべてのネットワークからのパブリック アクセスを許可することを意味します。 Private は、キー コンテナーがパブリック アクセスを無効にし、プライベート リンクを有効にすることを意味します。 既定値は Public です。 'Private'
'Public'
keyVaultResourceId キー コンテナーのリソース ID。 keyVaultNetworkAccess が の場合、 Privateこのフィールドは必須であり、有効なリソース ID である必要があります。 keyVaultNetworkAccess が の場合は Public、フィールドを空のままにします。 string

ManagedClusterSecurityProfileDefender

名前 説明 値
logAnalyticsWorkspaceResourceId Microsoft Defenderに関連付ける Log Analytics ワークスペースのリソース ID。 Microsoft Defenderが有効になっている場合、このフィールドは必須であり、有効なワークスペース リソース ID である必要があります。 Microsoft Defenderが無効になっている場合は、フィールドを空のままにします。 string
securityMonitoring セキュリティ プロファイルのクラウド設定の脅威検出をMicrosoft Defenderします。 ManagedClusterSecurityProfileDefenderSecurityMonitor...

ManagedClusterSecurityProfileDefenderSecurityMonitor...

名前 説明 値
enabled Defender 脅威検出を有効にするかどうか [bool]

ManagedClusterSecurityProfileImageCleaner

名前 説明 値
enabled AKS クラスターで Image Cleaner を有効にするかどうか。 [bool]
intervalHours イメージ クリーナーのスキャン間隔 (時間単位)。 INT

ManagedClusterSecurityProfileImageIntegrity

名前 説明 値
enabled イメージの整合性を有効にするかどうか。 既定値は false です。 [bool]

ManagedClusterSecurityProfileNodeRestriction

名前 説明 値
enabled ノード制限を有効にするかどうか [bool]

ManagedClusterSecurityProfileWorkloadIdentity

名前 説明 値
enabled ワークロード ID を有効にするかどうか。 [bool]

ServiceMeshProfile

名前 説明 値
istio Istio サービス メッシュの構成。 IstioServiceMesh
mode サービス メッシュのモード。 'Disabled'
'Istio' (必須)

IstioServiceMesh

名前 説明 値
certificateAuthority Istio Service Mesh 証明機関 (CA) の構成。 現時点では、こちらの説明に従ってプラグイン証明書のみをサポートしています https://aka.ms/asm-plugin-ca IstioCertificateAuthority
components Istio コンポーネントの構成。 IstioComponents
リビジョン Istio コントロール プレーンのリビジョンの一覧。 アップグレードが進行中でない場合、これは 1 つの値を保持します。 カナリア アップグレードが進行中の場合、2 つの連続する値のみを保持できます。 詳細については、「/azure/aks/istio-upgrade」を参照してください。 string[]

制約:
最大長 = 2

IstioCertificateAuthority

名前 説明 値
plugin Service Mesh のプラグイン証明書情報。 IstioPluginCertificateAuthority

IstioPluginCertificateAuthority

名前 説明 値
certChainObjectName Azure Key Vaultの証明書チェーン オブジェクト名。 string
certObjectName Azure Key Vaultの中間証明書オブジェクト名。 string
keyObjectName Azure Key Vaultの中間証明書秘密キー オブジェクト名。 string
keyVaultId Key Vaultのリソース ID。 string
rootCertObjectName Azure Key Vaultのルート証明書オブジェクト名。 string

IstioComponents

名前 説明 値
egressGateways Istio エグレス ゲートウェイ。 IstioEgressGateway[]
ingressGateways Istio イングレス ゲートウェイ。 IstioIngressGateway[]

IstioEgressGateway

名前 説明 値
enabled エグレス ゲートウェイを有効にするかどうか。 bool (必須)
nodeSelector エグレス ゲートウェイをスケジュールするための NodeSelector。 IstioEgressGatewayNodeSelector

IstioEgressGatewayNodeSelector

名前 説明 値
{カスタマイズされたプロパティ} string

IstioIngressGateway

名前 説明 値
enabled イングレス ゲートウェイを有効にするかどうか。 bool (必須)
mode イングレス ゲートウェイのモード。 'External'
'Internal' (必須)

ManagedClusterServicePrincipalProfile

名前 説明 値
clientId サービス プリンシパルの ID。 string (必須)
secret プレーン テキストでサービス プリンシパルに関連付けられているシークレット パスワード。 string

ManagedClusterStorageProfile

名前 説明 値
blobCSIDriver ストレージ プロファイルの AzureBlob CSI ドライバー設定。 ManagedClusterStorageProfileBlobCSIDriver
diskCSIDriver ストレージ プロファイルの AzureDisk CSI ドライバー設定。 ManagedClusterStorageProfileDiskCSIDriver
fileCSIDriver ストレージ プロファイルの AzureFile CSI ドライバー設定。 ManagedClusterStorageProfileFileCSIDriver
snapshotController ストレージ プロファイルのスナップショット コントローラー設定。 ManagedClusterStorageProfileSnapshotController

ManagedClusterStorageProfileBlobCSIDriver

名前 説明 値
enabled AzureBlob CSI ドライバーを有効にするかどうか。 既定値は false です。 [bool]

ManagedClusterStorageProfileDiskCSIDriver

名前 説明 値
enabled AzureDisk CSI ドライバーを有効にするかどうか。 既定値は、true です。 [bool]
version AzureDisk CSI ドライバーのバージョン。 既定値は v1 です。 string

ManagedClusterStorageProfileFileCSIDriver

名前 説明 値
enabled AzureFile CSI ドライバーを有効にするかどうか。 既定値は、true です。 [bool]

ManagedClusterStorageProfileSnapshotController

名前 説明 値
enabled スナップショット コントローラーを有効にするかどうか。 既定値は、true です。 [bool]

ClusterUpgradeSettings

名前 説明 値
overrideSettings オーバーライドの設定。 UpgradeOverrideSettings

UpgradeOverrideSettings

名前 説明 値
forceUpgrade クラスターを強制的にアップグレードするかどうか。 このオプションは、非推奨の API の使用を確認するなどのアップグレード保護をバイパスするようにアップグレード操作に指示します。 このオプションは注意して有効にしてください。 [bool]
until オーバーライドが有効になるまで。 これはアップグレードの開始時刻にのみ一致し、アップグレードの進行に合わせた有効期限が切れた場合 until でも、アップグレードを開始しても有効性は変わらないことに注意してください。 このフィールドは既定では設定されていません。 オーバーライドを有効にするには、 を設定する必要があります。 string

ManagedClusterWindowsProfile

名前 説明 値
adminPassword 管理者アカウントのパスワードを指定します。

最小長: 8 文字

最大長: 123 文字

複雑さの要件: 以下の 4 つの条件のうち 3 つを満たす必要がある
文字が小さい
上の文字を含む
数字を含む
特殊文字を含む (正規表現の一致 [\W_])

許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!"		 string
adminUsername 管理者アカウントの名前を指定します。

制限： "." で終わることはできません。

許可されていない値: "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 文字		 string (必須)
enableCSIProxy CSI プロキシの詳細については、 CSI プロキシの GitHub リポジトリを参照してください。 [bool]
gmsaProfile マネージド クラスター内の Windows gMSA プロファイル。 WindowsGmsaProfile
licenseType Windows VM に使用するライセンスの種類。 詳細については、「 Azure ハイブリッド ユーザー特典 」を参照してください。 'None'
'Windows_Server'

WindowsGmsaProfile

名前 説明 値
dnsServer Windows gMSA の DNS サーバーを指定します。

マネージド クラスターの作成に使用される vnet で DNS サーバーを構成している場合は、空に設定します。		 string
enabled マネージド クラスターで Windows gMSA を有効にするかどうかを指定します。 [bool]
rootDomainName Windows gMSA のルート ドメイン名を指定します。

マネージド クラスターの作成に使用される vnet で DNS サーバーを構成している場合は、空に設定します。		 string

ManagedClusterWorkloadAutoScalerProfile

名前 説明 値
keda ワークロード 自動スケーラー プロファイルの KEDA (Kubernetes イベント ドリブン自動スケーリング) 設定。 ManagedClusterWorkloadAutoScalerProfileKeda
verticalPodAutoscaler ManagedClusterWorkloadAutoScalerProfileVerticalPodAu...

ManagedClusterWorkloadAutoScalerProfileKeda

名前 説明 値
enabled KEDA を有効にするかどうか。 bool (必須)

ManagedClusterWorkloadAutoScalerProfileVerticalPodAu...

名前 説明 値
addonAutoscaling VPA アドオンが有効で、AKS で管理されるアドオンをスケーリングするように構成されているかどうか。 'Disabled'
'Enabled'
enabled クラスターで VPA アドオンを有効にするかどうか。 既定値は false です。 bool (必須)

ManagedClusterSKU

名前 説明 値
name マネージド クラスター SKU の名前。 'Base'
レベル 指定しない場合、既定値は 'Free' です。 詳細については、 AKS 価格レベル に関するページを参照してください。 'Free'
'Premium'
'Standard'

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
Azure Container Service (AKS) で Jenkins を使用する CI/CD

Azure にデプロイする		 コンテナーにより、アプリケーションの継続的なビルドとデプロイが非常に簡単になります。 Azure Container Service で Kubernetes を使用してこれらのコンテナーのデプロイを調整することで、コンテナーのレプリケート可能で管理可能なクラスターを実現できます。 コンテナー イメージを生成するための継続的ビルドを設定し、オーケストレーションすることで、デプロイのスピードと信頼性を向上させることができます。
Azure Gateway の min.io

Azure にデプロイする		 Blob Storage によってサポートされる S3 準拠ストレージ API を提供するための完全プライベート min.io Azure Gateway デプロイ
NAT ゲートウェイとApplication Gatewayを備えた AKS クラスター

Azure にデプロイする		 このサンプルでは、送信接続用の NAT ゲートウェイと受信接続用のApplication Gatewayを使用して AKS クラスターをデプロイする方法を示します。
プライベート AKS クラスターを作成する

Azure にデプロイする		 このサンプルでは、ジャンプボックス仮想マシンと共に仮想ネットワークにプライベート AKS クラスターを作成する方法を示します。
パブリック DNS ゾーンを使用してプライベート AKS クラスターを作成する

Azure にデプロイする		 このサンプルでは、パブリック DNS ゾーンを使用してプライベート AKS クラスターをデプロイする方法を示します。
マネージド Kubernetes クラスター (AKS) をデプロイする

Azure にデプロイする		 この ARM テンプレートは、高度なネットワーク機能を備えた AKS インスタンスを既存の仮想ネットワークにデプロイする方法を示しています。 さらに、選択したサービス プリンシパルには、AKS クラスターを含むサブネットに対してネットワーク共同作成者ロールが割り当てられます。
AAD (AKS) を使用してマネージド Kubernetes クラスターをデプロイする

Azure にデプロイする		 この ARM テンプレートは、既存の仮想ネットワークと Azure AD Integeration への高度なネットワーク機能を備えた AKS インスタンスのデプロイを示しています。 さらに、選択したサービス プリンシパルには、AKS クラスターを含むサブネットに対してネットワーク共同作成者ロールが割り当てられます。
Azure ML 用の AKS クラスターをデプロイする

Azure にデプロイする		 このテンプレートを使用すると、Azure ML にアタッチできる、アントレプライズ準拠の AKS クラスターをデプロイできます
Azure Container Service (AKS)

Azure にデプロイする		 Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする
Azure Container Service (AKS)

Azure にデプロイする		 Azure Linux コンテナー ホストを使用して Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする
Helm を使用した Azure Container Service (AKS)

Azure にデプロイする		 Helm を使用して Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする
Azure Kubernetes Service (AKS)

Azure にデプロイする		 Azure Kubernetes Service (AKS) を使用してマネージド Kubernetes クラスターをデプロイします
Application Gateway イングレス コントローラーを使用する AKS クラスター

Azure にデプロイする		 このサンプルでは、Application Gateway、Application Gateway イングレス コントローラー、Azure Container Registry、Log Analytics、Key Vaultを使用して AKS クラスターをデプロイする方法を示します

Terraform (AzAPI プロバイダー) リソース定義

managedClusters リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループ

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.ContainerService/managedClusters リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters@2024-01-02-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    delegatedResources = {
      {customized property} = {
        location = "string"
        referralResource = "string"
        resourceId = "string"
        tenantId = "string"
      }
    }
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      aadProfile = {
        adminGroupObjectIDs = [
          "string"
        ]
        clientAppID = "string"
        enableAzureRBAC = bool
        managed = bool
        serverAppID = "string"
        serverAppSecret = "string"
        tenantID = "string"
      }
      addonProfiles = {
        {customized property} = {
          config = {
            {customized property} = "string"
          }
          enabled = bool
        }
      }
      agentPoolProfiles = [
        {
          artifactStreamingProfile = {
            enabled = bool
          }
          availabilityZones = [
            "string"
          ]
          capacityReservationGroupID = "string"
          count = int
          creationData = {
            sourceResourceId = "string"
          }
          enableAutoScaling = bool
          enableCustomCATrust = bool
          enableEncryptionAtHost = bool
          enableFIPS = bool
          enableNodePublicIP = bool
          enableUltraSSD = bool
          gpuInstanceProfile = "string"
          gpuProfile = {
            installGPUDriver = bool
          }
          hostGroupID = "string"
          kubeletConfig = {
            allowedUnsafeSysctls = [
              "string"
            ]
            containerLogMaxFiles = int
            containerLogMaxSizeMB = int
            cpuCfsQuota = bool
            cpuCfsQuotaPeriod = "string"
            cpuManagerPolicy = "string"
            failSwapOn = bool
            imageGcHighThreshold = int
            imageGcLowThreshold = int
            podMaxPids = int
            topologyManagerPolicy = "string"
          }
          kubeletDiskType = "string"
          linuxOSConfig = {
            swapFileSizeMB = int
            sysctls = {
              fsAioMaxNr = int
              fsFileMax = int
              fsInotifyMaxUserWatches = int
              fsNrOpen = int
              kernelThreadsMax = int
              netCoreNetdevMaxBacklog = int
              netCoreOptmemMax = int
              netCoreRmemDefault = int
              netCoreRmemMax = int
              netCoreSomaxconn = int
              netCoreWmemDefault = int
              netCoreWmemMax = int
              netIpv4IpLocalPortRange = "string"
              netIpv4NeighDefaultGcThresh1 = int
              netIpv4NeighDefaultGcThresh2 = int
              netIpv4NeighDefaultGcThresh3 = int
              netIpv4TcpFinTimeout = int
              netIpv4TcpkeepaliveIntvl = int
              netIpv4TcpKeepaliveProbes = int
              netIpv4TcpKeepaliveTime = int
              netIpv4TcpMaxSynBacklog = int
              netIpv4TcpMaxTwBuckets = int
              netIpv4TcpTwReuse = bool
              netNetfilterNfConntrackBuckets = int
              netNetfilterNfConntrackMax = int
              vmMaxMapCount = int
              vmSwappiness = int
              vmVfsCachePressure = int
            }
            transparentHugePageDefrag = "string"
            transparentHugePageEnabled = "string"
          }
          maxCount = int
          maxPods = int
          messageOfTheDay = "string"
          minCount = int
          mode = "string"
          name = "string"
          networkProfile = {
            allowedHostPorts = [
              {
                portEnd = int
                portStart = int
                protocol = "string"
              }
            ]
            applicationSecurityGroups = [
              "string"
            ]
            nodePublicIPTags = [
              {
                ipTagType = "string"
                tag = "string"
              }
            ]
          }
          nodeInitializationTaints = [
            "string"
          ]
          nodeLabels = {
            {customized property} = "string"
          }
          nodePublicIPPrefixID = "string"
          nodeTaints = [
            "string"
          ]
          orchestratorVersion = "string"
          osDiskSizeGB = int
          osDiskType = "string"
          osSKU = "string"
          osType = "string"
          podIPAllocationMode = "string"
          podSubnetID = "string"
          powerState = {
            code = "string"
          }
          proximityPlacementGroupID = "string"
          scaleDownMode = "string"
          scaleSetEvictionPolicy = "string"
          scaleSetPriority = "string"
          securityProfile = {
            enableSecureBoot = bool
            enableVTPM = bool
            sshAccess = "string"
          }
          spotMaxPrice = "decimal-as-string"
          tags = {}
          type = "string"
          upgradeSettings = {
            drainTimeoutInMinutes = int
            maxSurge = "string"
            nodeSoakDurationInMinutes = int
          }
          virtualMachineNodesStatus = [
            {
              count = int
              size = "string"
            }
          ]
          virtualMachinesProfile = {
            scale = {
              manual = [
                {
                  count = int
                  sizes = [
                    "string"
                  ]
                }
              ]
            }
          }
          vmSize = "string"
          vnetSubnetID = "string"
          windowsProfile = {
            disableOutboundNat = bool
          }
          workloadRuntime = "string"
        }
      ]
      aiToolchainOperatorProfile = {
        enabled = bool
      }
      apiServerAccessProfile = {
        authorizedIPRanges = [
          "string"
        ]
        disableRunCommand = bool
        enablePrivateCluster = bool
        enablePrivateClusterPublicFQDN = bool
        enableVnetIntegration = bool
        privateDNSZone = "string"
        subnetId = "string"
      }
      autoScalerProfile = {
        balance-similar-node-groups = "string"
        daemonset-eviction-for-empty-nodes = bool
        daemonset-eviction-for-occupied-nodes = bool
        expander = "string"
        ignore-daemonsets-utilization = bool
        max-empty-bulk-delete = "string"
        max-graceful-termination-sec = "string"
        max-node-provision-time = "string"
        max-total-unready-percentage = "string"
        new-pod-scale-up-delay = "string"
        ok-total-unready-count = "string"
        scale-down-delay-after-add = "string"
        scale-down-delay-after-delete = "string"
        scale-down-delay-after-failure = "string"
        scale-down-unneeded-time = "string"
        scale-down-unready-time = "string"
        scale-down-utilization-threshold = "string"
        scan-interval = "string"
        skip-nodes-with-local-storage = "string"
        skip-nodes-with-system-pods = "string"
      }
      autoUpgradeProfile = {
        nodeOSUpgradeChannel = "string"
        upgradeChannel = "string"
      }
      azureMonitorProfile = {
        logs = {
          appMonitoring = {
            enabled = bool
          }
          containerInsights = {
            enabled = bool
            logAnalyticsWorkspaceResourceId = "string"
            windowsHostLogs = {
              enabled = bool
            }
          }
        }
        metrics = {
          appMonitoringOpenTelemetryMetrics = {
            enabled = bool
          }
          enabled = bool
          kubeStateMetrics = {
            metricAnnotationsAllowList = "string"
            metricLabelsAllowlist = "string"
          }
        }
      }
      bootstrapProfile = {
        artifactSource = "string"
        containerRegistryId = "string"
      }
      creationData = {
        sourceResourceId = "string"
      }
      disableLocalAccounts = bool
      diskEncryptionSetID = "string"
      dnsPrefix = "string"
      enableNamespaceResources = bool
      enablePodSecurityPolicy = bool
      enableRBAC = bool
      fqdnSubdomain = "string"
      httpProxyConfig = {
        httpProxy = "string"
        httpsProxy = "string"
        noProxy = [
          "string"
        ]
        trustedCa = "string"
      }
      identityProfile = {
        {customized property} = {
          clientId = "string"
          objectId = "string"
          resourceId = "string"
        }
      }
      ingressProfile = {
        webAppRouting = {
          dnsZoneResourceIds = [
            "string"
          ]
          enabled = bool
        }
      }
      kubernetesVersion = "string"
      linuxProfile = {
        adminUsername = "string"
        ssh = {
          publicKeys = [
            {
              keyData = "string"
            }
          ]
        }
      }
      metricsProfile = {
        costAnalysis = {
          enabled = bool
        }
      }
      networkProfile = {
        dnsServiceIP = "string"
        ipFamilies = [
          "string"
        ]
        kubeProxyConfig = {
          enabled = bool
          ipvsConfig = {
            scheduler = "string"
            tcpFinTimeoutSeconds = int
            tcpTimeoutSeconds = int
            udpTimeoutSeconds = int
          }
          mode = "string"
        }
        loadBalancerProfile = {
          allocatedOutboundPorts = int
          backendPoolType = "string"
          effectiveOutboundIPs = [
            {
              id = "string"
            }
          ]
          enableMultipleStandardLoadBalancers = bool
          idleTimeoutInMinutes = int
          managedOutboundIPs = {
            count = int
            countIPv6 = int
          }
          outboundIPPrefixes = {
            publicIPPrefixes = [
              {
                id = "string"
              }
            ]
          }
          outboundIPs = {
            publicIPs = [
              {
                id = "string"
              }
            ]
          }
        }
        loadBalancerSku = "string"
        monitoring = {
          enabled = bool
        }
        natGatewayProfile = {
          effectiveOutboundIPs = [
            {
              id = "string"
            }
          ]
          idleTimeoutInMinutes = int
          managedOutboundIPProfile = {
            count = int
          }
        }
        networkDataplane = "string"
        networkMode = "string"
        networkPlugin = "string"
        networkPluginMode = "overlay"
        networkPolicy = "string"
        outboundType = "string"
        podCidr = "string"
        podCidrs = [
          "string"
        ]
        serviceCidr = "string"
        serviceCidrs = [
          "string"
        ]
      }
      nodeProvisioningProfile = {
        mode = "string"
      }
      nodeResourceGroup = "string"
      nodeResourceGroupProfile = {
        restrictionLevel = "string"
      }
      oidcIssuerProfile = {
        enabled = bool
      }
      podIdentityProfile = {
        allowNetworkPluginKubenet = bool
        enabled = bool
        userAssignedIdentities = [
          {
            bindingSelector = "string"
            identity = {
              clientId = "string"
              objectId = "string"
              resourceId = "string"
            }
            name = "string"
            namespace = "string"
          }
        ]
        userAssignedIdentityExceptions = [
          {
            name = "string"
            namespace = "string"
            podLabels = {
              {customized property} = "string"
            }
          }
        ]
      }
      privateLinkResources = [
        {
          groupId = "string"
          id = "string"
          name = "string"
          requiredMembers = [
            "string"
          ]
          type = "string"
        }
      ]
      publicNetworkAccess = "string"
      safeguardsProfile = {
        excludedNamespaces = [
          "string"
        ]
        level = "string"
        version = "string"
      }
      securityProfile = {
        azureKeyVaultKms = {
          enabled = bool
          keyId = "string"
          keyVaultNetworkAccess = "string"
          keyVaultResourceId = "string"
        }
        customCATrustCertificates = [ object ]
        defender = {
          logAnalyticsWorkspaceResourceId = "string"
          securityMonitoring = {
            enabled = bool
          }
        }
        imageCleaner = {
          enabled = bool
          intervalHours = int
        }
        imageIntegrity = {
          enabled = bool
        }
        nodeRestriction = {
          enabled = bool
        }
        workloadIdentity = {
          enabled = bool
        }
      }
      serviceMeshProfile = {
        istio = {
          certificateAuthority = {
            plugin = {
              certChainObjectName = "string"
              certObjectName = "string"
              keyObjectName = "string"
              keyVaultId = "string"
              rootCertObjectName = "string"
            }
          }
          components = {
            egressGateways = [
              {
                enabled = bool
                nodeSelector = {
                  {customized property} = "string"
                }
              }
            ]
            ingressGateways = [
              {
                enabled = bool
                mode = "string"
              }
            ]
          }
          revisions = [
            "string"
          ]
        }
        mode = "string"
      }
      servicePrincipalProfile = {
        clientId = "string"
        secret = "string"
      }
      storageProfile = {
        blobCSIDriver = {
          enabled = bool
        }
        diskCSIDriver = {
          enabled = bool
          version = "string"
        }
        fileCSIDriver = {
          enabled = bool
        }
        snapshotController = {
          enabled = bool
        }
      }
      supportPlan = "string"
      upgradeSettings = {
        overrideSettings = {
          forceUpgrade = bool
          until = "string"
        }
      }
      windowsProfile = {
        adminPassword = "string"
        adminUsername = "string"
        enableCSIProxy = bool
        gmsaProfile = {
          dnsServer = "string"
          enabled = bool
          rootDomainName = "string"
        }
        licenseType = "string"
      }
      workloadAutoScalerProfile = {
        keda = {
          enabled = bool
        }
        verticalPodAutoscaler = {
          addonAutoscaling = "string"
          enabled = bool
        }
      }
    }
    sku = {
      name = "Base"
      tier = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

プロパティ値

managedClusters

名前 説明 値
type リソースの種類 "Microsoft.ContainerService/managedClusters@2024-01-02-preview"
name リソース名 string (必須)

文字数制限: 1 から 63

有効な文字:
英数字、アンダースコア、およびハイフン。

先頭と末尾には英数字を使用します。
location リソースが保存されている地理的な場所 string (必須)
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
tags リソース タグ。 タグ名と値のディクショナリ。
sku マネージド クラスター SKU。 ManagedClusterSKU
extendedLocation 仮想マシンの拡張された場所。 ExtendedLocation
identity マネージド クラスターの ID (構成されている場合)。 ManagedClusterIdentity
properties マネージド クラスターのプロパティ。 ManagedClusterProperties

ExtendedLocation

名前 説明 値
name 拡張場所の名前。 string
type 拡張された場所の型。 "EdgeZone"

ManagedClusterIdentity

名前 説明 値
delegatedResources このマネージド クラスターに割り当てられている委任された ID リソース。 これは、別の Azure リソース プロバイダーでのみ設定でき、マネージド クラスターは 1 つの委任された ID リソースのみを受け入れます。 内部使用のみです。 DelegatedResources
型 詳細については、「 AKS でのマネージド ID の使用」を参照してください。 "SystemAssigned"
"UserAssigned"
identity_ids キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID である必要があります。 ユーザー ID ID の配列。

DelegatedResources

名前 説明 値
{カスタマイズされたプロパティ} DelegatedResource

DelegatedResource

名前 説明 [値]
location ソース リソースの場所 - 内部使用のみ。 string
referralResource 紹介委任の委任 ID (省略可能) - 内部使用のみ。 string
resourceId 委任されたリソースの ARM リソース ID -内部使用のみ。 string
tenantId 委任されたリソースのテナント ID - 内部使用のみ。 string

制約:
最小長 = 36
最大長 = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedClusterIdentityUserAssignedIdentities

名前 説明 値
{カスタマイズされたプロパティ} ManagedServiceIdentityUserAssignedIdentitiesValue

ManagedServiceIdentityUserAssignedIdentitiesValue

このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。

ManagedClusterProperties

名前 説明 値
aadProfile Azure Active Directory の構成。 ManagedClusterAADProfile
addonProfiles マネージド クラスター アドオンのプロファイル。 ManagedClusterPropertiesAddonProfiles
agentPoolProfiles エージェント プールのプロパティ。 ManagedClusterAgentPoolProfile[]
aiToolchainOperatorProfile クラスター全体に適用される AI ツールチェーン演算子の設定。 ManagedClusterAIToolchainOperatorProfile
apiServerAccessProfile マネージド クラスター API サーバーのアクセス プロファイル。 ManagedClusterAPIServerAccessProfile
autoScalerProfile 有効にした場合にクラスター オートスケーラーに適用されるパラメーター ManagedClusterPropertiesAutoScalerProfile
autoUpgradeProfile 自動アップグレード構成。 ManagedClusterAutoUpgradeProfile
azureMonitorProfile コンテナー サービス クラスターの Prometheus アドオン プロファイル ManagedClusterAzureMonitorProfile
bootstrapProfile クラスター ブートストラップ構成のプロファイル。 ManagedClusterBootstrapProfile
creationData クラスターがスナップショットを使用して作成またはアップグレードされる場合に、ソース スナップショット ID を指定するために使用する CreationData。 CreationData
disableLocalAccounts true に設定すると、このクラスターで静的資格情報の取得は無効になります。 これは、AAD が有効になっているマネージド クラスターでのみ使用する必要があります。 詳細については、「 ローカル アカウントを無効にする」を参照してください。 [bool]
diskEncryptionSetID これは次の形式です: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' string
dnsPrefix これは、マネージド クラスターが作成された後は更新できません。 string
enableNamespaceResources 既定値は false です。 マネージド クラスターの作成と更新時に有効または無効にすることができます。 「ARM リソースとしての名前空間」の詳細を参照してください https://aka.ms/NamespaceARMResource 。 [bool]
enablePodSecurityPolicy (非推奨)Kubernetes ポッド セキュリティ ポリシー (プレビュー) を有効にするかどうか。 PodSecurityPolicy は Kubernetes v1.21 で非推奨となり、v1.25 の Kubernetes から削除されました。 詳細については、 と を参照 https://aka.ms/k8s/psp してください。 https://aka.ms/aks/psp. [bool]
enableRBAC Kubernetes Role-Based Access Control を有効にするかどうか。 [bool]
fqdnSubdomain これは、マネージド クラスターが作成された後は更新できません。 string
httpProxyConfig HTTP プロキシ サーバーを使用してクラスターをプロビジョニングするための構成。 ManagedClusterHttpProxyConfig
identityProfile クラスターに関連付けられている ID。 ManagedClusterPropertiesIdentityProfile
ingressProfile マネージド クラスターのイングレス プロファイル。 ManagedClusterIngressProfile
kubernetesVersion サポートされている AKS クラスターをアップグレードする際に、Kubernetes マイナー バージョンをスキップすることはできません。 すべてのアップグレードは、メジャー バージョン番号で順番に実行する必要があります。 たとえば、1.14.x -> 1.15.x または 1.15.x -> 1.16.x の間のアップグレードは許可されますが、1.14.x -> 1.16.x は許可されません。 詳細については、「 AKS クラスターのアップグレード 」を参照してください。 string
linuxProfile マネージド クラスター内の Linux VM のプロファイル。 ContainerServiceLinuxProfile
metricsProfile オプションのクラスター メトリック構成。 ManagedClusterMetricsProfile
networkProfile ネットワーク構成プロファイル。 ContainerServiceNetworkProfile
nodeProvisioningProfile クラスター全体に適用されるノード プロビジョニング設定。 ManagedClusterNodeProvisioningProfile
nodeResourceGroup エージェント プール ノードを含むリソース グループの名前。 string
nodeResourceGroupProfile ノード リソース グループ構成プロファイル。 ManagedClusterNodeResourceGroupProfile
oidcIssuerProfile マネージド クラスターの OIDC 発行者プロファイル。 ManagedClusterOidcIssuerProfile
podIdentityProfile AAD ポッド ID の統合の詳細については、「AAD ポッド ID の使用」を参照してください。 ManagedClusterPodIdentityProfile
privateLinkResources クラスターに関連付けられているプライベート リンク リソース。 PrivateLinkResource[]
publicNetworkAccess AKS のパブリック ネットワーク アクセスを許可または拒否する "無効"
"有効"
"SecuredByPerimeter"
safeguardsProfile セーフガード プロファイルには、特定のクラスターのすべてのセーフガード情報が保持されます SafeguardsProfile
securityProfile マネージド クラスターのセキュリティ プロファイル。 ManagedClusterSecurityProfile
serviceMeshProfile マネージド クラスターのサービス メッシュ プロファイル。 ServiceMeshProfile
servicePrincipalProfile Azure API の操作に使用するクラスターのサービス プリンシパル ID に関する情報。 ManagedClusterServicePrincipalProfile
storageProfile マネージド クラスターのストレージ プロファイル。 ManagedClusterStorageProfile
supportPlan マネージド クラスターのサポート プラン。 指定しない場合、既定値は 'KubernetesOfficial' です。 "AKSLongTermSupport"
"KubernetesOfficial"
upgradeSettings クラスターをアップグレードするための設定。 ClusterUpgradeSettings
windowsProfile マネージド クラスター内の Windows VM のプロファイル。 ManagedClusterWindowsProfile
workloadAutoScalerProfile マネージド クラスターのワークロード自動スケーラー プロファイル。 ManagedClusterWorkloadAutoScalerProfile

ManagedClusterAADProfile

名前 説明 値
adminGroupObjectIDs クラスターの管理者ロールを持つ AAD グループ オブジェクト ID の一覧。 string[]
clientAppID (非推奨)クライアント AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
enableAzureRBAC Kubernetes 承認に対して Azure RBAC を有効にするかどうか。 [bool]
キー管理 マネージド AAD を有効にするかどうか。 [bool]
serverAppID (非推奨)サーバー AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
serverAppSecret (非推奨)サーバー AAD アプリケーション シークレット。 詳細については、https://aka.ms/aks/aad-legacy. を参照してください string
tenantID 認証に使用する AAD テナント ID。 指定しない場合は、デプロイ サブスクリプションのテナントが使用されます。 string

ManagedClusterPropertiesAddonProfiles

名前 説明 値
{カスタマイズされたプロパティ} ManagedClusterAddonProfile

ManagedClusterAddonProfile

名前 説明 値
config アドオンを構成するためのキーと値のペア。 ManagedClusterAddonProfileConfig
enabled アドオンが有効かどうか。 bool (必須)

ManagedClusterAddonProfileConfig

名前 説明 値
{カスタマイズされたプロパティ} string

ManagedClusterAgentPoolProfile

名前 説明 値
artifactStreamingProfile AKS で成果物ストリーミングを使用するための構成。 AgentPoolArtifactStreamingProfile
availabilityZones ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。 string[]
capacityReservationGroupID AKS は、指定されたエージェント プールを容量予約グループに関連付けます。 string
count Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。 INT
creationData スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 CreationData
enableAutoScaling 自動スケーラーを有効にするかどうか [bool]
enableCustomCATrust true に設定すると、AKS は機能が有効になっていることを示すラベルをノードに追加し、ホスト サービスと共にデーモンセットをデプロイして、ユーザーが指定した base64 でエンコードされた証明書の一覧からノード信頼ストアにカスタム証明機関を同期します。 既定値は false です。 [bool]
enableEncryptionAtHost これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「/azure/aks/enable-host-encryption」を参照してください。 [bool]
enableFIPS 詳細については、「 FIPS 対応ノード プールの追加 」を参照してください。 [bool]
enableNodePublicIP シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオとしては、ゲームのワークロードがあります。この場合、ホップを最小限に抑えるために、コンソールをクラウド仮想マシンに直接接続する必要があります。 詳細については、「 ノードごとにパブリック IP を割り当てる」を参照してください。 既定値は false です。 [bool]
enableUltraSSD UltraSSD を有効にするかどうか [bool]
gpuInstanceProfile サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用する GPUInstanceProfile。 "MIG1g"
"MIG2g"
"MIG3g"
"MIG4g"
"MIG7g"
gpuProfile エージェント プールの GPU 設定。 AgentPoolGPUProfile
hostGroupID これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName} の形式です。 詳細については、「 Azure 専用ホスト」を参照してください。 string
kubeletConfig エージェント プール ノードの Kubelet 構成。 KubeletConfig
kubeletDiskType emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。 "OS"
"一時"
linuxOSConfig Linux エージェント ノードの OS 構成。 LinuxOSConfig
maxCount 自動スケーリングのノードの最大数 INT
maxPods ノードで実行できるポッドの最大数。 INT
messageOfTheDay デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードのその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。 string
minCount 自動スケーリング用のノードの最小数 INT
mode クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、「/azure/aks/use-system-pools」を参照してください。 "System"
"User"
name Windows エージェント プール名は 6 文字以下にする必要があります。 string (必須)

制約:
Pattern = ^[a-z][a-z0-9]{0,11}$
networkProfile エージェント プールのネットワーク関連の設定。 AgentPoolNetworkProfile
nodeInitializationTaints これらのテイントは AKS によって調整されず、kubectl 呼び出しで削除できます。 このフィールドはノード プールの作成後に変更できますが、再作成を必要とする別の操作 (ノード イメージのアップグレードなど) が発生するまで、ノードは新しいテイントで再作成されません。 これらのテイントを使用すると、ノードがワークロードを受け入れる準備が整う前に必要な構成を実行できます(例: 'key1=value1:NoSchedule' を使用して削除できます) kubectl taint nodes node1 key1=value1:NoSchedule- string[]
nodeLabels エージェント プール内のすべてのノードにわたって永続化されるノード ラベル。 ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。 string
nodeTaints ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。 string[]
orchestratorVersion パッチ バージョン {major.minor.patch} と {major.minor} の両方がサポートされています。 {major.minor} を指定すると、サポートされている最新のパッチ バージョンが自動的に選択されます。 エージェント プールを作成後に同じ {major.minor} で更新しても、新しいパッチ バージョンが使用可能な場合でも、アップグレードはトリガーされません。 AKS クラスター内のノード プールは、すべて同じ Kubernetes のバージョンにアップグレードするのがベスト プラクティスです。 ノード プールのバージョンは、コントロール プレーンと同じメジャー バージョンである必要があります。 ノード プールの "マイナー" バージョンは、コントロール プレーンのバージョンの 2 つ以内の "マイナー" バージョンでなければなりません。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳細については、 ノード プールのアップグレードに関するページを参照してください。 string
osDiskSizeGB マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。 INT

制約:
最小値 = 0
最大値 = 2048
osDiskType VM でサポートされ、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後は変更できない場合があります。 詳細については、「 エフェメラル OS」を参照してください。 "エフェメラル"
"マネージド"
osSKU エージェント プールで使用される OS SKU を指定します。 指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。 また、Windows 2019 が非推奨になった後、既定の Windows OSSKU は Windows2022 に変更されます。 "AzureLinux"
"CBLMariner"
"Mariner"
"Ubuntu"
"Windows2019"
"Windows2022"
"WindowsAnnual"
osType オペレーティング システムの種類。 既定値は Linux です。 "Linux"
"Windows"
podIPAllocationMode エージェント プール内のポッドの IP 割り当てモード。 podSubnetId と共に使用する必要があります。 既定値は "DynamicIndividual" です。 "DynamicIndividual"
"StaticBlock"
podSubnetID 省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、「vnetSubnetID」を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 string
powerState エージェント プールが最初に作成されたとき、最初は実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールを停止できるのは、エージェント プールが実行中で、プロビジョニング状態が [成功] の場合のみです PowerState
proximityPlacementGroupID 近接配置グループの ID。 string
scaleDownMode これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合、既定では Delete になります。 "割り当て解除"
"削除"
scaleSetEvictionPolicy scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。 "割り当て解除"
"削除"
scaleSetPriority 仮想マシン スケール セットの優先度。 指定しない場合、既定値は 'Regular' です。 "Regular"
"スポット"
securityProfile エージェント プールのセキュリティ設定。 AgentPoolSecurityProfile
spotMaxPrice 使用できる値は、0 より大きい 10 進値または -1 です。これは、オンデマンド価格を支払う意欲を示します。 スポット価格の詳細については、「 スポット VM の価格 文字列として 10 進値を指定する」を参照してください。 int または json decimal
tags エージェント プール仮想マシン スケール セットに永続化するタグ。 object
型 エージェント プールの種類。 "AvailabilitySet"
"VirtualMachineScaleSets"
"VirtualMachines"
upgradeSettings エージェント プールをアップグレードするための設定 AgentPoolUpgradeSettings
virtualMachineNodesStatus VirtualMachines エージェント プール内のノードの状態。 VirtualMachineNodes[]
virtualMachinesProfile VirtualMachines エージェント プールの仕様。 VirtualMachinesProfile
vmSize VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、cpu など) が含まれている場合、ポッドが正しく実行されない可能性があります。 制限付き VM サイズの詳細については、「/azure/aks/quotas-skus-regions」を参照してください。 string
vnetSubnetID これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 string
windowsProfile Windows エージェント プールの特定のプロファイル。 AgentPoolWindowsProfile
workloadRuntime ノードが実行できるワークロードの種類を決定します。 "KataMshvVmIsolation"
"OCIContainer"
"WasmWasi"

AgentPoolArtifactStreamingProfile

名前 説明 値
enabled 成果物ストリーミングは、オンデマンドのイメージ読み込みを通じて、ノード上のコンテナーのコールド スタートを高速化します。 この機能を使用するには、コンテナー イメージで ACR での成果物ストリーミングも有効にする必要があります。 指定しない場合、既定値は false です。 [bool]

CreationData

名前 説明 値
sourceResourceId これは、ターゲット オブジェクトの作成に使用するソース オブジェクトの ARM ID です。 string

AgentPoolGPUProfile

名前 説明 値
installGPUDriver エージェント プールの vmSize に GPU が含まれている場合、既定値は true、それ以外の場合は false です。 GPU ドライバーのインストールは、VM に GPU リソースが関連付けられている場合にのみ true に設定できます。 このフィールドを false に設定すると、GPU ドライバーの自動インストールが防止されます。 その場合、GPU を使用できるようにするには、ユーザーが GPU ドライバーのインストールを自分で実行する必要があります。 [bool]

KubeletConfig

名前 説明 値
allowedUnsafeSysctls 安全でない sysctl または安全でない sysctl パターンの許可された一覧 (で *終わる)。 string[]
containerLogMaxFiles コンテナーに表示できるコンテナー ログ ファイルの最大数。 数値は 2 ≥する必要があります。 INT

制約:
最小値 = 2
containerLogMaxSizeMB コンテナー ログ ファイルがローテーションされる前の最大サイズ (10Mi など)。 INT
cpuCfsQuota 既定値は true です。 [bool]
cpuCfsQuotaPeriod 既定値は '100ms' です。 有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。 たとえば、'300ms'、'2h45m' などです。 サポートされているユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。 string
cpuManagerPolicy 既定値は 'none' です。 詳細については、「 Kubernetes CPU 管理ポリシー 」を参照してください。 使用できる値は、'none' と 'static' です。 string
failSwapOn true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。 [bool]
imageGcHighThreshold イメージ ガベージ コレクションを無効にするには、100 に設定します。 既定値は 85% です INT
imageGcLowThreshold これは imageGcHighThreshold より高く設定できません。 既定値は 80% です INT
podMaxPids ポッドあたりのプロセスの最大数。 INT
topologyManagerPolicy 詳細については、「 Kubernetes Topology Manager」を参照してください。 既定値は 'none' です。 使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。 string

LinuxOSConfig

名前 説明 値
swapFileSizeMB 各ノードに作成されるスワップ ファイルのサイズ (MB)。 INT
sysctls Linux エージェント ノードの Sysctl 設定。 SysctlConfig
transparentHugePageDefrag 有効な値は、'always'、'defer'、'defer+madvise'、'madvise'、および 'never' です。 既定値は 'madvise' です。 詳細については、「 Transparent Hugepages」を参照してください。 string
transparentHugePageEnabled 有効な値は、'always'、'madvise'、および 'never' です。 既定値は 'always' です。 詳細については、「 Transparent Hugepages」を参照してください。 string

SysctlConfig

名前 説明 値
fsAioMaxNr Sysctl setting fs.aio-max-nr. INT
fsFileMax Sysctl setting fs.file-max. INT
fsInotifyMaxUserWatches sysctl setting fs.inotify.max_user_watches. INT
fsNrOpen Sysctl の設定fs.nr_open。 INT
kernelThreadsMax sysctl setting kernel.threads-max. INT
netCoreNetdevMaxBacklog Sysctl の設定net.core.netdev_max_backlog。 INT
netCoreOptmemMax Sysctl の設定net.core.optmem_max。 INT
netCoreRmemDefault Sysctl の設定net.core.rmem_default。 INT
netCoreRmemMax Sysctl の設定net.core.rmem_max。 INT
netCoreSomaxconn net.core.somaxconn を設定する Sysctl。 INT
netCoreWmemDefault Sysctl 設定net.core.wmem_default。 INT
netCoreWmemMax Sysctl の設定net.core.wmem_max。 INT
netIpv4IpLocalPortRange Sysctl の設定net.ipv4.ip_local_port_range。 string
netIpv4NeighDefaultGcThresh1 Sysctl の設定net.ipv4.neigh.default.gc_thresh1。 INT
netIpv4NeighDefaultGcThresh2 Sysctl の設定net.ipv4.neigh.default.gc_thresh2。 INT
netIpv4NeighDefaultGcThresh3 Sysctl の設定net.ipv4.neigh.default.gc_thresh3。 INT
netIpv4TcpFinTimeout Sysctl 設定net.ipv4.tcp_fin_timeout。 INT
netIpv4TcpkeepaliveIntvl Sysctl の設定net.ipv4.tcp_keepalive_intvl。 INT

制約:
最小値 = 10
最大値 = 90
netIpv4TcpKeepaliveProbes Sysctl の設定net.ipv4.tcp_keepalive_probes。 INT
netIpv4TcpKeepaliveTime Sysctl 設定net.ipv4.tcp_keepalive_time。 INT
netIpv4TcpMaxSynBacklog Sysctl の設定net.ipv4.tcp_max_syn_backlog。 INT
netIpv4TcpMaxTwBuckets Sysctl の設定net.ipv4.tcp_max_tw_buckets。 INT
netIpv4TcpTwReuse Sysctl 設定net.ipv4.tcp_tw_reuse。 [bool]
netNetfilterNfConntrackBuckets Sysctl の設定net.netfilter.nf_conntrack_buckets。 INT

制約:
最小値 = 65536
最大値 = 524288
netNetfilterNfConntrackMax Sysctl の設定net.netfilter.nf_conntrack_max。 INT

制約:
最小値 = 131072
最大値 = 2097152
vmMaxMapCount sysctl setting vm.max_map_count. INT
vmSwappiness Sysctl setting vm.swappiness. INT
vmVfsCachePressure Sysctl 設定vm.vfs_cache_pressure。 INT

AgentPoolNetworkProfile

名前 説明 値
allowedHostPorts アクセスが許可されているポート範囲。 指定された範囲は重複することができます。 PortRange[]
applicationSecurityGroups エージェント プールが作成時に関連付けるアプリケーション セキュリティ グループの ID。 string[]
nodePublicIPTags インスタンス レベルのパブリック IP の IP タグ。 IPTag[]

PortRange

名前 説明 値
portEnd 範囲に含まれる最大ポート。 範囲は 1 から 65535 で、portStart 以上である必要があります。 INT

制約:
最小値 = 1
最大値 = 65535
portStart 範囲に含まれる最小ポート。 範囲は 1 から 65535 で、portEnd 以下である必要があります。 INT

制約:
最小値 = 1
最大値 = 65535
protocol ポートのネットワーク プロトコル。 "TCP"
"UDP"

IPTag

名前 説明 値
ipTagType IP タグの種類。 例: RoutingPreference。 string
タグ パブリック IP に関連付けられている IP タグの値。 例: インターネット。 string

ManagedClusterAgentPoolProfilePropertiesNodeLabels

名前 説明 値
{カスタマイズされたプロパティ} string

PowerState

名前 説明 値
code クラスターが実行中か停止かを示します "Running"
"停止しました"

AgentPoolSecurityProfile

名前 説明 値
enableSecureBoot セキュア ブートは、署名されたオペレーティング システムとドライバーのみが起動できるようにするトラステッド起動の機能です。 詳細については、「aka.ms/aks/trustedlaunch」を参照してください。 指定しない場合、既定値は false です。 [bool]
enableVTPM vTPM は、ノード上でローカルに保持されているキーと測定用に専用のセキュリティで保護されたコンテナーを構成するためのトラステッド起動機能です。 詳細については、「aka.ms/aks/trustedlaunch」を参照してください。 指定しない場合、既定値は false です。 [bool]
sshAccess エージェント プールの SSH アクセス方法。 "無効"
"LocalUser"

AgentPoolUpgradeSettings

名前 説明 値
drainTimeoutInMinutes ポッドの削除とノードごとの正常終了を待機する時間 (分単位)。 この削除待機時間は、ポッドの中断予算での待機を優先します。 この時間を超えると、アップグレードは失敗します。 指定しない場合、既定値は 30 分です。 INT

制約:
最小値 = 1
最大値 = 1440
maxSurge これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定した場合は、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージです。 パーセンテージの場合、小数ノードは切り上げられます。 指定しない場合は、1 が既定値です。 ベスト プラクティスを含む詳細については、「/azure/aks/upgrade-cluster#customize-node-surge-upgrade」を参照してください。 string
nodeSoakDurationInMinutes ノードをドレインした後、再イメージ化して次のノードに進む前に待機する時間 (分単位)。 指定しない場合、既定値は 0 分です。 INT

制約:
最小値 = 0
最大値 = 30

VirtualMachineNodes

名前 説明 値
count ノードの数。 INT
size このノード グループをホストするために使用されるエージェントの VM サイズ。 string

VirtualMachinesProfile

名前 説明 値
scale VirtualMachines エージェント プールのスケーリング方法に関する仕様。 ScaleProfile

ScaleProfile

名前 説明 値
manual VirtualMachines エージェント プールを固定サイズにスケーリングする方法に関する仕様。 ManualScaleProfile[]

ManualScaleProfile

名前 説明 値
count ノードの数。 INT

制約:
最小値 = 0
最大値 = 1000
サイズ 許可されている VM サイズの一覧。 AKS では、スケーリング時に最初に使用可能なものが使用されます。 VM のサイズが使用できない場合 (クォータやリージョンの容量の理由など)、AKS は次のサイズを使用します。 string[]

AgentPoolWindowsProfile

名前 説明 値
disableOutboundNat 既定値は false です。 アウトバウンド NAT は、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェント プールでノード パブリック IP が有効になっていない場合にのみ無効にすることができます。 [bool]

ManagedClusterAIToolchainOperatorProfile

名前 説明 値
enabled AI ツールチェーン演算子が有効かどうかを示します。 [bool]

ManagedClusterAPIServerAccessProfile

名前 説明 値
authorizedIPRanges IP 範囲は CIDR 形式で指定されます (例: 137.117.106.88/29)。 この機能は、ノードあたりのパブリック IP を使用するクラスター、または Basic Load Balancerを使用しているクラスターとは互換性がありません。 詳細については、 API サーバーの承認された IP 範囲に関するページを参照してください。 string[]
disableRunCommand クラスターの実行コマンドを無効にするかどうか。 [bool]
enablePrivateCluster 詳細については、「 プライベート AKS クラスターの作成」を参照してください。 [bool]
enablePrivateClusterPublicFQDN プライベート クラスター用に追加のパブリック FQDN を作成するかどうか。 [bool]
enableVnetIntegration クラスターの apiserver vnet 統合を有効にするかどうか。 [bool]
privateDNSZone 既定値は [システム] です。 詳細については、「 プライベート DNS ゾーンを構成する」を参照してください。 使用できる値は、'system' と 'none' です。 string
subnetId これは、次の場合に必要です: 1。 BYO Vnet を使用して新しいクラスターを作成する。2. 既存のクラスターを更新して apiserver vnet 統合を有効にする。 string

ManagedClusterPropertiesAutoScalerProfile

名前 説明 値
balance-similar-node-groups 有効な値は 'true' と 'false' です string
daemonset-eviction-for-empty-nodes true に設定すると、ノードを削除する前に、空のノード上のすべてのデーモンセット ポッドが削除されます。 デーモンセット ポッドを削除できない場合は、スケーリングのために別のノードが選択されます。 false に設定すると、デーモンセット ポッドが確実に削除または削除されることなく、ノードが削除されます。 [bool]
daemonset-eviction-for-occupied-nodes true に設定すると、ノードが削除される前に、占有ノード上のすべてのデーモンセット ポッドが削除されます。 デーモンセット ポッドを削除できない場合は、スケーリングのために別のノードが選択されます。 false に設定すると、デーモンセット ポッドが確実に削除または削除されることなく、ノードが削除されます。 [bool]
expander 使用可能な値は、'最小廃棄物'、'most-pods'、'priority'、'random' です。 "最小廃棄物"
"most-pods"
"priority"
"random"
ignore-daemonsets-utilization true に設定すると、スケールダウンの決定を行うときに、daemonset によって使用されるリソースが考慮されます。 [bool]
max-empty-bulk-delete 既定値は 10 です。 string
max-graceful-termination-sec 既定値は 600 です。 string
max-node-provision-time 既定値は '15m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
max-total-unready-percentage 既定値は 45 です。 最大値は 100、最小値は 0 です。 string
new-pod-scale-up-delay バーストまたはバッチ スケールのように、Kubernetes スケジューラによってすべてのポッドがスケジュールされる前に CA を動作させたくないシナリオの場合、一定の期間に達する前のスケジュールされていないポッドを無視するように CA に指示できます。 既定値は '0s' です。 値は整数の後に単位 (秒の場合は 's'、分の場合は 'm'、時間の場合は 'h') である必要があります。 string
ok-total-unready-count これは整数である必要があります。 既定値は 3 です。 string
scale-down-delay-after-add 既定値は '10m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-delay-after-delete 既定値はスキャン間隔です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-delay-after-failure 既定値は '3m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-unneeded-time 既定値は '10m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-unready-time 既定値は '20m' です。 値は整数の後に 'm' が続く必要があります。 分 (m) 以外の時間の単位はサポートされていません。 string
scale-down-utilization-threshold 既定値は '0.5' です。 string
scan-interval 既定値は '10' です。 値は、秒数の整数である必要があります。 string
skip-nodes-with-local-storage 既定値は true です。 string
skip-nodes-with-system-pods 既定値は true です。 string

ManagedClusterAutoUpgradeProfile

名前 説明 値
nodeOSUpgradeChannel 既定値はアンマネージドですが、GA では NodeImage または SecurityPatch のいずれかに変更される場合があります。 "NodeImage"
"None"
"SecurityPatch"
"アンマネージド"
upgradeChannel 詳細については、「 AKS クラスターの自動アップグレード チャネルの設定」を参照してください。 "node-image"
"none"
"patch"
"rapid"
"安定"

ManagedClusterAzureMonitorProfile

名前 説明 値
logs Azure Monitor インフラストラクチャとアプリケーション ログのログ プロファイル。 すぐに使用できる Kubernetes インフラストラクチャ & アプリケーション ログを収集して、Azure Monitor に送信します。 概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileLogs
metrics prometheus サービス アドオンのメトリック プロファイル ManagedClusterAzureMonitorProfileMetrics

ManagedClusterAzureMonitorProfileLogs

名前 説明 値
appMonitoring Kubernetes アプリケーション コンテナーのアプリケーション監視プロファイル。 Azure Monitor OpenTelemetry ベースの SDK を使用して、アプリケーションの自動インストルメンテーションを使用して、アプリケーション ログ、メトリック、トレースを収集します。 概要については、「aka.ms/AzureMonitorApplicationMonitoring」を参照してください。 ManagedClusterAzureMonitorProfileAppMonitoring
containerInsights Kubernetes イベント、インベントリ、コンテナー stdout & stderr ログなどの Azure Monitor Container Insights プロファイル。概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileContainerInsights

ManagedClusterAzureMonitorProfileAppMonitoring

名前 説明 値
enabled アプリケーション監視が有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileContainerInsights

名前 説明 値
enabled Azure Monitor Container Insights ログ アドオンが有効かどうかを示します。 [bool]
logAnalyticsWorkspaceResourceId Azure Monitor Container Insights ログを格納するための Azure Log Analytics ワークスペースの完全修飾 ARM リソース ID。 string
windowsHostLogs Kubernetes Windows ノードログ収集用の Windows ホスト ログ プロファイル。 ETW、イベント ログ、テキスト ログなどを収集します。概要については、「aka.ms/AzureMonitorContainerInsights」を参照してください。 ManagedClusterAzureMonitorProfileWindowsHostLogs

ManagedClusterAzureMonitorProfileWindowsHostLogs

名前 説明 値
enabled Azure Monitor Container Insights ログ アドオンに対して Windows ホスト ログ収集が有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileMetrics

名前 説明 値
appMonitoringOpenTelemetryMetrics Kubernetes アプリケーション コンテナー メトリックのアプリケーション監視オープン テレメトリ メトリック プロファイル。 Azure Monitor OpenTelemetry ベースの SDK を使用して、アプリケーションの自動インストルメンテーションを使用して OpenTelemetry メトリックを収集します。 概要については、「aka.ms/AzureMonitorApplicationMonitoring」を参照してください。 ManagedClusterAzureMonitorProfileAppMonitoringOpenTe...
enabled Prometheus コレクターを有効にするかどうか bool (必須)
kubeStateMetrics コンテナー サービス クラスターの prometheus アドオン プロファイルの Kube 状態メトリック ManagedClusterAzureMonitorProfileKubeStateMetrics

ManagedClusterAzureMonitorProfileAppMonitoringOpenTe...

名前 説明 値
enabled アプリケーション監視のオープン テレメトリ メトリックが有効かどうかを示します。 [bool]

ManagedClusterAzureMonitorProfileKubeStateMetrics

名前 説明 値
metricAnnotationsAllowList リソースのラベル メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りのリスト。 string
metricLabelsAllowlist リソースのラベル メトリックで使用される Kubernetes 注釈キーのコンマ区切りのリスト。 string

ManagedClusterBootstrapProfile

名前 説明 値
artifactSource 成果物のダウンロード元のソース。 "キャッシュ"
"Direct"
containerRegistryId Azure Container Registryのリソース ID。 レジストリには、プライベート ネットワーク アクセス、Premium SKU、ゾーン冗長性が必要です。 string

ManagedClusterHttpProxyConfig

名前 説明 値
httpProxy 使用する HTTP プロキシ サーバー エンドポイント。 string
httpsProxy 使用する HTTPS プロキシ サーバー エンドポイント。 string
noProxy プロキシを経由しないエンドポイント。 string[]
trustedCa プロキシ サーバーへの接続に使用する代替 CA 証明書。 string

ManagedClusterPropertiesIdentityProfile

名前 説明 値
{カスタマイズされたプロパティ} UserAssignedIdentity

UserAssignedIdentity

名前 説明 値
clientId ユーザー割り当て ID のクライアント ID。 string
objectId ユーザー割り当て ID のオブジェクト ID。 string
resourceId ユーザー割り当て ID のリソース ID。 string

ManagedClusterIngressProfile

名前 説明 値
webAppRouting イングレス プロファイルの Web アプリ ルーティング設定。 ManagedClusterIngressProfileWebAppRouting

ManagedClusterIngressProfileWebAppRouting

名前 説明 値
dnsZoneResourceIds Web アプリ ルーティング アドオンに関連付ける DNS ゾーンのリソース ID。 Web アプリ ルーティングが有効になっている場合にのみ使用されます。 パブリック DNS ゾーンとプライベート DNS ゾーンは異なるリソース グループに含めることができますが、すべてのパブリック DNS ゾーンは同じリソース グループ内にあり、すべてのプライベート DNS ゾーンは同じリソース グループ内に存在する必要があります。 string[]

制約:
最大長 = 5
enabled Web アプリ ルーティングを有効にするかどうか。 [bool]

ContainerServiceLinuxProfile

名前 説明 値
adminUsername Linux VM に使用する管理者ユーザー名。 string (必須)

制約:
Pattern = ^[A-Za-z][-A-Za-z0-9_]*$
ssh Azure で実行されている Linux ベースの VM の SSH 構成。 ContainerServiceSshConfiguration (必須)

ContainerServiceSshConfiguration

名前 説明 値
publicKeys Linux ベースの VM で認証するために使用される SSH 公開キーの一覧。 最大 1 つのキーを指定できます。 ContainerServiceSshPublicKey[] (必須)

ContainerServiceSshPublicKey

名前 説明 値
keyData SSH 経由で VM で認証するために使用される証明書公開キー。 証明書は、ヘッダーの有無にかかわらず PEM 形式である必要があります。 string (必須)

ManagedClusterMetricsProfile

名前 説明 値
costAnalysis クラスターのコスト分析構成 ManagedClusterCostAnalysis

ManagedClusterCostAnalysis

名前 説明 値
enabled この機能を有効にするには、マネージド クラスター sku.tier を "Standard" に設定する必要があります。 これを有効にすると、Kubernetes 名前空間とデプロイの詳細がAzure portalの [コスト分析] ビューに追加されます。 指定しない場合、既定値は false です。 詳細については、「aka.ms/aks/docs/cost-analysis」を参照してください。 [bool]

ContainerServiceNetworkProfile

名前 説明 値
dnsServiceIP Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、serviceCidr で指定された Kubernetes サービス アドレス範囲内である必要があります。 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]?)$
ipFamilies IP ファミリは、単一スタッククラスターまたはデュアルスタック クラスターを決定するために使用されます。 単一スタックの場合、期待される値は IPv4 です。 デュアルスタックの場合、期待される値は IPv4 と IPv6 です。 次のいずれかを含む文字列配列:
"IPv4"
"IPv6"
kubeProxyConfig kube-proxy の構成のカスタマイズを保持します。 定義されていない値は、kube-proxy の既定の動作を使用します。 {version} が {メジャー バージョン}-{マイナー バージョン} 文字列で表される場所を確認します https://v{version}.docs.kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/ 。 Kubernetes バージョン 1.23 は '1-23' になります。 ContainerServiceNetworkProfileKubeProxyConfig
loadBalancerProfile クラスター ロード バランサーのプロファイル。 ManagedClusterLoadBalancerProfile
loadBalancerSku 既定値は 'standard' です。 ロード バランサー SKU の違いの詳細については、「Azure Load Balancer SKU」を参照してください。 "basic"
"standard"
監視 このアドオンは、ネットワーク監視を構成し、Prometheus 形式でネットワーク監視データを生成するために使用できます NetworkMonitoring
natGatewayProfile クラスター NAT ゲートウェイのプロファイル。 ManagedClusterNATGatewayProfile
networkDataplane Kubernetes クラスターで使用されるネットワーク データプレーン。 "azure"
"cilium"
networkMode networkPlugin が 'azure' 以外の場合、これは指定できません。 "bridge"
"transparent"
networkPlugin Kubernetes ネットワークの構築に使用されるネットワーク プラグイン。 "azure"
"kubenet"
"none"
networkPluginMode Kubernetes ネットワークの構築に使用されるネットワーク プラグイン モード。 "overlay"
networkPolicy Kubernetes ネットワークの構築に使用されるネットワーク ポリシー。 "azure"
"calico"
"cilium"
"none"
outboundType これはクラスター作成時にのみ設定でき、後で変更することはできません。 詳細については、「 エグレス送信の種類」を参照してください。 "loadBalancer"
"managedNATGateway"
"userAssignedNATGateway"
"userDefinedRouting"
podCidr Kubenet を使用している場合、ポッド IP を割り当てる CIDR 表記の IP 範囲。 string

制約:
Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
podCidrs 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークには、2 つの CIDR (IP ファミリごとに 1 つ (IPv4/IPv6) が必要です。 string[]
serviceCidr Kubenet を使用している場合、サービス クラスター IP を割り当てる CIDR 表記の IP 範囲。 どのサブネット IP アドレスとも重複していてはなりません。 string

制約:
Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidrs 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークには、2 つの CIDR (IP ファミリごとに 1 つ (IPv4/IPv6) が必要です。 サブネット IP 範囲と重複しないようにする必要があります。 string[]

ContainerServiceNetworkProfileKubeProxyConfig

名前 説明 値
enabled クラスター上の kube-proxy でを有効にするかどうか ('kubeProxyConfig' が存在しない場合、これらのカスタマイズを行わずに kube-proxy が既定で AKS で有効になります)。 [bool]
ipvsConfig IPVS の構成のカスタマイズを保持します。 'mode' が 'IPVS' に設定されている場合にのみ指定できます。 ContainerServiceNetworkProfileKubeProxyConfigIpvsCon...
mode 使用するプロキシ モード ('IPTABLES' または 'IPVS') を指定する "IPTABLES"
"IPVS"

ContainerServiceNetworkProfileKubeProxyConfigIpvsCon...

名前 説明 値
scheduler IPVS スケジューラの詳細については、以下を参照してください。 http://www.linuxvirtualserver.org/docs/scheduling.html. "LeastConnection"
"RoundRobin"
tcpFinTimeoutSeconds FIN を受信した後の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT
tcpTimeoutSeconds アイドル状態の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT
udpTimeoutSeconds IPVS UDP パケットに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 INT

ManagedClusterLoadBalancerProfile

名前 説明 値
allocatedOutboundPorts VM ごとに割り当てられた SNAT ポートの必要な数。 使用できる値は、0 ~ 64000 (含む) の範囲です。 既定値は 0 で、Azure でポートが動的に割り当てられます。 INT

制約:
最小値 = 0
最大値 = 64000
backendPoolType BackendPool Load Balancerマネージド受信の型。 "NodeIP"
"NodeIPConfiguration"
effectiveOutboundIP クラスター ロード バランサーの有効な送信 IP リソース。 ResourceReference[]
enableMultipleStandardLoadBalancers AKS クラスターごとに複数の標準ロード バランサーを有効にするかどうか。 [bool]
idleTimeoutInMinutes 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値は、4 ~ 120 (含む) の範囲です。 既定値は 30 分です。 INT

制約:
最小値 = 4
最大値 = 120
managedOutboundIPs クラスター ロード バランサーに必要なマネージド送信 IP。 ManagedClusterLoadBalancerProfileManagedOutboundIPs
outboundIPPrefixes クラスター ロード バランサーの必要な送信 IP プレフィックス リソース。 ManagedClusterLoadBalancerProfileOutboundIPPrefixes
outboundIP クラスター ロード バランサーに必要な送信 IP リソース。 ManagedClusterLoadBalancerProfileOutboundIPs

ResourceReference

名前 説明 値
id 完全修飾 Azure リソース ID。 string

ManagedClusterLoadBalancerProfileManagedOutboundIPs

名前 説明 値
count クラスター ロード バランサー用に Azure によって作成または管理される IPv4 送信 IP の必要な数。 使用できる値は、1 ~ 100 (含む) の範囲である必要があります。 既定値は 1 です。 INT

制約:
最小値 = 1
最大値 = 100
countIPv6 クラスター ロード バランサー用に Azure によって作成または管理される IPv6 送信 IP の必要な数。 使用できる値は、1 ~ 100 (含む) の範囲である必要があります。 既定値は、単一スタックの場合は 0、デュアルスタックの場合は 1 です。 INT

制約:
最小値 = 0
最大値 = 100

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

名前 説明 値
publicIPPrefixes パブリック IP プレフィックス リソースの一覧。 ResourceReference[]

ManagedClusterLoadBalancerProfileOutboundIPs

名前 説明 値
publicIPs パブリック IP リソースの一覧。 ResourceReference[]

NetworkMonitoring

名前 説明 値
enabled クラスターでネットワーク監視プラグインを有効または無効にする [bool]

ManagedClusterNATGatewayProfile

名前 説明 値
effectiveOutboundIP クラスター NAT ゲートウェイの有効な送信 IP リソース。 ResourceReference[]
idleTimeoutInMinutes 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値は、4 ~ 120 (含む) の範囲です。 既定値は 4 分です。 INT

制約:
最小値 = 4
最大値 = 120
managedOutboundIPProfile クラスター NAT ゲートウェイのマネージド送信 IP リソースのプロファイル。 ManagedClusterManagedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

名前 説明 値
count Azure によって作成または管理される送信 IP の必要な数。 使用できる値は、1 ~ 16 (含む) の範囲である必要があります。 既定値は 1 です。 INT

制約:
最小値 = 1
最大値 = 16

ManagedClusterNodeProvisioningProfile

名前 説明 値
mode 自動に設定したモードを手動に戻すことはできません。 "Auto"
"Manual"

ManagedClusterNodeResourceGroupProfile

名前 説明 値
restrictionLevel クラスターのノード リソース グループに適用される制限レベル "ReadOnly"
"無制限"

ManagedClusterOidcIssuerProfile

名前 説明 値
enabled OIDC 発行者が有効になっているかどうか。 [bool]

ManagedClusterPodIdentityProfile

名前 説明 値
allowNetworkPluginKubenet Kubenet での実行は、AAD ポッド ID のセキュリティ関連の性質と IP スプーフィングのリスクにより、既定で無効になっています。 詳細については、 AAD ポッド ID での Kubenet ネットワーク プラグインの使用 に関するページを参照してください。 [bool]
enabled ポッド ID アドオンが有効になっているかどうか。 [bool]
userAssignedIdentities クラスターで使用するポッド ID。 ManagedClusterPodIdentity[]
userAssignedIdentityExceptions 許可するポッド ID の例外。 ManagedClusterPodIdentityException[]

ManagedClusterPodIdentity

名前 説明 値
bindingSelector AzureIdentityBinding リソースに使用するバインド セレクター。 string
identity ユーザー割り当て ID の詳細。 UserAssignedIdentity (必須)
name ポッド ID の名前。 string (必須)
namespace ポッド ID の名前空間。 string (必須)

ManagedClusterPodIdentityException

名前 説明 値
name ポッド ID 例外の名前。 string (必須)
namespace ポッド ID 例外の名前空間。 string (必須)
podLabels 一致するポッド ラベル。 ManagedClusterPodIdentityExceptionPodLabels (必須)

ManagedClusterPodIdentityExceptionPodLabels

名前 説明 値
{カスタマイズされたプロパティ} string

PrivateLinkResource

名前 説明 値
groupId リソースのグループ ID。 string
id プライベート リンク リソースの ID。 string
name プライベート リンク リソースの名前。 string
requiredMembers リソースの RequiredMembers string[]
型 リソースの種類。 string

SafeguardsProfile

名前 説明 値
excludedNamespaces セーフガード チェックから除外された名前空間の一覧 string[]
レベル 使用するセーフガード レベル。 既定では、AKS が systemExcludedNamespaces 経由で除外するものを除くすべての名前空間に対してセーフガードが有効になっています "強制"
"Off"
"警告" (必須)
version 使用する制約のバージョン string

ManagedClusterSecurityProfile

名前 説明 値
azureKeyVaultKms セキュリティ プロファイルの Azure Key Vaultキー管理サービスの設定。 AzureKeyVaultKms
customCATrustCertificates カスタム CA 信頼機能が有効になっているノードの信頼ストアに追加される、最大 10 個の base64 でエンコードされた CA の一覧。 詳細については、「カスタム CA 信頼証明書」を参照してください。 any[]

制約:
最大長 = 10
Defender セキュリティ プロファイルの設定をMicrosoft Defenderします。 ManagedClusterSecurityProfileDefender
imageCleaner セキュリティ プロファイルのイメージ クリーナー設定。 ManagedClusterSecurityProfileImageCleaner
imageIntegrity イメージの整合性は、署名によってイメージの整合性を検証するAzure Policyと連携する機能です。 イメージ署名を適用するためにAzure Policyを適用しない限り、これは影響を及ぼすものではありません。 ポリシーを使用してこの機能を使用する方法については、「」を参照してください https://aka.ms/aks/image-integrity 。 ManagedClusterSecurityProfileImageIntegrity
nodeRestriction セキュリティ プロファイルのノード制限設定。 ManagedClusterSecurityProfileNodeRestriction
workloadIdentity セキュリティ プロファイルのワークロード ID 設定。 ワークロード ID を使用すると、Kubernetes アプリケーションは Azure AD を使用して Azure クラウド リソースに安全にアクセスできます。 詳細については、 https://aka.ms/aks/wi をご覧ください。 ManagedClusterSecurityProfileWorkloadIdentity

AzureKeyVaultKms

名前 説明 値
enabled Azure Key Vault キー管理サービスを有効にするかどうか。 既定値は false です。 [bool]
keyId Azure Key Vault キーの識別子。 詳細については、「 キー識別子の形式 」を参照してください。 Azure Key Vault キー管理サービスが有効になっている場合、このフィールドは必須であり、有効なキー識別子である必要があります。 Azure Key Vault キー管理サービスが無効になっている場合は、フィールドを空のままにします。 string
keyVaultNetworkAccess キー コンテナーのネットワーク アクセス。 設定可能な値は、Public および Private です。 Public は、キー コンテナーですべてのネットワークからのパブリック アクセスを許可することを意味します。 Private は、キー コンテナーがパブリック アクセスを無効にし、プライベート リンクを有効にすることを意味します。 既定値は Public です。 "Private"
"パブリック"
keyVaultResourceId キー コンテナーのリソース ID。 keyVaultNetworkAccess が の場合、 Privateこのフィールドは必須であり、有効なリソース ID である必要があります。 keyVaultNetworkAccess が の場合は Public、フィールドを空のままにします。 string

ManagedClusterSecurityProfileDefender

名前 説明 値
logAnalyticsWorkspaceResourceId Microsoft Defenderに関連付ける Log Analytics ワークスペースのリソース ID。 Microsoft Defenderが有効になっている場合、このフィールドは必須であり、有効なワークスペース リソース ID である必要があります。 Microsoft Defenderが無効になっている場合は、フィールドを空のままにします。 string
securityMonitoring セキュリティ プロファイルのクラウド設定の脅威検出をMicrosoft Defenderします。 ManagedClusterSecurityProfileDefenderSecurityMonitor...

ManagedClusterSecurityProfileDefenderSecurityMonitor...

名前 説明 値
enabled Defender 脅威検出を有効にするかどうか [bool]

ManagedClusterSecurityProfileImageCleaner

名前 説明 値
enabled AKS クラスターで Image Cleaner を有効にするかどうか。 [bool]
intervalHours イメージ クリーナーのスキャン間隔 (時間単位)。 INT

ManagedClusterSecurityProfileImageIntegrity

名前 説明 値
enabled イメージの整合性を有効にするかどうか。 既定値は false です。 [bool]

ManagedClusterSecurityProfileNodeRestriction

名前 説明 値
enabled ノード制限を有効にするかどうか [bool]

ManagedClusterSecurityProfileWorkloadIdentity

名前 説明 値
enabled ワークロード ID を有効にするかどうか。 [bool]

ServiceMeshProfile

名前 説明 値
istio Istio サービス メッシュの構成。 IstioServiceMesh
mode サービス メッシュのモード。 "無効"
"Istio" (必須)

IstioServiceMesh

名前 説明 値
certificateAuthority Istio Service Mesh 証明機関 (CA) の構成。 現時点では、こちらの説明に従ってプラグイン証明書のみをサポートしています https://aka.ms/asm-plugin-ca IstioCertificateAuthority
components Istio コンポーネントの構成。 IstioComponents
リビジョン Istio コントロール プレーンのリビジョンの一覧。 アップグレードが進行中でない場合、これは 1 つの値を保持します。 カナリア アップグレードが進行中の場合、2 つの連続する値のみを保持できます。 詳細については、「/azure/aks/istio-upgrade」を参照してください。 string[]

制約:
最大長 = 2

IstioCertificateAuthority

名前 説明 値
plugin Service Mesh のプラグイン証明書情報。 IstioPluginCertificateAuthority

IstioPluginCertificateAuthority

名前 説明 値
certChainObjectName Azure Key Vaultの証明書チェーン オブジェクト名。 string
certObjectName Azure Key Vaultの中間証明書オブジェクト名。 string
keyObjectName Azure Key Vaultの中間証明書秘密キー オブジェクト名。 string
keyVaultId Key Vaultのリソース ID。 string
rootCertObjectName Azure Key Vaultのルート証明書オブジェクト名。 string

IstioComponents

名前 説明 値
egressGateways Istio エグレス ゲートウェイ。 IstioEgressGateway[]
ingressGateways Istio イングレス ゲートウェイ。 IstioIngressGateway[]

IstioEgressGateway

名前 説明 値
enabled エグレス ゲートウェイを有効にするかどうか。 bool (必須)
nodeSelector エグレス ゲートウェイをスケジュールするための NodeSelector。 IstioEgressGatewayNodeSelector

IstioEgressGatewayNodeSelector

名前 説明 値
{カスタマイズされたプロパティ} string

IstioIngressGateway

名前 説明 値
enabled イングレス ゲートウェイを有効にするかどうか。 bool (必須)
mode イングレス ゲートウェイのモード。 "External"
"Internal" (必須)

ManagedClusterServicePrincipalProfile

名前 説明 値
clientId サービス プリンシパルの ID。 string (必須)
secret プレーン テキストでサービス プリンシパルに関連付けられているシークレット パスワード。 string

ManagedClusterStorageProfile

名前 説明 値
blobCSIDriver ストレージ プロファイルの AzureBlob CSI ドライバー設定。 ManagedClusterStorageProfileBlobCSIDriver
diskCSIDriver ストレージ プロファイルの AzureDisk CSI ドライバー設定。 ManagedClusterStorageProfileDiskCSIDriver
fileCSIDriver ストレージ プロファイルの AzureFile CSI ドライバー設定。 ManagedClusterStorageProfileFileCSIDriver
snapshotController ストレージ プロファイルのスナップショット コントローラー設定。 ManagedClusterStorageProfileSnapshotController

ManagedClusterStorageProfileBlobCSIDriver

名前 説明 値
enabled AzureBlob CSI ドライバーを有効にするかどうか。 既定値は false です。 [bool]

ManagedClusterStorageProfileDiskCSIDriver

名前 説明 値
enabled AzureDisk CSI ドライバーを有効にするかどうか。 既定値は、true です。 [bool]
version AzureDisk CSI ドライバーのバージョン。 既定値は v1 です。 string

ManagedClusterStorageProfileFileCSIDriver

名前 説明 値
enabled AzureFile CSI ドライバーを有効にするかどうか。 既定値は、true です。 [bool]

ManagedClusterStorageProfileSnapshotController

名前 説明 値
enabled スナップショット コントローラーを有効にするかどうか。 既定値は、true です。 [bool]

ClusterUpgradeSettings

名前 説明 値
overrideSettings オーバーライドの設定。 UpgradeOverrideSettings

UpgradeOverrideSettings

名前 説明 値
forceUpgrade クラスターを強制的にアップグレードするかどうか。 このオプションは、非推奨の API 使用状況の確認などのアップグレード保護をバイパスするようにアップグレード操作に指示します。 このオプションは注意して有効にしてください。 [bool]
until オーバーライドが有効になるまで。 これはアップグレードの開始時刻にのみ一致し、アップグレードが進むにつれて有効期限が切れた場合 until でも、アップグレードが開始されると有効性は変わらないことに注意してください。 このフィールドは既定では設定されていません。 オーバーライドを有効にするには、設定する必要があります。 string

ManagedClusterWindowsProfile

名前 説明 値
adminPassword 管理者アカウントのパスワードを指定します。

最小長: 8 文字

最大長: 123 文字

複雑さの要件: 以下の 4 つの条件のうち 3 つを満たす必要がある
文字が小さい
上の文字を含む
数字を含む
特殊文字があります (Regex match [\W_])

許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!"		 string
adminUsername 管理者アカウントの名前を指定します。

制限： "." で終わることはできません。

許可されていない値: "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 文字		 string (必須)
enableCSIProxy CSI プロキシの詳細については、 CSI プロキシの GitHub リポジトリを参照してください。 [bool]
gmsaProfile マネージド クラスター内の Windows gMSA プロファイル。 WindowsGmsaProfile
licenseType Windows VM に使用するライセンスの種類。 詳細については、「 Azure ハイブリッド ユーザー特典 」を参照してください。 "None"
"Windows_Server"

WindowsGmsaProfile

名前 説明 値
dnsServer Windows gMSA の DNS サーバーを指定します。

マネージド クラスターの作成に使用される vnet で DNS サーバーを構成している場合は、空に設定します。		 string
enabled マネージド クラスターで Windows gMSA を有効にするかどうかを指定します。 [bool]
rootDomainName Windows gMSA のルート ドメイン名を指定します。

マネージド クラスターの作成に使用される vnet で DNS サーバーを構成している場合は、空に設定します。		 string

ManagedClusterWorkloadAutoScalerProfile

名前 説明 値
keda ワークロード自動スケーラー プロファイルの KEDA (Kubernetes イベント ドリブン自動スケーリング) 設定。 ManagedClusterWorkloadAutoScalerProfileKeda
verticalPodAutoscaler ManagedClusterWorkloadAutoScalerProfileVerticalPodAu...

ManagedClusterWorkloadAutoScalerProfileKeda

名前 説明 値
enabled KEDA を有効にするかどうか。 bool (必須)

ManagedClusterWorkloadAutoScalerProfileVerticalPodAu...

名前 説明 値
addonAutoscaling VPA アドオンが有効で、AKS で管理されるアドオンをスケーリングするように構成されているかどうか。 "無効"
"有効"
enabled クラスターで VPA アドオンを有効にするかどうか。 既定値は false です。 bool (必須)

ManagedClusterSKU

名前 説明 値
name マネージド クラスター SKU の名前。 "Base"
レベル 指定しない場合、既定値は 'Free' です。 詳細については、 AKS の価格レベル に関するページを参照してください。 "Free"
"Premium"
"Standard"