Managed Clusters - List

Reference

Service:: AKS

API Version:: 2021-02-01

Gets a list of managed clusters in the specified subscription. The operation returns properties of each managed cluster.

HTTP

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

URI Parameters

Name	In	Required	Type	Description
subscriptionId	path	True	string	Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
api-version	query	True	string	Client Api Version.

Responses

Name	Type	Description
200 OK	ManagedClusterListResult	OK
Other Status Codes	CloudError	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

List Managed Clusters

Sample request

HTTP

HTTP

GET https://management.azure.com/subscriptions/subid1/providers/Microsoft.ContainerService/managedClusters?api-version=2021-02-01

Sample response

Status code:: 200

JSON

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

Definitions

Name	Description
AgentPoolMode	AgentPoolMode represents mode of an agent pool.
AgentPoolType	AgentPoolType represents types of an agent pool.
AgentPoolUpgradeSettings	Settings for upgrading an agentpool
AutoScalerProfile	Parameters to be applied to the cluster-autoscaler when enabled
CloudError	An error response from the Container service.
CloudErrorBody	An error response from the Container service.
code	Tells whether the cluster is Running or Stopped
ContainerServiceLinuxProfile	Profile for Linux VMs in the container service cluster.
ContainerServiceNetworkProfile	Profile of network configuration.
ContainerServiceSshConfiguration	SSH configuration for Linux-based VMs running on Azure.
ContainerServiceSshPublicKey	Contains information about SSH certificate public key data.
ContainerServiceVMSizeTypes	Size of agent VMs.
expander
Identity	Information of user assigned identity used by this add-on.
KubeletConfig	Kubelet configurations of agent nodes.
KubeletDiskType	KubeletDiskType determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage. Allowed values: 'OS', 'Temporary' (preview).
licenseType	The licenseType to use for Windows VMs. Windows_Server is used to enable Azure Hybrid User Benefits for Windows VMs.
LinuxOSConfig	OS configurations of Linux agent nodes.
loadBalancerSku	The load balancer sku for the managed cluster.
ManagedCluster	Managed cluster.
ManagedClusterAADProfile	AADProfile specifies attributes for Azure Active Directory integration.
ManagedClusterAddonProfile	A Kubernetes add-on profile for a managed cluster.
ManagedClusterAgentPoolProfile	Profile for the container service agent pool.
ManagedClusterAPIServerAccessProfile	Access profile for managed cluster API server.
ManagedClusterAutoUpgradeProfile	Auto upgrade profile for a managed cluster.
ManagedClusterIdentity	Identity for the managed cluster.
ManagedClusterListResult	The response from the List Managed Clusters operation.
ManagedClusterLoadBalancerProfile	Profile of the managed cluster load balancer.
ManagedClusterPodIdentity
ManagedClusterPodIdentityException
ManagedClusterPodIdentityProfile
ManagedClusterPodIdentityProvisioningState	The current provisioning state of the pod identity.
ManagedClusterServicePrincipalProfile	Information about a service principal identity for the cluster to use for manipulating Azure APIs.
ManagedClusterSKU
ManagedClusterSKUName	Name of a managed cluster SKU.
ManagedClusterSKUTier	Tier of a managed cluster SKU.
ManagedClusterWindowsProfile	Profile for Windows VMs in the container service cluster.
ManagedOutboundIPs	Desired managed outbound IPs for the cluster load balancer.
networkMode	Network mode used for building Kubernetes network.
NetworkPlugin	Network plugin used for building Kubernetes network.
NetworkPolicy	Network policy used for building Kubernetes network.
OSDiskType	OSDiskType represents the type of an OS disk on an agent pool.
OSType	OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux.
OutboundIPPrefixes	Desired outbound IP Prefix resources for the cluster load balancer.
OutboundIPs	Desired outbound IP resources for the cluster load balancer.
outboundType	The outbound (egress) routing method.
PowerState	Describes the Power State of the cluster
ProvisioningInfo
ResourceIdentityType	The type of identity used for the managed cluster. Type 'SystemAssigned' will use an implicitly created identity in master components and an auto-created user assigned identity in MC_ resource group in agent nodes. Type 'None' will not use MSI for the managed cluster, service principal will be used instead.
ResourceReference	A reference to an Azure resource.
ScaleSetEvictionPolicy	ScaleSetEvictionPolicy to be used to specify eviction policy for Spot virtual machine scale set. Default to Delete.
ScaleSetPriority	ScaleSetPriority to be used to specify virtual machine scale set priority. Default to regular.
SysctlConfig	Sysctl settings for Linux agent nodes.
upgradeChannel	upgrade channel for auto upgrade.
UserAssignedIdentities	The user identity associated with the managed cluster. This identity will be used in control plane and only one user assigned identity is allowed. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
UserAssignedIdentity

