次の方法で共有


ManagedClusterAgentPoolProfile interface

コンテナー サービス エージェント プールのプロファイル。

Extends

プロパティ

name

Windows エージェント プール名は 6 文字以下にする必要があります。

継承されたプロパティ

availabilityZones

ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。

capacityReservationGroupID

AKS は、指定されたエージェント プールを容量予約グループに関連付けます。

count

Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。

creationData

スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。

currentOrchestratorVersion

orchestratorVersion が major.minor.patch><完全に指定されたバージョンである場合、このフィールドは完全に同じになります。 orchestratorVersion が major.minor><場合、このフィールドには、使用されている major.minor.patch> バージョン全体 <含まれます。 注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

enableAutoScaling

自動スケーラーを有効にするかどうか

enableEncryptionAtHost

これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「https://docs.microsoft.com/azure/aks/enable-host-encryption」を参照してください。

enableFips

詳細については、「FIPS 対応ノード プール の追加」を参照してください。

enableNodePublicIP

シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオは、ホップを最小限に抑えるために、コンソールがクラウド仮想マシンに直接接続する必要があるゲーム ワークロードです。 詳細については、ノードごとにパブリック IP を割り当てる を参照してください。 既定値は false です。

enableUltraSSD

UltraSSD を有効にするかどうか

eTag

オプティミスティック コンカレンシーを実装するために使用される一意の読み取り専用文字列。 リソースが更新されると、eTag 値が変更されます。 通常の etag 規則に従ってオプティミスティック コンカレンシーを有効にするには、後続の要求の eTag 値を持つ if-match ヘッダーまたは if-none-match ヘッダーを指定します。 注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

gpuInstanceProfile

サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用される GPUInstanceProfile。

hostGroupID

形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}です。 詳細については、Azure 専用ホストのに関するページを参照してください。

kubeletConfig

エージェント プール ノード上の Kubelet 構成。

kubeletDiskType

emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。

linuxOSConfig

Linux エージェント ノードの OS 構成。

maxCount

自動スケーリングのノードの最大数

maxPods

ノードで実行できるポッドの最大数。

minCount

自動スケーリング用のノードの最小数

mode

クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、「https://docs.microsoft.com/azure/aks/use-system-pools」を参照してください。

networkProfile

エージェント プールのネットワーク関連の設定。

nodeImageVersion

ノード イメージのバージョン注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

nodeLabels

エージェント プール内のすべてのノードにわたって保持されるノード ラベル。

nodePublicIPPrefixID

これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。

nodeTaints

ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。

orchestratorVersion

パッチ バージョン <major.minor.patch> (1.20.13 など) と <major.minor> (1.20 など) の両方がサポートされています。 major.minor><指定すると、サポートされている最新の GA パッチ バージョンが自動的に選択されます。 クラスターの作成後に同じ <major.minor> を使用してクラスターを更新しても (例: 1.14.x -> 1.14)、新しいパッチ バージョンが使用可能な場合でも、アップグレードはトリガーされません。 ベスト プラクティスとして、AKS クラスター内のすべてのノード プールを同じ Kubernetes バージョンにアップグレードする必要があります。 ノード プールのバージョンには、コントロール プレーンと同じメジャー バージョンが必要です。 ノード プールのマイナー バージョンは、コントロール プレーン バージョンの 2 つのマイナー バージョン内にある必要があります。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳しくは、ノード・プールのアップグレード を参照してください。

osDiskSizeGB

マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。

osDiskType

VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後に変更できない場合があります。 詳細については、「エフェメラル OSを参照してください。

osSKU

エージェント プールで使用される OS SKU を指定します。 OSType が Linux の場合、既定値は Ubuntu です。 既定値は、Kubernetes <= 1.24 の場合は Windows 2019、OSType が Windows の場合は Kubernetes >= 1.25 の場合は Windows2022 です。

osType

オペレーティング システムの種類。 既定値は Linux です。

podSubnetID

省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、vnetSubnetID を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。

powerState

エージェント プールが最初に作成されるときは、最初に実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールは、実行中でプロビジョニング状態が成功した場合にのみ停止できます

provisioningState

現在のデプロイまたはプロビジョニングの状態。 注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

proximityPlacementGroupID

近接通信配置グループの ID。

scaleDownMode

これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合は、既定で Delete に設定されます。

scaleSetEvictionPolicy

scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。

scaleSetPriority

仮想マシン スケール セットの優先順位。 指定しない場合、既定値は 'Regular' です。

securityProfile

エージェント プールのセキュリティ設定。

spotMaxPrice

指定できる値は、0 より大きい任意の 10 進値またはオンデマンド価格を支払う意欲を示す -1 です。 スポット価格の詳細については、スポット VM の価格 を参照してください。

tags

エージェント プールの仮想マシン スケール セットに保持されるタグ。

type

エージェント プールの種類。

upgradeSettings

エージェント プールをアップグレードするための設定

vmSize

VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、cpu など) が含まれている場合、ポッドが正常に実行されない可能性があります。 制限付き VM サイズの詳細については、「https://docs.microsoft.com/azure/aks/quotas-skus-regions」を参照してください。

