# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Desktop Virtualization API Client Scaling…
  version: 1.0.0
extends: openapi/microsoft-azure-scalingplan-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure Virtual Desktop scaling plan
      effect: read
      questions:
      - What schedule and settings does my Azure Virtual Desktop scaling plan use?
      - Can I look up one scaling plan by name?
      instructions:
      - text: Get scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
      - text: Show the configuration of scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a scaling plan
      effect: write
      questions:
      - How do I set up autoscaling for session hosts with a new scaling plan?
      - Can I overwrite a scaling plan's full definition in one call?
      instructions:
      - text: Create scaling plan {scalingPlanName} with properties {properties}.
        slots:
          scalingPlanName: path.scalingPlanName
          properties: requestBody.properties
      - text: Create or replace the scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a scaling plan
      effect: destructive
      questions:
      - How do I delete a scaling plan I'm no longer using?
      - Can I remove autoscaling by deleting its scaling plan?
      instructions:
      - text: Delete scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
      - text: Remove the Virtual Desktop scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a scaling plan
      effect: write
      questions:
      - Can I change only the tags on a scaling plan?
      - Is there a way to tweak some scaling plan settings without resending everything?
      instructions:
      - text: Update the tags on scaling plan {scalingPlanName} to {tags}.
        slots:
          scalingPlanName: path.scalingPlanName
          tags: requestBody.tags
      - text: Patch scaling plan {scalingPlanName} with {properties}.
        slots:
          scalingPlanName: path.scalingPlanName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: List scaling plans in a resource group
      effect: read
      questions:
      - Which scaling plans are defined in this resource group?
      - Can I page resource group scaling plans in descending order?
      instructions:
      - text: List the scaling plans in this resource group.
      - text: List resource group scaling plans, {pageSize} per page.
        slots:
          pageSize: query.pageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DesktopVirtualization/scalingPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: List scaling plans in a subscription
      effect: read
      questions:
      - What scaling plans exist across my whole subscription?
      - Can I see subscription-wide scaling plans a page at a time?
      instructions:
      - text: List every scaling plan in my subscription.
      - text: Show subscription scaling plans skipping the first {initialSkip}.
        slots:
          initialSkip: query.initialSkip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/scalingPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: List scaling plans for a host pool
      effect: read
      questions:
      - Which scaling plan is attached to my host pool?
      - Can I check what autoscaling applies to one host pool?
      instructions:
      - text: List scaling plans for host pool {hostPoolName}.
        slots:
          hostPoolName: path.hostPoolName
      - text: Show which scaling plans are associated with host pool {hostPoolName}.
        slots:
          hostPoolName: path.hostPoolName
      method: generated
      generated: '2026-09-26'