AgentPoolMode

Enumeration

AgentPoolMode represents mode of an agent pool.

Value	Description
System
User

AgentPoolType

Enumeration

AgentPoolType represents types of an agent pool.

Value	Description
AvailabilitySet
VirtualMachineScaleSets

AgentPoolUpgradeSettings

Object

Settings for upgrading an agentpool

Name	Type	Description
maxSurge	string	Count or percentage of additional nodes to be added during upgrade. If empty uses AKS default

AutoScalerProfile

Object

Parameters to be applied to the cluster-autoscaler when enabled

Name	Type	Description
balance-similar-node-groups	string
expander	expander
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

CloudError

Object

An error response from the Container service.

Name	Type	Description
error	CloudErrorBody	Details about the error.

CloudErrorBody

Object

An error response from the Container service.

Name	Type	Description
code	string	An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
details	CloudErrorBody[]	A list of additional details about the error.
message	string	A message describing the error, intended to be suitable for display in a user interface.
target	string	The target of the particular error. For example, the name of the property in error.

code

Enumeration

Tells whether the cluster is Running or Stopped

Value	Description
Running
Stopped

ContainerServiceLinuxProfile

Object

Profile for Linux VMs in the container service cluster.

Name	Type	Description
adminUsername	string	The administrator username to use for Linux VMs.
ssh	ContainerServiceSshConfiguration	SSH configuration for Linux-based VMs running on Azure.

ContainerServiceNetworkProfile

Object

Profile of network configuration.

Name	Type	Default value	Description
dnsServiceIP	string	10.0.0.10	An IP address assigned to the Kubernetes DNS service. It must be within the Kubernetes service address range specified in serviceCidr.
dockerBridgeCidr	string	172.17.0.1/16	A CIDR notation IP range assigned to the Docker bridge network. It must not overlap with any Subnet IP ranges or the Kubernetes service address range.
loadBalancerProfile	ManagedClusterLoadBalancerProfile		Profile of the cluster load balancer.
loadBalancerSku	loadBalancerSku		The load balancer sku for the managed cluster.
networkMode	networkMode		Network mode used for building Kubernetes network.
networkPlugin	NetworkPlugin	kubenet	Network plugin used for building Kubernetes network.
networkPolicy	NetworkPolicy		Network policy used for building Kubernetes network.
outboundType	outboundType	loadBalancer	The outbound (egress) routing method.
podCidr	string	10.244.0.0/16	A CIDR notation IP range from which to assign pod IPs when kubenet is used.
serviceCidr	string	10.0.0.0/16	A CIDR notation IP range from which to assign service cluster IPs. It must not overlap with any Subnet IP ranges.

ContainerServiceSshConfiguration

Object

SSH configuration for Linux-based VMs running on Azure.

Name	Type	Description
publicKeys	ContainerServiceSshPublicKey[]	The list of SSH public keys used to authenticate with Linux-based VMs. Only expect one key specified.

ContainerServiceSshPublicKey

Object

Contains information about SSH certificate public key data.

Name	Type	Description
keyData	string	Certificate public key used to authenticate with VMs through SSH. The certificate must be in PEM format with or without headers.