vnetSubnetID

これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。

windowsProfile

Windows エージェント プールの特定のプロファイル。

workloadRuntime

ノードが実行できるワークロードの種類を決定します。

プロパティの詳細

name

Windows エージェント プール名は 6 文字以下にする必要があります。

name: string

プロパティ値

string

継承されたプロパティの詳細

availabilityZones

ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。

availabilityZones?: string[]

プロパティ値

string[]

ManagedClusterAgentPoolProfileProperties.availabilityZones から継承

capacityReservationGroupID

AKS は、指定されたエージェント プールを容量予約グループに関連付けます。

capacityReservationGroupID?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.capacityReservationGroupID から継承

count

Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。

count?: number

プロパティ値

number

managedClusterAgentPoolProfileProperties.countから継承された

creationData

スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。

creationData?: CreationData

プロパティ値

managedClusterAgentPoolProfileProperties.creationDataから継承された

currentOrchestratorVersion

orchestratorVersion が major.minor.patch><完全に指定されたバージョンである場合、このフィールドは完全に同じになります。 orchestratorVersion が major.minor><場合、このフィールドには、使用されている major.minor.patch> バージョン全体 <含まれます。 注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

currentOrchestratorVersion?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.currentOrchestratorVersion から継承

enableAutoScaling

自動スケーラーを有効にするかどうか

enableAutoScaling?: boolean

プロパティ値

boolean

managedClusterAgentPoolProfileProperties.enableAutoScaling から継承

enableEncryptionAtHost

これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「https://docs.microsoft.com/azure/aks/enable-host-encryption」を参照してください。

enableEncryptionAtHost?: boolean

プロパティ値

boolean

ManagedClusterAgentPoolProfileProperties.enableEncryptionAtHostから継承

enableFips

詳細については、「FIPS 対応ノード プール の追加」を参照してください。

enableFips?: boolean

プロパティ値

boolean

managedClusterAgentPoolProfileProperties.enableFipsから継承された

enableNodePublicIP

シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオは、ホップを最小限に抑えるために、コンソールがクラウド仮想マシンに直接接続する必要があるゲーム ワークロードです。 詳細については、ノードごとにパブリック IP を割り当てる を参照してください。 既定値は false です。

enableNodePublicIP?: boolean

プロパティ値

boolean

ManagedClusterAgentPoolProfileProperties.enableNodePublicIPから継承

enableUltraSSD

UltraSSD を有効にするかどうか

enableUltraSSD?: boolean

プロパティ値

boolean

ManagedClusterAgentPoolProfileProperties.enableUltraSSD から継承

eTag

オプティミスティック コンカレンシーを実装するために使用される一意の読み取り専用文字列。 リソースが更新されると、eTag 値が変更されます。 通常の etag 規則に従ってオプティミスティック コンカレンシーを有効にするには、後続の要求の eTag 値を持つ if-match ヘッダーまたは if-none-match ヘッダーを指定します。 注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

eTag?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.eTag から継承

gpuInstanceProfile

サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用される GPUInstanceProfile。

gpuInstanceProfile?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.gpuInstanceProfileから継承された

hostGroupID

形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}です。 詳細については、Azure 専用ホストのに関するページを参照してください。

hostGroupID?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.hostGroupIDから継承された

kubeletConfig

エージェント プール ノード上の Kubelet 構成。

kubeletConfig?: KubeletConfig

プロパティ値

ManagedClusterAgentPoolProfileProperties.kubeletConfig から継承

kubeletDiskType

emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。

kubeletDiskType?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.kubeletDiskTypeから継承

linuxOSConfig

Linux エージェント ノードの OS 構成。

linuxOSConfig?: LinuxOSConfig

プロパティ値

ManagedClusterAgentPoolProfileProperties.linuxOSConfig から継承

maxCount

自動スケーリングのノードの最大数

maxCount?: number

プロパティ値

number

managedClusterAgentPoolProfileProperties.maxCountから継承された

maxPods

ノードで実行できるポッドの最大数。

maxPods?: number

プロパティ値

number

ManagedClusterAgentPoolProfileProperties.maxPodsから継承

minCount

自動スケーリング用のノードの最小数

minCount?: number

プロパティ値

number

managedClusterAgentPoolProfileProperties.minCount から継承

mode

クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、「https://docs.microsoft.com/azure/aks/use-system-pools」を参照してください。

mode?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.modeから継承された

networkProfile

エージェント プールのネットワーク関連の設定。

networkProfile?: AgentPoolNetworkProfile

プロパティ値

managedClusterAgentPoolProfileProperties.networkProfile から継承

nodeImageVersion

ノード イメージのバージョン注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

nodeImageVersion?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.nodeImageVersionから継承された

nodeLabels

エージェント プール内のすべてのノードにわたって保持されるノード ラベル。

nodeLabels?: {[propertyName: string]: string}

プロパティ値

{[propertyName: string]: string}

