azure-native.containerservice.getAgentPool
Explore with Pulumi AI
Agent Pool. Azure REST API version: 2023-04-01.
Other available API versions: 2019-02-01, 2019-04-01, 2020-06-01, 2021-02-01, 2021-08-01, 2022-04-02-preview, 2023-05-02-preview, 2023-06-01, 2023-06-02-preview, 2023-07-01, 2023-07-02-preview, 2023-08-01, 2023-08-02-preview, 2023-09-01, 2023-09-02-preview, 2023-10-01, 2023-10-02-preview, 2023-11-01, 2023-11-02-preview, 2024-01-01, 2024-01-02-preview, 2024-02-01, 2024-02-02-preview, 2024-03-02-preview, 2024-04-02-preview, 2024-05-01, 2024-05-02-preview, 2024-06-02-preview, 2024-07-01, 2024-07-02-preview, 2024-08-01.
Using getAgentPool
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getAgentPool(args: GetAgentPoolArgs, opts?: InvokeOptions): Promise<GetAgentPoolResult>
function getAgentPoolOutput(args: GetAgentPoolOutputArgs, opts?: InvokeOptions): Output<GetAgentPoolResult>
def get_agent_pool(agent_pool_name: Optional[str] = None,
resource_group_name: Optional[str] = None,
resource_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetAgentPoolResult
def get_agent_pool_output(agent_pool_name: Optional[pulumi.Input[str]] = None,
resource_group_name: Optional[pulumi.Input[str]] = None,
resource_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetAgentPoolResult]
func LookupAgentPool(ctx *Context, args *LookupAgentPoolArgs, opts ...InvokeOption) (*LookupAgentPoolResult, error)
func LookupAgentPoolOutput(ctx *Context, args *LookupAgentPoolOutputArgs, opts ...InvokeOption) LookupAgentPoolResultOutput
> Note: This function is named LookupAgentPool
in the Go SDK.
public static class GetAgentPool
{
public static Task<GetAgentPoolResult> InvokeAsync(GetAgentPoolArgs args, InvokeOptions? opts = null)
public static Output<GetAgentPoolResult> Invoke(GetAgentPoolInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetAgentPoolResult> getAgentPool(GetAgentPoolArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: azure-native:containerservice:getAgentPool
arguments:
# arguments dictionary
The following arguments are supported:
- Agent
Pool stringName - The name of the agent pool.
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Resource
Name string - The name of the managed cluster resource.
- Agent
Pool stringName - The name of the agent pool.
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Resource
Name string - The name of the managed cluster resource.
- agent
Pool StringName - The name of the agent pool.
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- resource
Name String - The name of the managed cluster resource.
- agent
Pool stringName - The name of the agent pool.
- resource
Group stringName - The name of the resource group. The name is case insensitive.
- resource
Name string - The name of the managed cluster resource.
- agent_
pool_ strname - The name of the agent pool.
- resource_
group_ strname - The name of the resource group. The name is case insensitive.
- resource_
name str - The name of the managed cluster resource.
- agent
Pool StringName - The name of the agent pool.
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- resource
Name String - The name of the managed cluster resource.
getAgentPool Result
The following output properties are available:
- Current
Orchestrator stringVersion - If orchestratorVersion is a fully specified version <major.minor.patch>, this field will be exactly equal to it. If orchestratorVersion is <major.minor>, this field will contain the full <major.minor.patch> version being used.
- Id string
- Resource ID.
- Name string
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- Node
Image stringVersion - The version of node image
- Provisioning
State string - The current deployment or provisioning state.
- Type string
- Resource type
- Availability
Zones List<string> - The list of Availability zones to use for nodes. This can only be specified if the AgentPoolType property is 'VirtualMachineScaleSets'.
- Count int
- Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 1000 (inclusive) for user pools and in the range of 1 to 1000 (inclusive) for system pools. The default value is 1.
- Creation
Data Pulumi.Azure Native. Container Service. Outputs. Creation Data Response - CreationData to be used to specify the source Snapshot ID if the node pool will be created/upgraded using a snapshot.
- Enable
Auto boolScaling - Whether to enable auto-scaler
- Enable
Encryption boolAt Host - This is only supported on certain VM sizes and in certain Azure regions. For more information, see: https://docs.microsoft.com/azure/aks/enable-host-encryption
- Enable
FIPS bool - See Add a FIPS-enabled node pool for more details.
- Enable
Node boolPublic IP - Some scenarios may require nodes in a node pool to receive their own dedicated public IP addresses. A common scenario is for gaming workloads, where a console needs to make a direct connection to a cloud virtual machine to minimize hops. For more information see assigning a public IP per node. The default is false.
- Enable
Ultra boolSSD - Whether to enable UltraSSD
- Gpu
Instance stringProfile - GPUInstanceProfile to be used to specify GPU MIG instance profile for supported GPU VM SKU.
- Host
Group stringID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. For more information see Azure dedicated hosts.
- Kubelet
Config Pulumi.Azure Native. Container Service. Outputs. Kubelet Config Response - The Kubelet configuration on the agent pool nodes.
- Kubelet
Disk stringType - Determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage.
- Linux
OSConfig Pulumi.Azure Native. Container Service. Outputs. Linux OSConfig Response - The OS configuration of Linux agent nodes.
- Max
Count int - The maximum number of nodes for auto-scaling
- Max
Pods int - The maximum number of pods that can run on a node.
- Min
Count int - The minimum number of nodes for auto-scaling
- Mode string
- A cluster must have at least one 'System' Agent Pool at all times. For additional information on agent pool restrictions and best practices, see: https://docs.microsoft.com/azure/aks/use-system-pools
- Node
Labels Dictionary<string, string> - The node labels to be persisted across all nodes in agent pool.
- Node
Public stringIPPrefix ID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
- Node
Taints List<string> - The taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
- Orchestrator
Version string - Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. As a best practice, you should upgrade all node pools in an AKS cluster to the same Kubernetes version. The node pool version must have the same major version as the control plane. The node pool minor version must be within two minor versions of the control plane version. The node pool version cannot be greater than the control plane version. For more information see upgrading a node pool.
- Os
Disk intSize GB - OS Disk Size in GB to be used to specify the disk size for every machine in the master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
- Os
Disk stringType - The default is 'Ephemeral' if the VM supports it and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation. For more information see Ephemeral OS.
- Os
SKU string - Specifies the OS SKU used by the agent pool. The default is Ubuntu if OSType is Linux. The default is Windows2019 when Kubernetes <= 1.24 or Windows2022 when Kubernetes >= 1.25 if OSType is Windows.
- Os
Type string - The operating system type. The default is Linux.
- Pod
Subnet stringID - If omitted, pod IPs are statically assigned on the node subnet (see vnetSubnetID for more details). This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- Power
State Pulumi.Azure Native. Container Service. Outputs. Power State Response - When an Agent Pool is first created it is initially Running. The Agent Pool can be stopped by setting this field to Stopped. A stopped Agent Pool stops all of its VMs and does not accrue billing charges. An Agent Pool can only be stopped if it is Running and provisioning state is Succeeded
- Proximity
Placement stringGroup ID - The ID for Proximity Placement Group.
- Scale
Down stringMode - This also effects the cluster autoscaler behavior. If not specified, it defaults to Delete.
- Scale
Set stringEviction Policy - This cannot be specified unless the scaleSetPriority is 'Spot'. If not specified, the default is 'Delete'.
- Scale
Set stringPriority - The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
- Spot
Max doublePrice - Possible values are any decimal value greater than zero or -1 which indicates the willingness to pay any on-demand price. For more details on spot pricing, see spot VMs pricing
- Dictionary<string, string>
- The tags to be persisted on the agent pool virtual machine scale set.
- Upgrade
Settings Pulumi.Azure Native. Container Service. Outputs. Agent Pool Upgrade Settings Response - Settings for upgrading the agentpool
- Vm
Size string - VM size availability varies by region. If a node contains insufficient compute resources (memory, cpu, etc) pods might fail to run correctly. For more details on restricted VM sizes, see: https://docs.microsoft.com/azure/aks/quotas-skus-regions
- Vnet
Subnet stringID - If this is not specified, a VNET and subnet will be generated and used. If no podSubnetID is specified, this applies to nodes and pods, otherwise it applies to just nodes. This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- Workload
Runtime string - Determines the type of workload a node can run.
- Current
Orchestrator stringVersion - If orchestratorVersion is a fully specified version <major.minor.patch>, this field will be exactly equal to it. If orchestratorVersion is <major.minor>, this field will contain the full <major.minor.patch> version being used.
- Id string
- Resource ID.
- Name string
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- Node
Image stringVersion - The version of node image
- Provisioning
State string - The current deployment or provisioning state.
- Type string
- Resource type
- Availability
Zones []string - The list of Availability zones to use for nodes. This can only be specified if the AgentPoolType property is 'VirtualMachineScaleSets'.
- Count int
- Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 1000 (inclusive) for user pools and in the range of 1 to 1000 (inclusive) for system pools. The default value is 1.
- Creation
Data CreationData Response - CreationData to be used to specify the source Snapshot ID if the node pool will be created/upgraded using a snapshot.
- Enable
Auto boolScaling - Whether to enable auto-scaler
- Enable
Encryption boolAt Host - This is only supported on certain VM sizes and in certain Azure regions. For more information, see: https://docs.microsoft.com/azure/aks/enable-host-encryption
- Enable
FIPS bool - See Add a FIPS-enabled node pool for more details.
- Enable
Node boolPublic IP - Some scenarios may require nodes in a node pool to receive their own dedicated public IP addresses. A common scenario is for gaming workloads, where a console needs to make a direct connection to a cloud virtual machine to minimize hops. For more information see assigning a public IP per node. The default is false.
- Enable
Ultra boolSSD - Whether to enable UltraSSD
- Gpu
Instance stringProfile - GPUInstanceProfile to be used to specify GPU MIG instance profile for supported GPU VM SKU.
- Host
Group stringID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. For more information see Azure dedicated hosts.
- Kubelet
Config KubeletConfig Response - The Kubelet configuration on the agent pool nodes.
- Kubelet
Disk stringType - Determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage.
- Linux
OSConfig LinuxOSConfig Response - The OS configuration of Linux agent nodes.
- Max
Count int - The maximum number of nodes for auto-scaling
- Max
Pods int - The maximum number of pods that can run on a node.
- Min
Count int - The minimum number of nodes for auto-scaling
- Mode string
- A cluster must have at least one 'System' Agent Pool at all times. For additional information on agent pool restrictions and best practices, see: https://docs.microsoft.com/azure/aks/use-system-pools
- Node
Labels map[string]string - The node labels to be persisted across all nodes in agent pool.
- Node
Public stringIPPrefix ID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
- Node
Taints []string - The taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
- Orchestrator
Version string - Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. As a best practice, you should upgrade all node pools in an AKS cluster to the same Kubernetes version. The node pool version must have the same major version as the control plane. The node pool minor version must be within two minor versions of the control plane version. The node pool version cannot be greater than the control plane version. For more information see upgrading a node pool.
- Os
Disk intSize GB - OS Disk Size in GB to be used to specify the disk size for every machine in the master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
- Os
Disk stringType - The default is 'Ephemeral' if the VM supports it and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation. For more information see Ephemeral OS.
- Os
SKU string - Specifies the OS SKU used by the agent pool. The default is Ubuntu if OSType is Linux. The default is Windows2019 when Kubernetes <= 1.24 or Windows2022 when Kubernetes >= 1.25 if OSType is Windows.
- Os
Type string - The operating system type. The default is Linux.
- Pod
Subnet stringID - If omitted, pod IPs are statically assigned on the node subnet (see vnetSubnetID for more details). This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- Power
State PowerState Response - When an Agent Pool is first created it is initially Running. The Agent Pool can be stopped by setting this field to Stopped. A stopped Agent Pool stops all of its VMs and does not accrue billing charges. An Agent Pool can only be stopped if it is Running and provisioning state is Succeeded
- Proximity
Placement stringGroup ID - The ID for Proximity Placement Group.
- Scale
Down stringMode - This also effects the cluster autoscaler behavior. If not specified, it defaults to Delete.
- Scale
Set stringEviction Policy - This cannot be specified unless the scaleSetPriority is 'Spot'. If not specified, the default is 'Delete'.
- Scale
Set stringPriority - The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
- Spot
Max float64Price - Possible values are any decimal value greater than zero or -1 which indicates the willingness to pay any on-demand price. For more details on spot pricing, see spot VMs pricing
- map[string]string
- The tags to be persisted on the agent pool virtual machine scale set.
- Upgrade
Settings AgentPool Upgrade Settings Response - Settings for upgrading the agentpool
- Vm
Size string - VM size availability varies by region. If a node contains insufficient compute resources (memory, cpu, etc) pods might fail to run correctly. For more details on restricted VM sizes, see: https://docs.microsoft.com/azure/aks/quotas-skus-regions
- Vnet
Subnet stringID - If this is not specified, a VNET and subnet will be generated and used. If no podSubnetID is specified, this applies to nodes and pods, otherwise it applies to just nodes. This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- Workload
Runtime string - Determines the type of workload a node can run.
- current
Orchestrator StringVersion - If orchestratorVersion is a fully specified version <major.minor.patch>, this field will be exactly equal to it. If orchestratorVersion is <major.minor>, this field will contain the full <major.minor.patch> version being used.
- id String
- Resource ID.
- name String
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- node
Image StringVersion - The version of node image
- provisioning
State String - The current deployment or provisioning state.
- type String
- Resource type
- availability
Zones List<String> - The list of Availability zones to use for nodes. This can only be specified if the AgentPoolType property is 'VirtualMachineScaleSets'.
- count Integer
- Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 1000 (inclusive) for user pools and in the range of 1 to 1000 (inclusive) for system pools. The default value is 1.
- creation
Data CreationData Response - CreationData to be used to specify the source Snapshot ID if the node pool will be created/upgraded using a snapshot.
- enable
Auto BooleanScaling - Whether to enable auto-scaler
- enable
Encryption BooleanAt Host - This is only supported on certain VM sizes and in certain Azure regions. For more information, see: https://docs.microsoft.com/azure/aks/enable-host-encryption
- enable
FIPS Boolean - See Add a FIPS-enabled node pool for more details.
- enable
Node BooleanPublic IP - Some scenarios may require nodes in a node pool to receive their own dedicated public IP addresses. A common scenario is for gaming workloads, where a console needs to make a direct connection to a cloud virtual machine to minimize hops. For more information see assigning a public IP per node. The default is false.
- enable
Ultra BooleanSSD - Whether to enable UltraSSD
- gpu
Instance StringProfile - GPUInstanceProfile to be used to specify GPU MIG instance profile for supported GPU VM SKU.
- host
Group StringID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. For more information see Azure dedicated hosts.
- kubelet
Config KubeletConfig Response - The Kubelet configuration on the agent pool nodes.
- kubelet
Disk StringType - Determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage.
- linux
OSConfig LinuxOSConfig Response - The OS configuration of Linux agent nodes.
- max
Count Integer - The maximum number of nodes for auto-scaling
- max
Pods Integer - The maximum number of pods that can run on a node.
- min
Count Integer - The minimum number of nodes for auto-scaling
- mode String
- A cluster must have at least one 'System' Agent Pool at all times. For additional information on agent pool restrictions and best practices, see: https://docs.microsoft.com/azure/aks/use-system-pools
- node
Labels Map<String,String> - The node labels to be persisted across all nodes in agent pool.
- node
Public StringIPPrefix ID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
- node
Taints List<String> - The taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
- orchestrator
Version String - Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. As a best practice, you should upgrade all node pools in an AKS cluster to the same Kubernetes version. The node pool version must have the same major version as the control plane. The node pool minor version must be within two minor versions of the control plane version. The node pool version cannot be greater than the control plane version. For more information see upgrading a node pool.
- os
Disk IntegerSize GB - OS Disk Size in GB to be used to specify the disk size for every machine in the master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
- os
Disk StringType - The default is 'Ephemeral' if the VM supports it and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation. For more information see Ephemeral OS.
- os
SKU String - Specifies the OS SKU used by the agent pool. The default is Ubuntu if OSType is Linux. The default is Windows2019 when Kubernetes <= 1.24 or Windows2022 when Kubernetes >= 1.25 if OSType is Windows.
- os
Type String - The operating system type. The default is Linux.
- pod
Subnet StringID - If omitted, pod IPs are statically assigned on the node subnet (see vnetSubnetID for more details). This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- power
State PowerState Response - When an Agent Pool is first created it is initially Running. The Agent Pool can be stopped by setting this field to Stopped. A stopped Agent Pool stops all of its VMs and does not accrue billing charges. An Agent Pool can only be stopped if it is Running and provisioning state is Succeeded
- proximity
Placement StringGroup ID - The ID for Proximity Placement Group.
- scale
Down StringMode - This also effects the cluster autoscaler behavior. If not specified, it defaults to Delete.
- scale
Set StringEviction Policy - This cannot be specified unless the scaleSetPriority is 'Spot'. If not specified, the default is 'Delete'.
- scale
Set StringPriority - The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
- spot
Max DoublePrice - Possible values are any decimal value greater than zero or -1 which indicates the willingness to pay any on-demand price. For more details on spot pricing, see spot VMs pricing
- Map<String,String>
- The tags to be persisted on the agent pool virtual machine scale set.
- upgrade
Settings AgentPool Upgrade Settings Response - Settings for upgrading the agentpool
- vm
Size String - VM size availability varies by region. If a node contains insufficient compute resources (memory, cpu, etc) pods might fail to run correctly. For more details on restricted VM sizes, see: https://docs.microsoft.com/azure/aks/quotas-skus-regions
- vnet
Subnet StringID - If this is not specified, a VNET and subnet will be generated and used. If no podSubnetID is specified, this applies to nodes and pods, otherwise it applies to just nodes. This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- workload
Runtime String - Determines the type of workload a node can run.
- current
Orchestrator stringVersion - If orchestratorVersion is a fully specified version <major.minor.patch>, this field will be exactly equal to it. If orchestratorVersion is <major.minor>, this field will contain the full <major.minor.patch> version being used.
- id string
- Resource ID.
- name string
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- node
Image stringVersion - The version of node image
- provisioning
State string - The current deployment or provisioning state.
- type string
- Resource type
- availability
Zones string[] - The list of Availability zones to use for nodes. This can only be specified if the AgentPoolType property is 'VirtualMachineScaleSets'.
- count number
- Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 1000 (inclusive) for user pools and in the range of 1 to 1000 (inclusive) for system pools. The default value is 1.
- creation
Data CreationData Response - CreationData to be used to specify the source Snapshot ID if the node pool will be created/upgraded using a snapshot.
- enable
Auto booleanScaling - Whether to enable auto-scaler
- enable
Encryption booleanAt Host - This is only supported on certain VM sizes and in certain Azure regions. For more information, see: https://docs.microsoft.com/azure/aks/enable-host-encryption
- enable
FIPS boolean - See Add a FIPS-enabled node pool for more details.
- enable
Node booleanPublic IP - Some scenarios may require nodes in a node pool to receive their own dedicated public IP addresses. A common scenario is for gaming workloads, where a console needs to make a direct connection to a cloud virtual machine to minimize hops. For more information see assigning a public IP per node. The default is false.
- enable
Ultra booleanSSD - Whether to enable UltraSSD
- gpu
Instance stringProfile - GPUInstanceProfile to be used to specify GPU MIG instance profile for supported GPU VM SKU.
- host
Group stringID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. For more information see Azure dedicated hosts.
- kubelet
Config KubeletConfig Response - The Kubelet configuration on the agent pool nodes.
- kubelet
Disk stringType - Determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage.
- linux
OSConfig LinuxOSConfig Response - The OS configuration of Linux agent nodes.
- max
Count number - The maximum number of nodes for auto-scaling
- max
Pods number - The maximum number of pods that can run on a node.
- min
Count number - The minimum number of nodes for auto-scaling
- mode string
- A cluster must have at least one 'System' Agent Pool at all times. For additional information on agent pool restrictions and best practices, see: https://docs.microsoft.com/azure/aks/use-system-pools
- node
Labels {[key: string]: string} - The node labels to be persisted across all nodes in agent pool.
- node
Public stringIPPrefix ID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
- node
Taints string[] - The taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
- orchestrator
Version string - Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. As a best practice, you should upgrade all node pools in an AKS cluster to the same Kubernetes version. The node pool version must have the same major version as the control plane. The node pool minor version must be within two minor versions of the control plane version. The node pool version cannot be greater than the control plane version. For more information see upgrading a node pool.
- os
Disk numberSize GB - OS Disk Size in GB to be used to specify the disk size for every machine in the master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
- os
Disk stringType - The default is 'Ephemeral' if the VM supports it and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation. For more information see Ephemeral OS.
- os
SKU string - Specifies the OS SKU used by the agent pool. The default is Ubuntu if OSType is Linux. The default is Windows2019 when Kubernetes <= 1.24 or Windows2022 when Kubernetes >= 1.25 if OSType is Windows.
- os
Type string - The operating system type. The default is Linux.
- pod
Subnet stringID - If omitted, pod IPs are statically assigned on the node subnet (see vnetSubnetID for more details). This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- power
State PowerState Response - When an Agent Pool is first created it is initially Running. The Agent Pool can be stopped by setting this field to Stopped. A stopped Agent Pool stops all of its VMs and does not accrue billing charges. An Agent Pool can only be stopped if it is Running and provisioning state is Succeeded
- proximity
Placement stringGroup ID - The ID for Proximity Placement Group.
- scale
Down stringMode - This also effects the cluster autoscaler behavior. If not specified, it defaults to Delete.
- scale
Set stringEviction Policy - This cannot be specified unless the scaleSetPriority is 'Spot'. If not specified, the default is 'Delete'.
- scale
Set stringPriority - The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
- spot
Max numberPrice - Possible values are any decimal value greater than zero or -1 which indicates the willingness to pay any on-demand price. For more details on spot pricing, see spot VMs pricing
- {[key: string]: string}
- The tags to be persisted on the agent pool virtual machine scale set.
- upgrade
Settings AgentPool Upgrade Settings Response - Settings for upgrading the agentpool
- vm
Size string - VM size availability varies by region. If a node contains insufficient compute resources (memory, cpu, etc) pods might fail to run correctly. For more details on restricted VM sizes, see: https://docs.microsoft.com/azure/aks/quotas-skus-regions
- vnet
Subnet stringID - If this is not specified, a VNET and subnet will be generated and used. If no podSubnetID is specified, this applies to nodes and pods, otherwise it applies to just nodes. This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- workload
Runtime string - Determines the type of workload a node can run.
- current_
orchestrator_ strversion - If orchestratorVersion is a fully specified version <major.minor.patch>, this field will be exactly equal to it. If orchestratorVersion is <major.minor>, this field will contain the full <major.minor.patch> version being used.
- id str
- Resource ID.
- name str
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- node_
image_ strversion - The version of node image
- provisioning_
state str - The current deployment or provisioning state.
- type str
- Resource type
- availability_
zones Sequence[str] - The list of Availability zones to use for nodes. This can only be specified if the AgentPoolType property is 'VirtualMachineScaleSets'.
- count int
- Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 1000 (inclusive) for user pools and in the range of 1 to 1000 (inclusive) for system pools. The default value is 1.
- creation_
data CreationData Response - CreationData to be used to specify the source Snapshot ID if the node pool will be created/upgraded using a snapshot.
- enable_
auto_ boolscaling - Whether to enable auto-scaler
- enable_
encryption_ boolat_ host - This is only supported on certain VM sizes and in certain Azure regions. For more information, see: https://docs.microsoft.com/azure/aks/enable-host-encryption
- enable_
fips bool - See Add a FIPS-enabled node pool for more details.
- enable_
node_ boolpublic_ ip - Some scenarios may require nodes in a node pool to receive their own dedicated public IP addresses. A common scenario is for gaming workloads, where a console needs to make a direct connection to a cloud virtual machine to minimize hops. For more information see assigning a public IP per node. The default is false.
- enable_
ultra_ boolssd - Whether to enable UltraSSD
- gpu_
instance_ strprofile - GPUInstanceProfile to be used to specify GPU MIG instance profile for supported GPU VM SKU.
- host_
group_ strid - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. For more information see Azure dedicated hosts.
- kubelet_
config KubeletConfig Response - The Kubelet configuration on the agent pool nodes.
- kubelet_
disk_ strtype - Determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage.
- linux_
os_ Linuxconfig OSConfig Response - The OS configuration of Linux agent nodes.
- max_
count int - The maximum number of nodes for auto-scaling
- max_
pods int - The maximum number of pods that can run on a node.
- min_
count int - The minimum number of nodes for auto-scaling
- mode str
- A cluster must have at least one 'System' Agent Pool at all times. For additional information on agent pool restrictions and best practices, see: https://docs.microsoft.com/azure/aks/use-system-pools
- node_
labels Mapping[str, str] - The node labels to be persisted across all nodes in agent pool.
- node_
public_ strip_ prefix_ id - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
- node_
taints Sequence[str] - The taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
- orchestrator_
version str - Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. As a best practice, you should upgrade all node pools in an AKS cluster to the same Kubernetes version. The node pool version must have the same major version as the control plane. The node pool minor version must be within two minor versions of the control plane version. The node pool version cannot be greater than the control plane version. For more information see upgrading a node pool.
- os_
disk_ intsize_ gb - OS Disk Size in GB to be used to specify the disk size for every machine in the master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
- os_
disk_ strtype - The default is 'Ephemeral' if the VM supports it and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation. For more information see Ephemeral OS.
- os_
sku str - Specifies the OS SKU used by the agent pool. The default is Ubuntu if OSType is Linux. The default is Windows2019 when Kubernetes <= 1.24 or Windows2022 when Kubernetes >= 1.25 if OSType is Windows.
- os_
type str - The operating system type. The default is Linux.
- pod_
subnet_ strid - If omitted, pod IPs are statically assigned on the node subnet (see vnetSubnetID for more details). This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- power_
state PowerState Response - When an Agent Pool is first created it is initially Running. The Agent Pool can be stopped by setting this field to Stopped. A stopped Agent Pool stops all of its VMs and does not accrue billing charges. An Agent Pool can only be stopped if it is Running and provisioning state is Succeeded
- proximity_
placement_ strgroup_ id - The ID for Proximity Placement Group.
- scale_
down_ strmode - This also effects the cluster autoscaler behavior. If not specified, it defaults to Delete.
- scale_
set_ streviction_ policy - This cannot be specified unless the scaleSetPriority is 'Spot'. If not specified, the default is 'Delete'.
- scale_
set_ strpriority - The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
- spot_
max_ floatprice - Possible values are any decimal value greater than zero or -1 which indicates the willingness to pay any on-demand price. For more details on spot pricing, see spot VMs pricing
- Mapping[str, str]
- The tags to be persisted on the agent pool virtual machine scale set.
- upgrade_
settings AgentPool Upgrade Settings Response - Settings for upgrading the agentpool
- vm_
size str - VM size availability varies by region. If a node contains insufficient compute resources (memory, cpu, etc) pods might fail to run correctly. For more details on restricted VM sizes, see: https://docs.microsoft.com/azure/aks/quotas-skus-regions
- vnet_
subnet_ strid - If this is not specified, a VNET and subnet will be generated and used. If no podSubnetID is specified, this applies to nodes and pods, otherwise it applies to just nodes. This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- workload_
runtime str - Determines the type of workload a node can run.
- current
Orchestrator StringVersion - If orchestratorVersion is a fully specified version <major.minor.patch>, this field will be exactly equal to it. If orchestratorVersion is <major.minor>, this field will contain the full <major.minor.patch> version being used.
- id String
- Resource ID.
- name String
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- node
Image StringVersion - The version of node image
- provisioning
State String - The current deployment or provisioning state.
- type String
- Resource type
- availability
Zones List<String> - The list of Availability zones to use for nodes. This can only be specified if the AgentPoolType property is 'VirtualMachineScaleSets'.
- count Number
- Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 1000 (inclusive) for user pools and in the range of 1 to 1000 (inclusive) for system pools. The default value is 1.
- creation
Data Property Map - CreationData to be used to specify the source Snapshot ID if the node pool will be created/upgraded using a snapshot.
- enable
Auto BooleanScaling - Whether to enable auto-scaler
- enable
Encryption BooleanAt Host - This is only supported on certain VM sizes and in certain Azure regions. For more information, see: https://docs.microsoft.com/azure/aks/enable-host-encryption
- enable
FIPS Boolean - See Add a FIPS-enabled node pool for more details.
- enable
Node BooleanPublic IP - Some scenarios may require nodes in a node pool to receive their own dedicated public IP addresses. A common scenario is for gaming workloads, where a console needs to make a direct connection to a cloud virtual machine to minimize hops. For more information see assigning a public IP per node. The default is false.
- enable
Ultra BooleanSSD - Whether to enable UltraSSD
- gpu
Instance StringProfile - GPUInstanceProfile to be used to specify GPU MIG instance profile for supported GPU VM SKU.
- host
Group StringID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. For more information see Azure dedicated hosts.
- kubelet
Config Property Map - The Kubelet configuration on the agent pool nodes.
- kubelet
Disk StringType - Determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage.
- linux
OSConfig Property Map - The OS configuration of Linux agent nodes.
- max
Count Number - The maximum number of nodes for auto-scaling
- max
Pods Number - The maximum number of pods that can run on a node.
- min
Count Number - The minimum number of nodes for auto-scaling
- mode String
- A cluster must have at least one 'System' Agent Pool at all times. For additional information on agent pool restrictions and best practices, see: https://docs.microsoft.com/azure/aks/use-system-pools
- node
Labels Map<String> - The node labels to be persisted across all nodes in agent pool.
- node
Public StringIPPrefix ID - This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
- node
Taints List<String> - The taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
- orchestrator
Version String - Both patch version <major.minor.patch> (e.g. 1.20.13) and <major.minor> (e.g. 1.20) are supported. When <major.minor> is specified, the latest supported GA patch version is chosen automatically. Updating the cluster with the same <major.minor> once it has been created (e.g. 1.14.x -> 1.14) will not trigger an upgrade, even if a newer patch version is available. As a best practice, you should upgrade all node pools in an AKS cluster to the same Kubernetes version. The node pool version must have the same major version as the control plane. The node pool minor version must be within two minor versions of the control plane version. The node pool version cannot be greater than the control plane version. For more information see upgrading a node pool.
- os
Disk NumberSize GB - OS Disk Size in GB to be used to specify the disk size for every machine in the master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
- os
Disk StringType - The default is 'Ephemeral' if the VM supports it and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation. For more information see Ephemeral OS.
- os
SKU String - Specifies the OS SKU used by the agent pool. The default is Ubuntu if OSType is Linux. The default is Windows2019 when Kubernetes <= 1.24 or Windows2022 when Kubernetes >= 1.25 if OSType is Windows.
- os
Type String - The operating system type. The default is Linux.
- pod
Subnet StringID - If omitted, pod IPs are statically assigned on the node subnet (see vnetSubnetID for more details). This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- power
State Property Map - When an Agent Pool is first created it is initially Running. The Agent Pool can be stopped by setting this field to Stopped. A stopped Agent Pool stops all of its VMs and does not accrue billing charges. An Agent Pool can only be stopped if it is Running and provisioning state is Succeeded
- proximity
Placement StringGroup ID - The ID for Proximity Placement Group.
- scale
Down StringMode - This also effects the cluster autoscaler behavior. If not specified, it defaults to Delete.
- scale
Set StringEviction Policy - This cannot be specified unless the scaleSetPriority is 'Spot'. If not specified, the default is 'Delete'.
- scale
Set StringPriority - The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
- spot
Max NumberPrice - Possible values are any decimal value greater than zero or -1 which indicates the willingness to pay any on-demand price. For more details on spot pricing, see spot VMs pricing
- Map<String>
- The tags to be persisted on the agent pool virtual machine scale set.
- upgrade
Settings Property Map - Settings for upgrading the agentpool
- vm
Size String - VM size availability varies by region. If a node contains insufficient compute resources (memory, cpu, etc) pods might fail to run correctly. For more details on restricted VM sizes, see: https://docs.microsoft.com/azure/aks/quotas-skus-regions
- vnet
Subnet StringID - If this is not specified, a VNET and subnet will be generated and used. If no podSubnetID is specified, this applies to nodes and pods, otherwise it applies to just nodes. This is of the form: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
- workload
Runtime String - Determines the type of workload a node can run.
Supporting Types
AgentPoolUpgradeSettingsResponse
- Max
Surge string - This can either be set to an integer (e.g. '5') or a percentage (e.g. '50%'). If a percentage is specified, it is the percentage of the total agent pool size at the time of the upgrade. For percentages, fractional nodes are rounded up. If not specified, the default is 1. For more information, including best practices, see: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
- Max
Surge string - This can either be set to an integer (e.g. '5') or a percentage (e.g. '50%'). If a percentage is specified, it is the percentage of the total agent pool size at the time of the upgrade. For percentages, fractional nodes are rounded up. If not specified, the default is 1. For more information, including best practices, see: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
- max
Surge String - This can either be set to an integer (e.g. '5') or a percentage (e.g. '50%'). If a percentage is specified, it is the percentage of the total agent pool size at the time of the upgrade. For percentages, fractional nodes are rounded up. If not specified, the default is 1. For more information, including best practices, see: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
- max
Surge string - This can either be set to an integer (e.g. '5') or a percentage (e.g. '50%'). If a percentage is specified, it is the percentage of the total agent pool size at the time of the upgrade. For percentages, fractional nodes are rounded up. If not specified, the default is 1. For more information, including best practices, see: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
- max_
surge str - This can either be set to an integer (e.g. '5') or a percentage (e.g. '50%'). If a percentage is specified, it is the percentage of the total agent pool size at the time of the upgrade. For percentages, fractional nodes are rounded up. If not specified, the default is 1. For more information, including best practices, see: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
- max
Surge String - This can either be set to an integer (e.g. '5') or a percentage (e.g. '50%'). If a percentage is specified, it is the percentage of the total agent pool size at the time of the upgrade. For percentages, fractional nodes are rounded up. If not specified, the default is 1. For more information, including best practices, see: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
CreationDataResponse
- Source
Resource stringId - This is the ARM ID of the source object to be used to create the target object.
- Source
Resource stringId - This is the ARM ID of the source object to be used to create the target object.
- source
Resource StringId - This is the ARM ID of the source object to be used to create the target object.
- source
Resource stringId - This is the ARM ID of the source object to be used to create the target object.
- source_
resource_ strid - This is the ARM ID of the source object to be used to create the target object.
- source
Resource StringId - This is the ARM ID of the source object to be used to create the target object.
KubeletConfigResponse
- Allowed
Unsafe List<string>Sysctls - Allowed list of unsafe sysctls or unsafe sysctl patterns (ending in
*
). - Container
Log intMax Files - The maximum number of container log files that can be present for a container. The number must be ≥ 2.
- Container
Log intMax Size MB - The maximum size (e.g. 10Mi) of container log file before it is rotated.
- Cpu
Cfs boolQuota - The default is true.
- Cpu
Cfs stringQuota Period - The default is '100ms.' Valid values are a sequence of decimal numbers with an optional fraction and a unit suffix. For example: '300ms', '2h45m'. Supported units are 'ns', 'us', 'ms', 's', 'm', and 'h'.
- Cpu
Manager stringPolicy - The default is 'none'. See Kubernetes CPU management policies for more information. Allowed values are 'none' and 'static'.
- Fail
Swap boolOn - If set to true it will make the Kubelet fail to start if swap is enabled on the node.
- Image
Gc intHigh Threshold - To disable image garbage collection, set to 100. The default is 85%
- Image
Gc intLow Threshold - This cannot be set higher than imageGcHighThreshold. The default is 80%
- Pod
Max intPids - The maximum number of processes per pod.
- Topology
Manager stringPolicy - For more information see Kubernetes Topology Manager. The default is 'none'. Allowed values are 'none', 'best-effort', 'restricted', and 'single-numa-node'.
- Allowed
Unsafe []stringSysctls - Allowed list of unsafe sysctls or unsafe sysctl patterns (ending in
*
). - Container
Log intMax Files - The maximum number of container log files that can be present for a container. The number must be ≥ 2.
- Container
Log intMax Size MB - The maximum size (e.g. 10Mi) of container log file before it is rotated.
- Cpu
Cfs boolQuota - The default is true.
- Cpu
Cfs stringQuota Period - The default is '100ms.' Valid values are a sequence of decimal numbers with an optional fraction and a unit suffix. For example: '300ms', '2h45m'. Supported units are 'ns', 'us', 'ms', 's', 'm', and 'h'.
- Cpu
Manager stringPolicy - The default is 'none'. See Kubernetes CPU management policies for more information. Allowed values are 'none' and 'static'.
- Fail
Swap boolOn - If set to true it will make the Kubelet fail to start if swap is enabled on the node.
- Image
Gc intHigh Threshold - To disable image garbage collection, set to 100. The default is 85%
- Image
Gc intLow Threshold - This cannot be set higher than imageGcHighThreshold. The default is 80%
- Pod
Max intPids - The maximum number of processes per pod.
- Topology
Manager stringPolicy - For more information see Kubernetes Topology Manager. The default is 'none'. Allowed values are 'none', 'best-effort', 'restricted', and 'single-numa-node'.
- allowed
Unsafe List<String>Sysctls - Allowed list of unsafe sysctls or unsafe sysctl patterns (ending in
*
). - container
Log IntegerMax Files - The maximum number of container log files that can be present for a container. The number must be ≥ 2.
- container
Log IntegerMax Size MB - The maximum size (e.g. 10Mi) of container log file before it is rotated.
- cpu
Cfs BooleanQuota - The default is true.
- cpu
Cfs StringQuota Period - The default is '100ms.' Valid values are a sequence of decimal numbers with an optional fraction and a unit suffix. For example: '300ms', '2h45m'. Supported units are 'ns', 'us', 'ms', 's', 'm', and 'h'.
- cpu
Manager StringPolicy - The default is 'none'. See Kubernetes CPU management policies for more information. Allowed values are 'none' and 'static'.
- fail
Swap BooleanOn - If set to true it will make the Kubelet fail to start if swap is enabled on the node.
- image
Gc IntegerHigh Threshold - To disable image garbage collection, set to 100. The default is 85%
- image
Gc IntegerLow Threshold - This cannot be set higher than imageGcHighThreshold. The default is 80%
- pod
Max IntegerPids - The maximum number of processes per pod.
- topology
Manager StringPolicy - For more information see Kubernetes Topology Manager. The default is 'none'. Allowed values are 'none', 'best-effort', 'restricted', and 'single-numa-node'.
- allowed
Unsafe string[]Sysctls - Allowed list of unsafe sysctls or unsafe sysctl patterns (ending in
*
). - container
Log numberMax Files - The maximum number of container log files that can be present for a container. The number must be ≥ 2.
- container
Log numberMax Size MB - The maximum size (e.g. 10Mi) of container log file before it is rotated.
- cpu
Cfs booleanQuota - The default is true.
- cpu
Cfs stringQuota Period - The default is '100ms.' Valid values are a sequence of decimal numbers with an optional fraction and a unit suffix. For example: '300ms', '2h45m'. Supported units are 'ns', 'us', 'ms', 's', 'm', and 'h'.
- cpu
Manager stringPolicy - The default is 'none'. See Kubernetes CPU management policies for more information. Allowed values are 'none' and 'static'.
- fail
Swap booleanOn - If set to true it will make the Kubelet fail to start if swap is enabled on the node.
- image
Gc numberHigh Threshold - To disable image garbage collection, set to 100. The default is 85%
- image
Gc numberLow Threshold - This cannot be set higher than imageGcHighThreshold. The default is 80%
- pod
Max numberPids - The maximum number of processes per pod.
- topology
Manager stringPolicy - For more information see Kubernetes Topology Manager. The default is 'none'. Allowed values are 'none', 'best-effort', 'restricted', and 'single-numa-node'.
- allowed_
unsafe_ Sequence[str]sysctls - Allowed list of unsafe sysctls or unsafe sysctl patterns (ending in
*
). - container_
log_ intmax_ files - The maximum number of container log files that can be present for a container. The number must be ≥ 2.
- container_
log_ intmax_ size_ mb - The maximum size (e.g. 10Mi) of container log file before it is rotated.
- cpu_
cfs_ boolquota - The default is true.
- cpu_
cfs_ strquota_ period - The default is '100ms.' Valid values are a sequence of decimal numbers with an optional fraction and a unit suffix. For example: '300ms', '2h45m'. Supported units are 'ns', 'us', 'ms', 's', 'm', and 'h'.
- cpu_
manager_ strpolicy - The default is 'none'. See Kubernetes CPU management policies for more information. Allowed values are 'none' and 'static'.
- fail_
swap_ boolon - If set to true it will make the Kubelet fail to start if swap is enabled on the node.
- image_
gc_ inthigh_ threshold - To disable image garbage collection, set to 100. The default is 85%
- image_
gc_ intlow_ threshold - This cannot be set higher than imageGcHighThreshold. The default is 80%
- pod_
max_ intpids - The maximum number of processes per pod.
- topology_
manager_ strpolicy - For more information see Kubernetes Topology Manager. The default is 'none'. Allowed values are 'none', 'best-effort', 'restricted', and 'single-numa-node'.
- allowed
Unsafe List<String>Sysctls - Allowed list of unsafe sysctls or unsafe sysctl patterns (ending in
*
). - container
Log NumberMax Files - The maximum number of container log files that can be present for a container. The number must be ≥ 2.
- container
Log NumberMax Size MB - The maximum size (e.g. 10Mi) of container log file before it is rotated.
- cpu
Cfs BooleanQuota - The default is true.
- cpu
Cfs StringQuota Period - The default is '100ms.' Valid values are a sequence of decimal numbers with an optional fraction and a unit suffix. For example: '300ms', '2h45m'. Supported units are 'ns', 'us', 'ms', 's', 'm', and 'h'.
- cpu
Manager StringPolicy - The default is 'none'. See Kubernetes CPU management policies for more information. Allowed values are 'none' and 'static'.
- fail
Swap BooleanOn - If set to true it will make the Kubelet fail to start if swap is enabled on the node.
- image
Gc NumberHigh Threshold - To disable image garbage collection, set to 100. The default is 85%
- image
Gc NumberLow Threshold - This cannot be set higher than imageGcHighThreshold. The default is 80%
- pod
Max NumberPids - The maximum number of processes per pod.
- topology
Manager StringPolicy - For more information see Kubernetes Topology Manager. The default is 'none'. Allowed values are 'none', 'best-effort', 'restricted', and 'single-numa-node'.
LinuxOSConfigResponse
- Swap
File intSize MB - The size in MB of a swap file that will be created on each node.
- Sysctls
Pulumi.
Azure Native. Container Service. Inputs. Sysctl Config Response - Sysctl settings for Linux agent nodes.
- Transparent
Huge stringPage Defrag - Valid values are 'always', 'defer', 'defer+madvise', 'madvise' and 'never'. The default is 'madvise'. For more information see Transparent Hugepages.
- Transparent
Huge stringPage Enabled - Valid values are 'always', 'madvise', and 'never'. The default is 'always'. For more information see Transparent Hugepages.
- Swap
File intSize MB - The size in MB of a swap file that will be created on each node.
- Sysctls
Sysctl
Config Response - Sysctl settings for Linux agent nodes.
- Transparent
Huge stringPage Defrag - Valid values are 'always', 'defer', 'defer+madvise', 'madvise' and 'never'. The default is 'madvise'. For more information see Transparent Hugepages.
- Transparent
Huge stringPage Enabled - Valid values are 'always', 'madvise', and 'never'. The default is 'always'. For more information see Transparent Hugepages.
- swap
File IntegerSize MB - The size in MB of a swap file that will be created on each node.
- sysctls
Sysctl
Config Response - Sysctl settings for Linux agent nodes.
- transparent
Huge StringPage Defrag - Valid values are 'always', 'defer', 'defer+madvise', 'madvise' and 'never'. The default is 'madvise'. For more information see Transparent Hugepages.
- transparent
Huge StringPage Enabled - Valid values are 'always', 'madvise', and 'never'. The default is 'always'. For more information see Transparent Hugepages.
- swap
File numberSize MB - The size in MB of a swap file that will be created on each node.
- sysctls
Sysctl
Config Response - Sysctl settings for Linux agent nodes.
- transparent
Huge stringPage Defrag - Valid values are 'always', 'defer', 'defer+madvise', 'madvise' and 'never'. The default is 'madvise'. For more information see Transparent Hugepages.
- transparent
Huge stringPage Enabled - Valid values are 'always', 'madvise', and 'never'. The default is 'always'. For more information see Transparent Hugepages.
- swap_
file_ intsize_ mb - The size in MB of a swap file that will be created on each node.
- sysctls
Sysctl
Config Response - Sysctl settings for Linux agent nodes.
- transparent_
huge_ strpage_ defrag - Valid values are 'always', 'defer', 'defer+madvise', 'madvise' and 'never'. The default is 'madvise'. For more information see Transparent Hugepages.
- transparent_
huge_ strpage_ enabled - Valid values are 'always', 'madvise', and 'never'. The default is 'always'. For more information see Transparent Hugepages.
- swap
File NumberSize MB - The size in MB of a swap file that will be created on each node.
- sysctls Property Map
- Sysctl settings for Linux agent nodes.
- transparent
Huge StringPage Defrag - Valid values are 'always', 'defer', 'defer+madvise', 'madvise' and 'never'. The default is 'madvise'. For more information see Transparent Hugepages.
- transparent
Huge StringPage Enabled - Valid values are 'always', 'madvise', and 'never'. The default is 'always'. For more information see Transparent Hugepages.
PowerStateResponse
- Code string
- Tells whether the cluster is Running or Stopped
- Code string
- Tells whether the cluster is Running or Stopped
- code String
- Tells whether the cluster is Running or Stopped
- code string
- Tells whether the cluster is Running or Stopped
- code str
- Tells whether the cluster is Running or Stopped
- code String
- Tells whether the cluster is Running or Stopped
SysctlConfigResponse
- Fs
Aio intMax Nr - Sysctl setting fs.aio-max-nr.
- Fs
File intMax - Sysctl setting fs.file-max.
- Fs
Inotify intMax User Watches - Sysctl setting fs.inotify.max_user_watches.
- Fs
Nr intOpen - Sysctl setting fs.nr_open.
- Kernel
Threads intMax - Sysctl setting kernel.threads-max.
- Net
Core intNetdev Max Backlog - Sysctl setting net.core.netdev_max_backlog.
- Net
Core intOptmem Max - Sysctl setting net.core.optmem_max.
- Net
Core intRmem Default - Sysctl setting net.core.rmem_default.
- Net
Core intRmem Max - Sysctl setting net.core.rmem_max.
- Net
Core intSomaxconn - Sysctl setting net.core.somaxconn.
- Net
Core intWmem Default - Sysctl setting net.core.wmem_default.
- Net
Core intWmem Max - Sysctl setting net.core.wmem_max.
- Net
Ipv4Ip stringLocal Port Range - Sysctl setting net.ipv4.ip_local_port_range.
- Net
Ipv4Neigh intDefault Gc Thresh1 - Sysctl setting net.ipv4.neigh.default.gc_thresh1.
- Net
Ipv4Neigh intDefault Gc Thresh2 - Sysctl setting net.ipv4.neigh.default.gc_thresh2.
- Net
Ipv4Neigh intDefault Gc Thresh3 - Sysctl setting net.ipv4.neigh.default.gc_thresh3.
- Net
Ipv4Tcp intFin Timeout - Sysctl setting net.ipv4.tcp_fin_timeout.
- Net
Ipv4Tcp intKeepalive Probes - Sysctl setting net.ipv4.tcp_keepalive_probes.
- Net
Ipv4Tcp intKeepalive Time - Sysctl setting net.ipv4.tcp_keepalive_time.
- Net
Ipv4Tcp intMax Syn Backlog - Sysctl setting net.ipv4.tcp_max_syn_backlog.
- Net
Ipv4Tcp intMax Tw Buckets - Sysctl setting net.ipv4.tcp_max_tw_buckets.
- Net
Ipv4Tcp boolTw Reuse - Sysctl setting net.ipv4.tcp_tw_reuse.
- Net
Ipv4Tcpkeepalive intIntvl - Sysctl setting net.ipv4.tcp_keepalive_intvl.
- Net
Netfilter intNf Conntrack Buckets - Sysctl setting net.netfilter.nf_conntrack_buckets.
- Net
Netfilter intNf Conntrack Max - Sysctl setting net.netfilter.nf_conntrack_max.
- Vm
Max intMap Count - Sysctl setting vm.max_map_count.
- Vm
Swappiness int - Sysctl setting vm.swappiness.
- Vm
Vfs intCache Pressure - Sysctl setting vm.vfs_cache_pressure.
- Fs
Aio intMax Nr - Sysctl setting fs.aio-max-nr.
- Fs
File intMax - Sysctl setting fs.file-max.
- Fs
Inotify intMax User Watches - Sysctl setting fs.inotify.max_user_watches.
- Fs
Nr intOpen - Sysctl setting fs.nr_open.
- Kernel
Threads intMax - Sysctl setting kernel.threads-max.
- Net
Core intNetdev Max Backlog - Sysctl setting net.core.netdev_max_backlog.
- Net
Core intOptmem Max - Sysctl setting net.core.optmem_max.
- Net
Core intRmem Default - Sysctl setting net.core.rmem_default.
- Net
Core intRmem Max - Sysctl setting net.core.rmem_max.
- Net
Core intSomaxconn - Sysctl setting net.core.somaxconn.
- Net
Core intWmem Default - Sysctl setting net.core.wmem_default.
- Net
Core intWmem Max - Sysctl setting net.core.wmem_max.
- Net
Ipv4Ip stringLocal Port Range - Sysctl setting net.ipv4.ip_local_port_range.
- Net
Ipv4Neigh intDefault Gc Thresh1 - Sysctl setting net.ipv4.neigh.default.gc_thresh1.
- Net
Ipv4Neigh intDefault Gc Thresh2 - Sysctl setting net.ipv4.neigh.default.gc_thresh2.
- Net
Ipv4Neigh intDefault Gc Thresh3 - Sysctl setting net.ipv4.neigh.default.gc_thresh3.
- Net
Ipv4Tcp intFin Timeout - Sysctl setting net.ipv4.tcp_fin_timeout.
- Net
Ipv4Tcp intKeepalive Probes - Sysctl setting net.ipv4.tcp_keepalive_probes.
- Net
Ipv4Tcp intKeepalive Time - Sysctl setting net.ipv4.tcp_keepalive_time.
- Net
Ipv4Tcp intMax Syn Backlog - Sysctl setting net.ipv4.tcp_max_syn_backlog.
- Net
Ipv4Tcp intMax Tw Buckets - Sysctl setting net.ipv4.tcp_max_tw_buckets.
- Net
Ipv4Tcp boolTw Reuse - Sysctl setting net.ipv4.tcp_tw_reuse.
- Net
Ipv4Tcpkeepalive intIntvl - Sysctl setting net.ipv4.tcp_keepalive_intvl.
- Net
Netfilter intNf Conntrack Buckets - Sysctl setting net.netfilter.nf_conntrack_buckets.
- Net
Netfilter intNf Conntrack Max - Sysctl setting net.netfilter.nf_conntrack_max.
- Vm
Max intMap Count - Sysctl setting vm.max_map_count.
- Vm
Swappiness int - Sysctl setting vm.swappiness.
- Vm
Vfs intCache Pressure - Sysctl setting vm.vfs_cache_pressure.
- fs
Aio IntegerMax Nr - Sysctl setting fs.aio-max-nr.
- fs
File IntegerMax - Sysctl setting fs.file-max.
- fs
Inotify IntegerMax User Watches - Sysctl setting fs.inotify.max_user_watches.
- fs
Nr IntegerOpen - Sysctl setting fs.nr_open.
- kernel
Threads IntegerMax - Sysctl setting kernel.threads-max.
- net
Core IntegerNetdev Max Backlog - Sysctl setting net.core.netdev_max_backlog.
- net
Core IntegerOptmem Max - Sysctl setting net.core.optmem_max.
- net
Core IntegerRmem Default - Sysctl setting net.core.rmem_default.
- net
Core IntegerRmem Max - Sysctl setting net.core.rmem_max.
- net
Core IntegerSomaxconn - Sysctl setting net.core.somaxconn.
- net
Core IntegerWmem Default - Sysctl setting net.core.wmem_default.
- net
Core IntegerWmem Max - Sysctl setting net.core.wmem_max.
- net
Ipv4Ip StringLocal Port Range - Sysctl setting net.ipv4.ip_local_port_range.
- net
Ipv4Neigh IntegerDefault Gc Thresh1 - Sysctl setting net.ipv4.neigh.default.gc_thresh1.
- net
Ipv4Neigh IntegerDefault Gc Thresh2 - Sysctl setting net.ipv4.neigh.default.gc_thresh2.
- net
Ipv4Neigh IntegerDefault Gc Thresh3 - Sysctl setting net.ipv4.neigh.default.gc_thresh3.
- net
Ipv4Tcp IntegerFin Timeout - Sysctl setting net.ipv4.tcp_fin_timeout.
- net
Ipv4Tcp IntegerKeepalive Probes - Sysctl setting net.ipv4.tcp_keepalive_probes.
- net
Ipv4Tcp IntegerKeepalive Time - Sysctl setting net.ipv4.tcp_keepalive_time.
- net
Ipv4Tcp IntegerMax Syn Backlog - Sysctl setting net.ipv4.tcp_max_syn_backlog.
- net
Ipv4Tcp IntegerMax Tw Buckets - Sysctl setting net.ipv4.tcp_max_tw_buckets.
- net
Ipv4Tcp BooleanTw Reuse - Sysctl setting net.ipv4.tcp_tw_reuse.
- net
Ipv4Tcpkeepalive IntegerIntvl - Sysctl setting net.ipv4.tcp_keepalive_intvl.
- net
Netfilter IntegerNf Conntrack Buckets - Sysctl setting net.netfilter.nf_conntrack_buckets.
- net
Netfilter IntegerNf Conntrack Max - Sysctl setting net.netfilter.nf_conntrack_max.
- vm
Max IntegerMap Count - Sysctl setting vm.max_map_count.
- vm
Swappiness Integer - Sysctl setting vm.swappiness.
- vm
Vfs IntegerCache Pressure - Sysctl setting vm.vfs_cache_pressure.
- fs
Aio numberMax Nr - Sysctl setting fs.aio-max-nr.
- fs
File numberMax - Sysctl setting fs.file-max.
- fs
Inotify numberMax User Watches - Sysctl setting fs.inotify.max_user_watches.
- fs
Nr numberOpen - Sysctl setting fs.nr_open.
- kernel
Threads numberMax - Sysctl setting kernel.threads-max.
- net
Core numberNetdev Max Backlog - Sysctl setting net.core.netdev_max_backlog.
- net
Core numberOptmem Max - Sysctl setting net.core.optmem_max.
- net
Core numberRmem Default - Sysctl setting net.core.rmem_default.
- net
Core numberRmem Max - Sysctl setting net.core.rmem_max.
- net
Core numberSomaxconn - Sysctl setting net.core.somaxconn.
- net
Core numberWmem Default - Sysctl setting net.core.wmem_default.
- net
Core numberWmem Max - Sysctl setting net.core.wmem_max.
- net
Ipv4Ip stringLocal Port Range - Sysctl setting net.ipv4.ip_local_port_range.
- net
Ipv4Neigh numberDefault Gc Thresh1 - Sysctl setting net.ipv4.neigh.default.gc_thresh1.
- net
Ipv4Neigh numberDefault Gc Thresh2 - Sysctl setting net.ipv4.neigh.default.gc_thresh2.
- net
Ipv4Neigh numberDefault Gc Thresh3 - Sysctl setting net.ipv4.neigh.default.gc_thresh3.
- net
Ipv4Tcp numberFin Timeout - Sysctl setting net.ipv4.tcp_fin_timeout.
- net
Ipv4Tcp numberKeepalive Probes - Sysctl setting net.ipv4.tcp_keepalive_probes.
- net
Ipv4Tcp numberKeepalive Time - Sysctl setting net.ipv4.tcp_keepalive_time.
- net
Ipv4Tcp numberMax Syn Backlog - Sysctl setting net.ipv4.tcp_max_syn_backlog.
- net
Ipv4Tcp numberMax Tw Buckets - Sysctl setting net.ipv4.tcp_max_tw_buckets.
- net
Ipv4Tcp booleanTw Reuse - Sysctl setting net.ipv4.tcp_tw_reuse.
- net
Ipv4Tcpkeepalive numberIntvl - Sysctl setting net.ipv4.tcp_keepalive_intvl.
- net
Netfilter numberNf Conntrack Buckets - Sysctl setting net.netfilter.nf_conntrack_buckets.
- net
Netfilter numberNf Conntrack Max - Sysctl setting net.netfilter.nf_conntrack_max.
- vm
Max numberMap Count - Sysctl setting vm.max_map_count.
- vm
Swappiness number - Sysctl setting vm.swappiness.
- vm
Vfs numberCache Pressure - Sysctl setting vm.vfs_cache_pressure.
- fs_
aio_ intmax_ nr - Sysctl setting fs.aio-max-nr.
- fs_
file_ intmax - Sysctl setting fs.file-max.
- fs_
inotify_ intmax_ user_ watches - Sysctl setting fs.inotify.max_user_watches.
- fs_
nr_ intopen - Sysctl setting fs.nr_open.
- kernel_
threads_ intmax - Sysctl setting kernel.threads-max.
- net_
core_ intnetdev_ max_ backlog - Sysctl setting net.core.netdev_max_backlog.
- net_
core_ intoptmem_ max - Sysctl setting net.core.optmem_max.
- net_
core_ intrmem_ default - Sysctl setting net.core.rmem_default.
- net_
core_ intrmem_ max - Sysctl setting net.core.rmem_max.
- net_
core_ intsomaxconn - Sysctl setting net.core.somaxconn.
- net_
core_ intwmem_ default - Sysctl setting net.core.wmem_default.
- net_
core_ intwmem_ max - Sysctl setting net.core.wmem_max.
- net_
ipv4_ strip_ local_ port_ range - Sysctl setting net.ipv4.ip_local_port_range.
- net_
ipv4_ intneigh_ default_ gc_ thresh1 - Sysctl setting net.ipv4.neigh.default.gc_thresh1.
- net_
ipv4_ intneigh_ default_ gc_ thresh2 - Sysctl setting net.ipv4.neigh.default.gc_thresh2.
- net_
ipv4_ intneigh_ default_ gc_ thresh3 - Sysctl setting net.ipv4.neigh.default.gc_thresh3.
- net_
ipv4_ inttcp_ fin_ timeout - Sysctl setting net.ipv4.tcp_fin_timeout.
- net_
ipv4_ inttcp_ keepalive_ probes - Sysctl setting net.ipv4.tcp_keepalive_probes.
- net_
ipv4_ inttcp_ keepalive_ time - Sysctl setting net.ipv4.tcp_keepalive_time.
- net_
ipv4_ inttcp_ max_ syn_ backlog - Sysctl setting net.ipv4.tcp_max_syn_backlog.
- net_
ipv4_ inttcp_ max_ tw_ buckets - Sysctl setting net.ipv4.tcp_max_tw_buckets.
- net_
ipv4_ booltcp_ tw_ reuse - Sysctl setting net.ipv4.tcp_tw_reuse.
- net_
ipv4_ inttcpkeepalive_ intvl - Sysctl setting net.ipv4.tcp_keepalive_intvl.
- net_
netfilter_ intnf_ conntrack_ buckets - Sysctl setting net.netfilter.nf_conntrack_buckets.
- net_
netfilter_ intnf_ conntrack_ max - Sysctl setting net.netfilter.nf_conntrack_max.
- vm_
max_ intmap_ count - Sysctl setting vm.max_map_count.
- vm_
swappiness int - Sysctl setting vm.swappiness.
- vm_
vfs_ intcache_ pressure - Sysctl setting vm.vfs_cache_pressure.
- fs
Aio NumberMax Nr - Sysctl setting fs.aio-max-nr.
- fs
File NumberMax - Sysctl setting fs.file-max.
- fs
Inotify NumberMax User Watches - Sysctl setting fs.inotify.max_user_watches.
- fs
Nr NumberOpen - Sysctl setting fs.nr_open.
- kernel
Threads NumberMax - Sysctl setting kernel.threads-max.
- net
Core NumberNetdev Max Backlog - Sysctl setting net.core.netdev_max_backlog.
- net
Core NumberOptmem Max - Sysctl setting net.core.optmem_max.
- net
Core NumberRmem Default - Sysctl setting net.core.rmem_default.
- net
Core NumberRmem Max - Sysctl setting net.core.rmem_max.
- net
Core NumberSomaxconn - Sysctl setting net.core.somaxconn.
- net
Core NumberWmem Default - Sysctl setting net.core.wmem_default.
- net
Core NumberWmem Max - Sysctl setting net.core.wmem_max.
- net
Ipv4Ip StringLocal Port Range - Sysctl setting net.ipv4.ip_local_port_range.
- net
Ipv4Neigh NumberDefault Gc Thresh1 - Sysctl setting net.ipv4.neigh.default.gc_thresh1.
- net
Ipv4Neigh NumberDefault Gc Thresh2 - Sysctl setting net.ipv4.neigh.default.gc_thresh2.
- net
Ipv4Neigh NumberDefault Gc Thresh3 - Sysctl setting net.ipv4.neigh.default.gc_thresh3.
- net
Ipv4Tcp NumberFin Timeout - Sysctl setting net.ipv4.tcp_fin_timeout.
- net
Ipv4Tcp NumberKeepalive Probes - Sysctl setting net.ipv4.tcp_keepalive_probes.
- net
Ipv4Tcp NumberKeepalive Time - Sysctl setting net.ipv4.tcp_keepalive_time.
- net
Ipv4Tcp NumberMax Syn Backlog - Sysctl setting net.ipv4.tcp_max_syn_backlog.
- net
Ipv4Tcp NumberMax Tw Buckets - Sysctl setting net.ipv4.tcp_max_tw_buckets.
- net
Ipv4Tcp BooleanTw Reuse - Sysctl setting net.ipv4.tcp_tw_reuse.
- net
Ipv4Tcpkeepalive NumberIntvl - Sysctl setting net.ipv4.tcp_keepalive_intvl.
- net
Netfilter NumberNf Conntrack Buckets - Sysctl setting net.netfilter.nf_conntrack_buckets.
- net
Netfilter NumberNf Conntrack Max - Sysctl setting net.netfilter.nf_conntrack_max.
- vm
Max NumberMap Count - Sysctl setting vm.max_map_count.
- vm
Swappiness Number - Sysctl setting vm.swappiness.
- vm
Vfs NumberCache Pressure - Sysctl setting vm.vfs_cache_pressure.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0