ContainerServiceVMSizeTypes

Enumeration

Size of agent VMs.

Value	Description
Standard_A1
Standard_A10
Standard_A11
Standard_A1_v2
Standard_A2
Standard_A2_v2
Standard_A2m_v2
Standard_A3
Standard_A4
Standard_A4_v2
Standard_A4m_v2
Standard_A5
Standard_A6
Standard_A7
Standard_A8
Standard_A8_v2
Standard_A8m_v2
Standard_A9
Standard_B2ms
Standard_B2s
Standard_B4ms
Standard_B8ms
Standard_D1
Standard_D11
Standard_D11_v2
Standard_D11_v2_Promo
Standard_D12
Standard_D12_v2
Standard_D12_v2_Promo
Standard_D13
Standard_D13_v2
Standard_D13_v2_Promo
Standard_D14
Standard_D14_v2
Standard_D14_v2_Promo
Standard_D15_v2
Standard_D16_v3
Standard_D16s_v3
Standard_D1_v2
Standard_D2
Standard_D2_v2
Standard_D2_v2_Promo
Standard_D2_v3
Standard_D2s_v3
Standard_D3
Standard_D32_v3
Standard_D32s_v3
Standard_D3_v2
Standard_D3_v2_Promo
Standard_D4
Standard_D4_v2
Standard_D4_v2_Promo
Standard_D4_v3
Standard_D4s_v3
Standard_D5_v2
Standard_D5_v2_Promo
Standard_D64_v3
Standard_D64s_v3
Standard_D8_v3
Standard_D8s_v3
Standard_DS1
Standard_DS11
Standard_DS11_v2
Standard_DS11_v2_Promo
Standard_DS12
Standard_DS12_v2
Standard_DS12_v2_Promo
Standard_DS13
Standard_DS13-2_v2
Standard_DS13-4_v2
Standard_DS13_v2
Standard_DS13_v2_Promo
Standard_DS14
Standard_DS14-4_v2
Standard_DS14-8_v2
Standard_DS14_v2
Standard_DS14_v2_Promo
Standard_DS15_v2
Standard_DS1_v2
Standard_DS2
Standard_DS2_v2
Standard_DS2_v2_Promo
Standard_DS3
Standard_DS3_v2
Standard_DS3_v2_Promo
Standard_DS4
Standard_DS4_v2
Standard_DS4_v2_Promo
Standard_DS5_v2
Standard_DS5_v2_Promo
Standard_E16_v3
Standard_E16s_v3
Standard_E2_v3
Standard_E2s_v3
Standard_E32-16s_v3
Standard_E32-8s_v3
Standard_E32_v3
Standard_E32s_v3
Standard_E4_v3
Standard_E4s_v3
Standard_E64-16s_v3
Standard_E64-32s_v3
Standard_E64_v3
Standard_E64s_v3
Standard_E8_v3
Standard_E8s_v3
Standard_F1
Standard_F16
Standard_F16s
Standard_F16s_v2
Standard_F1s
Standard_F2
Standard_F2s
Standard_F2s_v2
Standard_F32s_v2
Standard_F4
Standard_F4s
Standard_F4s_v2
Standard_F64s_v2
Standard_F72s_v2
Standard_F8
Standard_F8s
Standard_F8s_v2
Standard_G1
Standard_G2
Standard_G3
Standard_G4
Standard_G5
Standard_GS1
Standard_GS2
Standard_GS3
Standard_GS4
Standard_GS4-4
Standard_GS4-8
Standard_GS5
Standard_GS5-16
Standard_GS5-8
Standard_H16
Standard_H16m
Standard_H16mr
Standard_H16r
Standard_H8
Standard_H8m
Standard_L16s
Standard_L32s
Standard_L4s
Standard_L8s
Standard_M128-32ms
Standard_M128-64ms
Standard_M128ms
Standard_M128s
Standard_M64-16ms
Standard_M64-32ms
Standard_M64ms
Standard_M64s
Standard_NC12
Standard_NC12s_v2
Standard_NC12s_v3
Standard_NC24
Standard_NC24r
Standard_NC24rs_v2
Standard_NC24rs_v3
Standard_NC24s_v2
Standard_NC24s_v3
Standard_NC6
Standard_NC6s_v2
Standard_NC6s_v3
Standard_ND12s
Standard_ND24rs
Standard_ND24s
Standard_ND6s
Standard_NV12
Standard_NV24
Standard_NV6

