Azure Kubernetes Service

Azure Kubernetes Service Agent Pools API

Operations for managing agent pools (node pools) within AKS clusters

GitHub OpenAPI

Operations 9

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools Azure Kubernetes Service List Agent Pools #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName} Azure Kubernetes Service Get an Agent Pool #
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName} Azure Kubernetes Service Create or Update an Agent Pool #
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName} Azure Kubernetes Service Delete an Agent Pool #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeProfiles/default Azure Kubernetes Service Get the Upgrade Profile for an Agent Pool #
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/availableAgentPoolVersions Azure Kubernetes Service Get Available Agent Pool Versions #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeNodeImageVersion Azure Kubernetes Service Upgrade Node Image Version #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/abort Azure Kubernetes Service Abort Latest Operation on an Agent Pool #
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/deleteMachines Azure Kubernetes Service Delete Specific Machines in an Agent Pool #

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-agent-pools-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-agent-pools-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-agent-pools-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Azure Kubernetes Service REST Agent Pools 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:
- name: Agent Pools
  description: Operations for managing agent pools (node pools) within AKS clusters
  externalDocs:
    url: https://learn.microsoft.com/en-us/rest/api/aks/agent-pools
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools
  : get:
      operationId: AgentPools_List
      summary: Azure Kubernetes Service List Agent Pools
      description: Gets a list of agent pools in the specified managed cluster.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPoolListResult'
              examples:
                AgentpoolsList200Example:
                  summary: Default AgentPools_List 200 response
                  x-microcks-default: true
                  value:
                    value:
                    - id: abc123
                      name: Example Title
                      type: example_value
                    nextLink: example_value
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsListdefaultExample:
                  summary: Default AgentPools_List default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}
  : get:
      operationId: AgentPools_Get
      summary: Azure Kubernetes Service Get an Agent Pool
      description: Gets the specified managed cluster agent pool.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPool'
              examples:
                AgentpoolsGet200Example:
                  summary: Default AgentPools_Get 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      provisioningState: example_value
                      count: 10
                      vmSize: example_value
                      osDiskSizeGB: 10
                      osDiskType: Managed
                      kubeletDiskType: OS
                      maxPods: 10
                      osType: Linux
                      osSKU: Ubuntu
                      type: VirtualMachineScaleSets
                      mode: System
                      orchestratorVersion: example_value
                      currentOrchestratorVersion: example_value
                      nodeImageVersion: example_value
                      enableAutoScaling: true
                      minCount: 10
                      maxCount: 10
                      scaleSetPriority: Spot
                      scaleSetEvictionPolicy: Delete
                      spotMaxPrice: 42.5
                      scaleDownMode: Delete
                      vnetSubnetID: '500123'
                      podSubnetID: '500123'
                      enableNodePublicIP: true
                      nodePublicIPPrefixID: '500123'
                      enableEncryptionAtHost: true
                      enableFIPS: true
                      enableUltraSSD: true
                      nodeLabels: example_value
                      nodeTaints:
                      - {}
                      tags: example_value
                      proximityPlacementGroupID: '500123'
                      availabilityZones:
                      - {}
                      workloadRuntime: OCIContainer
                      messageOfTheDay: example_value
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsGetdefaultExample:
                  summary: Default AgentPools_Get default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: AgentPools_CreateOrUpdate
      summary: Azure Kubernetes Service Create or Update an Agent Pool
      description: Creates or updates an agent pool in the specified managed cluster.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: if-match
        in: header
        description: The request should only proceed if an entity matches this string.
        schema:
          type: string
        example: example_value
      - name: if-none-match
        in: header
        description: The request should only proceed if no entity matches this string.
        schema:
          type: string
        example: example_value
      requestBody:
        required: true
        description: The agent pool to create or update.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentPool'
            examples:
              AgentpoolsCreateorupdateRequestExample:
                summary: Default AgentPools_CreateOrUpdate request
                x-microcks-default: true
                value:
                  id: abc123
                  name: Example Title
                  type: example_value
                  properties:
                    provisioningState: example_value
                    count: 10
                    vmSize: example_value
                    osDiskSizeGB: 10
                    osDiskType: Managed
                    kubeletDiskType: OS
                    maxPods: 10
                    osType: Linux
                    osSKU: Ubuntu
                    type: VirtualMachineScaleSets
                    mode: System
                    orchestratorVersion: example_value
                    currentOrchestratorVersion: example_value
                    nodeImageVersion: example_value
                    enableAutoScaling: true
                    minCount: 10
                    maxCount: 10
                    scaleSetPriority: Spot
                    scaleSetEvictionPolicy: Delete
                    spotMaxPrice: 42.5
                    scaleDownMode: Delete
                    vnetSubnetID: '500123'
                    podSubnetID: '500123'
                    enableNodePublicIP: true
                    nodePublicIPPrefixID: '500123'
                    enableEncryptionAtHost: true
                    enableFIPS: true
                    enableUltraSSD: true
                    nodeLabels: example_value
                    nodeTaints:
                    - {}
                    tags: example_value
                    proximityPlacementGroupID: '500123'
                    availabilityZones:
                    - {}
                    workloadRuntime: OCIContainer
                    messageOfTheDay: example_value
      responses:
        '200':
          description: OK. The update operation has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPool'
              examples:
                AgentpoolsCreateorupdate200Example:
                  summary: Default AgentPools_CreateOrUpdate 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      provisioningState: example_value
                      count: 10
                      vmSize: example_value
                      osDiskSizeGB: 10
                      osDiskType: Managed
                      kubeletDiskType: OS
                      maxPods: 10
                      osType: Linux
                      osSKU: Ubuntu
                      type: VirtualMachineScaleSets
                      mode: System
                      orchestratorVersion: example_value
                      currentOrchestratorVersion: example_value
                      nodeImageVersion: example_value
                      enableAutoScaling: true
                      minCount: 10
                      maxCount: 10
                      scaleSetPriority: Spot
                      scaleSetEvictionPolicy: Delete
                      spotMaxPrice: 42.5
                      scaleDownMode: Delete
                      vnetSubnetID: '500123'
                      podSubnetID: '500123'
                      enableNodePublicIP: true
                      nodePublicIPPrefixID: '500123'
                      enableEncryptionAtHost: true
                      enableFIPS: true
                      enableUltraSSD: true
                      nodeLabels: example_value
                      nodeTaints:
                      - {}
                      tags: example_value
                      proximityPlacementGroupID: '500123'
                      availabilityZones:
                      - {}
                      workloadRuntime: OCIContainer
                      messageOfTheDay: example_value
        '201':
          description: Created. The create operation has succeeded.
          headers:
            Azure-AsyncOperation:
              description: URL to query for status of the asynchronous operation.
              schema:
                type: string
            Retry-After:
              description: Suggested delay in seconds to check on operation status.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPool'
              examples:
                AgentpoolsCreateorupdate201Example:
                  summary: Default AgentPools_CreateOrUpdate 201 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      provisioningState: example_value
                      count: 10
                      vmSize: example_value
                      osDiskSizeGB: 10
                      osDiskType: Managed
                      kubeletDiskType: OS
                      maxPods: 10
                      osType: Linux
                      osSKU: Ubuntu
                      type: VirtualMachineScaleSets
                      mode: System
                      orchestratorVersion: example_value
                      currentOrchestratorVersion: example_value
                      nodeImageVersion: example_value
                      enableAutoScaling: true
                      minCount: 10
                      maxCount: 10
                      scaleSetPriority: Spot
                      scaleSetEvictionPolicy: Delete
                      spotMaxPrice: 42.5
                      scaleDownMode: Delete
                      vnetSubnetID: '500123'
                      podSubnetID: '500123'
                      enableNodePublicIP: true
                      nodePublicIPPrefixID: '500123'
                      enableEncryptionAtHost: true
                      enableFIPS: true
                      enableUltraSSD: true
                      nodeLabels: example_value
                      nodeTaints:
                      - {}
                      tags: example_value
                      proximityPlacementGroupID: '500123'
                      availabilityZones:
                      - {}
                      workloadRuntime: OCIContainer
                      messageOfTheDay: example_value
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsCreateorupdatedefaultExample:
                  summary: Default AgentPools_CreateOrUpdate default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: AgentPools_Delete
      summary: Azure Kubernetes Service Delete an Agent Pool
      description: Deletes an agent pool in the specified managed cluster.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Accepted. The delete operation will complete asynchronously.
          headers:
            Azure-AsyncOperation:
              description: URL to query for status of the asynchronous operation.
              schema:
                type: string
            Location:
              description: URL to query for the operation result.
              schema:
                type: string
            Retry-After:
              description: Suggested delay in seconds to check on operation status.
              schema:
                type: integer
        '204':
          description: No Content. The resource does not exist.
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsDeletedefaultExample:
                  summary: Default AgentPools_Delete default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeProfiles/default
  : get:
      operationId: AgentPools_GetUpgradeProfile
      summary: Azure Kubernetes Service Get the Upgrade Profile for an Agent Pool
      description: Gets the upgrade profile for an agent pool.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPoolUpgradeProfile'
              examples:
                AgentpoolsGetupgradeprofile200Example:
                  summary: Default AgentPools_GetUpgradeProfile 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      kubernetesVersion: example_value
                      osType: Linux
                      upgrades:
                      - kubernetesVersion: example_value
                        isPreview: true
                      latestNodeImageVersion: example_value
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsGetupgradeprofiledefaultExample:
                  summary: Default AgentPools_GetUpgradeProfile default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/availableAgentPoolVersions
  : get:
      operationId: AgentPools_GetAvailableAgentPoolVersions
      summary: Azure Kubernetes Service Get Available Agent Pool Versions
      description: Gets a list of supported Kubernetes versions for the specified agent pool.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPoolAvailableVersions'
              examples:
                AgentpoolsGetavailableagentpoolversions200Example:
                  summary: Default AgentPools_GetAvailableAgentPoolVersions 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    name: Example Title
                    type: example_value
                    properties:
                      agentPoolVersions:
                      - default: true
                        kubernetesVersion: example_value
                        isPreview: true
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsGetavailableagentpoolversionsdefaultExample:
                  summary: Default AgentPools_GetAvailableAgentPoolVersions default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeNodeImageVersion
  : post:
      operationId: AgentPools_UpgradeNodeImageVersion
      summary: Azure Kubernetes Service Upgrade Node Image Version
      description: Upgrades the node image version of an agent pool to the latest.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: OK. The agent pool node image has been upgraded.
        '202':
          description: Accepted. The operation will complete asynchronously.
          headers:
            Azure-AsyncOperation:
              description: URL to query for status of the asynchronous operation.
              schema:
                type: string
            Location:
              description: URL to query for the operation result.
              schema:
                type: string
            Retry-After:
              description: Suggested delay in seconds.
              schema:
                type: integer
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsUpgradenodeimageversiondefaultExample:
                  summary: Default AgentPools_UpgradeNodeImageVersion default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/abort
  : post:
      operationId: AgentPools_AbortLatestOperation
      summary: Azure Kubernetes Service Abort Latest Operation on an Agent Pool
      description: Aborts the currently running operation on the agent pool.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '202':
          description: Accepted. The operation will complete asynchronously.
          headers:
            Azure-AsyncOperation:
              description: URL to query for status of the asynchronous operation.
              schema:
                type: string
            Location:
              description: URL to query for the operation result.
              schema:
                type: string
            Retry-After:
              description: Suggested delay in seconds.
              schema:
                type: integer
        '204':
          description: No Content. No operation running.
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsAbortlatestoperationdefaultExample:
                  summary: Default AgentPools_AbortLatestOperation default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/deleteMachines
  : post:
      operationId: AgentPools_DeleteMachines
      summary: Azure Kubernetes Service Delete Specific Machines in an Agent Pool
      description: Deletes specific machines in an agent pool.
      tags:
      - Agent Pools
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/ResourceNameParameter'
      - $ref: '#/components/parameters/AgentPoolNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      requestBody:
        required: true
        description: The machine names to delete.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentPoolDeleteMachinesParameter'
            examples:
              AgentpoolsDeletemachinesRequestExample:
                summary: Default AgentPools_DeleteMachines request
                x-microcks-default: true
                value:
                  machineNames:
                  - example_value
      responses:
        '202':
          description: Accepted. The operation will complete asynchronously.
          headers:
            Azure-AsyncOperation:
              description: URL to query for status of the asynchronous operation.
              schema:
                type: string
            Location:
              description: URL to query for the operation result.
              schema:
                type: string
            Retry-After:
              description: Suggested delay in seconds.
              schema:
                type: integer
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
              examples:
                AgentpoolsDeletemachinesdefaultExample:
                  summary: Default AgentPools_DeleteMachines default response
                  x-microcks-default: true
                  value:
                    error:
                      code: example_value
                      message: example_value
                      target: example_value
                      details:
                      - code: example_value
                        message: example_value
                        target: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    ApiVersionParameter:
      name: api-version
      in: query
      required: true
      description: The API version to use for this operation.
      schema:
        type: string
        default: '2025-10-01'
    ResourceGroupNameParameter:
      name: resourceGroupName
      in: path
      required: true
      description: The name of the resource group. The name is case insensitive.
      schema:
        type: string
        minLength: 1
        maxLength: 90
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      required: true
      description: The ID of the target subscription. Must be a valid UUID.
      schema:
        type: string
        format: uuid
    AgentPoolNameParameter:
      name: agentPoolName
      in: path
      required: true
      description: The name of the agent pool.
      schema:
        type: string
        minLength: 1
        maxLength: 12
        pattern: ^[a-z][a-z0-9]{0,11}$
    ResourceNameParameter:
      name: resourceName
      in: path
      required: true
      description: The name of the managed cluster resource.
      schema:
        type: string
        minLength: 1
        maxLength: 63
        pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
  schemas:
    AgentPoolProperties:
      type: object
      description: Properties for the container service agent pool profile.
      properties:
        provisioningState:
          type: string
          readOnly: true
          description: The current deployment or provisioning state.
          example: example_value
        count:
          type: integer
          format: int32
          description: 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.
          example: 10
        vmSize:
          type: string
          description: The size of the agent VMs.
          example: example_value
        osDiskSizeGB:
          type: integer
          format: int32
          minimum: 0
          maximum: 2048
          description: OS Disk Size in GB.
          example: 10
        osDiskType:
          type: string
          enum:
          - Managed
          - Ephemeral
          description: The OS disk type.
          example: Managed
        kubeletDiskType:
          type: string
          enum:
          - OS
          - Temporary
          description: Kubelet disk type.
          example: OS
        maxPods:
          type: integer
          format: int32
          description: The maximum number of pods that can run on a node.
          example: 10
        osType:
          type: string
          enum:
          - Linux
          - Windows
          default: Linux
          description: The operating system type.
          example: Linux
        osSKU:
          type: string
          enum:
          - 

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