# 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-scalingplanpersonalschedule-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}/personalSchedules/{scalingPlanScheduleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a personal scaling plan schedule
      effect: read
      questions:
      - What does a personal desktop schedule in my AVD scaling plan look like?
      - How do I view the ramp-up and peak settings of a personal schedule?
      instructions:
      - text: Show personal schedule {scalingPlanScheduleName} in scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
      - text: Get the settings of personal schedule {scalingPlanScheduleName} on plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}/personalSchedules/{scalingPlanScheduleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a personal scaling plan schedule
      effect: write
      questions:
      - How do I add a schedule for personal host pools to an Azure Virtual Desktop scaling plan?
      - Can I overwrite an existing personal schedule's properties?
      instructions:
      - text: Create personal schedule {scalingPlanScheduleName} in scaling plan {scalingPlanName} with {properties}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
          properties: requestBody.properties
      - text: Replace personal schedule {scalingPlanScheduleName} on {scalingPlanName} using {properties}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}/personalSchedules/{scalingPlanScheduleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a personal scaling plan schedule
      effect: destructive
      questions:
      - How do I remove a personal schedule from my scaling plan?
      - Can I delete one personal desktop schedule and keep the plan?
      instructions:
      - text: Delete personal schedule {scalingPlanScheduleName} from scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
      - text: Remove personal schedule {scalingPlanScheduleName} on plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}/personalSchedules/{scalingPlanScheduleName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a personal scaling plan schedule
      effect: write
      questions:
      - How do I tweak the timing of an existing personal schedule?
      - Can I patch only some properties of a personal scaling schedule?
      instructions:
      - text: Patch personal schedule {scalingPlanScheduleName} in plan {scalingPlanName} with {properties}.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
          properties: requestBody.properties
      - text: Adjust personal schedule {scalingPlanScheduleName} on {scalingPlanName} without replacing it.
        slots:
          scalingPlanName: path.scalingPlanName
          scalingPlanScheduleName: path.scalingPlanScheduleName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/scalingPlans/{scalingPlanName}/personalSchedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List personal schedules in a scaling plan
      effect: read
      questions:
      - Which personal schedules are defined in my AVD scaling plan?
      - Can I page through a scaling plan's personal schedules in descending order?
      instructions:
      - text: List personal schedules in scaling plan {scalingPlanName}.
        slots:
          scalingPlanName: path.scalingPlanName
      - text: List personal schedules of {scalingPlanName}, {pageSize} per page.
        slots:
          scalingPlanName: path.scalingPlanName
          pageSize: query.pageSize
      method: generated
      generated: '2026-09-26'