expander

Enumeration

Value	Description
least-waste
most-pods
priority
random

Identity

Object

Information of user assigned identity used by this add-on.

Name	Type	Description
clientId	string	The client id of the user assigned identity.
objectId	string	The object id of the user assigned identity.
resourceId	string	The resource id of the user assigned identity.

KubeletConfig

Object

Kubelet configurations of agent nodes.

Name	Type	Description
allowedUnsafeSysctls	string[]	Allowlist of unsafe sysctls or unsafe sysctl patterns (ending in `*`).
containerLogMaxFiles	integer	The maximum number of container log files that can be present for a container. The number must be ≥ 2.
containerLogMaxSizeMB	integer	The maximum size (e.g. 10Mi) of container log file before it is rotated.
cpuCfsQuota	boolean	Enable CPU CFS quota enforcement for containers that specify CPU limits.
cpuCfsQuotaPeriod	string	Sets CPU CFS quota period value.
cpuManagerPolicy	string	CPU Manager policy to use.
failSwapOn	boolean	If set to true it will make the Kubelet fail to start if swap is enabled on the node.
imageGcHighThreshold	integer	The percent of disk usage after which image garbage collection is always run.
imageGcLowThreshold	integer	The percent of disk usage before which image garbage collection is never run.
podMaxPids	integer	The maximum number of processes per pod.
topologyManagerPolicy	string	Topology Manager policy to use.

KubeletDiskType

Enumeration

KubeletDiskType determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage. Allowed values: 'OS', 'Temporary' (preview).

Value	Description
OS
Temporary

licenseType

Enumeration

The licenseType to use for Windows VMs. Windows_Server is used to enable Azure Hybrid User Benefits for Windows VMs.

Value	Description
None
Windows_Server

LinuxOSConfig

Object

OS configurations of Linux agent nodes.

Name	Type	Description
swapFileSizeMB	integer	SwapFileSizeMB specifies size in MB of a swap file will be created on each node.
sysctls	SysctlConfig	Sysctl settings for Linux agent nodes.
transparentHugePageDefrag	string	Transparent Huge Page defrag configuration.
transparentHugePageEnabled	string	Transparent Huge Page enabled configuration.

loadBalancerSku

Enumeration

The load balancer sku for the managed cluster.

Value	Description
basic
standard

ManagedCluster

Object

Managed cluster.

