Azure Kubernetes Service

Azure Kubernetes Service Managed Clusters API

Operations for managing AKS managed clusters

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 15

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/managedClusters List all AKS clusters in a subscription · Azure Kubernetes Service List Managed Clusters #
Ask an LLM
“How do I see every AKS cluster across my whole Azure subscription?”
“Which managed Kubernetes clusters exist in this subscription, regardless of resource group?”
Tell an agent
List every AKS managed cluster in subscription {subscriptionId}.
Show me all Kubernetes clusters I have anywhere in my Azure subscription.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters List AKS clusters in a resource group · Azure Kubernetes Service List Managed Clusters by Resource Group #
Ask an LLM
“What AKS clusters are in a specific resource group?”
“Can I narrow my cluster list down to just one resource group?”
Tell an agent
List the AKS clusters in resource group {resourceGroupName} of subscription {subscriptionId}.
Show only the managed clusters that live in resource group {resourceGroupName}.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName} Get details of one AKS cluster · Azure Kubernetes Service Get a Managed Cluster #
Ask an LLM
“What is the current configuration of a single AKS cluster I name?”
“Where can I look up the provisioning state and settings of one managed cluster?”
Tell an agent
Get the details of AKS cluster {resourceName} in resource group {resourceGroupName}.
Show the full configuration of cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName} Create or reconfigure an AKS cluster · Azure Kubernetes Service Create or Update a Managed Cluster #
Ask an LLM
“How do I create a new managed Kubernetes cluster in Azure?”
“Can I change the SKU or identity settings of an existing AKS cluster?”
Tell an agent
Create AKS cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}, region {location}.
Update the configuration of cluster {resourceName} with properties {properties}.
PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName} Update tags on an AKS cluster · Azure Kubernetes Service Update Managed Cluster Tags #
Ask an LLM
“Can I change just the tags on an AKS cluster without touching its configuration?”
“Is there a quick way to label a managed cluster with cost-center tags?”
Tell an agent
Set tags {tags} on AKS cluster {resourceName}.
Replace the tags on cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName} with {tags}.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName} Delete an AKS cluster · Azure Kubernetes Service Delete a Managed Cluster #
Ask an LLM
“How do I tear down an AKS cluster I no longer need?”
“What happens when I delete a managed Kubernetes cluster?”
Tell an agent destructive · confirm first
Delete AKS cluster {resourceName} in resource group {resourceGroupName}.
Permanently remove managed cluster {resourceName} from subscription {subscriptionId}.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/upgradeProfiles/default Check available upgrades for an AKS cluster · Azure Kubernetes Service Get Upgrade Profile for a Managed Cluster #
Ask an LLM
“Which Kubernetes versions can my AKS cluster's control plane upgrade to?”
“How can I tell if a cluster upgrade is available?”
Tell an agent
Get the upgrade profile for cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
Show which upgrades are available for AKS cluster {resourceName}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterAdminCredential Get admin kubeconfig for an AKS cluster · Azure Kubernetes Service List Cluster Admin Credentials #
Ask an LLM
“How do I get the cluster-admin kubeconfig for my AKS cluster?”
“Where do I fetch admin-level credentials to run kubectl with full rights?”
Tell an agent
Fetch admin credentials for AKS cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
Give me the cluster-admin kubeconfig for {resourceName}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterUserCredential Get user kubeconfig for an AKS cluster · Azure Kubernetes Service List Cluster User Credentials #
Ask an LLM
“Can I get a regular user kubeconfig for an AKS cluster instead of admin access?”
“Where do non-admin users get their credentials to connect to a managed cluster?”
Tell an agent
Fetch user credentials for AKS cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
Get a non-admin kubeconfig for cluster {resourceName}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/listClusterMonitoringUserCredential Get monitoring user credentials for a cluster · Azure Kubernetes Service List Cluster Monitoring User Credentials #
Ask an LLM
“What credentials should a monitoring tool use to read from my AKS cluster?”
“Is there a separate monitoring-user kubeconfig for a managed cluster?”
Tell an agent
Fetch the monitoring user credentials for AKS cluster {resourceName}.
Get the monitoring kubeconfig for {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/rotateClusterCertificates Rotate an AKS cluster's certificates · Azure Kubernetes Service Rotate Cluster Certificates #
Ask an LLM
“How do I rotate the certificates on an AKS cluster?”
“Can I renew a managed cluster's certificates if I think they were exposed?”
Tell an agent
Rotate certificates on AKS cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
Renew all certificates for managed cluster {resourceName}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/stop Stop a running AKS cluster · Azure Kubernetes Service Stop a Managed Cluster #
Ask an LLM
“Can I pause an AKS cluster to save money without losing its state?”
“Does stopping a managed cluster work on clusters that are not backed by scale sets?”
Tell an agent
Stop AKS cluster {resourceName} in subscription {subscriptionId}, resource group {resourceGroupName}.
Shut down the control plane and nodes of cluster {resourceName} but keep its state.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/start Start a stopped AKS cluster · Azure Kubernetes Service Start a Managed Cluster #
Ask an LLM
“How do I bring a stopped AKS cluster back online?”
“Can I resume a managed cluster I stopped over the weekend?”
Tell an agent
Start the stopped AKS cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.
Power cluster {resourceName} back on.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/runCommand Run a kubectl command on an AKS cluster · Azure Kubernetes Service Run a Command on a Managed Cluster #
Ask an LLM
“Can I run kubectl against a private AKS cluster without direct network access?”
“Is it possible to send supporting files along with a command I run on the cluster?”
Tell an agent
Run the command {command} on AKS cluster {resourceName}.
Execute {command} on private cluster {resourceName} in subscription {subscriptionId}, group {resourceGroupName}, with zipped files {context}.
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/abort Cancel the running operation on an AKS cluster · Azure Kubernetes Service Abort the Latest Operation on a Managed Cluster #
Ask an LLM
“How do I cancel a cluster-level operation that is stuck in progress?”
“What state does the managed cluster go into after I abort its current operation?”
Tell an agent destructive · confirm first
Abort the operation currently running on AKS cluster {resourceName}.
Cancel the in-progress cluster operation on {resourceName} in subscription {subscriptionId}, group {resourceGroupName}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/azure/aks/
📖
Authentication
https://learn.microsoft.com/en-us/azure/aks/concepts-identity
📖
RateLimits
https://learn.microsoft.com/en-us/azure/aks/quotas-skus-regions
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/aks/learn/quick-kubernetes-deploy-portal
📖
APIReference
https://learn.microsoft.com/en-us/rest/api/aks/managed-clusters
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/aks/learn/quick-kubernetes-deploy-cli
📖
Documentation
https://learn.microsoft.com/en-us/azure/aks/create-node-pools
📖
APIReference
https://learn.microsoft.com/en-us/rest/api/aks/agent-pools
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/aks/create-node-pools

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-kubernetes-service/refs/heads/main/openapi/microsoft-azure-kubernetes-service-managed-clusters-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-kubernetes-service/refs/heads/main/json-schema/azure-kubernetes-service-cluster-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-kubernetes-service/refs/heads/main/json-ld/azure-kubernetes-service-context.jsonld
🔗
Pricing
https://azure.microsoft.com/en-us/pricing/details/kubernetes-service/
🔗
ChangeLog
https://github.com/Azure/AKS/blob/master/CHANGELOG.md
🔗
ReleaseNotes
https://learn.microsoft.com/en-us/azure/aks/release-tracker
🔗
SDKs
https://learn.microsoft.com/en-us/python/api/overview/azure/mgmt-containerservice-readme
🔗
SDKs
https://learn.microsoft.com/en-us/javascript/api/overview/azure/container-service
🔗
SDKs
https://learn.microsoft.com/en-us/dotnet/api/overview/azure/resourcemanager.containerservice-readme
🔗
SDKs
https://learn.microsoft.com/en-us/java/api/overview/azure/resourcemanager-containerservice-readme
🔗
SDKs
https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v6

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/microsoft-azure-kubernetes-service:microsoft-azure-kubernetes-service-managed-clusters-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-azure-kubernetes-service-managed-clusters-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Azure Kubernetes Service REST Managed Clusters API
  description: REST API for managing Azure Kubernetes Service (AKS) resources including managed clusters, agent pools, maintenance configurations, snapshots, private endpoint connections, and trusted access role bindings. AKS simplifies deploying a managed Kubernetes cluster in Azure by offloading operational overhead such as health monitoring and maintenance.
  version: '2025-10-01'
  contact:
    name: Microsoft Azure Support
    url: https://azure.microsoft.com/en-us/support/options/
  license:
    name: Microsoft API License
    url: https://azure.microsoft.com/en-us/support/legal/
  x-apisguru-categories:
  - cloud
  - containers
  - kubernetes
  x-logo:
    url: https://azure.microsoft.com/images/aks-icon.png
servers:
- url: https://management.azure.com
  description: Azure Resource Manager
security:
- azure_auth:
  - user_impersonation
tags:


# --- truncated at 32 KB (95 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-kubernetes-service/refs/heads/main/openapi/microsoft-azure-kubernetes-service-managed-clusters-api-openapi.yml