ManagedClusterAgentPoolProfileProperties.nodeLabelsから継承

nodePublicIPPrefixID

これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。

nodePublicIPPrefixID?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.nodePublicIPPrefixID から継承

nodeTaints

ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。

nodeTaints?: string[]

プロパティ値

string[]

managedClusterAgentPoolProfileProperties.nodeTaintsから継承された

orchestratorVersion

パッチ バージョン <major.minor.patch> (1.20.13 など) と <major.minor> (1.20 など) の両方がサポートされています。 major.minor><指定すると、サポートされている最新の GA パッチ バージョンが自動的に選択されます。 クラスターの作成後に同じ <major.minor> を使用してクラスターを更新しても (例: 1.14.x -> 1.14)、新しいパッチ バージョンが使用可能な場合でも、アップグレードはトリガーされません。 ベスト プラクティスとして、AKS クラスター内のすべてのノード プールを同じ Kubernetes バージョンにアップグレードする必要があります。 ノード プールのバージョンには、コントロール プレーンと同じメジャー バージョンが必要です。 ノード プールのマイナー バージョンは、コントロール プレーン バージョンの 2 つのマイナー バージョン内にある必要があります。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳しくは、ノード・プールのアップグレード を参照してください。

orchestratorVersion?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.orchestratorVersionから継承

osDiskSizeGB

マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。

osDiskSizeGB?: number

プロパティ値

number

managedClusterAgentPoolProfileProperties.osDiskSizeGBから継承された

osDiskType

VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後に変更できない場合があります。 詳細については、「エフェメラル OSを参照してください。

osDiskType?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.osDiskType から継承

osSKU

エージェント プールで使用される OS SKU を指定します。 OSType が Linux の場合、既定値は Ubuntu です。 既定値は、Kubernetes <= 1.24 の場合は Windows 2019、OSType が Windows の場合は Kubernetes >= 1.25 の場合は Windows2022 です。

osSKU?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.osSKU から継承

osType

オペレーティング システムの種類。 既定値は Linux です。

osType?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.osType から継承

podSubnetID

省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、vnetSubnetID を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。

podSubnetID?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.podSubnetID から継承された

powerState

エージェント プールが最初に作成されるときは、最初に実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールは、実行中でプロビジョニング状態が成功した場合にのみ停止できます

powerState?: PowerState

プロパティ値

managedClusterAgentPoolProfileProperties.powerStateから継承された

provisioningState

現在のデプロイまたはプロビジョニングの状態。 注: このプロパティはシリアル化されません。 サーバーによってのみ設定できます。

provisioningState?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.provisioningStateから継承された

proximityPlacementGroupID

近接通信配置グループの ID。

proximityPlacementGroupID?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.proximityPlacementGroupID から継承

scaleDownMode

これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合は、既定で Delete に設定されます。

scaleDownMode?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.scaleDownModeから継承された

scaleSetEvictionPolicy

scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。

scaleSetEvictionPolicy?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.scaleSetEvictionPolicy から継承

scaleSetPriority

仮想マシン スケール セットの優先順位。 指定しない場合、既定値は 'Regular' です。

scaleSetPriority?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.scaleSetPriorityから継承された

securityProfile

エージェント プールのセキュリティ設定。

securityProfile?: AgentPoolSecurityProfile

プロパティ値

managedClusterAgentPoolProfileProperties.securityProfileから継承された

spotMaxPrice

指定できる値は、0 より大きい任意の 10 進値またはオンデマンド価格を支払う意欲を示す -1 です。 スポット価格の詳細については、スポット VM の価格 を参照してください。

spotMaxPrice?: number

プロパティ値

number

ManagedClusterAgentPoolProfileProperties.spotMaxPriceから継承

tags

エージェント プールの仮想マシン スケール セットに保持されるタグ。

tags?: {[propertyName: string]: string}

プロパティ値

{[propertyName: string]: string}

managedClusterAgentPoolProfileProperties.tagsから継承された

type

エージェント プールの種類。

type?: string

プロパティ値

string

ManagedClusterAgentPoolProfileProperties.typeから継承

upgradeSettings

エージェント プールをアップグレードするための設定

upgradeSettings?: AgentPoolUpgradeSettings

プロパティ値

managedClusterAgentPoolProfileProperties.upgradeSettingsから継承された

vmSize

VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、cpu など) が含まれている場合、ポッドが正常に実行されない可能性があります。 制限付き VM サイズの詳細については、「https://docs.microsoft.com/azure/aks/quotas-skus-regions」を参照してください。

vmSize?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.vmSizeから継承された

vnetSubnetID

これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。

vnetSubnetID?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.vnetSubnetIDから継承された

windowsProfile

Windows エージェント プールの特定のプロファイル。

windowsProfile?: AgentPoolWindowsProfile

プロパティ値

ManagedClusterAgentPoolProfileProperties.windowsProfile から継承

workloadRuntime

ノードが実行できるワークロードの種類を決定します。

workloadRuntime?: string

プロパティ値

string

managedClusterAgentPoolProfileProperties.workloadRuntime から継承