Name	Type	Description
id	string	Resource Id
identity	ManagedClusterIdentity	The identity of the managed cluster, if configured.
location	string	Resource location
name	string	Resource name
properties.aadProfile	ManagedClusterAADProfile	Profile of Azure Active Directory configuration.
properties.addonProfiles	<string, ManagedClusterAddonProfile>	Profile of managed cluster add-on.
properties.agentPoolProfiles	ManagedClusterAgentPoolProfile[]	Properties of the agent pool.
properties.apiServerAccessProfile	ManagedClusterAPIServerAccessProfile	Access profile for managed cluster API server.
properties.autoScalerProfile	AutoScalerProfile	Parameters to be applied to the cluster-autoscaler when enabled
properties.autoUpgradeProfile	ManagedClusterAutoUpgradeProfile	Profile of auto upgrade configuration.
properties.azurePortalFQDN	string	FQDN for the master pool which used by proxy config.
properties.diskEncryptionSetID	string	ResourceId of the disk encryption set to use for enabling encryption at rest.
properties.dnsPrefix	string	DNS prefix specified when creating the managed cluster.
properties.enablePodSecurityPolicy	boolean	(DEPRECATING) Whether to enable Kubernetes pod security policy (preview). This feature is set for removal on October 15th, 2020. Learn more at aka.ms/aks/azpodpolicy.
properties.enableRBAC	boolean	Whether to enable Kubernetes Role-Based Access Control.
properties.fqdn	string	FQDN for the master pool.
properties.fqdnSubdomain	string	FQDN subdomain specified when creating private cluster with custom private dns zone.
properties.identityProfile		Identities associated with the cluster.
properties.kubernetesVersion	string	Version of Kubernetes specified when creating the managed cluster.
properties.linuxProfile	ContainerServiceLinuxProfile	Profile for Linux VMs in the container service cluster.
properties.maxAgentPools	integer	The max number of agent pools for the managed cluster.
properties.networkProfile	ContainerServiceNetworkProfile	Profile of network configuration.
properties.nodeResourceGroup	string	Name of the resource group containing agent pool nodes.
properties.podIdentityProfile	ManagedClusterPodIdentityProfile	Profile of managed cluster pod identity.
properties.powerState	PowerState	Represents the Power State of the cluster
properties.privateFQDN	string	FQDN of private cluster.
properties.provisioningState	string	The current deployment or provisioning state, which only appears in the response.
properties.servicePrincipalProfile	ManagedClusterServicePrincipalProfile	Information about a service principal identity for the cluster to use for manipulating Azure APIs.
properties.windowsProfile	ManagedClusterWindowsProfile	Profile for Windows VMs in the container service cluster.
sku	ManagedClusterSKU	The managed cluster SKU.
tags	object	Resource tags
type	string	Resource type

ManagedClusterAADProfile

Object

AADProfile specifies attributes for Azure Active Directory integration.

Name	Type	Description
adminGroupObjectIDs	string[]	AAD group object IDs that will have admin role of the cluster.
clientAppID	string	The client AAD application ID.
enableAzureRBAC	boolean	Whether to enable Azure RBAC for Kubernetes authorization.
managed	boolean	Whether to enable managed AAD.
serverAppID	string	The server AAD application ID.
serverAppSecret	string	The server AAD application secret.
tenantID	string	The AAD tenant ID to use for authentication. If not specified, will use the tenant of the deployment subscription.

ManagedClusterAddonProfile

Object

A Kubernetes add-on profile for a managed cluster.

Name	Type	Description
config	object	Key-value pairs for configuring an add-on.
enabled	boolean	Whether the add-on is enabled or not.
identity	Identity	Information of user assigned identity used by this add-on.

ManagedClusterAgentPoolProfile

Object

Profile for the container service agent pool.

Name	Type	Default value	Description
availabilityZones	string[]		Availability zones for nodes. Must use VirtualMachineScaleSets AgentPoolType.
count	integer		Number of agents (VMs) to host docker containers. Allowed values must be in the range of 0 to 100 (inclusive) for user pools and in the range of 1 to 100 (inclusive) for system pools. The default value is 1.
enableAutoScaling	boolean		Whether to enable auto-scaler
enableEncryptionAtHost	boolean		Whether to enable EncryptionAtHost
enableNodePublicIP	boolean		Enable public IP for nodes
kubeletConfig	KubeletConfig		KubeletConfig specifies the configuration of kubelet on agent nodes.
kubeletDiskType	KubeletDiskType		KubeletDiskType determines the placement of emptyDir volumes, container runtime data root, and Kubelet ephemeral storage. Currently allows one value, OS, resulting in Kubelet using the OS disk for data.
linuxOSConfig	LinuxOSConfig		LinuxOSConfig specifies the OS configuration of linux agent nodes.
maxCount	integer		Maximum number of nodes for auto-scaling
maxPods	integer		Maximum number of pods that can run on a node.
minCount	integer		Minimum number of nodes for auto-scaling
mode	AgentPoolMode		AgentPoolMode represents mode of an agent pool
name	string		Unique name of the agent pool profile in the context of the subscription and resource group.
nodeImageVersion	string		Version of node image
nodeLabels	object		Agent pool node labels to be persisted across all nodes in agent pool.
nodePublicIPPrefixID	string		Public IP Prefix ID. VM nodes use IPs assigned from this Public IP Prefix.
nodeTaints	string[]		Taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule.
orchestratorVersion	string		Version of orchestrator specified when creating the managed cluster.
osDiskSizeGB	integer		OS Disk Size in GB to be used to specify the disk size for every machine in this master/agent pool. If you specify 0, it will apply the default osDisk size according to the vmSize specified.
osDiskType	OSDiskType		OS disk type to be used for machines in a given agent pool. Allowed values are 'Ephemeral' and 'Managed'. If unspecified, defaults to 'Ephemeral' when the VM supports ephemeral OS and has a cache disk larger than the requested OSDiskSizeGB. Otherwise, defaults to 'Managed'. May not be changed after creation.
osType	OSType	Linux	OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux.
podSubnetID	string		Pod SubnetID specifies the VNet's subnet identifier for pods.
powerState	PowerState		Describes whether the Agent Pool is Running or Stopped
provisioningState	string		The current deployment or provisioning state, which only appears in the response.
proximityPlacementGroupID	string		The ID for Proximity Placement Group.
scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	ScaleSetEvictionPolicy to be used to specify eviction policy for Spot virtual machine scale set. Default to Delete.
scaleSetPriority	ScaleSetPriority	Regular	ScaleSetPriority to be used to specify virtual machine scale set priority. Default to regular.
spotMaxPrice	number	-1	SpotMaxPrice to be used to specify the maximum price you are willing to pay in US Dollars. Possible values are any decimal value greater than zero or -1 which indicates default price to be up-to on-demand.
tags	object		Agent pool tags to be persisted on the agent pool virtual machine scale set.
type	AgentPoolType		AgentPoolType represents types of an agent pool
upgradeSettings	AgentPoolUpgradeSettings		Settings for upgrading the agentpool
vmSize	ContainerServiceVMSizeTypes		Size of agent VMs.
vnetSubnetID	string		VNet SubnetID specifies the VNet's subnet identifier for nodes and maybe pods

ManagedClusterAPIServerAccessProfile

Object

Access profile for managed cluster API server.

Name	Type	Description
authorizedIPRanges	string[]	Authorized IP Ranges to kubernetes API server.
enablePrivateCluster	boolean	Whether to create the cluster as a private cluster or not.
privateDNSZone	string	Private dns zone mode for private cluster.

ManagedClusterAutoUpgradeProfile

Object

Auto upgrade profile for a managed cluster.

Name	Type	Description
upgradeChannel	upgradeChannel	upgrade channel for auto upgrade.

ManagedClusterIdentity

Object

Identity for the managed cluster.

Name	Type	Description
principalId	string	The principal id of the system assigned identity which is used by master components.
tenantId	string	The tenant id of the system assigned identity which is used by master components.
type	ResourceIdentityType	The type of identity used for the managed cluster. Type 'SystemAssigned' will use an implicitly created identity in master components and an auto-created user assigned identity in MC_ resource group in agent nodes. Type 'None' will not use MSI for the managed cluster, service principal will be used instead.
userAssignedIdentities	UserAssignedIdentities	The user identity associated with the managed cluster. This identity will be used in control plane and only one user assigned identity is allowed. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ManagedClusterListResult

Object

The response from the List Managed Clusters operation.

Name	Type	Description
nextLink	string	The URL to get the next set of managed cluster results.
value	ManagedCluster[]	The list of managed clusters.

ManagedClusterLoadBalancerProfile

Object

Profile of the managed cluster load balancer.

Name	Type	Default value	Description
allocatedOutboundPorts	integer	0	Desired number of allocated SNAT ports per VM. Allowed values must be in the range of 0 to 64000 (inclusive). The default value is 0 which results in Azure dynamically allocating ports.
effectiveOutboundIPs	ResourceReference[]		The effective outbound IP resources of the cluster load balancer.
idleTimeoutInMinutes	integer	30	Desired outbound flow idle timeout in minutes. Allowed values must be in the range of 4 to 120 (inclusive). The default value is 30 minutes.
managedOutboundIPs	ManagedOutboundIPs		Desired managed outbound IPs for the cluster load balancer.
outboundIPPrefixes	OutboundIPPrefixes		Desired outbound IP Prefix resources for the cluster load balancer.
outboundIPs	OutboundIPs		Desired outbound IP resources for the cluster load balancer.

ManagedClusterPodIdentity

Object

Name	Type	Description
identity	UserAssignedIdentity	Information of the user assigned identity.
name	string	Name of the pod identity.
namespace	string	Namespace of the pod identity.
provisioningInfo	ProvisioningInfo
provisioningState	ManagedClusterPodIdentityProvisioningState	The current provisioning state of the pod identity.

ManagedClusterPodIdentityException

Object

Name	Type	Description
name	string	Name of the pod identity exception.
namespace	string	Namespace of the pod identity exception.
podLabels	object	Pod labels to match.

ManagedClusterPodIdentityProfile

Object

Name	Type	Description
allowNetworkPluginKubenet	boolean	Customer consent for enabling AAD pod identity addon in cluster using Kubenet network plugin.
enabled	boolean	Whether the pod identity addon is enabled.
userAssignedIdentities	ManagedClusterPodIdentity[]	User assigned pod identity settings.
userAssignedIdentityExceptions	ManagedClusterPodIdentityException[]	User assigned pod identity exception settings.

ManagedClusterPodIdentityProvisioningState

Enumeration

The current provisioning state of the pod identity.

Value	Description
Assigned
Deleting
Failed
Updating

ManagedClusterServicePrincipalProfile

Object

Information about a service principal identity for the cluster to use for manipulating Azure APIs.

Name	Type	Description
clientId	string	The ID for the service principal.
secret	string	The secret password associated with the service principal in plain text.

ManagedClusterSKU

Object

Name	Type	Description
name	ManagedClusterSKUName	Name of a managed cluster SKU.
tier	ManagedClusterSKUTier	Tier of a managed cluster SKU.

ManagedClusterSKUName

Enumeration

Name of a managed cluster SKU.

Value	Description
Basic

ManagedClusterSKUTier

Enumeration

Tier of a managed cluster SKU.

Value	Description
Free
Paid

ManagedClusterWindowsProfile

Object

Profile for Windows VMs in the container service cluster.

Name	Type	Description
adminPassword	string	Specifies the password of the administrator account. Minimum-length: 8 characters Max-length: 123 characters Complexity requirements: 3 out of 4 conditions below need to be fulfilled Has lower characters Has upper characters Has a digit Has a special character (Regex match [\W_]) Disallowed values: "abc@123", "P@$$w0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"
adminUsername	string	Specifies the name of the administrator account. restriction: Cannot end in "." Disallowed values: "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". Minimum-length: 1 character Max-length: 20 characters
licenseType	licenseType	The licenseType to use for Windows VMs. Windows_Server is used to enable Azure Hybrid User Benefits for Windows VMs.

ManagedOutboundIPs

Object

Desired managed outbound IPs for the cluster load balancer.

Name	Type	Default value	Description
count	integer	1	Desired number of outbound IP created/managed by Azure for the cluster load balancer. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1.

networkMode

Enumeration

Network mode used for building Kubernetes network.

Value	Description
bridge
transparent

NetworkPlugin

Enumeration

Network plugin used for building Kubernetes network.

Value	Description
azure
kubenet

NetworkPolicy

Enumeration

Network policy used for building Kubernetes network.

Value	Description
azure
calico

OSDiskType

Enumeration

OSDiskType represents the type of an OS disk on an agent pool.

Value	Description
Ephemeral
Managed

OSType

Enumeration

OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux.

Value	Description
Linux
Windows

OutboundIPPrefixes

Object

Desired outbound IP Prefix resources for the cluster load balancer.

Name	Type	Description
publicIPPrefixes	ResourceReference[]	A list of public IP prefix resources.

OutboundIPs

Object

Desired outbound IP resources for the cluster load balancer.

Name	Type	Description
publicIPs	ResourceReference[]	A list of public IP resources.

outboundType

Enumeration

The outbound (egress) routing method.

Value	Description
loadBalancer
userDefinedRouting

PowerState

Object

Describes the Power State of the cluster

Name	Type	Description
code	code	Tells whether the cluster is Running or Stopped

ProvisioningInfo

Object

Name	Type	Description
error	CloudError	Pod identity assignment error (if any).

ResourceIdentityType

Enumeration

The type of identity used for the managed cluster. Type 'SystemAssigned' will use an implicitly created identity in master components and an auto-created user assigned identity in MC_ resource group in agent nodes. Type 'None' will not use MSI for the managed cluster, service principal will be used instead.

Value	Description
None
SystemAssigned
UserAssigned

ResourceReference

Object

A reference to an Azure resource.

Name	Type	Description
id	string	The fully qualified Azure resource id.

ScaleSetEvictionPolicy

Enumeration

ScaleSetEvictionPolicy to be used to specify eviction policy for Spot virtual machine scale set. Default to Delete.

Value	Description
Deallocate
Delete

ScaleSetPriority

Enumeration

ScaleSetPriority to be used to specify virtual machine scale set priority. Default to regular.

Value	Description
Regular
Spot

SysctlConfig

Object

Sysctl settings for Linux agent nodes.

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

upgradeChannel

Enumeration

upgrade channel for auto upgrade.

Value	Description
none
patch
rapid
stable

UserAssignedIdentities

Object

The user identity associated with the managed cluster. This identity will be used in control plane and only one user assigned identity is allowed. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Name	Type	Description

UserAssignedIdentity

Object

Name	Type	Description
clientId	string	The client id of the user assigned identity.
objectId	string	The object id of the user assigned identity.
resourceId	string	The resource id of the user assigned identity.

Share via

Managed Clusters - List

URI Parameters

Responses

Security

azure_auth

Scopes

Examples

List Managed Clusters

Sample request

Sample response

Definitions

AgentPoolMode

AgentPoolType

AgentPoolUpgradeSettings

AutoScalerProfile

CloudError

CloudErrorBody

code

ContainerServiceLinuxProfile

ContainerServiceNetworkProfile

ContainerServiceSshConfiguration

ContainerServiceSshPublicKey

ContainerServiceVMSizeTypes

expander

Identity

KubeletConfig

KubeletDiskType

licenseType

LinuxOSConfig

loadBalancerSku

ManagedCluster

ManagedClusterAADProfile

ManagedClusterAddonProfile

ManagedClusterAgentPoolProfile

ManagedClusterAPIServerAccessProfile

ManagedClusterAutoUpgradeProfile

ManagedClusterIdentity

ManagedClusterListResult

ManagedClusterLoadBalancerProfile

ManagedClusterPodIdentity

ManagedClusterPodIdentityException

ManagedClusterPodIdentityProfile

ManagedClusterPodIdentityProvisioningState

ManagedClusterServicePrincipalProfile

ManagedClusterSKU

ManagedClusterSKUName

ManagedClusterSKUTier

ManagedClusterWindowsProfile

ManagedOutboundIPs

networkMode

NetworkPlugin

NetworkPolicy

OSDiskType

OSType

OutboundIPPrefixes

OutboundIPs

outboundType

PowerState

ProvisioningInfo

ResourceIdentityType

ResourceReference

ScaleSetEvictionPolicy

ScaleSetPriority

SysctlConfig

upgradeChannel

UserAssignedIdentities

UserAssignedIdentity

Additional resources